VisualState.Name プロパティ

定義

名前空間:

System.Windows

アセンブリ:

PresentationFramework.dll

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

プロパティ値

String

VisualStateの名前。

例

次の例では、CommonStates と呼ばれる Button の ControlTemplate に VisualStateGroup を作成し、状態、Normal、Pressed、および MouseOverの VisualState オブジェクトを追加します。 Button では、CommonStatesVisualStateGroup内にある Disabled と呼ばれる状態も定義されますが、簡潔にするために省略されています。 例全体については、「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>

注釈

VisualState の Name を VisualStateManagerに渡すことで、要素が入力するビジュアル状態を指定します。

Control が ControlTemplateの VisualStateManager を使用する場合、コントロール作成者は、TemplateVisualStateAttribute をクラス シグネチャに配置して、コントロールが ControlTemplate で見つけるオブジェクト VisualState を指定する必要があります。 作成者 ControlTemplate 新しい VisualState オブジェクトを定義し、Name プロパティを TemplateVisualStateAttribute.Name プロパティで指定された値に設定します。

WPF に含まれているコントロールの表示状態の名前については、「コントロールのスタイルとテンプレートのを参照してください。 既存のコントロールの ControlTemplate オブジェクトと VisualState オブジェクトを作成する方法については、「ControlTemplateを作成して既存のコントロールの外観をカスタマイズする」を参照してください。