Menggunakan Lembar Properti di Aplikasi Anda

Untuk menggunakan lembar properti di aplikasi Anda, selesaikan langkah-langkah berikut:

1. Buat sumber daya templat dialog untuk setiap halaman properti. Perlu diingat bahwa pengguna mungkin beralih dari satu halaman ke halaman lain, jadi letakkan setiap halaman sesering mungkin.

   Templat dialog untuk semua halaman tidak harus berukuran sama. Kerangka kerja menggunakan ukuran halaman terbesar untuk menentukan berapa banyak ruang yang akan dialokasikan dalam lembar properti untuk halaman properti.

   Saat Membuat sumber daya templat dialog untuk halaman properti, Anda harus menentukan gaya berikut ini di lembar properti Properti Dialog:

   • Atur kotak Edit keterangan pada halaman Umum ke teks yang ingin Anda munculkan di tab untuk halaman ini.

   • Atur kotak Daftar gaya pada halaman Gaya ke Anak.

   • Atur kotak Daftar batas pada halaman Gaya menjadi Tipis.

   • Pastikan kotak centang Bilah Judul pada halaman Gaya dipilih.

   • Pastikan bahwa kotak centang Dinonaktifkan pada halaman Gaya Lainnya dipilih.

2. Buat kelas turunan CPropertyPage yang sesuai dengan setiap templat dialog halaman properti. Lihat Menambahkan Kelas. Pilih CPropertyPage sebagai kelas dasar.

3. Buat variabel anggota untuk menyimpan nilai untuk halaman properti ini. Proses untuk menambahkan variabel anggota ke halaman properti sama persis dengan menambahkan variabel anggota ke kotak dialog, karena halaman properti adalah kotak dialog khusus. Untuk informasi selengkapnya, lihat Menentukan Variabel Anggota untuk Kontrol Dialog.

4. Buat objek CPropertySheet dalam kode sumber Anda. Biasanya, Anda membuat CPropertySheet objek di handler untuk perintah yang menampilkan lembar properti. Objek ini mewakili seluruh lembar properti. Jika Anda membuat lembar properti modal dengan fungsi DoModal , kerangka kerja menyediakan tiga tombol perintah secara default: OK, Batal, dan Terapkan. Kerangka kerja tidak membuat tombol perintah untuk lembar properti tanpa mode yang dibuat dengan fungsi Buat . Anda tidak perlu memperoleh kelas kecuali CPropertySheet Anda ingin menambahkan kontrol lain (seperti jendela pratinjau) atau menampilkan lembar properti tanpa mode. Langkah ini diperlukan untuk lembar properti tanpa mode karena tidak berisi kontrol default apa pun yang dapat digunakan untuk menutup lembar properti.

5. Agar setiap halaman ditambahkan ke lembar properti, lakukan hal berikut:

   • Buat satu objek untuk setiap CPropertyPagekelas turunan yang Anda buat sebelumnya dalam proses ini.

   • Panggil CPropertySheet::AddPage untuk setiap halaman.

   Biasanya, objek yang membuat CPropertySheet juga membuat CPropertyPage objek dalam langkah ini. Namun, jika Anda menerapkan CPropertySheetkelas -turunan, Anda dapat menyematkan CPropertyPage objek di CPropertySheet objek dan memanggil AddPage setiap halaman dari CPropertySheetkonstruktor kelas turunan. AddPageCPropertyPage menambahkan objek ke daftar halaman lembar properti tetapi tidak benar-benar membuat jendela untuk halaman tersebut. Oleh karena itu, tidak perlu menunggu hingga pembuatan jendela lembar properti untuk dipanggil AddPage; Anda dapat memanggil AddPage dari konstruktor lembar properti.

   Secara default, jika lembar properti memiliki lebih banyak tab daripada yang akan pas dalam satu baris lembar properti, tab akan ditumpuk dalam beberapa baris. Untuk menonaktifkan penumpukan, panggil CPropertySheet::EnableStackedTabs dengan parameter yang diatur ke FALSE. Anda harus memanggil EnableStackedTabs saat membuat lembar properti.

6. Panggil CPropertySheet::D oModal atau Buat untuk menampilkan lembar properti. Panggil DoModal untuk membuat lembar properti sebagai kotak dialog modal. Panggil Buat untuk membuat lembar properti sebagai kotak dialog tanpa mode.

7. Bertukar data antara halaman properti dan pemilik lembar properti. Ini dijelaskan dalam artikel Bertukar Data.

Untuk contoh cara menggunakan lembar properti, lihat SAMPEL Umum MFC PROPDLG.

Baca juga

Lembar Properti