Estructura NMTBSAVE (commctrl.h)

Esta estructura se pasa a las aplicaciones cuando reciben un código de notificación de TBN_SAVE . Contiene información sobre el botón que se está guardando actualmente. Las aplicaciones pueden modificar los valores de los miembros para guardar información adicional.

Sintaxis

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

Miembros

hdr

Tipo: NMHDR

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

pData

Tipo: DWORD*

Puntero al flujo de datos usado para almacenar la información de guardado. Cuando haya finalizado, contendrá bloques de información definida por Shell para cada botón, alternando con bloques definidos por la aplicación. Las aplicaciones también pueden optar por 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. Cuando se inicia el guardado, shell pasará la cantidad de memoria que necesita en cbData, pero no se asignará memoria. Debe asignar suficiente memoria para que pData contenga los datos, además de los del Shell.

pCurrent

Tipo: DWORD*

Puntero al inicio de la parte sin usar del flujo de datos. Debe cargar los datos aquí y, a continuación, avanzar pCurrent al inicio de la parte restante sin usar. A continuación, shell cargará la información del botón siguiente, avanzará pCurrent, etc.

cbData

Tipo: UINT

Tamaño del flujo de datos. Cuando se inicia el guardado, cbData se establecerá en la cantidad de datos necesarios para el Shell. Debe cambiarla a la cantidad total asignada.

iItem

Tipo: int

Este parámetro suele ser el índice de base cero del botón que se está guardando actualmente. Se establece en -1 para indicar que se está iniciando un guardado.

cButtons

Tipo: int

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

tbButton

Tipo: TBBUTTON

Estructura TBBUTTON que contiene información sobre el botón que se está guardando actualmente.

Requisitos

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