通过

toast

  • 项目

Toast 是屏幕底部显示的计时警报。 它会在可配置的持续时间后被自动消除。

它以小警报的方式向用户提供有关操作的简单反馈。

特定于平台的初始化

要访问 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。

以下屏幕截图显示生成的 Toast：

属性

属性 类型​​ 说明 默认值
文本 string 显示在 Toast 中的文本。 必需
持续时间 ToastDuration 显示的持续时间 Toast。 ToastDuration.Short
TextSize double 文本字号。 14.0

ToastDuration

ToastDuration 枚举定义以下成员：

  • Short - 显示 Toast 2 秒
  • Long - 显示 Toast 3.5 秒

这些值遵循 android.widget.Toast API 中定义的常数。

方法

方法 说明
显示 显示请求的 Toast。 如果当前显示 Toast，则会在显示请求的 Toast 之前自动将其消除。
取消 消除当前 toast。

注意

一次只能显示一个 Toast。 如果第二次调用 Show 方法，则将自动消除第一个 Toast。

示例

可以在 .NET MAUI 社区工具包示例应用程序中找到此功能的示例。

API

可以在 .NET MAUI 社区工具包 GitHub 存储库查看Toast 的源代码

不同平台的实现和限制的详细信息

  1. API 通过实现 IToast 接口，支持使用你自己的实现替代现有方法或创建你自己的 Toast。
  2. Toast 在由 Google 创建的 Android 上实现。 其他平台使用自定义实现的容器（UIView 用于 iOS 和 MacCatalyst，ToastNotification 用于 Windows）。
  3. Tizen 上的 Toast 不能使用其 Duration 和 TextSize 属性进行自定义。