ThumbButtonInfo Kelas

Definisi

Ruang nama:

System.Windows.Shell

Rakitan:

PresentationFramework.dll

Mewakili informasi tentang cara menampilkan tombol di gambar mini taskbar Windows 7.

public ref class ThumbButtonInfo sealed : System::Windows::Freezable, System::Windows::Input::ICommandSource

public sealed class ThumbButtonInfo : System.Windows.Freezable, System.Windows.Input.ICommandSource

type ThumbButtonInfo = class
    inherit Freezable
    interface ICommandSource

Public NotInheritable Class ThumbButtonInfo
Inherits Freezable
Implements ICommandSource

Warisan

Object

DispatcherObject

DependencyObject

Freezable

ThumbButtonInfo

Penerapan

ICommandSource

Contoh

Contoh berikut menunjukkan cara membuat ThumbButtonInfo di markup. TaskbarItemInfo berisi kumpulan ThumbButtonInfo objek yang menyediakan akses ke perintah Putar dan Hentikan dari item taskbar. Contoh ini adalah bagian dari contoh yang lebih besar yang disediakan untuk TaskbarItemInfo kelas .

<Window.TaskbarItemInfo>
    <TaskbarItemInfo x:Name="taskBarItemInfo1" 
                     Overlay="{StaticResource ResourceKey=StopImage}"
                     ThumbnailClipMargin="80,0,80,140"
                     Description="Taskbar Item Info Sample">
        <TaskbarItemInfo.ThumbButtonInfos>
            <ThumbButtonInfoCollection>
                <ThumbButtonInfo
                    DismissWhenClicked="False"
                    Command="MediaCommands.Play"
                    CommandTarget="{Binding ElementName=btnPlay}"
                    Description="Play"
                    ImageSource="{StaticResource ResourceKey=PlayImage}"/>
                <ThumbButtonInfo
                    DismissWhenClicked="True"
                    Command="MediaCommands.Stop"
                    CommandTarget="{Binding ElementName=btnStop}"
                    Description="Stop"
                    ImageSource="{StaticResource ResourceKey=StopImage}"/>
            </ThumbButtonInfoCollection>
        </TaskbarItemInfo.ThumbButtonInfos>
    </TaskbarItemInfo>
</Window.TaskbarItemInfo>

Keterangan

Taskbar Windows 7 menyediakan fungsionalitas yang ditingkatkan yang memungkinkan Anda menggunakan tombol taskbar untuk mengomunikasikan status kepada pengguna dan mengekspos tugas umum saat jendela diminimalkan atau disembunyikan. Anda dapat menambahkan tombol ke gambar mini taskbar untuk menyediakan akses ke tugas umum tanpa beralih ke jendela aplikasi. Misalnya, Pemutar Media Windows menyediakan tombol Putar, Jeda, Teruskan, dan Kembali yang dapat Anda gunakan untuk mengontrol pemutaran media dari gambar mini taskbar saat aplikasi diminimalkan.

Kelas ThumbButtonInfo berisi properti yang menjelaskan bagaimana shell Windows 7 menampilkan tombol di gambar mini taskbar. Ini menyediakan pembungkus terkelola di sekitar Windows API asli. ThumbButtonInfo objek terkandung dalam TaskbarItemInfo.ThumbButtonInfos koleksi.

Fungsionalitas bilah tugas yang ditingkatkan tidak tersedia di versi Windows yang lebih lama dari Windows 7. Di Windows 7, beberapa fungsionalitas mungkin tidak tersedia tergantung pada pengaturan pengguna. Misalnya, tombol hanya ditampilkan di gambar mini taskbar saat Windows Aero diaktifkan. Aplikasi Anda harus menyediakan cara alternatif untuk berinteraksi dengan pengguna yang tidak bergantung pada fungsionalitas taskbar yang ditingkatkan.

Ilustrasi berikut menunjukkan pratinjau taskbar dengan dua tombol jempol yang menyediakan akses ke perintah Putar dan Hentikan.

Sampel Info
Tombol Jempol Bilah Tugas Windows

Konstruktor

ThumbButtonInfo()

Menginisialisasi instans baru kelas ThumbButtonInfo.

Bidang

CommandParameterProperty	CommandParameter Mengidentifikasi properti dependensi.
CommandProperty	Command Mengidentifikasi properti dependensi.
CommandTargetProperty	CommandTarget Mengidentifikasi properti dependensi.
DescriptionProperty	Description Mengidentifikasi properti dependensi.
DismissWhenClickedProperty	DismissWhenClicked Mengidentifikasi properti dependensi.
ImageSourceProperty	ImageSource Mengidentifikasi properti dependensi.
IsBackgroundVisibleProperty	IsBackgroundVisible Mengidentifikasi properti dependensi.
IsEnabledProperty	IsEnabled Mengidentifikasi properti dependensi.
IsInteractiveProperty	IsInteractive Mengidentifikasi properti dependensi.
VisibilityProperty	Visibility Mengidentifikasi properti dependensi.

Properti

