PowerApps の Back および Navigate 関数Back and Navigate functions in PowerApps

表示する画面を変更します。Changes which screen is displayed.

概要Overview

ほとんどのアプリには、複数の画面が含まれます。Most apps contain multiple screens. Back および Navigate 関数を使用して、表示する画面を変更します。Use the Back and Navigate function to change which screen is displayed. たとえば、ユーザーがボタンを選択したときに別の画面を表示する場合は、Navigate 関数が含まれた数式に、ボタンの OnSelect プロパティを設定します。For example, set the OnSelect property of a button to a formula that includes a Navigate function if you want to show a different screen when a user selects that button. その数式では、Fade などのビジュアルの切り替えを指定することで、画面の切り替わり方を選択できます。In that formula, you can specify a visual transition, such as Fade, to control how one screen changes to another.

Back および Navigate で変更できるのは、表示する画面のみです。Back and Navigate change only which screen is displayed. 現在表示されていない画面は、バックグラウンドで引き続き動作します。Screens that aren't currently displayed continue to operate behind the scenes. その他の画面のコントロールのプロパティを参照する数式を作成できます。You can build formulas that refer to properties of controls on other screens. たとえば、ユーザーことができます 1 つの画面上のスライダーの値を変更、数式では、その値を使用する別の画面に移動しますおよび新しい画面での動作の影響を確認します。For example, a user can change the value of a slider on one screen, navigate to a different screen that uses that value in a formula, and ascertain how it affects what happens in the new screen. ユーザーは、元の画面に戻るし、スライダーがその値を保持することを確認します。The user can then navigate back to the original screen and confirm that the slider has retained its value.

ユーザーが画面間を移動したとき、コンテキスト変数も保持されます。Context variables are also preserved when a user navigates between screens. Navigate を使用して、数式で表示される画面に 1 つ以上のコンテキスト変数を設定できます。これは、画面外からコンテキスト変数を設定する唯一の方法です。You can use Navigate to set one or more context variables for the screen that the formula will display, which is the only way to set a context variable from outside the screen. このアプローチにより、画面にパラメーターを渡すことができます。You can use this approach to pass parameters to a screen. 他のプログラミング ツールを使用したことがあれば、このアプローチはプロシージャにパラメーターを渡す処理に似ています。If you've used another programming tool, this approach is similar to passing parameters to procedures.

内でのみ、いずれの関数を使用することができます、動作の数式します。You can use either function only within a behavior formula.

最初の引数で、表示する画面の名前を指定します。In the first argument, specify the name of the screen to display.

2 番目の引数で、前の画面がどのように新しい画面に変化するかを指定します。In the second argument, specify how the old screen changes to the new screen:

切り替えの引数Transition Argument 説明Description デモDemonstration
ScreenTransition.CoverScreenTransition.Cover 新しい画面はスライドして表示、現在の画面をカバーする、左から右に移動します。The new screen slides into view, moving right to left, to cover the current screen. 画面遷移カバーのアニメーション
ScreenTransition.CoverRightScreenTransition.CoverRight 移行のビューに新しい画面のスライドは左から右、現在の画面をカバーすることです。The new screen slides into view, moving left to right, to cover the current screen. 画面遷移カバーの適切なアニメーション
ScreenTransition.FadeScreenTransition.Fade 新しい画面を表示する現在の画面のフェードします。The current screen fades away to reveal the new screen. 画面の遷移のフェード アニメーション
ScreenTransition.None (既定)ScreenTransition.None (Default) 迅速に、新しい画面には、現在の画面が置き換えられます。The new screen quickly replaces the current screen. 画面遷移 none アニメーション
ScreenTransition.UnCoverScreenTransition.UnCover 現在の画面は、新しい画面を明らかにするため、左から右に移動してスライドします。The current screen slides out of view, moving right to left, to uncover the new screen. 画面遷移アニメーションを発見します。
ScreenTransition.UnCoverRightScreenTransition.UnCoverRight 非表示、移動、現在の画面スライドは左から右を新しい画面を明らかにすることです。The current screen slides out of view, moving left to right, to uncover the new screen. 画面の切り替えが適切なアニメーションを発見します。

