Struktur PROPSHEETPAGE

Artikel
06/13/2023

Menentukan halaman dalam lembar properti.

Sintaks

typedef struct {
    DWORD      dwSize;
    DWORD      dwFlags;
    HINSTANCE  hInstance;
    union {
        LPCSTR                 pszTemplate;
        PROPSHEETPAGE_RESOURCE pResource;
    };
    union {
        HICON  hIcon;
        LPCSTR pszIcon;
    };
    LPCSTR          pszTitle;
    DLGPROC         pfnDlgProc;
    LPARAM          lParam;
    LPFNPSPCALLBACK pfnCallback;
    UINT            *pcRefParent;
    LPCTSTR         pszHeaderTitle;
    LPCTSTR         pszHeaderSubTitle;
    HANDLE          hActCtx;
    union 
    {
        HBITMAP     hbmHeader;
        LPCSTR      pszbmHeader;
    }
} PROPSHEETPAGE, *LPPROPSHEETPAGE;

Anggota

dwSize

Jenis: DWORD

Ukuran, dalam byte, dari struktur ini.

dwFlags

Jenis: DWORD

Bendera yang menunjukkan opsi mana yang akan digunakan saat membuat halaman lembar properti. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
PSP_DEFAULT	Menggunakan arti default untuk semua anggota struktur. Bendera ini tidak didukung saat menggunakan wizard gaya Aero (PSH_AEROWIZARD).
PSP_DLGINDIRECT	Membuat halaman dari templat kotak dialog dalam memori yang ditujukan oleh anggota pResource . Fungsi PropertySheet mengasumsikan bahwa templat yang ada dalam memori tidak dilindungi penulisan. Templat baca-saja akan menyebabkan pengecualian di beberapa versi Windows.
PSP_HASHELP	Mengaktifkan tombol Bantuan lembar properti saat halaman aktif. Bendera ini tidak didukung saat menggunakan wizard gaya Aero (PSH_AEROWIZARD).
PSP_HIDEHEADER	Versi 5.80 dan yang lebih baru. Menyebabkan lembar properti panduan menyembunyikan area header saat halaman dipilih. Jika marka air telah disediakan, marka air akan dicat di sisi kiri halaman. Bendera ini harus diatur untuk halaman selamat datang dan selesai, dan dihilangkan untuk halaman interior. Bendera ini tidak didukung saat menggunakan wizard gaya Aero (PSH_AEROWIZARD).
PSP_PREMATURE	Versi 4.71 atau yang lebih baru. Menyebabkan halaman dibuat saat lembar properti dibuat. Jika bendera ini tidak ditentukan, halaman tidak akan dibuat sampai dipilih pertama kali. Bendera ini tidak didukung saat menggunakan wizard gaya Aero (PSH_AEROWIZARD).
PSP_RTLREADING	Membalikkan arah tampilan pszTitle . Jendela normal menampilkan semua teks, termasuk pszTitle, kiri-ke-kanan (LTR). Untuk bahasa seperti Ibrani atau Arab yang membaca kanan-ke-kiri (RTL), jendela dapat dicerminkan dan semua teks akan ditampilkan RTL. Jika PSP_RTLREADING diatur, pszTitle akan membaca RTL di jendela induk normal, dan LTR di jendela induk yang dicerminkan.
PSP_USECALLBACK	Memanggil fungsi yang ditentukan oleh anggota pfnCallback saat membuat atau menghancurkan halaman lembar properti yang ditentukan oleh struktur ini.
PSP_USEFUSIONCONTEXT	Versi 6.0 dan yang lebih baru. Gunakan konteks aktivasi. Untuk menggunakan konteks aktivasi, Anda harus mengatur bendera ini dan menetapkan handel konteks aktivasi ke hActCtx. Lihat Komentar.
PSP_USEHEADERSUBTITLE	Versi 5.80 atau yang lebih baru. Menampilkan string yang diarahkan oleh anggota pszHeaderSubTitle sebagai subtitel area header halaman Wizard97. Untuk menggunakan bendera ini, Anda juga harus mengatur bendera PSH_WIZARD97 di anggota dwFlags dari struktur PROPSHEETHEADER terkait. Bendera PSP_USEHEADERSUBTITLE diabaikan jika PSP_HIDEHEADER diatur. Di wizard gaya Aero, judul muncul di dekat bagian atas area klien.
PSP_USEHEADERTITLE	Versi 5.80 atau yang lebih baru. Menampilkan string yang diarahkan oleh anggota pszHeaderTitle sebagai judul di header halaman interior Wizard97. Anda juga harus mengatur bendera PSH_WIZARD97 di anggota dwFlags dari struktur PROPSHEETHEADER terkait. Bendera PSP_USEHEADERTITLE diabaikan jika PSP_HIDEHEADER diatur. Bendera ini tidak didukung saat menggunakan wizard gaya Aero (PSH_AEROWIZARD).
PSP_USEHICON	Menggunakan hIcon sebagai ikon kecil pada tab untuk halaman. Bendera ini tidak didukung saat menggunakan wizard gaya Aero (PSH_AEROWIZARD).
PSP_USEICONID	Menggunakan pszIcon sebagai nama sumber daya ikon untuk memuat dan menggunakan sebagai ikon kecil pada tab untuk halaman. Bendera ini tidak didukung saat menggunakan wizard gaya Aero (PSH_AEROWIZARD).
PSP_USEREFPARENT	Mempertahankan jumlah referensi yang ditentukan oleh anggota pcRefParent selama masa pakai halaman lembar properti yang dibuat dari struktur ini.
PSP_USETITLE	Menggunakan anggota pszTitle sebagai judul kotak dialog lembar properti alih-alih judul yang disimpan dalam templat kotak dialog. Bendera ini tidak didukung saat menggunakan wizard gaya Aero (PSH_AEROWIZARD).

