Struktur PROPSHEETPAGE
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) |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk