PowerApps の画面コントロールScreen control in PowerApps

アプリ内で 1 つまたは複数の他のコントロールを含む UI 要素。A UI element that contains one or more other controls in an app.

説明Description

ほとんどのアプリには、ラベル コントロールやボタン コントロールのほか、データを表示したりナビゲーションをサポートしたりするその他のコントロールを含む複数の画面コントロールがあります。Most apps have multiple Screen controls that contain Label controls, Button controls, and other controls that show data and support navigation.

主要なプロパティKey properties

BackgroundImage – 画面の背景に表示される画像ファイルの名前です。BackgroundImage – The name of an image file that appears in the background of a screen.

Fill – コントロールの背景色です。Fill – The background color of a control.

その他のプロパティAdditional properties

ImagePosition – 画面またはコントロールのサイズが画像と異なる場合の、画面またはコントロール内の画像の位置です (Fill (フィル)、Fit (サイズに合わせる)、Stretch (伸ばす)、Tile (タイル表示)、または Center (中央に表示))。ImagePosition – The position (Fill, Fit, Stretch, Tile, or Center) of an image in a screen or a control if it isn't the same size as the image.

OnHidden – ユーザーがある画面から離れたときのアプリの動作。OnHidden – The behavior of an app when the user navigates away from a screen.

OnVisible – ユーザーが画面に移動したときのアプリの動作。OnVisible – The behavior of an app when the user navigates to a screen.

OnStart – ユーザーがアプリを開くときのアプリの動作です。OnStart – The behavior of the app when the user opens the app.

  • このプロパティで設定した数式は、アプリの最初の画面が表示される前に実行されます。The formula to which this property is set runs before the first screen of the app appears. アプリ開始時にどの画面が最初に表示されるかを変更するには、Navigate 関数を呼び出します。Call the Navigate function to change which screen appears first when the app starts.
  • UpdateContext 関数でコンテキスト変数を設定することはできません (どの画面もまだ表示されていないため)。You can't set context variables with the UpdateContext function because no screen has appeared yet. ただし、Navigate 関数でコンテキスト変数を渡し、Collect 関数を使用してコレクションを作成し、そのコレクションに入力することができます。However, you can pass context variables in the Navigate function and create and fill a collection by using the Collect function.
  • アプリを更新する場合、このプロパティで設定した数式は、アプリが PowerApps Studio に読み込まれるときに実行されます。When you update an app, the formula to which this property is set runs when the app is loaded into PowerApps Studio. このプロパティ変更の影響を確認するには、アプリを保存して閉じ、再読み込みする必要があります。To see the impact of changing this property, you'll need to save, close, and reload your app.
  • OnStart プロパティは、実際には画面ではなくアプリのプロパティです。The OnStart property is actually a property of the app, not the screen. 編集の便宜を考慮して、このプロパティをアプリの最初の画面のプロパティとして表示し、変更します。For editing convenience, you view and modify it as a property on the first screen of your app. 最初の画面を削除したか、画面の順序を変更したために、このプロパティを見つけられなくなることがあります。If you remove the first screen or reorder screens, this property may become hard to find. その場合は、アプリを保存して閉じ、再読み込みすると、最初の画面のプロパティとして表示されます。In this case, save, close, and reload your app, and the property will reappear as a property of the first screen.

Distinct( DataSource, ColumnName )Distinct( DataSource, ColumnName )

Example

  1. ラジオ コントロールを追加して ScreenFills という名前を付け、その Items プロパティを次の値に設定します。Add a Radio control, name it ScreenFills, and set its Items property to this value:
    ["Red", "Green"]["Red", "Green"]

    コントロールの追加、命名、構成についてはこちらをご覧くださいDon't know how to add, name, and configure a control?

  2. 既定の画面コントロールにSource という名前を付け、別の画面コントロールを追加して Target という名前を付けます。Name the default Screen control Source, add another Screen control, and name it Target.
  3. Sourceシェイプ コントロール (矢印など) を追加し、その OnSelect プロパティを次の数式に設定します。On Source, add a Shape control (such as an arrow), and set its OnSelect property to this formula:
    Navigate(Target, ScreenTransition.Fade)Navigate(Target, ScreenTransition.Fade)

    Navigate 関数またはその他の関数については各関連記事を参照してください。Want more information about the Navigate function or other functions?

  4. Targetシェイプ コントロール (矢印など) を追加し、その OnSelect プロパティを次の数式に設定します。In Target, add a Shape control (such as an arrow), and set its OnSelect property to this formula:
    Navigate(Source, ScreenTransition.Fade)Navigate(Source, ScreenTransition.Fade)
  5. TargetFill プロパティを次の数式に設定します。Set the Fill property of Target to this formula:
    If("Red" in ScreenFills.Selected.Value, RGBA(255, 0, 0, 1), RGBA(54, 176, 75, 1))If("Red" in ScreenFills.Selected.Value, RGBA(255, 0, 0, 1), RGBA(54, 176, 75, 1))
  6. Source から、F5 キーを押して、ラジオ コントロールのどちらかのオプションをクリックまたはタップしてから、シェイプ コントロールをクリックまたはタップします。From Source, press F5, click or tap either option in the Radio control, and then click or tap the Shape control.

    Target が、選択した色で表示されます。Target appears in the color that you chose.

  7. Target で、シェイプ コントロールをクリックまたはタップして Source に戻ります。On Target, click or tap the Shape control to return to Source.
  8. (オプション) ラジオ コントロールの他のオプションをクリックまたはタップしてから、シェイプ コントロールをクリックまたはタップして Target が他の色で表示されることを確認します。(optional) Click or tap the other option in the Radio control, and then click or tap the Shape control to confirm that Target appears in the other color.
  9. 既定のワークスペースに戻るには、Esc キーを押します。To return to the default workspace, press Esc.