struktur PROPSHEETHEADERA_V2 (prsht.h)

Menentukan bingkai dan halaman lembar properti.

Catatan

Struktur ini tidak dimaksudkan untuk digunakan langsung dalam kode Anda. Sebagai gantinya, gunakan struktur PROPSHEETHEADER .

Sintaks

typedef struct _PROPSHEETHEADERA_V2 {
  union {
    HBITMAP hbmWatermark;
    LPCSTR  pszbmWatermark;
  } DUMMYUNIONNAME4;
  HPALETTE hplWatermark;
  union {
    HBITMAP hbmHeader;
    LPCSTR  pszbmHeader;
  } DUMMYUNIONNAME5;
} PROPSHEETHEADERA_V2, *LPPROPSHEETHEADERA_V2;

Anggota

DUMMYUNIONNAME4

DUMMYUNIONNAME4.hbmWatermark

Jenis: HBITMAP

Versi 5.80 atau yang lebih baru. Tangani ke bitmap marka air. Jika anggota dwFlags tidak menyertakan PSH_USEHBMWATERMARK, anggota ini diabaikan.

DUMMYUNIONNAME4.pszbmWatermark

Jenis: LPCTSTR

Versi 5.80 atau yang lebih baru. Sumber daya bitmap untuk digunakan sebagai marka air. Anggota ini dapat menentukan pengidentifikasi sumber daya bitmap atau alamat string yang menentukan nama sumber daya bitmap. Jika anggota dwFlags menyertakan PSH_USEHBMWATERMARK, anggota ini diabaikan.

hplWatermark

Jenis: HPALETTE

Versi 5.80 atau yang lebih baru. Struktur HPALETTE yang digunakan untuk menggambar bitmap marka air dan/atau bitmap header. Jika anggota dwFlags tidak menyertakan PSH_USEHPLWATERMARK, anggota ini diabaikan.

DUMMYUNIONNAME5

DUMMYUNIONNAME5.hbmHeader

Jenis: HBITMAP

Versi 5.80 atau yang lebih baru. Tangani ke bitmap header. Jika anggota dwFlags tidak menyertakan PSH_USEHBMHEADER, anggota ini diabaikan.

DUMMYUNIONNAME5.pszbmHeader

Jenis: LPCSTR

Versi 5.80 atau yang lebih baru. Sumber daya bitmap untuk digunakan sebagai header. Anggota ini dapat menentukan pengidentifikasi sumber daya bitmap atau alamat string yang menentukan nama sumber daya bitmap. Jika anggota dwFlags menyertakan PSH_USEHBMHEADER, anggota ini diabaikan.

Keterangan

Jika pengguna memilih pengaturan seperti Font Besar, yang memperbesar kotak dialog, marka air yang dicat pada halaman mulai dan selesai juga akan diperbesar. Ukuran dan posisi bitmap asli akan tetap sama. Area tambahan akan diisi dengan warna piksel di sudut kiri atas bitmap.

Perhatikan bahwa beberapa anggota struktur ini hanya didukung untuk Comctl32.dll versi 4.71 dan yang lebih baru. Anda dapat mengaktifkan anggota ini dengan menyertakan salah satu hal berikut ini di header Anda.

#define _WIN32_IE 0x0400 // For version 4.71

atau

#define _WIN32_IE 0x0500 // For version 5.80

Namun, Anda harus menginisialisasi struktur dengan ukurannya. Jika Anda menggunakan ukuran struktur yang saat ini ditentukan, aplikasi mungkin tidak berjalan dengan versi Comctl32.dll sebelumnya, yang mengharapkan struktur yang lebih kecil. Ini termasuk semua sistem dengan Windows 95 atau Microsoft Windows NT 4.0 yang tidak menginstal Internet Explorer 4.0 atau yang lebih baru. Anda dapat menjalankan aplikasi pada versi Comctl32.dll pra-4.71 dengan menentukan nomor versi yang sesuai. Namun, ini dapat menyebabkan masalah jika aplikasi Anda juga perlu berjalan pada sistem dengan versi yang lebih baru.

Anda dapat tetap kompatibel dengan semua versi Comctl32.dll dengan menggunakan file header saat ini dan mengatur ukuran struktur PROPSHEETHEADER dengan tepat. Sebelum Anda menginisialisasi struktur, gunakan fungsi DllGetVersion untuk menentukan versi Comctl32.dll mana yang diinstal pada sistem. Jika versinya 4.71 atau lebih tinggi, gunakan

psh.dwSize = sizeof(PROPSHEETHEADER);

untuk menginisialisasi anggota dwSize . Untuk versi sebelumnya, ukuran struktur pra-4,71 diberikan oleh konstanta PROPSHEETHEADER_V1_SIZE. Penggunaan

psh.dwSize = PROPSHEETHEADER_V1_SIZE;

Gaya PSH_WIZARD, PSH_WIZARD97, dan PSH_WIZARD_LITE saling tidak kompatibel. Hanya salah satu bendera gaya ini yang harus diatur. PSH_AEROWIZARD harus dikombinasikan dengan PSH_WIZARD.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	prsht.h