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的開頭放置全域資料區塊。 應用程式定義的區塊格式和長度是由應用程式決定。 儲存開始時，Shell 會傳遞 cbData中所需的記憶體數量，但不會配置任何記憶體。 您必須為 pData 配置足夠的記憶體來保存您的資料，以及 Shell 的 。

pCurrent

類型： DWORD*

資料流程未使用部分開頭的指標。 您應該在這裡載入您的資料，然後將 pCurrent 前進到其餘未使用部分的開頭。 殼層接著會載入下一個按鈕的資訊、前進 pCurrent等等。

cbData

類型： UINT

資料流程的大小。 儲存開始時， cbData 會設定為 Shell 所需的資料量。 您應該將它變更為配置的總金額。

iItem

類型： int

此參數通常是目前儲存之按鈕之以零起始的索引。 它設定為 -1，表示正在啟動儲存。

cButtons

類型： int

按鈕數目的估計值。 因為它是以資料流程的大小為基礎，所以可能不正確。 用戶端應該適當地更新它。

tbButton

類型： TBBUTTON

TBBUTTON結構，其中包含目前儲存之按鈕的相關資訊。

規格需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	commctrl.h