MMC_LISTPAD_INFO struttura (mmc.h)
La struttura MMC_LISTPAD_INFO viene introdotta in MMC 1.1.
La struttura MMC_LISTPAD_INFO viene compilata dal metodo IExtendTaskPad::GetListPadInfo per specificare le informazioni seguenti per un blocco attività di visualizzazione elenco:
- Testo del titolo per il controllo elenco
- Testo per un pulsante facoltativo
- ID comando passato a IExtendTaskPad::TaskNotify quando viene fatto clic su tale pulsante.
Sintassi
typedef struct _MMC_LISTPAD_INFO {
LPOLESTR szTitle;
LPOLESTR szButtonText;
LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;
Members
szTitle
Puntatore a una stringa con terminazione null che contiene il testo posizionato direttamente sopra il controllo elenco. Questo testo può essere l'etichetta per gli oggetti all'interno del controllo elenco (ad esempio "Stampanti" se l'elenco contiene stampanti) o istruzioni (ad esempio "Selezionare una stampante e fare clic su un'azione da eseguire".
Se szTitle è NULL o vuoto, non viene visualizzato alcun titolo per il controllo elenco.
Tenere presente che il membro szTitle non è uguale al parametro pszTitle per IExtendTaskPad::GetTitle. Il metodo IExtendTaskPad::GetTitle restituisce il titolo per l'intero taskpad visualizzato nella parte superiore del blocco attività e viene visualizzato in ogni blocco attività MMC standard. Il membro szTitle di MMC_LISTPAD_INFO è l'etichetta per il controllo elenco e viene visualizzato solo nei blocchi attività di visualizzazione elenco MMC.
szButtonText
Puntatore a una stringa con terminazione null che contiene il testo posizionato su un pulsante che è direttamente sopra il controllo elenco e a destra del testo szTitle .
Quando l'utente fa clic su questo pulsante sul blocco attività, MMC chiama il metodo IExtendTaskPad::TaskNotify dello snap-in e passa il valore specificato in nCommandID come struttura VARIANT nel parametro arg. VARIANT passato a TaskNotify ha un membro vt impostato su VT_I4 e un membro lVal che contiene l'ID comando.
Per rendere visualizzato il pulsante senza testo, impostare szButtonText su una stringa vuota.
Per nascondere questo pulsante da visualizzare nel blocco attività, impostare szButtonText su NULL.
nCommandID
Valore che funge da identificatore per il pulsante specificato da szButtonText. È consigliabile rendere questo valore univoco per ogni blocco attività per identificare il blocco attività che ha inviato la notifica di clic sul pulsante.
Quando l'utente fa clic su questo pulsante, MMC chiama il metodo IExtendTaskPad::TaskNotify dello snap-in e passa questo valore come variant nel parametro arg.
Questo valore viene ignorato se szButtonText è NULL.
Commenti
Allocare le stringhe szTitle e szButtonText con la funzione API COM CoTaskMemAlloc (o l'equivalente) e MMC lo rilascia.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Intestazione | mmc.h |