Select 函數

適用於:畫布應用

模擬在控制項上的選取動作,導致評估 OnSelect 公式。

說明

函 Select 式會模擬控制項上的選取動作,就像使用者已按一下或點選控制項一樣。 因此,就會評估目標控制項上的 OnSelect 公式。

用 Select 來將選取動作傳播至父控制項。 舉例來說,此傳播類型是資源庫中的預設行為。 根據預設,資源庫控制項中任何控制項的 OnSelect 屬性都會設定為 Select( 父 )。 如此一來,您就可以將 OnSelect 屬性的值設為 Gallery 控制項本身,且使用者無論在資源庫中的任何位置點擊或點選都會評估該公式。

如果您想要在資源庫中有一或多個控制項,以從資源庫本身執行不同動作,則請將這些控制項的 OnSelect 屬性設為預設值以外的值。 如果您希望那些控制項執行與資源庫本身相同的動作,則可將資源庫中大部分控制項的 OnSelect 屬性保留預設值。

Select 將目標 OnSelect 排入佇列以供稍後處理,這可能會在目前公式完成評估之後發生。 Select 不會導致目標 OnSelect 立即評估,也不會 Select 等候 OnSelect 完成評估。

您無法跨螢幕使用 Select 。

您只能與具有 OnSelect 屬性的控制項搭配使用Select。

您只能在Select行為公式中使用。

控制項本身無法 Select 直接或間接地透過其他控制項。

選取函式也可以搭配資源庫使用。 例如,您可以使用此函式指定要在資源庫中選取的資料列或資料行,以及要在該資源庫資料列或資料行中選取的控制項。 當您選取資料列或資料行時,資源庫的選取範圍就會變更,而 Gallery 控制項上的 OnSelect 公式也會受到評估。 如果提供資料列或資料行中的控制項,即會評估子控制項的 OnSelect 公式。

語法

Select(控制)

  • Control(控制) –必需。 要代表使用者選取的控制項。

Select( 控制項、列或列、子控制項 )

  • Control(控制) –必需。 要代表使用者選取的控制項。
  • Row or column (行或列 )–不需要。 要代表使用者在 Gallery 控制項中選取的資料列或資料行編號 (從 1 開始)。
  • 子系 Control - 不需要。 在所要選「控制項」參數中識別的控制項子控制項。

範例

  • 按鈕

    Select(button1)

  • 畫廊

    Select(Gallery1, 1)

    模擬使用者在 Gallery1 中選取列 1 或欄 1。

  • 畫廊

    Select(Gallery1, 1, ChildControl1)

    模擬使用者在資源庫 1 的列 1 或欄 1 中選取子控制項 1。

基本使用方式

  1. 新增 Button 控制項,然後將它重新命名為 Button1 (如果它有不同名稱的話)。

  2. 將 Button1 的 OnSelect 屬性設為以下公式︰

    通知(“Hello World”)

  3. 在相同畫面上,新增第二個 Button 控制項,並將其 OnSelect 屬性設為以下公式:

    Select(按鈕1)

  4. 按住 Alt 鍵,同時選取第二個按鈕。

    您的應用程式頂端會顯示通知。 Button1 的 OnSelect 屬性產生了此通知。

    動畫顯示兩個按鈕的 OnSelect 屬性設定,以及點擊第二個按鈕時顯示的通知。

  1. 新增可包含其他控制項的垂直 Gallery 控制項。

    Select 包含控制項的垂直資源庫。

  2. 將資源庫的 OnSelect 屬性設為以下公式:

    通知(「已選擇圖庫」)

  3. 按住 Alt 鍵,然後點擊或點選資源庫的背景或資源庫中的任意控制項。

    所有的動作都將會在應用程式頂端顯示 Gallery Selected 通知。

    使用資源庫的 OnSelect 屬性,以指定使用者點擊或點選資源庫中項目時所要採取的預設動作。

  4. 將影像控制項的 OnSelect 屬性設為以下公式:

    notify( “已選取的影像”, NotificationType.Success )

  5. 按住 Alt 鍵,然後點擊或點選資源庫的各個項目。

    當您點擊或點選資源庫中除了影像之外的任何控制項時,會像之前一樣顯示 Gallery Selected。 當您按一下或點選影像,則會顯示 Image Selected。

    在資源庫中使用各別的控制項,以採取與資源庫預設動作不同的動作。

    動畫顯示 Gallery 控制項 OnSelect 屬性的預設值,以及採取不同動作的控制項。

  6. 在相同畫面上,新增 Button 控制項,並將其 OnSelect 屬性設為以下公式:

    Select( 圖庫1,2,圖片1 )

  7. 按住 Alt 鍵時,選取按鈕。

    應用程式頂端會顯示 Image Selected 通知。 按一下按鈕會模擬在資源庫列 2 中選取影像。