次の方法で共有

Select 関数

適用先: キャンバス アプリ

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

内容

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

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

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

Select は、後で処理するためにターゲット OnSelect をキューに入れます。これは、現在の数式の評価が完了した後に発生する可能性があります。 Selectでは、ターゲット OnSelect が直ちに評価されることはなく、OnSelect の評価が完了するまで待機Select。

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

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

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

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

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

構文

Select( コントロール )

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

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

  • コントロール – 必須。 ユーザーの代理として選択するコントロール。
  • 行または列 – 必須ではありません。 ユーザーの代わりに選択するギャラリー コントロールの行または列の数 (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 プロパティを次の数式に設定します。

    Select( Button1 )

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

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

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

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

    Select コントロールを含む垂直ギャラリー。

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

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

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

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

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

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

    Notify( "Image Selected", NotificationType.Success )

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

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

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

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

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

    Select( Gallery1,2,Image1 )

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

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

  • Last updated on