Bagikan melalui

Antarmuka ITaskbarList3 (shobjidl_core.h)

  • Artikel

Memperluas ITaskbarList2 dengan mengekspos metode yang mendukung fungsionalitas tombol peluncuran terpadu dan beralih taskbar yang ditambahkan di Windows 7. Fungsionalitas ini mencakup representasi gambar mini dan beralih target berdasarkan tab individual dalam aplikasi bertab, toolbar gambar mini, overlay pemberitahuan dan status, dan indikator kemajuan.

Warisan

Antarmuka ITaskbarList3 mewarisi dari ITaskbarList2. ITaskbarList3 juga memiliki jenis anggota ini:

Metode

Antarmuka ITaskbarList3 memiliki metode ini.

 
ITaskbarList3::RegisterTab

Menginformasikan taskbar bahwa tab baru atau gambar mini dokumen telah disediakan untuk ditampilkan dalam flyout grup taskbar aplikasi.
ITaskbarList3::SetOverlayIcon

Menerapkan overlay ke tombol taskbar untuk menunjukkan status aplikasi atau pemberitahuan kepada pengguna.
ITaskbarList3::SetProgressState

Menyetel tipe dan status indikator kemajuan yang ditampilkan pada tombol bilah tugas.
ITaskbarList3::SetProgressValue

Menampilkan atau memperbarui bilah kemajuan yang dihosting di tombol taskbar untuk memperlihatkan persentase tertentu yang diselesaikan dari operasi penuh.
ITaskbarList3::SetTabActive

Menginformasikan bilah tugas bahwa tab atau jendela dokumen telah dibuat jendela aktif.
ITaskbarList3::SetTabOrder

Menyisipkan gambar mini baru ke dalam flyout grup antarmuka dokumen bertab atau antarmuka beberapa dokumen (MDI) atau memindahkan gambar mini yang ada ke posisi baru dalam grup aplikasi.
ITaskbarList3::SetThumbnailClip

Memilih sebagian area klien jendela untuk ditampilkan sebagai gambar mini jendela tersebut di taskbar.
ITaskbarList3::SetThumbnailTooltip

Menentukan atau memperbarui teks tipsalat yang ditampilkan saat penunjuk mouse berada pada gambar mini pratinjau individual dalam flyout tombol taskbar.
ITaskbarList3::ThumbBarAddButtons

Menambahkan toolbar gambar mini dengan sekumpulan tombol tertentu ke gambar mini jendela di flyout tombol taskbar.
ITaskbarList3::ThumbBarSetImageList

Menentukan daftar gambar yang berisi gambar tombol untuk toolbar yang disematkan dalam gambar mini jendela di flyout tombol taskbar.
ITaskbarList3::ThumbBarUpdateButtons

Menampilkan, mengaktifkan, menonaktifkan, atau menyembunyikan tombol dalam bilah alat gambar mini seperti yang diperlukan oleh status jendela saat ini. Toolbar gambar mini adalah toolbar yang disematkan dalam gambar mini jendela di flyout tombol taskbar.
ITaskbarList3::UnregisterTab

Menghapus gambar mini dari grup pratinjau aplikasi saat tab atau dokumen tersebut ditutup dalam aplikasi.

Keterangan

Antarmuka ini juga menyediakan metode antarmuka ITaskbarList dan ITaskbarList2 , dari mana ia mewarisi.

Kapan harus Menerapkan

Implementasi antarmuka ini disediakan di Windows sebagai CLSID_TaskbarList. Antarmuka ini tidak diimplementasikan oleh pihak ketiga.

Kapan Harus Digunakan

Gunakan metode antarmuka ini untuk melakukan hal berikut:
  • Saat bekerja dengan aplikasi TDI (seperti Windows Internet Explorer) atau aplikasi MDI (seperti Microsoft Excel) yang menampilkan jendelanya sebagai grup pada taskbar:
    • Sediakan taskbar dengan gambar mini yang mewakili tampilan tab atau dokumen individual.
    • Hapus gambar mini tab atau dokumen individual dari grup.
    • Ubah urutan gambar mini dalam grup.
    • Atur gambar mini tab sebagai item yang dipilih saat gambar mini diperlihatkan.
  • Saat menerapkan overlay ke ikon taskbar, seperti pemberitahuan.
  • Saat menampilkan kemajuan operasi, seperti menyalin atau menginstal item.
  • Saat menambahkan bilah alat ke gambar mini.
Ketika aplikasi menampilkan jendela, tombol taskbar-nya dibuat oleh sistem. Ketika tombol di tempat, taskbar mengirimkan pesan TaskbarButtonCreated ke jendela. Aplikasi Anda harus memanggil RegisterWindowMessage(L"TaskbarButtonCreated") dan menangani pesan tersebut di wndproc-nya. Pesan tersebut harus diterima oleh aplikasi Anda sebelum memanggil metode ITaskbarList3 apa pun.
Catatan Aplikasi tidak dapat menyematkan diri secara terprogram ke taskbar. Fungsionalitas tersebut dicadangkan secara ketat untuk pengguna.
 

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header shobjidl_core.h (termasuk Shobjidl.h)

Lihat juga

ITaskbarList2

Ekstensi Taskbar