Fungsi panggilan balik LPFNPSPCALLBACKA (prsht.h)

Artikel
11/20/2024

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.

Sintaksis

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	Arti
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 dibuat atau dihancurkan. Lihat bagian Keterangan untuk diskusi lebih lanjut.

Mengembalikan nilai

Jenis: UINT

Nilai pengembalian tergantung pada nilai parameter uMsg.

Komentar

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

Catatan Lembar properti sedang dalam proses memanipulasi daftar halaman saat 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.

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	prsht.h

Bagikan melalui