struktur MMC_LISTPAD_INFO (mmc.h)

Artikel
08/24/2023

Struktur MMC_LISTPAD_INFO diperkenalkan dalam MMC 1.1.

Struktur MMC_LISTPAD_INFO diisi oleh metode IExtendTaskPad::GetListPadInfo untuk menentukan informasi berikut untuk taskpad tampilan daftar:

Teks judul untuk kontrol daftar
Teks untuk tombol opsional
ID perintah diteruskan ke IExtendTaskPad::TaskNotify saat tombol tersebut diklik.

Sintaks

typedef struct _MMC_LISTPAD_INFO {
  LPOLESTR szTitle;
  LPOLESTR szButtonText;
  LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;

Anggota

szTitle

Penunjuk ke string yang dihentikan null yang berisi teks yang ditempatkan tepat di atas kontrol daftar. Teks ini bisa menjadi label untuk objek dalam kontrol daftar (seperti "Printer" jika daftar berisi printer) atau instruksi (seperti "Pilih printer dan klik tindakan yang akan dilakukan.").

Jika szTitleNULL atau kosong, tidak ada judul yang ditampilkan untuk kontrol daftar.

Ketahuilah bahwa anggota szTitle tidak sama dengan parameter pszTitle untuk IExtendTaskPad::GetTitle. Metode IExtendTaskPad::GetTitle mengembalikan judul untuk seluruh taskpad yang muncul di bagian atas taskpad dan muncul di setiap taskpad MMC standar. Anggota szTitledari MMC_LISTPAD_INFO adalah label untuk kontrol daftar dan hanya muncul di taskpad tampilan daftar MMC.

szButtonText

Penunjuk ke string yang dihentikan null yang berisi teks yang ditempatkan pada tombol yang tepat di atas kontrol daftar dan di sebelah kanan teks szTitle .

Ketika pengguna mengklik tombol ini di taskpad, MMC memanggil metode IExtendTaskPad::TaskNotify dari snap-in dan meneruskan nilai yang ditentukan dalam nCommandID sebagai struktur VARIAN dalam parameter arg. VARIAN yang diteruskan ke TaskNotify memiliki anggota vt yang diatur ke VT_I4 dan anggota lVal yang berisi ID perintah.

Untuk membuat tombol muncul tanpa teks, atur szButtonText ke string kosong.

Untuk menyembunyikan tombol ini agar muncul di taskpad, atur szButtonText ke NULL.

nCommandID

Nilai yang berfungsi sebagai pengidentifikasi untuk tombol yang ditentukan oleh szButtonText. Disarankan agar Anda membuat nilai ini unik untuk setiap taskpad untuk membantu mengidentifikasi taskpad yang mengirim pemberitahuan klik tombol.

Saat pengguna mengklik tombol ini, MMC memanggil metode IExtendTaskPad::TaskNotify dari snap-in dan meneruskan nilai ini sebagai VARIAN dalam parameter arg.

Nilai ini diabaikan jika szButtonText ADALAH NULL.

Keterangan

Alokasikan string szTitle dan szButtonText dengan fungsi COM API CoTaskMemAlloc (atau yang setara) dan MMC akan merilisnya.

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	mmc.h

Lihat juga

IExtendTaskPad::GetListPadInfo

IExtendTaskPad::TaskNotify

Bagikan melalui