VisualStateGroup.Name 속성

정의

네임스페이스:

System.Windows

어셈블리:

PresentationFramework.dll

의 이름을 VisualStateGroup가져오거나 설정합니다.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

public string Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

속성 값

String

VisualStateGroup의 이름입니다.

예제

다음 예제에서는 이름이 지정 CommonStatesFocusStates되고 .VisualStateGroup 컨트롤은 항상 각각 VisualStateGroup 정확히 하나의 상태에 있습니다. 전체 예제는 컨트롤에 대한 템플릿을 만드는 방법을 참조하세요.

<VisualStateManager.VisualStateGroups>

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

    <!--Define the VisualTransitions that can be used when the control
        transitions between VisualStates that are defined in the
        VisualStatGroup.-->
    <VisualStateGroup.Transitions>

      <!--Take one hundredth of a second to transition to the
          Pressed state.-->
      <VisualTransition To="Pressed" 
                        GeneratedDuration="0:0:0.01" />

      <!--Take one half second to trasition to the MouseOver state.-->
      <VisualTransition To="MouseOver" 
                        GeneratedDuration="0:0:0.5" />

      <!--Take one hundredth of a second to transition from the
          Pressed state to the MouseOver state.-->
      <VisualTransition From="Pressed" To="MouseOver" 
                        GeneratedDuration="0:0:0.01" />

      <!--Take one and a half seconds to transition from the
          MouseOver state to the Normal state. 
          Have the SolidColorBrush, BorderBrush, fade to blue, 
          then to yellow, and then to black in that time.-->
      <VisualTransition From="MouseOver" To="Normal" 
                            GeneratedDuration="0:0:1.5">
        <Storyboard>
          <ColorAnimationUsingKeyFrames
            Storyboard.TargetProperty="Color"
            Storyboard.TargetName="BorderBrush"
            FillBehavior="HoldEnd" >

            <ColorAnimationUsingKeyFrames.KeyFrames>

              <LinearColorKeyFrame Value="Blue" 
                KeyTime="0:0:0.5" />
              <LinearColorKeyFrame Value="Yellow" 
                KeyTime="0:0:1" />
              <LinearColorKeyFrame Value="Black" 
                KeyTime="0:0:1.5" />

            </ColorAnimationUsingKeyFrames.KeyFrames>
          </ColorAnimationUsingKeyFrames>
        </Storyboard>
      </VisualTransition>
    </VisualStateGroup.Transitions>

    <!--The Normal state is the state the button is in
        when it is not in another state from this VisualStateGroup.
        There is no special visual behavior for this state, but
        the VisualState must be defined in order for the button
        to return to its initial state.-->
    <VisualState x:Name="Normal" />

    <!--Change the border of the button 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 border of the button to Transparent when the
        button is pressed.-->
    <VisualState x:Name="Pressed">
      <Storyboard >
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color" 
                        To="Transparent" 
                        />
      </Storyboard>
    </VisualState>

    <!--Show the DisabledRect when the IsEnabled property on
        the button is false.-->
    <VisualState x:Name="Disabled">
      <Storyboard>
        <DoubleAnimation Storyboard.TargetName="DisabledRect" 
                         Storyboard.TargetProperty="Opacity"
                         To="1" Duration="0" />
      </Storyboard>
    </VisualState>
  </VisualStateGroup>

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

    <!--Define the VisualStates in this VistualStateGroup.-->
    <VisualState x:Name="Focused">
      <Storyboard>
        <ObjectAnimationUsingKeyFrames 
          Storyboard.TargetName="FocusVisual" 
          Storyboard.TargetProperty="Visibility" Duration
          ="0">
          
          <DiscreteObjectKeyFrame KeyTime="0">
            <DiscreteObjectKeyFrame.Value>
              <Visibility>Visible</Visibility>
            </DiscreteObjectKeyFrame.Value>
          </DiscreteObjectKeyFrame>
        </ObjectAnimationUsingKeyFrames>
      </Storyboard>
    </VisualState>
    <VisualState x:Name="Unfocused">
      <Storyboard>
        <ObjectAnimationUsingKeyFrames 
          Storyboard.TargetName="FocusVisual" 
          Storyboard.TargetProperty="Visibility"
          Duration="0">
          
          <DiscreteObjectKeyFrame KeyTime="0">
            <DiscreteObjectKeyFrame.Value>
              <Visibility>Collapsed</Visibility>
            </DiscreteObjectKeyFrame.Value>
          </DiscreteObjectKeyFrame>
        </ObjectAnimationUsingKeyFrames>
      </Storyboard>
    </VisualState>
  </VisualStateGroup>
</VisualStateManager.VisualStateGroups>

설명

컨트롤 작성자는 해당 클래스 정의에 컨트롤을 추가하여 컨트롤이 있을 수 있는 TemplateVisualStateAttribute 상태를 지정합니다. 동일한 상태가 동일한 TemplateVisualStateAttribute.GroupNameVisualStateGroup상태에 속합니다. 속성을 NameVisualStateGroup 속성 값 TemplateVisualStateAttribute.GroupName 으로 설정합니다.