VisualStateGroup 클래스

정의

네임스페이스:: Microsoft.UI.Xaml

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

편집

한 상태에서 다른 상태로 이동하는 데 사용되는 상호 배타적인 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

특성: ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

예제

이 예제에서는 하나의 그리드를 포함하는 단추에 대한 간단한 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 집합에 사용되는 각 이름 문자열은 해당 템플릿에서 고유해야 합니다. 하지만 여러 컨트롤에 동일한 그룹 이름을 사용하는 것이 일반적입니다. 예를 들어 거의 모든 기존 컨트롤 템플릿에는 VisualStateGroupx:Name attribute "CommonStates"가 있습니다.

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

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

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

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

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

StateTriggerBase에서 파생되는 사용자 지정 트리거
MinWindowWidth로 인해 AdaptiveTrigger가 활성화됨
MinWindowHeight로 인해 AdaptiveTrigger가 활성화됨

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

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

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

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

생성자

Name	Description
VisualStateGroup()	VisualStateGroup 클래스의 새 인스턴스를 초기화합니다.

속성

Name	Description
CurrentState	GoToState 메서드를 성공적으로 호출하여 가장 최근에 설정한 VisualState를 가져옵니다.
Dispatcher	항상 Windows 앱 SDK 앱에서 반환 `null` 합니다. 대신 DispatcherQueue 를 사용합니다. (다음에서 상속됨 DependencyObject)
DispatcherQueue	`DispatcherQueue` 이 개체가 연결된 개체를 가져옵니다. 코드 `DispatcherQueue` 가 비 UI 스레드에 의해 시작되더라도 UI 스레드에서 액세스할 `DependencyObject` 수 있는 기능을 나타냅니다. (다음에서 상속됨 DependencyObject)
Name	VisualStateGroup의 이름을 가져옵니다.
States	상호 배타적인 VisualState 개체의 컬렉션을 가져옵니다.
Transitions	VisualTransition 개체의 컬렉션을 가져옵니다.

메서드

Name	Description
ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. (다음에서 상속됨 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다. (다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)	DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다. (다음에서 상속됨 DependencyObject)
ReadLocalValue(DependencyProperty)	로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. (다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	이 DependencyObject 인스턴스에서 특정 DependencyProperty의 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. (다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject에 대한 종속성 속성의 로컬 값을 설정합니다. (다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다. (다음에서 상속됨 DependencyObject)

이벤트

Name	Description
CurrentStateChanged	컨트롤이 다른 상태로 변경된 후에 발생합니다.
CurrentStateChanging	컨트롤이 다른 상태로 변경되기 시작할 때 발생합니다.

적용 대상

추가 정보

피드백

이 페이지가 도움이 되었나요?