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

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

Properti VisualStateGroup.States berisi objek VisualState. VisualStateGroup objek ditambahkan ke properti terlampir VisualStateManager.VisualStateGroups, yang didefinisikan pada FrameworkElement. Anda dapat menambahkan objek VisualState ke FrameworkElementapa pun, tetapi biasanya digunakan dalam ControlTemplateControl. Untuk informasi tentang cara membuat objek ControlTemplate dan VisualState untuk kontrol yang ada, lihat Menyesuaikan Tampilan Kontrol yang Ada dengan Membuat ControlTemplate. Untuk contoh penggunaan objek VisualState di luar ControlTemplate, lihat kelas VisualStateManager.

Konstruktor

VisualState()

Menginisialisasi instans baru kelas VisualState.

Properti

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

Metode

CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke DispatcherObjectini. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dihapus ditentukan oleh pengidentifikasi DependencyProperty. (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 dicapai dengan memanggil fungsi CoerceValueCallback apa pun yang ditentukan dalam metadata properti untuk properti dependensi karena ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
Equals(Object)	Menentukan apakah DependencyObject yang disediakan setara dengan DependencyObjectsaat ini. (Diperoleh dari DependencyObject)
GetHashCode()	Mendapatkan kode hash untuk DependencyObjectini. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada DependencyObjectini. (Diperoleh dari DependencyObject)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans DependencyObjectini. (Diperoleh dari DependencyObject)
InvalidateProperty(DependencyProperty)	Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Dipanggil setiap kali nilai efektif dari properti dependensi apa pun pada DependencyObject ini 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 pengidentifikasi DependencyPropertyKey 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)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke DispatcherObjectini . (Diperoleh dari DispatcherObject)