Navigate を使用して、新しい画面のコンテキスト変数を作成または更新できます。You can use Navigate to create or update context variables of the new screen. 省略可能な 3 番目の引数として、コンテキスト変数の名前 (名として) とコンテキスト変数の新しい値を含むレコードを渡します。As an optional third argument, pass a record that contains the context-variable name as a column name and the new value for the context variable. このレコードは、 UpdateContext 関数で使用するレコードと同じです。This record is the same as the record that you use with the UpdateContext function.

前の画面の OnHidden プロパティまたは新しい画面の OnVisible プロパティ、あるいはその両方を設定して、切り替え時の追加の変更を実施します。Set the OnHidden property of the old screen, the OnVisible property of the new screen, or both to make additional changes during the transition. App.ActiveScreen プロパティが更新され、変更が反映されます。The App.ActiveScreen property will be updated to reflect the change.

移動通常返すtrueが返されますが、 falseエラーが発生した場合。Navigate normally returns true but will return false if an error is encountered.

BackBack

戻る関数は、最近表示された画面に戻ります。The Back function returns to the screen that was most recently displayed.

Navigate呼び出し、表示された画面と、移行、アプリを追跡します。For each Navigate call, the app tracks the screen that appeared and the transition. 連続するを使用する戻る呼び出し、ユーザーに表示されていたときに画面をアプリで開始します。You can use successive Back calls to return all the way to the screen that appeared when the user started the app.

ときに、戻る関数が実行される、逆の遷移は、既定で使用されます。When the Back function runs, the inverse transition is used by default. 画面に表示されていた場合など、 CoverRight遷移、戻るを使用してスライドアウト(左側には) を返します。For example, if a screen appeared through the CoverRight transition, Back uses UnCover (which is to the left) to return. フェードNoneは独自の逆です。Fade and None are their own inverses. 省略可能な引数を渡す戻る特定の遷移を強制的にします。Pass an optional argument to Back to force a specific transition.

戻る通常返すtrue返しますが、 falseユーザーがアプリを起動してから別の画面に移動していない場合。Back normally returns true but returns false if the user hasn't navigated to another screen since starting the app.

構文Syntax

Back( [ Transition ] )Back( [ Transition ] )

  • 遷移- 省略可能。Transition - Optional. 現在の画面と、前の画面間を使用するビジュアルの切り替え。The visual transition to use between the current screen and the previous screen. このトピックの前に、この引数の有効な値の一覧を参照してください。Refer to the list of valid values for this argument earlier in this topic. 既定では、画面を返します、遷移は、表示される、切り替え効果の逆数です。By default, the transition through which a screen returns is the inverse of the transition through which it appeared.

Navigate( Screen [, Transition [, UpdateContextRecord ] ] )Navigate( Screen [, Transition [, UpdateContextRecord ] ] )

  • Screen - 必須。Screen - Required. 表示する画面。The screen to display.
  • 遷移- 省略可能。Transition - Optional. 現在の画面と次の画面の間で使用するビジュアルの切り替え。The visual transition to use between the current screen and the next screen. このトピックで既に掲載した、この引数の有効な値の一覧を参照してください。See the list of valid values for this argument earlier in this topic. 既定値はNoneします。The default value is None.
  • UpdateContextRecord - 省略可能。UpdateContextRecord - Optional. 1 つ以上の列の名前と、その列ごとの値を含むレコード。A record that contains the name of at least one column and a value for each column. このレコードは、 UpdateContext 関数に渡されたときのように、新しい画面のコンテキスト変数を更新します。This record updates the context variables of the new screen as if passed to the UpdateContext function.

Examples

