다음을 통해 공유


VisualStateGroup 클래스

정의

한 상태에서 다른 상태로 이동하는 데 사용되는 상호 배타적 VisualState 개체 및 VisualTransition 개체를 포함합니다.

public ref class VisualStateGroup sealed : DependencyObject
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="States")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class VisualStateGroup final : DependencyObject
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="States")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class VisualStateGroup : DependencyObject
Public NotInheritable Class VisualStateGroup
Inherits DependencyObject
<VisualStateManager.VisualStateGroups>
   <VisualStateGroup x:Name="groupname" ...>
     oneOrMoreVisualStates
   </VisualStateGroup>
   <!--- other peer VisualStateGroup's here ... -->
</VisualStateManager.VisualStateGroups>
상속
Object Platform::Object IInspectable DependencyObject VisualStateGroup
특성

예제

이 예제에서는 하나의 Grid를 포함하는 단추에 대한 간단한 ControlTemplate을 만듭니다. 또한 "PointerOver" 및 "Normal" 상태를 정의하는 "CommonStates"라는 를 포함합니다 VisualStateGroup . VisualStateGroup 또한 에는 사용자가 포인터를 위에 놓을 때 가 녹색에서 빨간색으로 변경되는 데 1초 Grid 가 걸리도록 지정하는 VisualTransitionButton있습니다.

<ControlTemplate TargetType="Button">
  <Grid >
    <VisualStateManager.VisualStateGroups>
      <VisualStateGroup x:Name="CommonStates">

        <VisualStateGroup.Transitions>

          <!--Take one half second to transition to the PointerOver state.-->
          <VisualTransition To="PointerOver" 
                              GeneratedDuration="0:0:0.5"/>
        </VisualStateGroup.Transitions>
        
        <VisualState x:Name="Normal" />

        <!--Change the SolidColorBrush, ButtonBrush, to red when the
            Pointer is over the button.-->
        <VisualState x:Name="PointerOver">
          <Storyboard>
            <ColorAnimation Storyboard.TargetName="ButtonBrush" 
                            Storyboard.TargetProperty="Color" To="Red" />
          </Storyboard>
        </VisualState>
      </VisualStateGroup>
    </VisualStateManager.VisualStateGroups>
    <Grid.Background>
      <SolidColorBrush x:Name="ButtonBrush" Color="Green"/>
    </Grid.Background>
  </Grid>
</ControlTemplate>

설명

컨트롤 템플릿의 일부로 XAML에서 선언된 각 VisualStateGroup 항목에는 항상 x:Name 특성 이 설정되어 있어야 합니다. 컨트롤 템플릿의 VisualStateGroups 집합에 사용되는 각 이름 문자열은 해당 템플릿에서 고유해야 합니다. 하지만 여러 컨트롤에 동일한 그룹 이름을 사용하는 것이 일반적입니다. 예를 들어 거의 모든 기존 컨트롤 템플릿에는 "CommonStates"가 포함된 가 VisualStateGroupx:Name attribute 있습니다.

VisualStateGroup 내의 시각적 상태 집합은 그룹에서 상호 배타적이어야 합니다. 즉, 컨트롤은 정의된 각 VisualStateGroup 그룹의 시각적 상태 중 하나를 항상 사용해야 합니다. 컨트롤이 두 상태에서 동시에 사용되는 경우가 있을 때마다 두 상태가 서로 다른 그룹에 있는지 확인합니다. 예를 들어 드롭다운 컨트롤에 동시에 초점을 맞추고 드롭다운을 열 수 있습니다. 올바른 시각적 상태 디자인에서는 각 상태에 대해 별도의 VisualStateGroup 가 있으므로 둘 다 한 번에 활성화할 수 있습니다. 이러한 그룹에는 "FocusStates" 및 "DropDownStates"와 같은 이름이 있을 수 있습니다.

VisualState 요소 중 하나에서 임시 스토리보드 동작을 사용하도록 설정하는 을 정의 VisualStateGroup 할 때마다 그룹에 이전 상태를 취소하기 위해 호출할 수 있는 초 VisualState 가 포함되어 있는지 확인합니다. 이는 Storyboard 없이 x:Name 특성으로 두 번째 VisualState 를 선언하는 것만큼 간단할 수 있습니다.

에 대해 VisualStateGroup 설정한 x:Name 특성 값은 VisualStateManager.GoToState 호출에 사용되지 않습니다. 대신 x:Name attribute 에 사용되는 VisualStateManager.GoToStateVisualState의 입니다. 를 사용하는 VisualStateManager.GoToState 모든 사람은 사용 가능한 모든 그룹 및 상태를 알고 있어야 하므로 각 호출이 그룹 내의 이전 상태에서 새 상태로 올바르게 전환됩니다.

