Struktur NMTBRESTORE (commctrl.h)

Memungkinkan aplikasi untuk mengekstrak informasi yang ditempatkan di NMTBSAVE ketika status toolbar disimpan. Struktur ini diteruskan ke aplikasi ketika mereka menerima kode pemberitahuan TBN_RESTORE .

Sintaks

typedef struct tagNMTBRESTORE {
  NMHDR    hdr;
  DWORD    *pData;
  DWORD    *pCurrent;
  UINT     cbData;
  int      iItem;
  int      cButtons;
  int      cbBytesPerRecord;
  TBBUTTON tbButton;
} NMTBRESTORE, *LPNMTBRESTORE;

Anggota

hdr

Jenis: NMHDR

Struktur NMHDR yang berisi informasi tambahan tentang pemberitahuan.

pData

Jenis: DWORD*

Arahkan ke aliran data dengan informasi penyimpanan yang disimpan. Ini berisi blok informasi yang ditentukan Shell untuk setiap tombol, bergantian dengan blok yang ditentukan aplikasi. Aplikasi juga dapat menempatkan blok data global di awal pData. Format dan panjang blok yang ditentukan aplikasi ditentukan oleh aplikasi.

pCurrent

Jenis: DWORD*

Penunjuk ke blok data yang ditentukan aplikasi saat ini. Setelah mengekstrak data, aplikasi harus maju pCurrent ke akhir blok, sehingga menunjuk ke blok berikutnya dari data yang ditentukan Shell.

cbData

Jenis: UINT

Ukuran pData.

iItem

Jenis: int

Nilai -1 menunjukkan bahwa pemulihan dimulai, dan pCurrent akan menunjuk ke awal aliran data. Jika tidak, ini adalah indeks tombol berbasis nol, dan pCurrent akan menunjuk ke data tombol saat ini.

cButtons

Jenis: int

Perkirakan jumlah tombol. Karena perkiraan didasarkan pada ukuran aliran data, itu mungkin salah. Klien harus memperbaruinya sebagaimana mestinya.

cbBytesPerRecord

Jenis: int

Jumlah byte yang diperlukan untuk menyimpan data untuk setiap tombol. Ketika pemulihan dimulai, cbBytesPerRecord akan diatur ke ukuran struktur data yang ditentukan Shell. Anda perlu menaikkannya dengan ukuran struktur yang menyimpan data yang ditentukan aplikasi.

tbButton

Jenis: TBBUTTON

Struktur TBBUTTON yang berisi informasi tentang tombol yang saat ini sedang dipulihkan. Aplikasi harus mengubah struktur ini seperlunya sebelum kembali.

Persyaratan