関数を選択する

  • [アーティクル]

適用先: キャンバス アプリ モデル駆動型アプリ

コントロールでのアクションの選択をシミュレートし、OnSelect 式を評価します。

内容

Select 関数では、ユーザーがコントロールをクリックまたはタップした場合と同じように、コントロールでのアクションの選択をシミュレートします。 その結果、対象のコントロールでの OnSelect 式が評価されます。

Select を使用して、アクションの選択を親コントロールに伝達します。 この種類の伝達は、ギャラリーなどでの既定の動作です。 既定では、Gallery コントロールのすべてのコントロールの OnSelect プロパティは Select (Parent) に設定されています。 これにより、ギャラリー コントロール自体の OnSelect プロパティの値を設定でき、ユーザーがギャラリーのどこをクリックまたはタップしたかにかかわらず、その計算式が評価されます。

ギャラリーの 1 つ以上のコントロールでギャラリー自体とは異なるアクションを実行させる場合、それらのコントロールの OnSelect プロパティを既定値以外に設定します。 ギャラリー自体と同じアクションを実行させる場合は、ギャラリーのほとんどのコントロールの OnSelect プロパティを既定値のままにすることができます。

Select は、後の処理のために対象の OnSelect をキューに入れますが、この動作は現在の式の評価が完了した後で行われる場合があります。 Select によって対象の OnSelect がすぐに評価されたり、Select が OnSelect の評価の完了まで待機したりすることはありません。

複数の画面で Select を使用することはできません。

Select は、OnSelect プロパティを持つコントロールと共にのみ使用できます。

Select は、動作の数式 でのみ使用できます。

コントロールが直接、または他のコントロールを通じて間接的に、自身を Select することはできません。

Select 関数はギャラリーでも使用できます。 たとえば、ギャラリーで選択する行または列や、ギャラリーのその行または列で選択するためのコントロールを指定するために使用できます。 行または列を選択すると、ギャラリーの選択が変更され、ギャラリー コントロールの OnSelect 式が評価されます。 行または列内のコントロールが指定されている場合は、子コントロールの OnSelect 式が評価されます。

構文

Select(コントロール)

  • Control – 必須。 ユーザーの代理として選択するコントロール。

Select( Control, Row or column, Child Control )

  • Control – 必須。 ユーザーの代理として選択するコントロール。
  • 行または列 – 任意。 ユーザーの代わりに選択するギャラリー コントロールの行または列の数 (1 から開始)。
  • 子コントロール - 任意。 「コントロール」パラメーターで識別されるコントロールの子コントロールを選択します。

例

  • ボタン

    Select(button1)

  • ギャラリー

    Select(Gallery1, 1)

    ユーザーによる Gallery1 での行 1 または列 1 の選択をシミュレートします。

  • ギャラリー

    Select(Gallery1, 1, ChildControl1)

    ユーザーによる Gallery1 の行 1 または列 1 の ChildConttrol1 の選択をシミュレートします。

基本的な使用方法

  1. Button コントロールを追加し、別の名前になっている場合は Button1 に名前を変更します。

  2. Button1 の OnSelect プロパティを次の数式に設定します。

    Notify( "Hello World" )

  3. 同じ画面で、2 つ目の Button コントロールを追加し、その OnSelect プロパティを次の数式に設定します。

    Select( Button1 )

  4. Alt キーを押しながら 2 つ目のボタンを選択します。

    通知がアプリケーションの上部に表示されます。 この通知を生成したのは、Button1 の OnSelect プロパティです。

    2 つのボタンの OnSelect プロパティの設定と、2 つ目のボタンがクリックされたときの通知を示すアニメーション。

  1. 他のコントロールを含む垂直方向のGallery コントロールを追加します。

    コントロールを含む垂直ギャラリーを選択します。

  2. ギャラリーの OnSelect プロパティを次の計算式に設定します。

    Notify( "Gallery Selected" )

  3. Alt キーを押しながら、ギャラリーの背景かギャラリー内のコントロールをクリックまたはタップします。

    すべてのアクションで、アプリケーションの上部に Garllery Selected 通知が表示されます。

    ギャラリーの OnSelect プロパティを使用して、ユーザーがギャラリーの項目をクリックまたはタップしたときに実行する既定のアクションを指定します。

  4. 画像コントロールの OnSelect プロパティを次の計算式に設定します。

    Notify( "Image Selected", Success )

  5. Alt キーを押しながら、ギャラリーのさまざまな要素をクリックまたはタップします。

    画像以外のギャラリーのコントロールをクリックまたはタップすると、前と同様に Gallery Selected が表示されます。 画像をクリックまたはタップすると、Image Selected が表示されます。

    ギャラリーで個々のコントロールを使用して、ギャラリーの既定のアクションとは異なるアクションを実行させます。

    ギャラリー コントロールの OnSelect プロパティの既定値と、異なるアクションを実行するコントロールを示すアニメーション。

  6. 同じ画面で、Button コントロールを追加し、その OnSelect プロパティを次の数式に設定します。

    Select( Gallery1,2,Image1 )

  7. Alt キーを押しながら、ボタンを選択します。

    Image Selected 通知がアプリの上部に表示されます。 ボタンのクリックで、ギャラリーの行 2 のイメージの選択がシミュレートされました。