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.

Sintassi

typedef struct tagNMTBSAVE {
  NMHDR    hdr;
  DWORD    *pData;
  DWORD    *pCurrent;
  UINT     cbData;
  int      iItem;
  int      cButtons;
  TBBUTTON tbButton;
} NMTBSAVE, *LPNMTBSAVE;

Members

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.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	commctrl.h