Estructura NMTBRESTORE (commctrl.h)

Permite a las aplicaciones extraer la información que se colocó en NMTBSAVE cuando se guardó el estado de la barra de herramientas. Esta estructura se pasa a las aplicaciones cuando reciben un código de notificación de TBN_RESTORE .

Sintaxis

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

Miembros

hdr

Tipo: NMHDR

Estructura NMHDR que contiene información adicional sobre la notificación.

pData

Tipo: DWORD*

Puntero al flujo de datos con la información de guardado almacenada. Contiene bloques de información definidos por shell para cada botón, alternando con bloques definidos por la aplicación. Las aplicaciones también pueden colocar un bloque de datos globales al principio de pData. La aplicación determina el formato y la longitud de los bloques definidos por la aplicación.

pCurrent

Tipo: DWORD*

Puntero al bloque actual de datos definidos por la aplicación. Después de extraer los datos, la aplicación debe avanzar pCurrent al final del bloque, por lo que apunta al siguiente bloque de datos definidos por Shell.

cbData

Tipo: UINT

Tamaño de pData.

iItem

Tipo: int

El valor de -1 indica que se está iniciando la restauración y pCurrent apuntará al inicio del flujo de datos. De lo contrario, es el índice de botón de base cero y pCurrent apuntará a los datos del botón actual.

cButtons

Tipo: int

Estimación del número de botones. Dado que la estimación se basa en el tamaño del flujo de datos, podría ser incorrecto. El cliente debe actualizarlo según corresponda.

cbBytesPerRecord

Tipo: int

Número de bytes necesarios para contener los datos de cada botón. Cuando se inicie la restauración, cbBytesPerRecord se establecerá en el tamaño de la estructura de datos definida por Shell. Debe incrementarlo por el tamaño de la estructura que contiene los datos definidos por la aplicación.

tbButton

Tipo: TBBUTTON

Estructura TBBUTTON que contiene información sobre el botón que se está restaurando actualmente. Las aplicaciones deben modificar esta estructura según sea necesario antes de devolverla.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	commctrl.h