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 を進める必要があります。 その後、シェルは次のボタンの情報を読み込み、 pCurrent を進めるなどを行います。

cbData

型: UINT

データ ストリームのサイズ。 保存が開始されると、 cbData はシェルで必要なデータの量に設定されます。 割り当てられた合計金額に変更する必要があります。

iItem

型: int

このパラメーターは、通常、現在保存されているボタンの 0 から始まるインデックスです。 保存が開始されていることを示すには、-1 に設定されます。

cButtons

型: int

ボタンの数の見積もり。 データ ストリームのサイズに基づいているため、正しくない可能性があります。 クライアントは、必要に応じて更新する必要があります。

tbButton

種類: TBBUTTON

現在保存されているボタンに関する情報を含む TBBUTTON 構造体。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
Header	commctrl.h