VisualState.Name VisualState.Name VisualState.Name VisualState.Name Property

定義

VisualState の名前を取得または設定します。Gets or sets the name of the VisualState.

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

プロパティ値

VisualState の名前。The name of the VisualState.

次の例では、作成、VisualStateGroupで、ControlTemplateButtonと呼ばれるCommonStatesし、追加VisualStateオブジェクト、州、 NormalPressedMouseOverThe following example creates a VisualStateGroup in the ControlTemplate of a Button called CommonStates and adds VisualState objects for the states, Normal, Pressed, and MouseOver. Buttonもと呼ばれる状態を定義Disabled内にある、 CommonStatesVisualStateGroup例は簡潔にするため省略します。The Button also defines a state called Disabled that is in the CommonStatesVisualStateGroup, but the example omits it for brevity. 全体の例では、次を参照してください。 ControlTemplate の作成による既存のコントロールの外観のカスタマイズします。For the entire example, see Customizing the Appearance of an Existing Control by Creating a 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>

注釈

要素を表示する状態を渡すことで入力する必要がありますを指定する、NameVisualStateVisualStateManagerします。You specify which visual state an element should enter by passing the Name of the VisualState to the VisualStateManager.

ときに、Controlを使用して、VisualStateManagerで、 ControlTemplate、コントロールの作成者を指定する必要がありますVisualStateオブジェクト内で検索するコントロールが必要です、ControlTemplate配置することで、TemplateVisualStateAttributeそのクラスのシグネチャでします。When a Control uses the VisualStateManager in a ControlTemplate, the control author should specify which VisualState objects the control expects to find in its ControlTemplate by putting the TemplateVisualStateAttribute on its class signature. ControlTemplate 作成者は新しい定義VisualStateオブジェクトと設定、Nameプロパティによって指定された値をTemplateVisualStateAttribute.Nameプロパティ。ControlTemplate authors define new VisualState objects and set the Name property to the value specified by the TemplateVisualStateAttribute.Name property.

含まれているコントロールの視覚的な状態の名前を検索するWPFWPFを参照してくださいコントロールのスタイルとテンプレートします。To find the names of the visual states for the controls that are included with WPFWPF, see Control Styles and Templates. 作成する方法については、ControlTemplateVisualState既存のコントロール オブジェクトを参照してくださいControlTemplate の作成による既存のコントロールの外観のカスタマイズします。For information about how to create a ControlTemplate and VisualState objects for existing controls, see Customizing the Appearance of an Existing Control by Creating a ControlTemplate.

適用対象