MMC_TASK struttura (mmc.h)

Articolo
02/29/2024

La struttura MMC_TASK viene introdotta in MMC 1.1.

La struttura MMC_TASK viene compilata dal metodo IEnumTASK::Next per specificare tutti i dati necessari per configurare un'attività singola in un blocco attività.

Sintassi

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;

Members

sDisplayObject

MMC_TASK_DISPLAY_OBJECT struttura che lo snap-in deve compilare per specificare l'immagine da visualizzare come immagine per l'attività nel blocco attività specificato da pszGroup.

szText

Puntatore a una stringa con terminazione null che contiene il testo posizionato direttamente a destra dell'immagine con il mouse. Questo testo funge da etichetta per l'attività. Questo testo deve essere un'azione nell'imperativo, ad esempio "Aggiungi un nuovo utente".

szHelpString

Puntatore a una stringa con terminazione null contenente il testo descrittivo inserito nell'angolo superiore destro quando l'utente sposta il mouse sull'immagine sul mouse o sul testo dell'etichetta per l'attività. Questo testo funge da descrizione per l'attività, ad esempio "Crea un nuovo account, crea una cassetta postale e configura tutto ciò che un utente deve accedere alla rete".

eActionType

Valore di tipo MMC_ACTION_TYPE che specifica il tipo di azione attivato quando un utente fa clic su un'attività in un blocco attività.

Esistono tre tipi di azioni:

MMC_ACTION_ID

Quando l'utente fa clic sull'attività, MMC chiama IExtendTaskPad::TaskNotify e restituisce l'ID comando specificato nel membro nCommandID . Se si specifica questo valore, è necessario il membro nCommandID .

MMC_ACTION_LINK

Quando l'utente fa clic sull'attività, MMC attiva il collegamento specificato da szActionURL. Se si specifica questo valore, è necessario il membro szActionURL .

MMC_ACTION_SCRIPT

Quando l'utente fa clic sull'attività, MMC esegue lo script contenuto in szScript usando il metodo window.execScript nella pagina DHTML del blocco attività. Se si specifica questo valore, è necessario il membro zScript .

nCommandID

Usato solo se eActionType è MMC_ACTION_ID.

Valore che specifica l'ID comando restituito allo snap-in quando l'utente fa clic sull'attività.

Quando MMC chiama IExtendTaskPad::TaskNotify, passa il parametro arg a una struttura VARIANT che contiene l'ID comando per l'attività che è stato fatto clic sul blocco attività. Il campo vt è VT_I4 e il campo lVal contiene l'ID comando.

szActionURL

Usato solo se eActionType è MMC_ACTION_LINK.

[out] Puntatore a una stringa con terminazione null contenente l'URL a cui collega l'attività. L'URL deve essere completo. La stringa può anche contenere uno script anziché un URL.

szScript

Usato solo se eActionType è MMC_ACTION_SCRIPT.

[out] Puntatore a una stringa con terminazione null contenente lo script da eseguire usando il metodo window.execScript nella pagina DHTML del blocco attività. Per specificare il linguaggio di script, iniziare la stringa con il linguaggio di script:

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

Se non viene specificato alcun linguaggio di script, il linguaggio predefinito è JavaScript.

Commenti

Allocare le stringhe szText, szHelpString, szActionURL e szScript usate nella struttura con la funzione API COM CoTaskMemAlloc (o l'equivalente) e MMC li rilascia.

È anche necessario allocare le stringhe nella struttura MMC_TASK_DISPLAY_BITMAP o MMC_TASK_DISPLAY_SYMBOL specificata nel membro sDisplayObject con CoTaskMemAlloc (o equivalente) e MMC li rilascia.