VisualState 요소 집합 외에도 는 VisualStateGroup 각각 VisualTransition 그룹에 정의된 명명된 VisualState 요소 중 하나 이상과 관련된 VisualTransition 요소 집합을 정의할 수도 있습니다. XAML에서 요소 집합을 의 VisualState 직접 개체 요소 자식 요소 VisualStateGroup로 선언할 수 있습니다. 이는 시각적 상태의 컬렉션인 States 속성이 의 XAML 콘텐츠 속성 VisualStateGroup이기 때문에 가능합니다. 반면 시각적 전환 컬렉션을 설정하려면 XAML의 VisualStateGroup.Transitions 속성 요소 내에서 해당 컬렉션을 선언해야 합니다. XAML 콘텐츠 속성에 대한 자세한 내용은 XAML 구문 가이드를 참조하세요.

StateTriggers를 사용하여 시각적 상태를 제어하는 경우 트리거 엔진은 다음 우선 순위 규칙을 사용하여 트리거의 점수를 매기고 활성화할 트리거 및 해당 VisualState를 결정합니다.

  1. StateTriggerBase에서 파생되는 사용자 지정 트리거
  2. MinWindowWidth로 인해 활성화된 AdaptiveTrigger
  3. MinWindowHeight로 인해 활성화된 AdaptiveTrigger

점수 매기기에서 충돌이 있는 활성 트리거가 여러 개 있는 경우(즉, 두 개의 활성 사용자 지정 트리거) 태그 파일에 선언된 첫 번째 트리거가 우선합니다.

참고: AdaptiveTriggerStateTriggerBase에서 파생되지만 MinWindowWidth 및/또는 MinWindowHeight 설정을 통해서만 활성화할 수 있습니다.

VisualStateGroup 사용자 지정 VisualStateManager 구현을 지원하는 API

의 많은 API VisualStateGroup 는 사용자 지정 VisualStateManager 구현을 지원하기 위해만 존재합니다. 여기에는 Name, CurrentState, CurrentStateChanging, CurrentStateChanged가 포함됩니다. 컨트롤 템플릿에 대한 시각적 상태의 가장 일반적인 사용은 이러한 API가 필요하지 않습니다. 특히 이벤트를 처리하는 것은 일반적이지 않습니다. 컨트롤에 대한 대부분의 논리 작업에는 자체 속성 및 이벤트가 포함됩니다. 대부분의 앱 및 컨트롤 정의 시나리오에서 컨트롤에 발생하는 시각적 상태 변경은 컨트롤이 다른 논리에 대한 트리거가 아니라 해당 템플릿에 적용되는 논리의 최종 결과여야 합니다.

생성자

VisualStateGroup()

VisualStateGroup 클래스의 새 instance 초기화합니다.

속성

CurrentState

GoToState 메서드에 대한 성공적인 호출에서 가장 최근에 설정된 VisualState를 가져옵니다.

Dispatcher

항상 Windows App SDK 앱에서 를 반환 null 합니다. 대신 DispatcherQueue 를 사용합니다.

(다음에서 상속됨 DependencyObject)
DispatcherQueue

DispatcherQueue 이 개체가 연결된 을 가져옵니다. 는 DispatcherQueue 코드가 비 UI 스레드에 의해 시작되는 경우에도 UI 스레드에서 에 액세스할 DependencyObject 수 있는 기능을 나타냅니다.

(다음에서 상속됨 DependencyObject)
Name

VisualStateGroup의 이름을 가져옵니다.

States

상호 배타적인 VisualState 개체의 컬렉션을 가져옵니다.

Transitions

VisualTransition 개체의 컬렉션을 가져옵니다.

메서드

ClearValue(DependencyProperty)

종속성 속성의 로컬 값을 지웁니다.

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

애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 모든 기본 값을 반환합니다.

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

DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다.

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

로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

DependencyObject instance 특정 DependencyProperty의 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다.

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

DependencyObject에서 종속성 속성의 로컬 값을 설정합니다.

(다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다.

(다음에서 상속됨 DependencyObject)

이벤트

CurrentStateChanged

컨트롤이 다른 상태로 변경된 후에 발생합니다.

CurrentStateChanging

컨트롤이 다른 상태로 변경되기 시작할 때 발생합니다.

적용 대상

추가 정보