用法和示例

项目列表 Web 扩展具有其核心功能的参数以及用于自定义其内容的其他参数。

以下是主参数：

  • 项目键：对包含项目唯一名称和进一步处理操作的单元格范围的引用。触发操作时，Actions.Input.Text 将发送以下值之一：
    • Actions.Input.Text="Row"：将选中该项目。
    • Actions.Input.Text="Edit"：已单击“编辑”按钮。
    • Actions.Input.Text="Delete"：已单击“删除”按钮。
  • 项目数据：对包含项目数据的单元格范围或包含相同数据的 XML 的单元格的引用。为项目键的下列可选属性保留数据范围的第一列：
  • 标题 (字符串)
  • 描述 1 (字符串)
  • 描述 2 (字符串)
  • 时间戳 (字符串)
  • 可见 (布尔值)：如果为假，则隐藏项目。默认为“真”。
  • 已启用 (布尔值)：如果为“假”，则该项目已禁用。默认为“真”。
  • 已选 (布尔值)：如果为“真”，将选中该项目。默认为“假”。
  • 编辑 (布尔值)：如果"真"，将显示内联编辑和删除图标。默认为“假”。
这些附加参数可启用内容自定义。指定 ="" 以使用可用的默认值。
注意

可指定诸如错误消息等文本，使用 TRANSLATEUNIQUESTRING 函数确保在更改用户界面的语言时翻译文本。

  • 多选：如果为真，则会启用多选。默认为“假”。
  • 搜索框占位符：默认情况下，搜索框可见且为空。指定“假”以禁用该复选框。
  • 错误消息：默认情况下，如果没有列表项目，错误消息为“没有可用项”。
  • 主标题：列表的标题。默认情况下，不显示标题。
  • 主标题颜色：标题的默认颜色为 #368ac0。
  • 标题颜色：标题字体的默认颜色为 #1a1a1a。
  • 所选颜色：突出显示所选行的颜色。默认为 #c8e9f4。
  • 所选项目文本：默认情况下，文本为“已选”。只有在已启用多选的情况下，此参数才适用。
  • 移除操作：定义单击“移除”按钮时触发的单元格上的操作。默认文本为“删除”。只有在已启用多选的情况下，此参数才适用。
  • 隐藏侧边框：指定“真”可隐藏行的左边框和右边框。默认情况下，边框可见。
  • 边框颜色：默认情况下，边框的颜色为 #d8d8d8。
  1. 创建 Application Studio 报告。
  2. 将此样本数据插入范围 B8:H12：
    密钥 标题 说明1 说明2 已启用 已选 编辑
    a 项目 A 说明 A FALSE TRUE
    b 项目 B 说明 B 详细信息 B FALSE FALSE FALSE
    c 项目 C 说明 C TRUE FALSE
    d 项目 D 说明 D FALSE FALSE
  3. 创建名为 rv_SelectedItem 的报告变量，然后将 “c” 指定为值及默认值并选择作为其值。在变量属性中，将“假”指定为“持久的”选项的值。
  4. 在单元格 G9 中，指定 “=ReportVariables.rv_SelectedItem.Text=B9”：将公式复制到单元格 G10、G11 和 G12。
    进行此更新后，单元格保留其原始文本。
  5. 在每个键单元格 (B9、B10、B11 和 B12) 中，创建具有以下特征的操作：
    操作:类型
    选择“设置参数”作为操作类型。
    操作:模式
    选择 “Web 扩展”作为模式。
    操作:条件
    指定 “=Actions.Input.Text="ROW"”。
    注意

    除非操作模式为 Web 扩展，否则该条件无效。

    参数：名称
    单击“添加参数”并选择 rv_SelectedItem 变量。
    参数：属性
    指定“所选 Value(.Text)”。
    参数：值
    对于 B9 中的操作，指定 “=B9”。对于其他操作，分别指定 “=B10”、“=B11” 和 “=B12”。
  6. 创建名为 rv_TitleItemA 的报告变量并指定“项目 A” 作为其值。在变量的属性中，指定“项目 A” 作为默认值，然后选择“假” 作为“持久的”选项值。
  7. 在单元格 C9 中，指定 “=ReportVariables.rv_TitleItemA.Text” 并按 “Enter”。
    进行此更新后，单元格将保留其原始文本。
  8. 在单元格 B9 上，创建具有以下特征的操作：
    操作:类型
    选择“设置参数”作为操作类型。
    操作:模式
    选择 “Web 扩展”作为模式。
    操作:条件
    指定 “=Actions.Input.Text="EDIT"”
    注意

    除非操作模式为 Web 扩展，否则该条件无效。

    参数：名称
    单击“添加参数”并选择 rv_TitleItemA 变量。
    参数：属性
    选择“Value(.Text)”
    参数：值
    指定 “="Edited Item A"”。
  9. 在单元格 B13 中，指定 SETPROPERTY 公式： 
    =SETPROPERTY("",B9:B12,C8,C9:C12,D8,D9:D12,E8,E9:E12,F8,F9:F12,G8,G9:G12,H8,H9:H12)
  10. 单击“对象”工具栏上的 “Web 扩展”，然后双击“项目列表”Web 扩展。
    光标变为十字线。
  11. 拖动光标以插入，调整和定位 Web 扩展。
  12. 指定下列参数：
    唯一名称
    指定包含列表项目的唯一名称的单元格范围。在此示例中，指定 “=B9:B12”。
    项目数据
    指定定义扩展数据表的单元格范围。在此示例中，指定 “=B13”。
  13. 也可为这些参数指定值，或指定 “=""” 以使用默认值。
    主标题
    默认情况下，列表没有标题。也可指定标题。
    主标题字体颜色
    如果指定主标题，则默认颜色为蓝色 (#368ac0)。也可指定不同的颜色值。
    搜索框占位符
    默认情况下，搜索框为空。也可指定要在框中显示的文本。若要隐藏搜索框，可指定 “FALSE” (区分大小写)。
    错误消息
    默认情况下，如果没有可用的项目，则不会显示任何错误。也可指定错误消息。如果更改 UI 语言，使用 TRANSLATESTRING 可简化错误的翻译。
    标题字体颜色
    默认情况下，列表项目的标题为深灰色 (#1a1a1a)。也可指定不同的颜色值
    所选颜色
    指定突出显示所选列表项的颜色。默认为浅蓝色(#c8e9f4)。也可指定不同的颜色值。
    多选
    默认情况下，只能选择单个项目。若要启用多个项目选择的复选框，可指定 “=”TRUE””。
    隐藏侧边框
    默认情况下，每行都有一个左边框和一个右边框。指定 “"=TRUE"” 可隐藏这些边框。
    边框颜色
    默认情况下，列表的顶部和侧边框为浅灰色(#d8d8d8)。也可指定不同的颜色值。
    所选项目文本
    如果已启用多选，则指示所选项目数，然后是已选。也可指定不同的文本。如果更改 UI 语言，使用 TRANSLATESTRINGUNIQUE 可简化文本的翻译。
    操作栏移除按钮

    如果启用了多选，则可显示移除按钮来取消选择所选项目。指定包含移除这一词的单元格的引用。

    如果更改 UI 语言，使用 TRANSLATESTRING 可简化按钮的翻译。