Power Apps の Notify 関数
バナー メッセージをユーザーに表示します。
内容
Notify 関数を使用すると、画面の上部に現在表示されている内容の上に重ねて、バナー メッセージがユーザーに表示されます。 通知は、ユーザーがそれを閉じるか、別の通知で置き換えられるか、またはタイムアウトの期限が切れるまで、既定で 10 秒に設定されています。
メッセージの種類に応じて適切な色とアイコンが使用されます。 種類は、関数の 2 つ目の引数で指定します。
注意
Notify 関数の文字数制限は 500 文字です。
| NotificationType 引数 | 内容 |
|---|---|
| NotificationType.Error | メッセージをエラーとして表示します。 |
| NotificationType.Information (既定) | メッセージを情報提供として表示します。 |
| NotificationType.Success | メッセージを成功として表示します。 |
| NotificationType.Warning | メッセージを警告として表示します。 |
アプリの作成中と、エンド ユーザーがアプリを使用しているときの両方でメッセージが表示されます。
Notify は、動作の数式 内でのみ使用できます。
Notify は IfError 関数と組み合わせて、エラーを検出し、カスタム エラー メッセージを使って報告することができます。
Power Apps では、Notify と全く異なるメカニズムを使用してプッシュ通知を送信することもできます。 詳細については、Power Apps で通知を送信する を参照してください。
Notify は、常に true を返します。
注: この関数は、以前は ShowError という名前で、エラー メッセージのみを表示できました。
構文
Notify( Message [, NotificationType [ , Timeout ] ] )
- Message – 必須。 ユーザーに表示するメッセージ。
- NotificationType – 省略可能。 上の表の表示できるメッセージの種類。 既定は NotificationType.Information です。
- Timeout – 省略可能。 通知を自動的に閉じる前に待機するミリ秒数。 既定値は 10 秒 (または 10000 ミリ秒) です。 タイムアウト が 0 の場合、通知は無期限に表示されます。
例
手順
画面に Button コントロールを追加します。
Button の OnSelect プロパティを数式に設定します。
Notify( "Hello, World" )クリックするか、ボタンを押します。
ボタンがクリックされるたびに、Hello, World というメッセージが情報提供としてユーザーに表示されます。 ユーザーがこのメッセージを閉じないようにするか、もう一度ボタンを押すようにしないと、10 秒 (既定のタイムアウト) で自動的に閉じます。
エラーを示すようにメッセージの種類を変更します。 次の数式に 2 つ目の引数を追加します。
Notify( "Hello, World", NotificationType.Error )クリックするか、ボタンを押します。
これで、ボタンがクリックされるたびに、Hello, World というメッセージがエラーとしてユーザーに表示されます。 ユーザーがこのメッセージを閉じないようにするか、もう一度ボタンを押すようにしないと、10 秒 (既定のタイムアウト) で自動的に閉じます。
警告を示すようにメッセージの種類を変更します。 次の式の 2 つ目の引数を変更します。
Notify( "Hello, World", NotificationType.Warning, 4000 )クリックするか、ボタンを押します。
これで、ボタンがクリックされるたびに、Hello, World というメッセージが警告としてユーザーに表示されます。 ユーザーがこのメッセージを閉じないようにするか、ボタンをもう一度押すようにしないと、4 秒 (4000 ミリ秒) で自動的に閉じます。
成功を示すようにメッセージの種類を変更します。 次の式の 2 つ目の引数を変更します。
Notify( "Hello, World", NotificationType.Success, 0 )クリックするか、ボタンを押します。
これで、ボタンがクリックされるたびに、Hello, World というメッセージが成功としてユーザーに表示されます。 タイムアウト時間が 0 の場合、通知はユーザーによって、またはボタンをもう一度押すことによってのみ閉じられます。
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。
フィードバック
フィードバックの送信と表示