CanFreeze	Mendapatkan nilai yang menunjukkan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Freezable)
Command	Mendapatkan atau mengatur perintah yang akan dipanggil ketika tombol gambar mini ini diklik.
CommandParameter	Mendapatkan atau mengatur parameter untuk diteruskan ke Command properti .
CommandTarget	Mendapatkan atau mengatur elemen untuk menaikkan perintah yang ditentukan.
DependencyObjectType	Mendapatkan yang membungkus jenis CLR instans DependencyObjectType ini. (Diperoleh dari DependencyObject)
Description	Mendapatkan atau mengatur teks yang akan ditampilkan untuk tipsalat tombol gambar mini.
DismissWhenClicked	Mendapatkan atau mengatur nilai yang menunjukkan apakah gambar mini taskbar ditutup saat tombol gambar mini diklik.
Dispatcher	Mendapatkan ini DispatcherDispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
ImageSource	Mendapatkan atau mengatur gambar yang ditampilkan pada tombol gambar mini.
IsBackgroundVisible	Mendapatkan atau mengatur nilai yang menunjukkan apakah batas dan sorotan ditampilkan di sekitar tombol gambar mini.
IsEnabled	Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol gambar mini diaktifkan.
IsFrozen	Mendapatkan nilai yang menunjukkan apakah objek saat ini dapat dimodifikasi. (Diperoleh dari Freezable)
IsInteractive	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengguna dapat berinteraksi dengan tombol gambar mini.
IsSealed	Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject)
Visibility	Mendapatkan atau mengatur nilai yang menentukan status tampilan tombol gambar mini.

Metode

CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dibersihkan ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dibersihkan ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
Clone()	Membuat klon yang dapat dimodifikasi dari Freezable, membuat salinan mendalam dari nilai objek. Saat menyalin properti dependensi objek, metode ini menyalin ekspresi (yang mungkin tidak lagi diselesaikan) tetapi bukan animasi atau nilainya saat ini. (Diperoleh dari Freezable)
CloneCore(Freezable)	Menjadikan instans sebagai kloning (salinan mendalam) dari yang ditentukan Freezable menggunakan nilai properti dasar (non-animasi). (Diperoleh dari Freezable)
CloneCurrentValue()	Membuat kloning yang dapat dimodifikasi (salinan dalam) dari Freezable menggunakan nilainya saat ini. (Diperoleh dari Freezable)
CloneCurrentValueCore(Freezable)	Menjadikan instans sebagai kloning yang dapat dimodifikasi (salinan mendalam) dari yang ditentukan Freezable menggunakan nilai properti saat ini. (Diperoleh dari Freezable)
CoerceValue(DependencyProperty)	Memaksakan nilai properti dependensi yang ditentukan. Ini dicapai dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
CreateInstance()	Menginisialisasi instans baru kelas Freezable. (Diperoleh dari Freezable)
CreateInstanceCore()	Saat diimplementasikan di kelas turunan, membuat instans baru dari kelas turunan Freezable . (Diperoleh dari Freezable)
Equals(Object)	Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject)
Freeze()	Membuat objek saat ini tidak dapat dimodifikasi dan mengatur propertinya IsFrozen ke true. (Diperoleh dari Freezable)
FreezeCore(Boolean)	Freezable Membuat objek tidak dapat dimodifikasi atau menguji apakah dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Freezable)
GetAsFrozen()	Membuat salinan beku dari Freezable, menggunakan nilai properti dasar (non-animasi). Karena salinan dibekukan, sub-objek yang dibekukan disalin oleh referensi. (Diperoleh dari Freezable)
GetAsFrozenCore(Freezable)	Membuat instans menjadi kloning beku dari yang ditentukan Freezable menggunakan nilai properti dasar (non-animasi). (Diperoleh dari Freezable)
GetCurrentValueAsFrozen()	Membuat salinan beku dari Freezable menggunakan nilai properti saat ini. Karena salinan dibekukan, sub-objek yang dibekukan disalin oleh referensi. (Diperoleh dari Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Menjadikan instans saat ini sebagai klon beku dari klon yang ditentukan Freezable. Jika objek memiliki properti dependensi animasi, nilai animasinya saat ini akan disalin. (Diperoleh dari Freezable)
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)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject)
InvalidateProperty(DependencyProperty)	Mengevaluasi ulang nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnChanged()	Dipanggil ketika objek saat ini Freezable dimodifikasi. (Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Memastikan bahwa penunjuk konteks yang sesuai ditetapkan untuk DependencyObjectType anggota data yang baru saja ditetapkan. (Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. (Diperoleh dari Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Mengambil alih DependencyObject implementasi OnPropertyChanged(DependencyPropertyChangedEventArgs) untuk juga memanggil handler apa pun Changed sebagai respons terhadap properti dependensi yang berubah dari jenis Freezable. (Diperoleh dari Freezable)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject)
ReadPreamble()	Memastikan bahwa Freezable sedang diakses dari utas yang valid. Pewaris Freezable harus memanggil metode ini di awal API apa pun yang membaca anggota data yang bukan properti dependensi. (Diperoleh dari Freezable)
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)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
WritePostscript()	Menaikkan Changed peristiwa untuk Freezable dan memanggil metodenya OnChanged() . Kelas yang berasal dari Freezable harus memanggil metode ini di akhir API apa pun yang memodifikasi anggota kelas yang tidak disimpan sebagai properti dependensi. (Diperoleh dari Freezable)
WritePreamble()	Memverifikasi bahwa Freezable tidak dibekukan dan diakses dari konteks utas yang valid. Freezable pewaris harus memanggil metode ini di awal API apa pun yang menulis ke anggota data yang bukan properti dependensi. (Diperoleh dari Freezable)

Acara

Changed	Terjadi ketika Freezable atau objek yang dikandungnya dimodifikasi. (Diperoleh dari Freezable)
Click	Terjadi ketika tombol gambar mini diklik.

Lihat juga

• TaskbarItemInfo