VisualStateGroup 클래스

정의

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

특성

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

예제

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

<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

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

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

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

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

생성자

속성

메서드

이벤트

적용 대상

추가 정보

• DependencyObject
• VisualStateManager
• VisualState
• XAML 컨트롤 템플릿
• 스토리보드 애니메이션
• XAML 컨트롤 및 앱 스타일 샘플