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 はデータ ストリームの先頭を指します。 それ以外の場合は、0 から始まるボタン インデックスになり、 pCurrent は現在のボタンのデータを指します。

cButtons

型: int

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

cbBytesPerRecord

型: int

各ボタンのデータを保持するために必要なバイト数。 復元が開始されると、 cbBytesPerRecord はシェル定義データ構造のサイズに設定されます。 アプリケーション定義データを保持する構造体のサイズだけインクリメントする必要があります。

tbButton

種類: TBBUTTON

現在復元中のボタンに関する情報を含む TBBUTTON 構造体。 アプリケーションは、 を返す前に、必要に応じてこの構造体を変更する必要があります。

要件

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