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 的 ButtonControlTemplate 中建立 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 時，控件作者應該指定控件預期在其 ControlTemplate 中找到哪些 VisualState 物件，方法是將 TemplateVisualStateAttribute 放在其類別簽章上。 ControlTemplate 作者定義新的 VisualState 物件，並將 Name 屬性設定為 TemplateVisualStateAttribute.Name 屬性所指定的值。

若要尋找 WPF 隨附之控制元件的視覺狀態名稱，請參閱 控制項樣式和範本。 如需如何為現有控件建立 和 對象的詳細資訊，請參閱建立 ControlTemplate自定義現有控件的外觀 。