VisualState.Name Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau menetapkan nama 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

Nilai Properti

String

Nama dari VisualState.

Contoh

Contoh berikut membuat VisualStateGroup di dari objek yang Button dipanggil CommonStates dan menambahkan VisualState objek untuk status, , NormalPressed, dan MouseOverControlTemplate . juga Button mendefinisikan status yang disebut Disabled yang ada di CommonStatesVisualStateGroup, tetapi contoh menghilangkannya untuk brevity. Untuk seluruh contoh, lihat Cara membuat templat untuk kontrol.

  <!--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>

Keterangan

Anda menentukan status visual mana yang harus dimasukkan elemen dengan meneruskan Name ke VisualStateVisualStateManager.

Control Ketika menggunakan VisualStateManager dalam ControlTemplate, pembuat kontrol harus menentukan objek mana yang VisualState diharapkan untuk ditemukan kontrol dengan ControlTemplate menempatkan TemplateVisualStateAttribute pada tanda tangan kelasnya. ControlTemplate penulis menentukan objek baru VisualState dan mengatur Name properti ke nilai yang ditentukan oleh TemplateVisualStateAttribute.Name properti .

Untuk menemukan nama status visual untuk kontrol yang disertakan dengan WPF, lihat Gaya Kontrol dan Templat. Untuk informasi tentang cara membuat ControlTemplate objek dan VisualState untuk kontrol yang sudah ada, lihat Cara membuat templat untuk kontrol.