Struttura NMTBSAVE (commctrl.h)
Questa struttura viene passata alle applicazioni quando ricevono un codice di notifica TBN_SAVE . Contiene informazioni sul pulsante attualmente salvato. Le applicazioni possono modificare i valori dei membri per salvare informazioni aggiuntive.
typedef struct tagNMTBSAVE {
NMHDR hdr;
DWORD *pData;
DWORD *pCurrent;
UINT cbData;
int iItem;
int cButtons;
TBBUTTON tbButton;
} NMTBSAVE, *LPNMTBSAVE;
hdr
Tipo: NMHDR
Struttura NMHDR che contiene informazioni aggiuntive sulla notifica.
pData
Tipo: DWORD*
Puntatore al flusso di dati usato per archiviare le informazioni di salvataggio. Al termine, conterrà blocchi di informazioni definite dalla shell per ogni pulsante, alternando blocchi definiti dall'applicazione. Le applicazioni possono anche scegliere di inserire un blocco di dati globali all'inizio di pData. Il formato e la lunghezza dei blocchi definiti dall'applicazione sono determinati dall'applicazione. All'avvio del salvataggio, shell passerà la quantità di memoria necessaria in cbData, ma non verrà allocata alcuna memoria. È necessario allocare memoria sufficiente per pData per contenere i dati, oltre a quello della shell.
pCurrent
Tipo: DWORD*
Puntatore all'inizio della parte inutilizzata del flusso di dati. È necessario caricare i dati qui e quindi passare pCurrent all'inizio della parte rimanente inutilizzata. Shell caricherà quindi le informazioni per il pulsante successivo, farà avanzare pCurrent e così via.
cbData
Tipo: UINT
Dimensioni del flusso di dati. All'avvio del salvataggio , cbData verrà impostato sulla quantità di dati necessari per shell. È consigliabile modificarlo in base all'importo totale allocato.
iItem
Tipo: int
Questo parametro è in genere l'indice in base zero del pulsante attualmente in fase di salvataggio. È impostato su -1 per indicare che viene avviato un salvataggio.
cButtons
Tipo: int
Stima del numero di pulsanti. Poiché si basa sulle dimensioni del flusso di dati, potrebbe non essere corretto. Il client deve aggiornarlo in base alle esigenze.
tbButton
Tipo: TBBUTTON
Struttura TBBUTTON che contiene informazioni sul pulsante attualmente in fase di salvataggio.
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Intestazione | commctrl.h |