VisualState.Name Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur 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 VisualState.

Contoh

Contoh berikut membuat VisualStateGroup di ControlTemplateButton yang disebut CommonStates dan menambahkan objek VisualState untuk status, Normal, Pressed, dan MouseOver. Button juga mendefinisikan status yang disebut Disabled yang ada di CommonStatesVisualStateGroup, tetapi contoh menghilangkannya untuk brevity. Untuk seluruh contoh, lihat Menyesuaikan Tampilan Kontrol yang Ada dengan Membuat 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>

Keterangan

Anda menentukan status visual mana yang harus dimasukkan elemen dengan meneruskan NameVisualState ke VisualStateManager.

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

Untuk menemukan nama status visual untuk kontrol yang disertakan dengan WPF, lihat Gaya Kontrol dan Templat. Untuk informasi tentang cara membuat objek ControlTemplate dan VisualState untuk kontrol yang ada, lihat Menyesuaikan Tampilan Kontrol yang Ada dengan Membuat ControlTemplate.