Fungsi panggilan balik LPFNPSPCALLBACKA (prsht.h)

Artikel
03/15/2023

Menentukan fungsi panggilan balik yang ditentukan aplikasi yang dipanggil lembar properti saat halaman dibuat dan kapan akan dihancurkan. Aplikasi dapat menggunakan fungsi ini untuk melakukan operasi inisialisasi dan pembersihan untuk halaman.

Sintaks

LPFNPSPCALLBACKA Lpfnpspcallbacka;

UINT Lpfnpspcallbacka(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEA *ppsp
)
{...}

Parameter

hwnd

Jenis: HWND

Dipesan; harus NULL.

[in] uMsg

Jenis: UINT

Bendera tindakan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
PSPCB_ADDREF	Versi 5.80 atau yang lebih baru. Halaman sedang dibuat. Nilai yang dikembalikan tidak digunakan.
PSPCB_CREATE	Kotak dialog untuk halaman sedang dibuat. Kembalikan bukan nol untuk memungkinkannya dibuat, atau nol untuk mencegahnya.
PSPCB_RELEASE	Halaman sedang dihancurkan. Nilai yang dikembalikan diabaikan.

[in, out] ppsp

Jenis: LPPROPSHEETPAGE

Penunjuk ke struktur PROPSHEETPAGE yang menentukan halaman yang sedang dibuat atau dihancurkan. Lihat bagian Keterangan untuk diskusi lebih lanjut.

Mengembalikan nilai

Jenis: UINT

Nilai yang dikembalikan tergantung pada nilai parameter uMsg .

Keterangan

Aplikasi harus menentukan alamat fungsi panggilan balik ini di anggota pfnCallback dari struktur PROPSHEETPAGE sebelum meneruskan struktur ke fungsi CreatePropertySheetPage .

Catatan Lembar properti sedang dalam proses memanipulasi daftar halaman ketika fungsi ini dipanggil. Jangan coba menambah, menghapus, atau menyisipkan halaman saat menangani pemberitahuan ini. Melakukannya akan memiliki hasil yang tidak dapat diprediksi.

Dengan pengecualian anggota lParam , aplikasi Anda tidak boleh memodifikasi struktur PROPSHEETPAGE . Melakukannya akan memiliki hasil yang tidak dapat diprediksi. Anggota lParam berisi data yang ditentukan aplikasi dan dapat dimodifikasi sesuai kebutuhan.

Catatan

Header prsht.h mendefinisikan LPFNPSPCALLBACK sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Share via