Struktur NMTBSAVE (commctrl.h)

Struktur ini diteruskan ke aplikasi ketika mereka menerima kode pemberitahuan TBN_SAVE . Ini berisi informasi tentang tombol yang saat ini sedang disimpan. Aplikasi dapat mengubah nilai anggota untuk menyimpan informasi tambahan.

Sintaks

typedef struct tagNMTBSAVE {
  NMHDR    hdr;
  DWORD    *pData;
  DWORD    *pCurrent;
  UINT     cbData;
  int      iItem;
  int      cButtons;
  TBBUTTON tbButton;
} NMTBSAVE, *LPNMTBSAVE;

Anggota

hdr

Jenis: NMHDR

Struktur NMHDR yang berisi informasi tambahan tentang pemberitahuan.

pData

Jenis: DWORD*

Penunjuk ke aliran data yang digunakan untuk menyimpan informasi penyimpanan. Setelah selesai, ini akan berisi blok informasi yang ditentukan Shell untuk setiap tombol, bergantian dengan blok yang ditentukan oleh aplikasi. Aplikasi juga dapat memilih untuk menempatkan blok data global di awal pData. Format dan panjang blok yang ditentukan aplikasi ditentukan oleh aplikasi. Ketika penyimpanan dimulai, Shell akan melewati jumlah memori yang dibutuhkan dalam cbData, tetapi tidak ada memori yang akan dialokasikan. Anda harus mengalokasikan memori yang cukup agar pData menyimpan data Anda, ditambah Shell.

pCurrent

Jenis: DWORD*

Penunjuk ke awal bagian aliran data yang tidak digunakan. Anda harus memuat data Anda di sini, lalu melanjutkan pCurrent ke awal bagian yang tidak digunakan yang tersisa. Shell kemudian akan memuat informasi untuk tombol berikutnya, maju pCurrent, dan sebagainya.

cbData

Jenis: UINT

Ukuran aliran data. Ketika penyimpanan dimulai, cbData akan diatur ke jumlah data yang diperlukan oleh Shell. Anda harus mengubahnya menjadi jumlah total yang dialokasikan.

iItem

Jenis: int

Parameter ini biasanya merupakan indeks berbasis nol dari tombol yang saat ini sedang disimpan. Ini diatur ke -1 untuk menunjukkan bahwa penyimpanan dimulai.

cButtons

Jenis: int

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

tbButton

Jenis: TBBUTTON

Struktur TBBUTTON yang berisi informasi tentang tombol yang saat ini sedang disimpan.

Persyaratan