Trigger 类

参考

定义

命名空间:: Microsoft.Maui.Controls

程序集:: Microsoft.Maui.Controls.dll

Source:: Trigger.cs

Source:: Trigger.cs

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示属性条件和在满足条件时所执行的操作的类。

public ref class Trigger sealed : Microsoft::Maui::Controls::TriggerBase, Microsoft::Maui::Controls::Xaml::IValueProvider

[Microsoft.Maui.Controls.ContentProperty("Setters")]
[Microsoft.Maui.Controls.Xaml.AcceptEmptyServiceProvider]
public sealed class Trigger : Microsoft.Maui.Controls.TriggerBase, Microsoft.Maui.Controls.Xaml.IValueProvider

[<Microsoft.Maui.Controls.ContentProperty("Setters")>]
[<Microsoft.Maui.Controls.Xaml.AcceptEmptyServiceProvider>]
type Trigger = class
    inherit TriggerBase
    interface IValueProvider

Public NotInheritable Class Trigger
Inherits TriggerBase
Implements IValueProvider

继承: Object

BindableObject

TriggerBase
Trigger

属性: ContentPropertyAttribute AcceptEmptyServiceProviderAttribute

实现: IValueProvider

注解

该 Trigger 类适用于检查已向其添加的控件上的任何属性的值。也就是说，其默认绑定上下文是已向其添加的控件。若要在父级以外的控件上绑定，开发人员应改用该 DataTrigger 类。

下面的 XML 示例提示用户键入机密，即“文本颜色为红色”。当用户键入机密时，Entry 文本将颜色更改为红色。如果用户随后编辑文本与机密不同，则代码将返回默认颜色。此示例演示如何使用触发器绑定到封闭控件。


<?xml version="1.0" encoding="utf-8"?>
<ContentPage    xmlns="http://xamarin.com/schemas/2014/forms"
                xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
                xmlns:local="clr-namespace:TriggerDemo"
                x:Class="TriggerDemo.TriggerDemoPage">
<StackLayout VerticalOptions="Center">
<Label Text="Tell me the secret"
               VerticalOptions="Center"
               HorizontalOptions="Center" />
<Entry Placeholder="Type the secret here."
               VerticalOptions="Center"
               HorizontalOptions="Center">
<Entry.Triggers>
<Trigger TargetType="Entry"
                    Property="Text"
                    Value="The text color is red">
<Setter Property="TextColor" Value="Red" />
</Trigger>
</Entry.Triggers>
</Entry>
</StackLayout>
</ContentPage>

下面的示例演示开发人员如何使用触发器来响应事件，并使用 TriggerAction<T> 类更新控件属性的值。该示例提示用户回答有关文本颜色的问题，然后在用户键入“文本颜色为红色”时调用 ColorTriggerAction 将文本变为红色。开发人员应注意，虽然本示例在用户继续编辑字符串时不会将文本更改回默认颜色，但开发人员可以另外实现并指定退出操作以获取该结果。

在命名空间中 TriggerDemo 定义以下 ColorTriggerAction 类：

public class ColorTriggerAction : TriggerAction<Entry>
{
    protected override void Invoke(Entry sender)
    {
        sender.TextColor = Color.Red;
    }
}

开发人员可以使用下面的 XAML 创建通过将文本区域的颜色 Entry 更改为红色来响应机密字符串的页面。

<?xml version="1.0" encoding="utf-8"?>
<ContentPage    xmlns="http://xamarin.com/schemas/2014/forms"
                xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
                xmlns:local="clr-namespace:TriggerDemo"
                x:Class="TriggerDemo.TriggerDemoPage">
<StackLayout VerticalOptions="Center">
<Label Text="What color is &quot;The text&quot;?"
               VerticalOptions="Center"
               HorizontalOptions="Center" />
<Entry Placeholder="Type answer here."
               VerticalOptions="Center"
               HorizontalOptions="Center"
               BackgroundColor="White">
<Entry.Triggers>
<Trigger TargetType="Entry"
                         Property="Text"
                         Value="The text is red" >
<Trigger.EnterActions>
<local:ColorTriggerAction />
</Trigger.EnterActions>
</Trigger>
</Entry.Triggers>
</Entry>
</StackLayout>
</ContentPage>

构造函数

Trigger(Type)

