共用方式為

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