Bagikan melalui


Lembar Properti

Bagian ini berisi informasi tentang elemen pemrograman yang digunakan dengan lembar properti.

Ikhtisar

Topik Isi
Tentang Lembar Properti Lembar properti adalah jendela yang memungkinkan pengguna untuk melihat dan mengedit properti item.
Membuat Wizard Wizard adalah jenis lembar properti yang menyediakan cara sederhana dan canggih untuk memandu pengguna melalui prosedur.
Menggunakan Lembar Properti Bagian ini memberikan detail implementasi dan contoh kode untuk bekerja dengan lembar properti.

Fungsi

Topik Isi
AddPropSheetPageProc Menentukan fungsi panggilan balik yang ditentukan aplikasi yang digunakan ekstensi lembar properti untuk menambahkan halaman ke lembar properti.
CreatePropertySheetPage Membuat halaman baru untuk lembar properti.
DestroyPropertySheetPage Menghancurkan halaman lembar properti. Aplikasi harus memanggil fungsi ini untuk halaman yang belum diteruskan ke fungsiPropertySheet.
PropertySheet Membuat lembar properti dan menambahkan halaman yang ditentukan dalam struktur header lembar properti yang ditentukan.
propSheetPageProc 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.
PropSheetProc Fungsi panggilan balik yang ditentukan aplikasi yang dipanggil sistem saat lembar properti sedang dibuat dan diinisialisasi.

Pesan

Topik Isi
PSM_ADDPAGE Menambahkan halaman baru ke akhir lembar properti yang sudah ada. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_AddPage.
PSM_APPLY Mensimulasikan pilihan tombol Terapkan, menunjukkan bahwa satu atau beberapa halaman telah berubah dan perubahan perlu divalidasi dan direkam.
PSM_CANCELTOCLOSE Dikirim oleh aplikasi ketika telah melakukan perubahan sejak pemberitahuan PSN_APPLY terbaru yang tidak dapat dibatalkan. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_CancelToClose.
PSM_CHANGED Menginformasikan lembar properti bahwa informasi dalam halaman telah berubah. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_Changed.
PSM_ENABLEWIZBUTTONS Mengaktifkan atau menonaktifkan salah satu tombol standar dalam wizard Aero. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_EnableWizButtons.
PSM_GETCURRENTPAGEHWND Mengambil handel ke jendela halaman lembar properti saat ini. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_GetCurrentPageHwnd.
PSM_GETRESULT Digunakan oleh lembar properti tanpa mode untuk mengambil informasi yang dikembalikan ke lembar properti modal dengan PropertySheet. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_GetResult.
PSM_GETTABCONTROL Mengambil handel ke kontrol tab lembar properti. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_GetTabControl.
PSM_HWNDTOINDEX Mengambil handel jendela halaman lembar properti dan mengembalikan indeks berbasis nolnya. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_HwndToIndex.
PSM_IDTOINDEX Mengambil ID sumber daya halaman lembar properti dan mengembalikan indeks berbasis nol. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_IdToIndex.
PSM_INDEXTOHWND Mengambil indeks halaman lembar properti dan mengembalikan handel jendelanya. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_IndexToHwnd.
PSM_INDEXTOID Mengambil indeks halaman lembar properti dan mengembalikan ID sumber dayanya. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_IndexToId.
PSM_INDEXTOPAGE Mengambil indeks halaman lembar properti dan mengembalikan handel HPROPSHEETPAGE-nya. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_IndexToPage.
PSM_INSERTPAGE Menyisipkan halaman baru ke dalam lembar properti yang sudah ada. Halaman dapat disisipkan baik pada indeks tertentu atau setelah halaman tertentu. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_InsertPage.
PSM_ISDIALOGMESSAGE Meneruskan pesan ke kotak dialog lembar properti dan menunjukkan apakah kotak dialog memproses pesan. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_IsDialogMessage.
PSM_PAGETOINDEX Mengambil handel HPROPSHEETPAGE dari halaman lembar properti dan mengembalikan indeks berbasis nol. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_PageToIndex.
PSM_PRESSBUTTON Mensimulasikan pemilihan tombol lembar properti. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_PressButton.
PSM_QUERYSIBLINGS Dikirim ke lembar properti, yang kemudian meneruskan pesan ke setiap halamannya. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_QuerySiblings.
PSM_REBOOTSYSTEM Menunjukkan sistem perlu dimulai ulang agar perubahan diterapkan. Anda dapat mengirim pesan PSM_REBOOTSYSTEM secara eksplisit atau dengan menggunakan makro PropSheet_RebootSystem.
PSM_RECALCPAGESIZES Menghitung ulang ukuran halaman lembar properti standar atau wizard setelah halaman ditambahkan atau dihapus. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_RecalcPageSizes.
PSM_REMOVEPAGE Menghapus halaman dari lembar properti. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_RemovePage.
PSM_RESTARTWINDOWS Menunjukkan bahwa Windows perlu dimulai ulang agar perubahan diterapkan.
PSM_SETBUTTONTEXT Mengatur teks pada tombol dalam wizard Aero. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_SetButtonText.
PSM_SETCURSEL Mengaktifkan halaman yang ditentukan dalam lembar properti. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_SetCurSel.
PSM_SETCURSELID Mengaktifkan halaman yang diberikan dalam lembar properti berdasarkan pengidentifikasi sumber daya halaman. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_SetCurSelByID.
PSM_SETFINISHTEXT Mengatur teks tombol Selesai dalam wizard, memperlihatkan dan mengaktifkan tombol, dan menyembunyikan tombol Berikutnya dan Kembali. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_SetFinishText.
PSM_SETHEADERBITMAP Pesan ini tidak diimplementasikan.
PSM_SETHEADERBITMAPRESOURCE Pesan ini tidak diimplementasikan.
PSM_SETHEADERSUBTITLE Mengatur teks subtitel untuk header halaman interior wizard. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_SetHeaderSubTitle.
PSM_SETHEADERTITLE Mengatur teks judul untuk header halaman interior wizard. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro PropSheet_SetHeaderTitle.
PSM_SETNEXTTEXT Mengatur teks tombol Berikutnya dalam wizard. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_SetNextText.
PSM_SETTITLE Mengatur judul lembar properti. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_SetTitle.
PSM_SETWIZBUTTONS Mengaktifkan atau menonaktifkan tombol Back, Berikutnya, , dan Selesai dalam wizard. Anda juga dapat menggunakan makro PropSheet_SetWizButtons untuk memposting pesan.
PSM_SHOWWIZBUTTONS Memperlihatkan atau menyembunyikan tombol dalam wisaya. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_ShowWizButtons.
PSM_UNCHANGED Menginformasikan lembar properti bahwa informasi dalam halaman telah dikembalikan ke status tersimpan sebelumnya. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro PropSheet_UnChanged.