初始化一个新 Trigger 实例。

属性

BindingContext	获取或设置一个对象，该对象包含由属于此 BindableObject属性的绑定属性所面向的属性。这是一种可绑定属性。 (继承自 BindableObject)
Dispatcher	获取创建此可绑定对象时可用的调度程序，否则会尝试查找最近的可用调度程序（可能是窗口的/应用）。 (继承自 BindableObject)
EnterActions	获取将在满足触发条件时调用的 TriggerAction 对象的列表。忽略 EventTrigger 类。 (继承自 TriggerBase)
ExitActions	获取在不再满足触发条件时调用的 TriggerAction 对象的列表。忽略 EventTrigger 类。 (继承自 TriggerBase)
IsSealed	获取一个值，该值指示触发器是否密封。 (继承自 TriggerBase)
Property	获取或设置其值将与 Value 进行比较以确定何时调用资源库的属性。
Setters	获取当 Property 命名的属性等于 Value 时将应用的 Setter 对象列表。
TargetType	TriggerBase 对象可附加到的对象类型。 (继承自 TriggerBase)
Value	获取或设置由 Property 属性命名的属性的值，它将导致资源库被应用。

方法

ApplyBindings()	将所有当前绑定应用于 BindingContext。 (继承自 BindableObject)
ClearValue(BindableProperty)	清除以前为可绑定属性设置的任何值。 (继承自 BindableObject)
ClearValue(BindablePropertyKey)	清除以前为其键标识的可绑定属性设置的任何值。 (继承自 BindableObject)
CoerceValue(BindableProperty)	强制指定可绑定属性的值。这是通过调用 BindableProperty.CoerceValueDelegate 指定的可绑定属性来完成的。 (继承自 BindableObject)
CoerceValue(BindablePropertyKey)	强制指定可绑定属性的值。这是通过调用 BindableProperty.CoerceValueDelegate 指定的可绑定属性来完成的。 (继承自 BindableObject)
GetValue(BindableProperty)	返回给定可绑定属性中包含的值。 (继承自 BindableObject)
IsSet(BindableProperty)	确定可绑定属性是否存在并设置了值。 (继承自 BindableObject)
OnBindingContextChanged()	引发 BindingContextChanged 事件。 (继承自 BindableObject)
OnPropertyChanged(String)	引发 PropertyChanged 事件。 (继承自 BindableObject)
OnPropertyChanging(String)	引发 PropertyChanging 事件。 (继承自 BindableObject)
RemoveBinding(BindableProperty)	从可绑定属性中删除以前设置的绑定。 (继承自 BindableObject)
SetBinding(BindableProperty, BindingBase)	将绑定分配给可绑定属性。 (继承自 BindableObject)
SetValue(BindableProperty, Object)	设置指定的可绑定属性的值。 (继承自 BindableObject)
SetValue(BindablePropertyKey, Object)	设置指定的可绑定属性的值。 (继承自 BindableObject)
UnapplyBindings()	从当前上下文中删除所有当前绑定。 (继承自 BindableObject)

事件

BindingContextChanged	当 BindingContext 属性的值更改时发生。 (继承自 BindableObject)
PropertyChanged	在属性值更改时发生。 (继承自 BindableObject)
PropertyChanging	在属性值更改时发生。 (继承自 BindableObject)

显式接口实现

IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)	表示属性条件和在满足条件时所执行的操作的类。 (继承自 BindableObject)
IValueProvider.ProvideValue(IServiceProvider)	表示属性条件和在满足条件时所执行的操作的类。

扩展方法

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)	表示属性条件和在满足条件时所执行的操作的类。
SetAppTheme<T>(BindableObject, BindableProperty, T, T)	表示属性条件和在满足条件时所执行的操作的类。
SetAppThemeColor(BindableObject, BindableProperty, Color, Color)	表示属性条件和在满足条件时所执行的操作的类。
SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)	创建绑定并将其应用到属性。
SetBinding<TSource,TProperty>(BindableObject, BindableProperty, Func<TSource,TProperty>, BindingMode, IValueConverter, Object, String, Object, Object, Object)	在源对象上的属性和目标对象的属性之间创建绑定。

适用于

通过

Trigger 类

定义

注解

构造函数

属性

方法

事件

显式接口实现

扩展方法

适用于

另请参阅

其他资源