Estrutura NMTBRESTORE (commctrl.h)

  • Artigo

Permite que os aplicativos extraam as informações que foram colocadas em NMTBSAVE quando o estado da barra de ferramentas foi salvo. Essa estrutura é passada para aplicativos quando eles recebem um código de notificação TBN_RESTORE .

Sintaxe

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

Membros

hdr

Tipo: NMHDR

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

pData

Tipo: DWORD*

Ponteiro para o fluxo de dados com as informações de salvamento armazenadas. Ele contém blocos de informações definidos pelo Shell para cada botão, alternando com blocos definidos pelo aplicativo. Os aplicativos também podem 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.

pCurrent

Tipo: DWORD*

Ponteiro para o bloco atual de dados definidos pelo aplicativo. Depois de extrair os dados, o aplicativo deve avançar pCurrent para o final do bloco, portanto, ele está apontando para o próximo bloco de dados definidos pelo Shell.

cbData

Tipo: UINT

Tamanho do pData.

iItem

Tipo: int

O valor de -1 indica que a restauração está iniciando e pCurrent apontará para o início do fluxo de dados. Caso contrário, é o índice de botão baseado em zero e pCurrent apontará para os dados do botão atual.

cButtons

Tipo: int

Estimar o número de botões. Como a estimativa é baseada no tamanho do fluxo de dados, ela pode estar incorreta. O cliente deve atualizá-lo conforme apropriado.

cbBytesPerRecord

Tipo: int

Número de bytes necessários para manter os dados de cada botão. Quando a restauração for iniciada, cbBytesPerRecord será definido como o tamanho da estrutura de dados definida pelo Shell. Você precisa incrementá-lo pelo tamanho da estrutura que contém os dados definidos pelo aplicativo.

tbButton

Tipo: TBBUTTON

Estrutura TBBUTTON que contém informações sobre o botão que está sendo restaurado no momento. Os aplicativos devem modificar essa estrutura conforme necessário antes de retornar.

Requisitos

Requisito Valor
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