トースト
Toast
は、画面の下部に表示される、指定時刻に作動するアラートです。 設定した時間が経過すると、自動的に閉じられます。
小さなアラート内で操作に関する簡単なフィードバックをユーザーに提供します。
構文
C#
Toast
を表示するには、まず静的メソッド Toast.Make()
を使用して作成し、次にメソッド Show()
を使用して表示します。
using CommunityToolkit.Maui.Alerts;
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
string text = "This is a Toast";
ToastDuration duration = ToastDuration.Short;
double fontSize = 14;
var toast = Toast.Make(text, duration, fontSize);
await toast.Show(cancellationTokenSource.Token);
Toast.Make()
を呼び出すときは、パラメータ string text
が必要です。 その他のパラメーターはすべて省略可能です。 省略可能なパラメータ ToastDuration duration
では、既定の期間の ToastDuration.Short
が使用されます。 省略可能なパラメータ double fontSize
では、デフォルト値の 14.0
が使用されます。
次のスクリーンショットは、結果のトーストを示しています。
Properties
プロパティ | タイプ | 説明 | 規定値 |
---|---|---|---|
Text | string |
Toast に表示されるテキスト。 |
必須 |
Duration | ToastDuration |
Toast が表示される期間。 |
ToastDuration.Short |
TextSize | double |
テキストのフォント サイズ | 14.0 |
ToastDuration
ToastDuration
列挙型には、次のメンバーが定義されています。
Short
- 2 秒間Toast
を表示するLong
- 3.5 秒間Toast
を表示する
これらの値は、android.widget.Toast
API で定義された定数に従います。
メソッド
メソッド | 説明 |
---|---|
表示 | 要求された Toast を表示します。 Toast が現在表示されている場合、要求された Toast が表示される前に自動的に閉じられます。 |
無視 | 現在のトーストを閉じます。 |
Note
一度に表示できる Toast
は 1 つだけです。 2 回目の Show
メソッドを呼び出すと、最初の Toast
は自動的に閉じられます。
例
この機能の動作例は「.NET MAUI Community Toolkit サンプル アプリケーション」で確認できます。
API
Toast
のソース コードは、.NET MAUI Community Toolkit の GitHub リポジトリにあります。
さまざまなプラットフォームの実装と制限の詳細
- API では、
IToast
インターフェイスを実装することで、既存のメソッドを独自の実装でオーバーライドしたり、独自のトーストを作成したりできます。 - トーストは、Google によって作成された Android に実装されています。 他のプラットフォームでは、カスタム実装コンテナー (iOS および MacCatalyst の場合は
UIView
、Windows の場合はToastNotification
) を使用します。 - Tizen のトーストは、
Duration
およびTextSize
プロパティを使用してカスタマイズできません。
.NET MAUI Community Toolkit
フィードバック
https://aka.ms/ContentUserFeedback。
近日公開予定: 2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub イシューを段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、以下を参照してください:フィードバックの送信と表示