Структура NMTBRESTORE (commctrl.h)

Позволяет приложениям извлекать сведения, которые были помещены в NMTBSAVE при сохранении состояния панели инструментов. Эта структура передается приложениям при получении TBN_RESTORE кода уведомления.

Синтаксис

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

Члены

hdr

Тип: NMHDR

Структура NMHDR, содержащая дополнительные сведения об уведомлении.

pData

Тип: DWORD*

Указатель на поток данных с сохраненными сведениями о сохранении. Он содержит определенные оболочкой блоки сведений для каждой кнопки, чередующиеся с блоками, определенными приложением. Приложения также могут размещать блок глобальных данных в начале pData. Формат и длина блоков, определяемых приложением, определяются приложением.

pCurrent

Тип: DWORD*

Указатель на текущий блок данных, определяемых приложением. После извлечения данных приложение должно перейти pCurrent в конец блока, чтобы оно указывало на следующий блок данных, определенных оболочкой.

cbData

Тип: UINT

Размер pData.

iItem

Тип: int

Значение -1 указывает, что восстановление начинается, а pCurrent указывает на начало потока данных. В противном случае это отсчитываемый от нуля индекс кнопки, и pCurrent будет указывать на данные текущей кнопки.

cButtons

Тип: int

Оценка количества кнопок. Так как оценка основана на размере потока данных, она может быть неправильной. Клиент должен обновить его соответствующим образом.

cbBytesPerRecord

Тип: int

Количество байтов, необходимых для хранения данных для каждой кнопки. Когда начнется восстановление, cbBytesPerRecord будет иметь размер структуры данных, определенной оболочкой. Необходимо увеличить его на размер структуры, содержащей данные, определяемые приложением.

tbButton

Тип: TBBUTTON

Структура TBBUTTON, содержащая сведения о текущей восстанавливаемой кнопке. Приложения должны изменить эту структуру при необходимости перед возвратом.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	commctrl.h