数式Formula 説明Description 結果Result
(詳細) を移動します。Navigate( Details ) 切り替えもコンテキスト変数の値の変更もせずに、Details 画面を表示します。Displays the Details screen with no transition or change in value for a context variable. Details 画面がすばやく表示されます。The Details screen appears quickly.
Navigate( Details, ScreenTransition.Fade )Navigate( Details, ScreenTransition.Fade ) Details 画面を Fade 切り替えで表示します。Displays the Details screen with a Fade transition. コンテキスト変数の値は変更されません。No value of a context variable is changed. 現在の画面がフェードアウトし、Details 画面が表示されます。The current screen fades away to show the Details screen.
Navigate( Details, ScreenTransition.Fade, { ID: 12 } )Navigate( Details, ScreenTransition.Fade, { ID: 12 } ) Details 画面を Fade 切り替えで表示し、コンテキスト変数 ID の値を 12 に更新します。Displays the Details screen with a Fade transition, and updates the value of the ID context variable to 12. 現在の画面がフェードアウトし、Details 画面が表示され、画面上のコンテキスト変数 ID の値が 12 に設定されます。The current screen fades away to show the Details screen, and the context variable ID on that screen is set to 12.
Navigate( Details, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } )Navigate( Details, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } ) Details 画面を Fade 切り替えで表示します。Displays the Details screen with a Fade transition. コンテキスト変数 ID の値を 12 に更新し、コンテキスト変数 Shade の値を Color.Red に更新します。Updates the value of the ID context variable to 12, and updates the value of the Shade context variable to Color.Red. 現在の画面がフェードアウトし、Details 画面が表示されます。The current screen fades away to show the Details screen. Details 画面上のコンテキスト変数 ID12 に設定され、コンテキスト変数 ShadeColor.Red に設定されます。The context variable ID on the Details screen is set to 12, and the context variable Shade is set to Color.Red. Details 画面上のコントロールの Fill プロパティを Shade に設定した場合、そのコントロールは赤色で表示されます。If you set the Fill property of a control on the Details screen to Shade, that control would display as red.
Back()Back() 既定の戻り値の移行前の画面が表示されます。Displays the previous screen with the default return transition. 現在の画面が表示されていた、遷移の逆の遷移を前の画面が表示されます。Displays the previous screen through the inverse transition of the transition through which the current screen appeared.
Back( ScreenTransition.Cover )Back( ScreenTransition.Cover ) 前の画面が表示されます、カバー遷移します。Displays the previous screen with the Cover transition. 前の画面が表示されます、カバーにより、現在の画面が表示された遷移に関係なく、移行します。Displays the previous screen through the Cover transition, regardless of the transition through which the current screen appeared.

ステップバイステップStep-by-step

  1. 空のアプリを作成します。Create a blank app.

  2. 2 番目の画面を追加しています。Add a second screen to it.

    アプリには、2 つの空の画面が含まれています。Screen1Screen2します。The app contains two blank screens: Screen1 and Screen2.

  3. 設定、入力プロパティのScreen2Grayします。Set the Fill property of Screen2 to the value Gray.

  4. Screen2、ボタンを追加し、設定、その OnSelect に次の式のプロパティ。On Screen2, add a button, and set its OnSelect property to this formula:

    Navigate( Screen1, ScreenTransition.Cover )
    
  5. 押しながら、 Altキーで、ボタンを選択します。While holding down the Alt key, select the button.

    Screen1左側に対応する切り替えを白い背景が表示されます。Screen1 appears with a white background through a transition that covers to the left.

  6. Screen1、ボタンを追加し、設定、そのOnSelectに次の式のプロパティ。On Screen1, add a button, and set its OnSelect property to this formula:

    Back()
    
  7. 押しながら、 Altキーで、ボタンを選択します。While holding down the Alt key, select the button.

    グレーの背景を右に明らかにする遷移を 2 番目の画面が表示されます (逆のカバー)。The second screen appears with a gray background through a transition that uncovers to the right (the inverse of Cover).

  8. あちこちに繰り返し、各画面にボタンを選択します。Select the button on each screen repeatedly to bounce back and forth.

その他の例Another example