次の方法で共有

関数を選択する

  • [アーティクル]

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

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

内容

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

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

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

選択 は、現在の数式の評価が完了した後に発生する可能性のある、後の処理のためにターゲット OnSelect をキューに入れます。 選択 は、ターゲット OnSelect をすぐに評価しません。また、 選択 OnSelect の評価が完了するまで待機しません。

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

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

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

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

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

構文

選択( コントロール )

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

選択( コントロール、行または列、子 コントロール )

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

例

  • ボタン

    Select(button1)

  • ギャラリー

    Select(Gallery1, 1)

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

  • ギャラリー

    Select(Gallery1, 1, ChildControl1)

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

基本的な使用方法

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

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

    通知("Hello World")

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

    選択( ボタン1 )

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

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

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

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

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

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

    通知(「ギャラリーが選択されました」)

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

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

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

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

    通知(「画像が選択されました」、成功)

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

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

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

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

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

    選択( ギャラリー1,2,画像1 )

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

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