struktur MMC_TASK (mmc.h)

Struktur MMC_TASK diperkenalkan dalam MMC 1.1.

Struktur MMC_TASK diisi oleh metode IEnumTASK::Next untuk menentukan semua data yang diperlukan untuk menyiapkan tugas individual pada taskpad.

Sintaks

typedef struct _MMC_TASK {
  MMC_TASK_DISPLAY_OBJECT sDisplayObject;
  LPOLESTR                szText;
  LPOLESTR                szHelpString;
  MMC_ACTION_TYPE         eActionType;
  union {
    LONG_PTR nCommandID;
    LPOLESTR szActionURL;
    LPOLESTR szScript;
  };
} MMC_TASK;

Anggota

sDisplayObject

MMC_TASK_DISPLAY_OBJECT struktur yang harus diisi snap-in untuk menentukan gambar yang akan ditampilkan sebagai gambar untuk tugas di taskpad yang ditentukan oleh pszGroup.

szText

Penunjuk ke string null-terminated yang berisi teks yang ditempatkan langsung di sebelah kanan gambar mouse-over. Teks ini berfungsi sebagai label untuk tugas. Teks ini harus menjadi tindakan dalam imperatif seperti "Tambahkan pengguna baru."

szHelpString

Penunjuk ke string yang dihentikan null yang berisi teks deskriptif yang ditempatkan di sudut kanan atas saat pengguna memindahkan mouse ke atas gambar mouse-over atau teks label untuk tugas tersebut. Teks ini berfungsi sebagai deskripsi untuk tugas seperti "Membuat akun baru, membuat kotak surat, dan menyiapkan semua yang harus diakses pengguna jaringan."

eActionType

Nilai jenis MMC_ACTION_TYPE yang menentukan jenis tindakan yang dipicu saat pengguna mengklik tugas di taskpad.

Ada tiga jenis tindakan:

MMC_ACTION_ID

Saat pengguna mengklik tugas, MMC memanggil IExtendTaskPad::TaskNotify dan mengembalikan ID perintah yang ditentukan dalam anggota nCommandID . Jika Anda menentukan nilai ini, anggota nCommandID diperlukan.

MMC_ACTION_LINK

Saat pengguna mengklik tugas, MMC mengaktifkan tautan yang ditentukan oleh szActionURL. Jika Anda menentukan nilai ini, anggota szActionURL diperlukan.

MMC_ACTION_SCRIPT

Saat pengguna mengklik tugas, MMC menjalankan skrip yang terkandung dalam szScript menggunakan metode window.execScript pada halaman DHTML taskpad. Jika Anda menentukan nilai ini, anggota zScript diperlukan.

nCommandID

Digunakan hanya jika eActionTypeMMC_ACTION_ID.

Nilai yang menentukan ID perintah yang dikembalikan ke snap-in saat pengguna mengklik tugas.

Ketika MMC memanggil IExtendTaskPad::TaskNotify, mmC meneruskan parameter arg struktur VARIAN yang berisi ID perintah untuk tugas yang diklik pada taskpad. Bidang vtVT_I4 dan bidang lVal berisi ID perintah.

szActionURL

Digunakan hanya jika eActionTypeMMC_ACTION_LINK.

[keluar] Penunjuk ke string yang dihentikan null yang berisi URL tempat tugas ditautkan. URL harus sepenuhnya memenuhi syarat. String juga dapat berisi skrip alih-alih URL.

szScript

Digunakan hanya jika eActionTypeMMC_ACTION_SCRIPT.

[keluar] Penunjuk ke string yang dihentikan null yang berisi skrip untuk dijalankan menggunakan metode window.execScript pada halaman DHTML taskpad. Untuk menentukan bahasa skrip, mulai string dengan bahasa skrip:

• "VBSCRIPT:"
• "JSCRIPT:"
• "JAVASCRIPT:"

Keterangan

Alokasikan string szText, szHelpString, szActionURL, dan szScript yang digunakan dalam struktur dengan fungsi COM API CoTaskMemAlloc (atau yang setara) dan MMC akan merilisnya.

Anda juga harus mengalokasikan string dalam struktur MMC_TASK_DISPLAY_BITMAP atau MMC_TASK_DISPLAY_SYMBOL yang ditentukan dalam anggota sDisplayObject dengan CoTaskMemAlloc (atau yang setara) dan MMC akan merilisnya.

Persyaratan

Lihat juga

IEnumTASK::Berikutnya

IExtendTaskPad::TaskNotify

MMC_ACTION_TYPE

MMC_TASK_DISPLAY_BITMAP

MMC_TASK_DISPLAY_OBJECT

MMC_TASK_DISPLAY_SYMBOL