选择函数

适用于:画布应用模型驱动应用

在控件上模拟选择操作,导致对 OnSelect 公式进行求值。

描述

Select 函数在控件上模拟选择操作,就像用户已单击或点击控件一样。 结果是,在目标控件上对 OnSelect 公式求值。

使用 Select 将选择操作传播到父控件。 此类型的传播是在库等位置的默认行为。 默认情况下,Gallery 控件中的任何控件的 OnSelect 属性均设置为 Select( Parent )。 这样一来,您可以设置 Gallery 控件本身的 OnSelect 属性的值,并将对该公式求值,无论用户在库中可能单击或点击哪个位置。

如果您希望库中的一个或多个控件从库本身执行不同的操作,请将这些控件的 OnSelect 属性设置为默认值以外的其他值。 如果您希望这些控件从库本身执行同一操作,可保留库中大部分控件的 OnSelect 属性的默认值。

Select 对目标 OnSelect 排队,以便以后进行处理,此操作可能在当前公式完成求值后执行。 Select 不会导致目标 OnSelect 立即求值,Select 也不会等待 OnSelect 完成求值。

不能跨屏幕使用 Select

只能对具有 OnSelect 属性的控件使用 Select

只能在行为公式中使用 Select

控件不能通过其他控件直接或间接使用 Select

Select 函数还可在图像库中使用。 例如,它可用来指定要在图像库中选定的行或列,或指定要在图像库的该行或该列中选定的控件。 选择某行或某列时,图像库所选内容将出现变化,并且对计算图像 Gallery 控件上的 OnSelect 公式进行求值。 如果提供了行或列中的控件,则对计算子控件的 OnSelect 公式进行求值。

语法

Select( Control )

  • Control – 必需。 代表用户进行选择的控件。

Select( Control, Row or column, Child Control )

  • Control – 必需。 代表用户进行选择的控件。
  • Row or column – 非必需。 要代表用户在图像 Gallery 控件中选择的行数或列数(从 1 开始)。
  • Child Control - 必需。 在要选择的“control”参数中标识的控件的子控件。

示例

  • Button

    Select(button1)

  • Select(Gallery1, 1)

    模拟用户在 Gallery1 中选择第 1 行或第 1 列的情况。

  • Select(Gallery1, 1, ChildControl1)

    模拟用户在 Gallery1 的第 1 行或第 1 列中选择 ChildConttrol1 的情况。

基本用法

  1. 添加一个 Button 控件,然后将其重命名为 Button1(如果它具有不同名称)。

  2. Button1OnSelect 属性设置为此公式:

    Notify( "Hello World" )

  3. 在同一屏幕上添加第二个 Button 控件,并将其 OnSelect 属性设置为此公式:

    Select( Button1 )

  4. 按住 Alt 键,并选择第二个按钮。

    将在您的应用的顶部出现一条通知。 Button1OnSelect 属性生成了此通知。

    当单击第二个按钮时,将出现动画,显示两个按钮和通知的 OnSelect 属性设置。

  1. 添加含有其他控件的垂直 Gallery 控件。

    选择含有控件的垂直控件。

  2. 将库的 OnSelect 属性设置为此公式:

    Notify( "Gallery Selected" )

  3. 按住 Alt 键,并单击或点击库的背景或库中的任何控件。

    所有操作都将在应用顶部显示已选择库的通知。

    使用库的 OnSelect 属性指定当用户单击或点击库中的项时要执行的默认操作。

  4. 将 Image 控件的 OnSelect 属性设置为此公式:

    Notify( "Image Selected", Success )

  5. 按住 Alt 键,并单击或点击库的各种元素。

    单击或点击库中除 Image 控件以外的任何控件时,将像以前一样显示已选择库。 单击或点击图像时,将显示已选择图像

    使用库中的单独控件执行与库的默认操作不同的操作。

    动画显示 Gallery 控件的 OnSelect 属性的默认值,以及执行不同操作的控件。

  6. 在相同屏幕上添加一个 Button 控件,并将其 OnSelect 属性设置为此公式:

    Select( Gallery1,2,Image1 )

  7. 按住 Alt 键,并选择此按钮。

    您的应用的顶部将显示已选择图像通知。 按钮单击模拟了在库的第 2 行中选择图像的情况。