hInstance

Jenis: HINSTANCE

Tangani ke instans untuk memuat ikon atau sumber daya string. Jika anggota pszIcon, pszTitle, pszHeaderTitle, atau pszHeaderSubTitle mengidentifikasi sumber daya yang akan dimuat, hInstance harus ditentukan.

pszTemplate

Jenis: LPCSTR

Templat kotak dialog yang digunakan untuk membuat halaman. Anggota ini dapat menentukan pengidentifikasi sumber daya templat atau alamat string yang menentukan nama templat. Jika bendera PSP_DLGINDIRECT di anggota dwFlags diatur, pszTemplate diabaikan. Anggota ini dinyatakan sebagai serikat dengan pResource.

pResource

Jenis: LPCDLGTEMPLATE

Penunjuk ke templat kotak dialog dalam memori. Fungsi PropertySheet mengasumsikan bahwa templat tidak dilindungi terhadap penulisan. Templat baca-saja akan menyebabkan pengecualian di beberapa versi Windows. Untuk menggunakan anggota ini, Anda harus mengatur bendera PSP_DLGINDIRECT di anggota dwFlags . Anggota ini dinyatakan sebagai serikat dengan pszTemplate.

hIcon

Jenis: HICON

Tangani ke ikon untuk digunakan sebagai ikon di tab halaman. Jika anggota dwFlags tidak menyertakan PSP_USEHICON, anggota ini diabaikan. Anggota ini dinyatakan sebagai serikat dengan pszIcon.

pszIcon

Jenis: LPCSTR

Sumber daya ikon untuk digunakan sebagai ikon di tab halaman. Anggota ini dapat menentukan pengidentifikasi sumber daya ikon atau alamat string yang menentukan nama sumber daya ikon. Untuk menggunakan anggota ini, Anda harus mengatur bendera PSP_USEICONID di anggota dwFlags . Anggota ini dinyatakan sebagai serikat dengan hIcon.

pszTitle

Jenis: LPCSTR

Judul kotak dialog lembar properti. Judul ini mengambil alih judul yang ditentukan dalam templat kotak dialog. Anggota ini dapat menentukan pengidentifikasi sumber daya string atau alamat string yang menentukan judul. Untuk menggunakan anggota ini, Anda harus mengatur bendera PSP_USETITLE di anggota dwFlags .

pfnDlgProc

Jenis: DLGPROC

Arahkan ke prosedur kotak dialog untuk halaman tersebut. Karena halaman dibuat sebagai kotak dialog tanpa mode, prosedur kotak dialog tidak boleh memanggil fungsi EndDialog .

