VisualState Kelas

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mewakili tampilan visual kontrol saat berada dalam status tertentu.

public ref class VisualState : System::Windows::DependencyObject

[System.Windows.Markup.ContentProperty("Storyboard")]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public class VisualState : System.Windows.DependencyObject

[<System.Windows.Markup.ContentProperty("Storyboard")>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type VisualState = class
    inherit DependencyObject

Public Class VisualState
Inherits DependencyObject

Warisan

Object

DispatcherObject

DependencyObject

VisualState

Atribut

ContentPropertyAttribute RuntimeNamePropertyAttribute

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

VisualState Menentukan bagaimana kontrol terlihat saat berada dalam status tertentu. Misalnya, ketika Button ditekan, batasnya mungkin warnanya berbeda dari biasanya. Kelas VisualState memiliki Storyboard properti yang mengubah tampilan kontrol. Ketika kontrol memasuki status yang ditentukan oleh VisualState.Name properti , dimulai Storyboard . Ketika kontrol keluar dari status, berhenti Storyboard .

Properti VisualStateGroup.States berisi VisualState objek. VisualStateGroup objek ditambahkan ke VisualStateManager.VisualStateGroups properti terlampir, yang didefinisikan pada pada FrameworkElement. Anda dapat menambahkan VisualState objek ke apa pun FrameworkElement, tetapi biasanya digunakan dalam ControlTemplate dari Control. Untuk informasi tentang cara membuat ControlTemplate objek dan VisualState untuk kontrol yang sudah ada, lihat Cara membuat templat untuk kontrol. Untuk contoh penggunaan VisualState objek di luar ControlTemplate, lihat VisualStateManager kelas .

Konstruktor

Nama	Deskripsi
VisualState()	Menginisialisasi instans baru dari kelas VisualState.

Properti

Nama	Deskripsi
DependencyObjectType	DependencyObjectType Mendapatkan yang membungkus jenis CLR instans ini. (Diperoleh dari DependencyObject)
Dispatcher	Dispatcher Mendapatkan ini DispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
IsSealed	Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject)
Name	Mendapatkan atau menetapkan nama VisualState.
Storyboard	Mendapatkan atau mengatur Storyboard yang mendefinisikan tampilan kontrol ketika berada dalam status yang diwakili oleh VisualState.

Metode

Nama	Deskripsi
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dihapus ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dihapus ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
CoerceValue(DependencyProperty)	Memaksa nilai properti dependensi yang ditentukan. Ini dilakukan dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
Equals(Object)	Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject)
GetHashCode()	Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject)
InvalidateProperty(DependencyProperty)	Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Dipanggil setiap kali nilai efektif dari properti dependensi apa pun pada ini DependencyObject telah diperbarui. Properti dependensi tertentu yang berubah dilaporkan dalam data peristiwa. (Diperoleh dari DependencyObject)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Mengatur nilai properti dependensi tanpa mengubah sumber nilainya. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya. (Diperoleh dari DependencyObject)
SetValue(DependencyPropertyKey, Object)	Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh DependencyPropertyKey pengidentifikasi properti dependensi. (Diperoleh dari DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus membuat serialisasi nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)