Pemberitahuan

Topik Isi
PSN_APPLY Dikirim ke setiap halaman dalam lembar properti untuk menunjukkan bahwa pengguna telah mengklik tombol OK, Tutup, atau Terapkan dan ingin semua perubahan diterapkan. Pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.
PSN_GETOBJECT Dikirim oleh lembar properti untuk meminta objek target drop saat kursor melewati salah satu tombol kontrol tab.
PSN_HELP Memberi tahu halaman bahwa pengguna telah mengklik tombol Bantuan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.
PSN_KILLACTIVE Memberi tahu halaman bahwa akan kehilangan aktivasi karena halaman lain sedang diaktifkan atau pengguna telah mengklik tombol OK. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.
PSN_QUERYCANCEL Menunjukkan bahwa pengguna telah membatalkan lembar properti. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.
PSN_QUERYINITIALFOCUS Dikirim oleh lembar properti untuk memberikan halaman lembar properti kesempatan untuk menentukan kontrol kotak dialog mana yang harus menerima fokus awal. Pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.
PSN_RESET Memberi tahu halaman bahwa lembar properti akan dihancurkan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.
PSN_SETACTIVE Memberi tahu halaman bahwa halaman akan diaktifkan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.
PSN_TRANSLATEACCELERATOR Memberi tahu lembar properti bahwa pesan keyboard telah diterima. Ini memberikan halaman kesempatan untuk melakukan terjemahan akselerator keyboard privat. Pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.
PSN_WIZBACK Memberi tahu halaman bahwa pengguna telah mengklik tombol Kembali dalam wizard. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.
PSN_WIZFINISH Memberi tahu halaman bahwa pengguna telah mengklik tombol Selesai dalam wizard. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.
PSN_WIZNEXT Memberi tahu halaman bahwa pengguna telah mengklik tombol Berikutnya dalam panduan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY.

Struktur

Topik Isi
PROPSHEETHEADER Menentukan bingkai dan halaman lembar properti.
PROPSHEETPAGE Menentukan halaman dalam lembar properti.
PSHNOTIFY Berisi informasi untuk kode pemberitahuan lembar properti.