VisualState.Storyboard Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur Storyboard yang menentukan nilai properti khusus status dan tampilan kontrol saat menggunakan status visual ini.
public:
property Storyboard ^ Storyboard { Storyboard ^ get(); void set(Storyboard ^ value); };
Storyboard Storyboard();
void Storyboard(Storyboard value);
public Storyboard Storyboard { get; set; }
var storyboard = visualState.storyboard;
visualState.storyboard = storyboard;
Public Property Storyboard As Storyboard
<VisualState>
singleStoryboard
</VisualState>
Nilai Properti
Papan Cerita yang menentukan perubahan properti untuk diterapkan ke kontrol saat VisualState ini digunakan sebagai status visual saat ini.
Contoh
Contoh ini membuat ControlTemplate sederhana untuk Tombol yang berisi satu Kisi. VisualState dengan nilai atribut x:Name dari "PointerOver" memiliki Papan Cerita yang mengubah warna konten tombol (Kisi) dari hijau ke merah saat pengguna meletakkan penunjuk di atas Tombol. VisualState dengan nilai atribut x:Name "Normal" disertakan sehingga ketika pengguna memindahkan penunjuk dari tombol, latar belakang Grid kembali ke hijau.
<ControlTemplate TargetType="Button">
<Grid >
<VisualStateManager.VisualStateGroups>
<VisualStateGroup x:Name="CommonStates">
<VisualStateGroup.Transitions>
<!--Take one half second to transition to the PointerOver state.-->
<VisualTransition To="PointerOver"
GeneratedDuration="0:0:0.5"/>
</VisualStateGroup.Transitions>
<VisualState x:Name="Normal" />
<!--Change the SolidColorBrush, ButtonBrush, to red when the
Pointer is over the button.-->
<VisualState x:Name="PointerOver">
<Storyboard>
<ColorAnimation Storyboard.TargetName="ButtonBrush"
Storyboard.TargetProperty="Color" To="Red" />
</Storyboard>
</VisualState>
</VisualStateGroup>
</VisualStateManager.VisualStateGroups>
<Grid.Background>
<SolidColorBrush x:Name="ButtonBrush" Color="Green"/>
</Grid.Background>
</Grid>
</ControlTemplate>
Keterangan
Nilai properti Storyboardadalah null atau objek Storyboard tunggal. Papan Cerita seperti kontainer untuk animasi; ini dapat berisi satu atau beberapa definisi animasi. Setiap animasi tersebut dapat menargetkan properti dependensi tertentu pada target bernama tertentu. Target bernama harus berupa elemen dalam templat kontrol yang memiliki nilai atribut Nama atau x:Name yang ditentukan dalam templat itu sendiri. Properti dependensi harus berupa properti yang ada dalam model objek tersebut, atau properti terlampir. Untuk menargetkan animasi, Anda menggunakan properti terlampir Storyboard.TargetName dan Storyboard.TargetProperty . Untuk informasi selengkapnya tentang cara menentukan animasi dengan sintaks XAML, dan jenis animasi yang bisa Anda gunakan, lihat Animasi papan cerita.
Animasi yang memengaruhi tata letak berpotensi bergantung pada animasi, yang dapat memiliki konsekuensi performa bagi pengguna kontrol Anda saat kontrol memuat VisualState. Untuk informasi selengkapnya, lihat Animasi storyboard untuk status visual.