VisualState 클래스

정의

네임스페이스:

System.Windows

어셈블리:

PresentationFramework.dll

컨트롤이 특정 상태일 때의 시각적 모양을 나타냅니다.

public ref class VisualState : System::Windows::DependencyObject

[System.Windows.Markup.ContentProperty("Storyboard")]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public class VisualState : System.Windows.DependencyObject

[<System.Windows.Markup.ContentProperty("Storyboard")>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type VisualState = class
    inherit DependencyObject

Public Class VisualState
Inherits DependencyObject

상속

Object

DispatcherObject

DependencyObject

VisualState

특성

ContentPropertyAttribute RuntimeNamePropertyAttribute

예제

다음 예제에서는 CommonStatesButtonControlTemplateVisualStateGroup 만들고 상태, Normal, Pressed및 MouseOver대한 VisualState 개체를 추가합니다. Button CommonStates VisualStateGroup있는 Disabled 상태를 정의하지만 간결성을 위해 이 상태를 생략하는 예제입니다. 전체 예제는 ControlTemplate만들어 기존 컨트롤의 모양 사용자 지정을 참조하세요.

  <!--Define the states and transitions for the common states.
      The states in the VisualStateGroup are mutually exclusive to
      each other.-->
  <VisualStateGroup x:Name="CommonStates">

    <!--The Normal state is the state the button is in
        when it is not in another state from this VisualStateGroup.-->
    <VisualState x:Name="Normal" />

    <!--Change the SolidColorBrush, BorderBrush, to red when the
        mouse is over the button.-->
    <VisualState x:Name="MouseOver">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color" 
                        To="Red" />
      </Storyboard>
    </VisualState>

    <!--Change the SolidColorBrush, BorderBrush, to Transparent when the
        button is pressed.-->
    <VisualState x:Name="Pressed">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color"
                        To="Transparent"/>
      </Storyboard>
    </VisualState>

    <!--The Disabled state is omitted for brevity.-->
  </VisualStateGroup>
</VisualStateManager.VisualStateGroups>

설명

VisualState 컨트롤이 특정 상태일 때의 모양을 지정합니다. 예를 들어 Button 누르면 테두리가 일반과 다른 색일 수 있습니다. VisualState 클래스에는 컨트롤의 모양을 변경하는 Storyboard 속성이 있습니다. 컨트롤이 VisualState.Name 속성에 지정된 상태로 들어가면 Storyboard 시작됩니다. 컨트롤이 상태를 종료하면 Storyboard 중지됩니다.

VisualStateGroup.States 속성에는 VisualState 개체가 포함됩니다. VisualStateGroup 개체는 FrameworkElement정의된 VisualStateManager.VisualStateGroups 연결된 속성에 추가됩니다. FrameworkElement VisualState 개체를 추가할 수 있지만 일반적으로 ControlControlTemplate 사용됩니다. 기존 컨트롤에 대한 ControlTemplate 및 VisualState 개체를 만드는 방법에 대한 자세한 내용은 ControlTemplate만들어 기존 컨트롤의 모양 사용자 지정을 참조하세요. ControlTemplate외부에서 VisualState 개체를 사용하는 예제는 VisualStateManager 클래스를 참조하세요.

생성자

VisualState()

VisualState 클래스의 새 인스턴스를 초기화합니다.

속성

DependencyObjectType	이 인스턴스의 CLR 형식을 래핑하는 DependencyObjectType 가져옵니다. (다음에서 상속됨 DependencyObject)
Dispatcher	이 DispatcherObject 연결된 Dispatcher 가져옵니다. (다음에서 상속됨 DispatcherObject)
IsSealed	이 인스턴스가 현재 봉인되어 있는지 여부를 나타내는 값을 가져옵니다(읽기 전용). (다음에서 상속됨 DependencyObject)
Name	VisualState이름을 가져오거나 설정합니다.
Storyboard	컨트롤이 VisualState표시되는 상태일 때 컨트롤의 모양을 정의하는 Storyboard 가져오거나 설정합니다.

메서드

CheckAccess()	호출 스레드가 이 DispatcherObject액세스할 수 있는지 여부를 확인합니다. (다음에서 상속됨 DispatcherObject)
ClearValue(DependencyProperty)	속성의 로컬 값을 지웁니다. 지울 속성은 DependencyProperty 식별자에 의해 지정됩니다. (다음에서 상속됨 DependencyObject)
ClearValue(DependencyPropertyKey)	읽기 전용 속성의 로컬 값을 지웁니다. 지울 속성은 DependencyPropertyKey지정됩니다. (다음에서 상속됨 DependencyObject)
CoerceValue(DependencyProperty)	지정된 종속성 속성의 값을 강제 변환합니다. 이 작업은 호출 DependencyObject있는 종속성 속성에 대한 속성 메타데이터에 지정된 CoerceValueCallback 함수를 호출하여 수행됩니다. (다음에서 상속됨 DependencyObject)
Equals(Object)	제공된 DependencyObject 현재 DependencyObject동일한지 여부를 확인합니다. (다음에서 상속됨 DependencyObject)
GetHashCode()	이 DependencyObject대한 해시 코드를 가져옵니다. (다음에서 상속됨 DependencyObject)
GetLocalValueEnumerator()	이 DependencyObject값을 로컬로 설정한 종속성 속성을 결정하기 위한 특수한 열거자를 만듭니다. (다음에서 상속됨 DependencyObject)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
GetValue(DependencyProperty)	이 DependencyObject인스턴스에 대한 종속성 속성의 현재 유효 값을 반환합니다. (다음에서 상속됨 DependencyObject)
InvalidateProperty(DependencyProperty)	지정된 종속성 속성의 유효 값을 다시 평가합니다. (다음에서 상속됨 DependencyObject)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	이 DependencyObject 종속성 속성의 유효 값이 업데이트될 때마다 호출됩니다. 변경된 특정 종속성 속성은 이벤트 데이터에 보고됩니다. (다음에서 상속됨 DependencyObject)
ReadLocalValue(DependencyProperty)	종속성 속성의 로컬 값(있는 경우)을 반환합니다. (다음에서 상속됨 DependencyObject)
SetCurrentValue(DependencyProperty, Object)	해당 값 원본을 변경하지 않고 종속성 속성의 값을 설정합니다. (다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)	종속성 속성 식별자에 의해 지정된 종속성 속성의 로컬 값을 설정합니다. (다음에서 상속됨 DependencyObject)
SetValue(DependencyPropertyKey, Object)	종속성 속성의 DependencyPropertyKey 식별자에 의해 지정된 읽기 전용 종속성 속성의 로컬 값을 설정합니다. (다음에서 상속됨 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	serialization 프로세스가 제공된 종속성 속성의 값을 serialize해야 하는지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 DependencyObject)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
VerifyAccess()	호출 스레드가 이 DispatcherObject액세스할 수 있도록 합니다. (다음에서 상속됨 DispatcherObject)