EventTrigger 類別

定義

命名空間:

Microsoft.Maui.Controls

組件:

Microsoft.Maui.Controls.dll

來源:

EventTrigger.cs

代表觸發事件及引發事件時要叫用之 TriggerAction 物件清單的類別。

public ref class EventTrigger sealed : Microsoft::Maui::Controls::TriggerBase

[Microsoft.Maui.Controls.ContentProperty("Actions")]
public sealed class EventTrigger : Microsoft.Maui.Controls.TriggerBase

[<Microsoft.Maui.Controls.ContentProperty("Actions")>]
type EventTrigger = class
    inherit TriggerBase

Public NotInheritable Class EventTrigger
Inherits TriggerBase

繼承

Object

BindableObject

TriggerBase

EventTrigger

屬性

ContentPropertyAttribute

備註

下列範例顯示開發人員如何使用事件觸發程式來回應事件，以及更新控件屬性的值。

在命名空間中TriggerDemo定義下列ColorTriggerAction類別：

public class ColorTriggerAction : TriggerAction<Entry>
{
  protected override void Invoke(Entry sender)
  {
      Color[] color ={ Color.Red,
                       Color.Orange,
                       Color.Yellow,
                       Color.Green,
                       Color.Blue,
                       Color.Indigo,
                       Color.Violet };
      sender.TextColor = color[sender.Text.Length % color.Length];
  }
}

開發人員可以使用下列 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="Do you see colors?"
             VerticalOptions="Center"
             HorizontalOptions="Center" />
<Entry Placeholder="Type stuff here."
             VerticalOptions="Center"
             HorizontalOptions="Center"
             BackgroundColor="Black">
<Entry.Triggers>
<EventTrigger Event="TextChanged" >
<local:ColorTriggerAction />
</EventTrigger>
</Entry.Triggers>
</Entry>
</StackLayout>
</ContentPage>

建構函式

EventTrigger()

建立新的 EventTrigger 執行個體。

屬性

Actions	取得引發 Event 屬性所識別之事件時要叫用的 TriggerAction 物件清單。
BindingContext	取得或設定 物件，其中包含屬於這個 BindableObject之系結屬性的目標屬性。 這是可繫結屬性。 (繼承來源 BindableObject)
Dispatcher	取得建立這個可系結物件時可用的發送器，否則會嘗試尋找最接近的可用發送器（可能是視窗的/應用程式）。 (繼承來源 BindableObject)
EnterActions	取得符合觸發條件時要叫用的 TriggerAction 物件清單。 若為 EventTrigger 類別請予以略過。 (繼承來源 TriggerBase)
Event	取得或設定事件名稱，這個事件會導致叫用包含在 Actions 中的動作。
ExitActions	取得觸發條件不再符合之後要叫用的 TriggerAction 物件清單。 若為 EventTrigger 類別請予以略過。 (繼承來源 TriggerBase)
IsSealed	取得值，指出是否密封觸發程序。 (繼承來源 TriggerBase)
TargetType	可附加這個 TriggerBase 物件的目標物件類型。 (繼承來源 TriggerBase)

方法

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)

代表觸發事件及引發事件時要叫用之 TriggerAction 物件清單的類別。 (繼承來源 BindableObject)

擴充方法

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)	代表觸發事件及引發事件時要叫用之 TriggerAction 物件清單的類別。
SetAppTheme<T>(BindableObject, BindableProperty, T, T)	代表觸發事件及引發事件時要叫用之 TriggerAction 物件清單的類別。
SetAppThemeColor(BindableObject, BindableProperty, Color, Color)	代表觸發事件及引發事件時要叫用之 TriggerAction 物件清單的類別。
SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)	建立並將繫結套用至屬性。

另請參閱

• Setter
• PropertyCondition
• DataTrigger
• Trigger