lParam

Jenis: LPARAM

Saat halaman dibuat, salinan struktur PROPSHEETPAGE halaman diteruskan ke prosedur kotak dialog dengan pesan WM_INITDIALOG . Anggota lParam disediakan untuk memungkinkan Anda meneruskan informasi khusus aplikasi ke prosedur kotak dialog. Ini tidak berpengaruh pada halaman itu sendiri.

pfnCallback

Jenis: LPFNPSPCALLBACK

Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi yang dipanggil ketika halaman dibuat dan kapan akan dihancurkan. Untuk informasi selengkapnya tentang fungsi panggilan balik, lihat fungsi panggilan balik LPFNPSPCALLBACKA. Untuk menggunakan anggota ini, Anda harus mengatur bendera PSP_USECALLBACK di anggota dwFlags .

pcRefParent

Jenis: UINT*

Penunjuk ke nilai jumlah referensi. Untuk menggunakan anggota ini, Anda harus mengatur bendera PSP_USEREFPARENT di anggota dwFlags .

Catatan

Saat halaman lembar properti dibuat, nilai yang ditunjukkan oleh pcRefParent akan bertambah. Anda membuat halaman lembar properti secara implisit dengan mengatur bendera PSH_PROPSHEETPAGE di anggota dwFlagsPROPSHEETHEADER dan memanggil fungsi PropertySheet . Anda dapat melakukannya secara eksplisit dengan menggunakan fungsi CreatePropertySheetPage . Saat halaman lembar properti dihancurkan, nilai yang ditunjukkan oleh anggota pcRefParent akan dikurangi. Ini terjadi secara otomatis ketika lembar properti dihancurkan. Anda dapat secara eksplisit menghancurkan halaman lembar properti dengan menggunakan fungsi DestroyPropertySheetPage .

pszHeaderTitle

Jenis: LPCTSTR

Versi 5.80 atau yang lebih baru. Judul area header. Untuk menggunakan anggota ini di bawah panduan gaya Wizard97, Anda juga harus melakukan hal berikut:

Atur bendera PSP_USEHEADERTITLE di anggota dwFlags .
Atur bendera PSH_WIZARD97 di anggota dwFlags dari struktur PROPSHEETHEADER halaman.
Pastikan bahwa bendera PSP_HIDEHEADER di anggota dwFlags tidak ditetapkan.

pszHeaderSubTitle

Jenis: LPCTSTR

Versi 5.80 atau yang lebih baru. Subtitel area header. Untuk menggunakan anggota ini, Anda harus melakukan hal berikut:

Atur bendera PSP_USEHEADERSUBTITLE di anggota dwFlags .
Atur bendera PSH_WIZARD97 di anggota dwFlags dari struktur PROPSHEETHEADER halaman.
Pastikan bahwa bendera PSP_HIDEHEADER di anggota dwFlags tidak ditetapkan.

Catatan

Anggota ini diabaikan saat menggunakan wizard gaya Aero (PSH_AEROWIZARD)

hActCtx

Jenis: HANDEL

Versi 6.0 atau yang lebih baru. Handel konteks aktivasi. Atur anggota ini ke handel yang dikembalikan saat Anda membuat konteks aktivasi dengan CreateActCtx. Sistem akan mengaktifkan konteks ini sebelum membuat kotak dialog. Anda tidak perlu menggunakan anggota ini jika Anda menggunakan manifes global.

hbmHeader

Jenis: HBITMAP

Anggota ini dinyatakan sebagai persatuan dengan pszbmHeader.

pszbmHeader

Jenis: LPCSTR

Anggota ini dinyatakan sebagai persatuan dengan hbmHeader.

Keterangan

Comctl32.dll versi 6 dan yang lebih baru tidak dapat didistribusikan ulang. Untuk menggunakan Comctl32.dll versi 6 atau yang lebih baru, tentukan file .dll dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Prsht.h
Nama Unicode dan ANSI	PROPSHEETHEADERW (Unicode) dan PROPSHEETHEADERA (ANSI)

Bagikan melalui

Struktur PROPSHEETPAGE

Sintaks

Anggota

Keterangan

Persyaratan

Saran dan Komentar

Sumber Daya Tambahan: