Trigger 클래스

정의

조건부로 작업을 수행하거나 속성 값을 적용하는 트리거를 나타냅니다.Represents a trigger that applies property values or performs actions conditionally.

public ref class Trigger : System::Windows::TriggerBase, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IAddChild
[System.Windows.Markup.ContentProperty("Setters")]
[System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")]
public class Trigger : System.Windows.TriggerBase, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IAddChild
type Trigger = class
    inherit TriggerBase
    interface IAddChild
    interface ISupportInitialize
Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize
상속
특성
구현

예제

다음 예제에서는 명명 된 Style 사용할 수 있는 Button 컨트롤입니다.The following example shows a named Style available to Button controls. Style 정의 Trigger 변경 하는 요소는 Foreground 단추의 속성 때를 IsPressed 속성이 true합니다.The Style defines a Trigger element that changes the Foreground property of a button when the IsPressed property is true.

<Style x:Key="Triggers" TargetType="Button">
    <Style.Triggers>
    <Trigger Property="IsPressed" Value="true">
        <Setter Property = "Foreground" Value="Green"/>
    </Trigger>
    </Style.Triggers>
</Style>

설명

WPFWPF 와 같은 최종 사용자 작업에 해당 하는 속성을 정의 IsMouseOver 로 설정 된 속성 true 위로 커서를 가리킬 때를 UIElement 이나 해당 IsMouseOver 속성을 ContentElement.defines properties that correspond to end-user actions, such as the IsMouseOver property that is set to true when the user hovers the cursor over a UIElement or the corresponding IsMouseOver property of a ContentElement. 최종 사용자 작업에서 속성 값을 나타내는 합니다 Trigger 요소를 사용 하면 WPFWPF 속성 값을 변경 하는 스타일에 따라 해당 최종 사용자 작업을 모두에서 태그 내입니다.Representing end-user actions in property values, along with the Trigger element, allows WPFWPF styles to change property values based on those end-user actions, all from within markup.

트리거에 의해 변경 된 속성 트리거 조건이 더 이상 만족 하는 경우 이전 값으로 다시 자동으로 됩니다.The properties changed by triggers are automatically reset to their previous value when the triggered condition is no longer satisfied. 일시적이 지는 변경 되어야 할 및 원래 돌아가서 상태를 상태와 같은 트리거 최적화 되었는지 IsPressedButton 하 고 IsSelected 에서 ListBoxItem합니다.Triggers are optimized for transient states which are expected to change and return to original state, such as IsPressed on Button and IsSelected on ListBoxItem. Property 관심 종속성 속성 이어야 합니다.The Property of interest must be a dependency property.

모두 지정 해야 합니다 PropertyValue 속성에는 Trigger 의미 있는 트리거에 대 한.Note that you must specify both the Property and Value properties on a Trigger for the trigger to be meaningful. 하나 또는 두 속성 모두 설정 되지 않은 경우 예외가 throw 됩니다.If one or both of the properties are not set, an exception is thrown.

Setters 의 속성을 Trigger 개체 수만 구성 Setter 개체입니다.The Setters property of a Trigger object can only consist of Setter objects. 추가 Setter 자식을 Trigger 개체가 암시적으로 추가 합니다 SetterBaseCollection 에 대 한를 Trigger 개체입니다.Adding a Setter child to a Trigger object implicitly adds it to the SetterBaseCollection for the Trigger object. EventSetter 개체가 지원 되지 않습니다. 만 Style.Setters 지원 EventSetter 개체입니다.EventSetter objects are not supported; only Style.Setters supports EventSetter objects.

다른 유형의 트리거가 있습니다.There are other types of triggers. MultiTrigger 여러 속성의 상태에 따라 변경 내용을 적용할 수 있습니다.MultiTrigger allows you to apply changes based on the state of multiple properties. EventTrigger 이벤트가 발생할 때 변경 내용을 적용할 수 있습니다.EventTrigger allows you to apply changes when an event occurs. DataTriggerMultiDataTrigger 데이터 바인딩된 속성에 대 한 것입니다.DataTrigger and MultiDataTrigger are for data-bound properties.

생성자

Trigger()

Trigger 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Trigger class.

속성

DependencyObjectType

이 인스턴스의 CLRCLR 형식을 래핑하는 DependencyObjectType을 가져옵니다.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(다음에서 상속됨 DependencyObject)
Dispatcher

Dispatcher와 연결된 DispatcherObject를 가져옵니다.Gets the Dispatcher this DispatcherObject is associated with.

(다음에서 상속됨 DispatcherObject)
EnterActions

트리거 개체가 활성화될 때 적용할 TriggerAction 개체의 컬렉션을 가져옵니다.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. 이 속성은 EventTrigger 클래스에 적용되지 않습니다.This property does not apply to the EventTrigger class.

(다음에서 상속됨 TriggerBase)
ExitActions

트리거 개체가 비활성화될 때 적용할 TriggerAction 개체의 컬렉션을 가져옵니다.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. 이 속성은 EventTrigger 클래스에 적용되지 않습니다.This property does not apply to the EventTrigger class.

(다음에서 상속됨 TriggerBase)
IsSealed

이 인스턴스가 현재 봉인되어 있는지(읽기 전용인지) 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether this instance is currently sealed (read-only).

(다음에서 상속됨 DependencyObject)
Property

트리거의 Value 속성과 비교하는 값을 반환하는 속성을 가져오거나 설정합니다.Gets or sets the property that returns the value that is compared with the Value property of the trigger. 수행되는 비교 작업은 참조 일치 검사입니다.The comparison is a reference equality check.

Setters

지정된 조건을 충족할 때 적용할 속성 값을 설명하는 Setter 개체의 컬렉션을 가져옵니다.Gets a collection of Setter objects, which describe the property values to apply when the specified condition has been met.

SourceName

관련 setter가 적용되도록 하는 속성이 있는 개체의 이름을 가져오거나 설정합니다.Gets or sets the name of the object with the property that causes the associated setters to be applied.

Value

요소의 속성 값과 비교할 값을 가져오거나 설정합니다.Gets or sets the value to be compared with the property value of the element. 수행되는 비교 작업은 참조 일치 검사입니다.The comparison is a reference equality check.

메서드

CheckAccess()

호출 스레드가 이 DispatcherObject에 액세스할 수 있는지 여부를 확인합니다.Determines whether the calling thread has access to this DispatcherObject.

(다음에서 상속됨 DispatcherObject)
ClearValue(DependencyProperty)

속성의 로컬 값을 지웁니다.Clears the local value of a property. 지울 속성이 DependencyProperty 식별자에서 지정됩니다.The property to be cleared is specified by a DependencyProperty identifier.

(다음에서 상속됨 DependencyObject)
ClearValue(DependencyPropertyKey)

읽기 전용 속성의 로컬 값을 지웁니다.Clears the local value of a read-only property. 선언할 속성이 DependencyPropertyKey에서 지정됩니다.The property to be cleared is specified by a DependencyPropertyKey.

(다음에서 상속됨 DependencyObject)
CoerceValue(DependencyProperty)

지정된 종속성 속성의 값을 강제 변환합니다.Coerces the value of the specified dependency property. 호출하는 DependencyObject에 있으므로 이 작업은 종속성 속성의 속성 메타데이터에 지정된 CoerceValueCallback 함수를 호출하여 수행합니다.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(다음에서 상속됨 DependencyObject)
Equals(Object)

제공된 DependencyObject가 현재 DependencyObject에 해당하는지 여부를 확인합니다.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(다음에서 상속됨 DependencyObject)
GetHashCode()

DependencyObject의 해시 코드를 가져옵니다.Gets a hash code for this DependencyObject.

(다음에서 상속됨 DependencyObject)
GetLocalValueEnumerator()

DependencyObject에 대해 로컬로 값을 설정한 종속성 속성을 확인하기 위한 특수 열거자를 만듭니다.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(다음에서 상속됨 DependencyObject)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
GetValue(DependencyProperty)

DependencyObject의 인스턴스에서 종속성 속성의 현재 유효 값을 반환합니다.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(다음에서 상속됨 DependencyObject)
InvalidateProperty(DependencyProperty)

지정된 종속성 속성의 유효 값을 다시 계산합니다.Re-evaluates the effective value for the specified dependency property.

(다음에서 상속됨 DependencyObject)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

DependencyObject에서 종속성 속성의 유효 값이 업데이트될 때마다 호출됩니다.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. 변경된 특정 종속성 속성은 이벤트 데이터에서 보고됩니다.The specific dependency property that changed is reported in the event data.

(다음에서 상속됨 DependencyObject)
ReadLocalValue(DependencyProperty)

종속성 속성의 로컬 값을 반환합니다(있는 경우).Returns the local value of a dependency property, if it exists.

(다음에서 상속됨 DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)

형식 변환기가 Trigger 개체의 속성 값을 제공하는 경우를 처리합니다.Handles cases where a type converter provides a value for a property of a Trigger object.

SetCurrentValue(DependencyProperty, Object)

해당 값 소스를 변경하지 않고 종속성 속성의 값을 설정합니다.Sets the value of a dependency property without changing its value source.

(다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)

지정된 종속성 속성 식별자를 가진 종속성 속성의 로컬 값을 설정합니다.Sets the local value of a dependency property, specified by its dependency property identifier.

(다음에서 상속됨 DependencyObject)
SetValue(DependencyPropertyKey, Object)

종속성 속성의 DependencyPropertyKey 식별자에 의해 지정된 읽기 전용 종속성 속성의 로컬 값을 설정합니다.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(다음에서 상속됨 DependencyObject)
ShouldSerializeProperty(DependencyProperty)

serialization 프로세스에서 지정된 종속성 속성의 값을 직렬화해야 하는지 여부를 나타내는 값을 반환합니다.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(다음에서 상속됨 DependencyObject)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
VerifyAccess()

호출 스레드에서 이 DispatcherObject에 액세스할 수 있는지 확인합니다.Enforces that the calling thread has access to this DispatcherObject.

(다음에서 상속됨 DispatcherObject)

명시적 인터페이스 구현

IAddChild.AddChild(Object)

자식 개체를 추가합니다.Adds a child object.

IAddChild.AddText(String)

노드의 텍스트 콘텐츠를 개체에 추가합니다.Adds the text content of a node to the object.

ISupportInitialize.BeginInit()

초기화가 시작됨을 개체에 알립니다.Signals the object that initialization is starting.

ISupportInitialize.EndInit()

초기화가 완료됨을 개체에 알립니다.Signals the object that initialization is complete.

적용 대상

추가 정보