トースト

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 リポジトリにあります。

さまざまなプラットフォームの実装と制限の詳細

  1. API では、IToast インターフェイスを実装することで、既存のメソッドを独自の実装でオーバーライドしたり、独自のトーストを作成したりできます。
  2. トーストは、Google によって作成された Android に実装されています。 他のプラットフォームでは、カスタム実装コンテナー (iOS および MacCatalyst の場合は UIView、Windows の場合は ToastNotification) を使用します。
  3. Tizen のトーストは、Duration および TextSize プロパティを使用してカスタマイズできません。