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

  • Статья

Эта структура передается приложениям при получении кода уведомления TBN_SAVE . Он содержит сведения о кнопке, сохраненной в данный момент. Приложения могут изменять значения членов для сохранения дополнительных сведений.

Синтаксис

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

Члены

hdr

Тип: NMHDR

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

pData

Тип: DWORD*

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

pCurrent

Тип: DWORD*

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

cbData

Тип: UINT

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

iItem

Тип: int

Этот параметр обычно является отсчитываемый от нуля индекс кнопки, сохраняемой в данный момент. Он имеет значение -1, чтобы указать, что начинается сохранение.

cButtons

Тип: int

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

tbButton

Тип: TBBUTTON

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

Требования

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