Struttura NMTBRESTORE (commctrl.h)

Consente alle applicazioni di estrarre le informazioni inserite in NMTBSAVE quando è stato salvato lo stato della barra degli strumenti. Questa struttura viene passata alle applicazioni quando ricevono un codice di notifica TBN_RESTORE .

Sintassi

typedef struct tagNMTBRESTORE {
  NMHDR    hdr;
  DWORD    *pData;
  DWORD    *pCurrent;
  UINT     cbData;
  int      iItem;
  int      cButtons;
  int      cbBytesPerRecord;
  TBBUTTON tbButton;
} NMTBRESTORE, *LPNMTBRESTORE;

Members

hdr

Tipo: NMHDR

Struttura NMHDR che contiene informazioni aggiuntive sulla notifica.

pData

Tipo: DWORD*

Puntatore al flusso di dati con le informazioni di salvataggio archiviate. Contiene blocchi di informazioni definiti dalla shell per ogni pulsante, alternati a blocchi definiti dall'applicazione. Le applicazioni possono anche inserire un blocco di dati globali all'inizio di pData. Il formato e la lunghezza dei blocchi definiti dall'applicazione sono determinati dall'applicazione.

pCurrent

Tipo: DWORD*

Puntatore al blocco corrente di dati definiti dall'applicazione. Dopo l'estrazione dei dati, l'applicazione deve avanzare pCurrent alla fine del blocco, quindi punta al blocco successivo di dati definiti da Shell.

cbData

Tipo: UINT

Dimensioni di pData.

iItem

Tipo: int

Il valore -1 indica che il ripristino è in fase di avvio e pCurrent punterà all'inizio del flusso di dati. In caso contrario, si tratta dell'indice del pulsante in base zero e pCurrent punterà ai dati del pulsante corrente.

cButtons

Tipo: int

Stima del numero di pulsanti. Poiché la stima è basata sulle dimensioni del flusso di dati, potrebbe non essere corretta. Il client deve aggiornarlo in base alle esigenze.

cbBytesPerRecord

Tipo: int

Numero di byte necessari per contenere i dati per ogni pulsante. All'avvio del ripristino, cbBytesPerRecord verrà impostato sulle dimensioni della struttura dei dati definita dalla shell. È necessario incrementarlo in base alle dimensioni della struttura che contiene i dati definiti dall'applicazione.

tbButton

Tipo: TBBUTTON

Struttura TBBUTTON che contiene informazioni sul pulsante in fase di ripristino. Le applicazioni devono modificare questa struttura in base alle esigenze prima della restituzione.

Requisiti

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