Estrutura NMTBSAVE (commctrl.h)

Essa estrutura é passada para aplicativos quando eles recebem um código de notificação TBN_SAVE . Ele contém informações sobre o botão que está sendo salvo no momento. Os aplicativos podem modificar os valores dos membros para salvar informações adicionais.

Sintaxe

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

Membros

hdr

Tipo: NMHDR

Uma estrutura NMHDR que contém informações adicionais sobre a notificação.

pData

Tipo: DWORD*

Um ponteiro para o fluxo de dados usado para armazenar as informações de salvamento. Quando concluído, ele conterá blocos de informações definidas pelo Shell para cada botão, alternando com blocos definidos pelo aplicativo. Os aplicativos também podem optar por colocar um bloco de dados globais no início do pData. O formato e o comprimento dos blocos definidos pelo aplicativo são determinados pelo aplicativo. Quando o salvamento for iniciado, o Shell passará a quantidade de memória necessária em cbData, mas nenhuma memória será alocada. Você deve alocar memória suficiente para o pData armazenar seus dados, além dos do Shell.

pCurrent

Tipo: DWORD*

Um ponteiro para o início da parte não utilizada do fluxo de dados. Você deve carregar seus dados aqui e, em seguida, avançar pCurrent para o início da parte não utilizada restante. Em seguida, o Shell carregará as informações para o próximo botão, avançará pCurrent e assim por diante.

cbData

Tipo: UINT

O tamanho do fluxo de dados. Quando o salvamento for iniciado, cbData será definido como a quantidade de dados necessária pelo Shell. Você deve alterá-lo para o valor total alocado.

iItem

Tipo: int

Esse parâmetro geralmente é o índice baseado em zero do botão que está sendo salvo no momento. Ele é definido como -1 para indicar que um salvamento está sendo iniciado.

cButtons

Tipo: int

Uma estimativa do número de botões. Como ele se baseia no tamanho do fluxo de dados, ele pode estar incorreto. O cliente deve atualizá-lo conforme apropriado.

tbButton

Tipo: TBBUTTON

Uma estrutura TBBUTTON que contém informações sobre o botão que está sendo salvo no momento.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	commctrl.h