用法和示例

若要配置 Web 扩展下拉列表,必须指定以下参数:

  • 主题:指定颜色主题。选项是 "Vibrant""Subtle"。默认为 "Subtle"
  • 模式:指定颜色。值为 "Light""Dark""High Contrast"""。空字符串值 "" 等同于 "Light"
  • 标签:设置控件的标签。空字符串值 "" 隐藏标签、所需指示符和带有工具提示的信息图标。
  • 项目数据:定义要在下拉列表中显示具有以下列的项目表:
    • 项目 ID。使用此列可在选择更改时定义操作
    • 项目标题
    • 已选 (FALSE = 空字符串 "" 或 TRUE)
    • 已禁用。可选列 (FALSE = 空字符串 "" 或 TRUE)
    • 可见。可选列 (TRUE = 空字符串 "" 或 FALSE)
  • 多选:指定下拉列表允许单个选择还是多个选择。为单个选择使用空字符串 """FALSE",为多个选择使用 "TRUE"
  • 必填:定义是否要求选择元素。如果未提供,则默认为 "TRUE"
  • 信息:为信息图标提供工具提示文本。空字符串 "" 隐藏信息图标。
  • 状态:将控件状态定义为 "Enabled""Disabled""Read-only"。如果未提供,则默认使用 "Enabled"
  • 提示文本:将提示文本定义为字符串,如果未选择日期,则显示该提示。空字符串 "" 显示日期格式,这取决于区域设置。

此示例显示如何创建单个选择下拉列表并将此选择存储在报告变量中以供进一步处理。

  1. 创建 Application Studio 报告。
  2. 创建名为 Selection 的报告变量。
  3. 属性 - 报告窗格中,将即时写回选项设置为自动
  4. 在单元格 B2:D5 中插入下拉列表 Web 扩展。
  5. Web 扩展格式对话框中,指定以下值:
    主题
    指定 ="Vibrant"
    模式
    指定 ="Light"
    标签
    指定 ="Position"
    项目数据
    指定 =B7:F11
    多选
    指定 ="TRUE"
    必填
    指定 ="TRUE"
    信息
    指定 ="You can select one or more positions"
    状态
    指定 ="Enabled"
    提示文本
    指定 ="Select positions"
  6. 在单元格范围 B7:F11 中指定此样本表及其值:
    ID 标题 已选 已禁用 可见
    Id1 选项 1 =GETPROPERTY(ReportVariables.Selection.Text,B8,"selected")="True" FALSE TRUE
    Id2 选项 2 =GETPROPERTY(ReportVariables.Selection.Text,B9,"selected")="True" FALSE TRUE
    Id3 选项 3 =GETPROPERTY(ReportVariables.Selection.Text,B10,"selected")="True" FALSE TRUE
    Id4 选项 4 =GETPROPERTY(ReportVariables.Selection.Text,B11,"selected")="True" FALSE TRUE

    参数 Item Data 连接到此单元格范围。从表中读取每个元素的状态。在此示例中,所有元素均将启用并可见。选择元素时,仅更改所选列中的选择状态。GETPROPERTY 函数从 Selection 变量读取当前选择。

  7. 对于 ID 列中的每项,使用以下设置定义操作:
    • 操作
      类型
      指定 Set parameter
      条件
      指定 =TRUE
      模式
      指定 Web Extension
    • 参数
      名称
      指定 reportvariable.Selection
      属性
      指定 Value(.Text)
      指定 =Actions.Input.Text
  8. 单击确定
  9. 在 Web 浏览器中保存并查看报告。