Kelas CSnapInPropertyPageImpl
Kelas ini menyediakan metode untuk menerapkan objek halaman properti snap-in.
Penting
Kelas ini dan anggotanya tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.
CSnapInPropertyPageImpl : public CDialogImplBase
| Nama | Deskripsi |
|---|---|
| CSnapInPropertyPageImpl::CSnapInPropertyPageImpl | Konstruktor. |
| Nama | Deskripsi |
|---|---|
| CSnapInPropertyPageImpl::CancelToClose | Mengubah status tombol OK dan Batal . |
| CSnapInPropertyPageImpl::Create | Menginisialisasi objek yang baru dibuat CSnapInPropertyPageImpl . |
| CSnapInPropertyPageImpl::OnApply | Dipanggil oleh kerangka kerja saat pengguna mengklik tombol Terapkan Sekarang saat menggunakan lembar properti jenis wizard. |
| CSnapInPropertyPageImpl::OnHelp | Dipanggil oleh kerangka kerja saat pengguna mengklik tombol Bantuan saat menggunakan lembar properti jenis wizard. |
| CSnapInPropertyPageImpl::OnKillActive | Dipanggil oleh kerangka kerja ketika halaman saat ini tidak lagi aktif. |
| CSnapInPropertyPageImpl::OnQueryCancel | Dipanggil oleh kerangka kerja ketika pengguna mengklik tombol Batalkan dan sebelum pembatalan terjadi. |
| CSnapInPropertyPageImpl::OnReset | Dipanggil oleh kerangka kerja saat pengguna mengklik tombol Reset saat menggunakan lembar properti jenis wizard. |
| CSnapInPropertyPageImpl::OnSetActive | Dipanggil oleh kerangka kerja ketika halaman saat ini menjadi aktif. |
| CSnapInPropertyPageImpl::OnWizardBack | Dipanggil oleh kerangka kerja saat pengguna mengklik tombol Kembali saat menggunakan lembar properti jenis wizard. |
| CSnapInPropertyPageImpl::OnWizardFinish | Dipanggil oleh kerangka kerja saat pengguna mengklik tombol Selesai saat menggunakan lembar properti jenis wizard. |
| CSnapInPropertyPageImpl::OnWizardNext | Dipanggil oleh kerangka kerja saat pengguna mengklik tombol Berikutnya saat menggunakan lembar properti jenis wizard. |
| CSnapInPropertyPageImpl::QuerySiblings | Meneruskan pesan saat ini ke semua halaman lembar properti. |
| CSnapInPropertyPageImpl::SetModified | Panggil untuk mengaktifkan atau menonaktifkan tombol Terapkan Sekarang . |
| Nama | Deskripsi |
|---|---|
| CSnapInPropertyPageImpl::m_psp | Struktur Windows PROPSHEETPAGE yang CSnapInPropertyPageImpl digunakan oleh objek. |
CSnapInPropertyPageImpl menyediakan implementasi dasar untuk objek halaman properti snap-in. Fitur dasar halaman properti snap-in diimplementasikan menggunakan beberapa antarmuka dan jenis peta yang berbeda.
CDialogImplBase
CSnapInPropertyPageImpl
Header: atlsnap.h
Panggil fungsi ini setelah perubahan yang tidak dapat dipulihkan dilakukan pada data di halaman lembar properti modal.
void CancelToClose();
Fungsi ini akan mengubah tombol OK menjadi Tutup dan menonaktifkan tombol Batal . Perubahan ini memperingatkan pengguna bahwa perubahan bersifat permanen dan modifikasi tidak dapat dibatalkan.
Fungsi CancelToClose anggota tidak melakukan apa pun dalam lembar properti tanpa mode, karena lembar properti tanpa mode tidak memiliki tombol Batal secara default.
Membuat CSnapInPropertyPageImpl objek.
CSnapInPropertyPageImpl(LPCTSTR lpszTitle = NULL);
lpszTitle
[di] Judul halaman properti.
Untuk menginisialisasi struktur yang mendasar, panggil CSnapInPropertyPageImpl::Create.
Panggil fungsi ini untuk menginisialisasi struktur yang mendasar dari halaman properti.
HPROPSHEETPAGE Create();
Handel ke struktur yang PROPSHEETPAGE berisi atribut lembar properti yang baru dibuat.
Anda harus terlebih dahulu memanggil CSnapInPropertyPageImpl::CSnapInPropertyPageImpl sebelum memanggil fungsi ini.
m_psp adalah struktur yang anggotanya menyimpan karakteristik PROPSHEETPAGE.
PROPSHEETPAGE m_psp;
Gunakan struktur ini untuk menginisialisasi tampilan halaman properti setelah dibangun.
Untuk informasi selengkapnya tentang struktur ini, termasuk daftar anggotanya, lihat PROPSHEETPAGE di Windows SDK.
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol OK atau Terapkan Sekarang .
BOOL OnApply();
Bukan nol jika perubahan diterima; jika tidak, 0.
Sebelum OnApply dapat dipanggil oleh kerangka kerja, Anda harus telah memanggil SetModified dan mengatur parameternya ke TRUE. Ini akan mengaktifkan tombol Terapkan Sekarang segera setelah pengguna membuat perubahan pada halaman properti.
Ambil alih fungsi anggota ini untuk menentukan tindakan apa yang diambil program Anda ketika pengguna mengklik tombol Terapkan Sekarang . Saat mengambil alih, fungsi harus mengembalikan TRUE untuk menerima perubahan dan FALSE untuk mencegah perubahan diterapkan.
Implementasi OnApply default mengembalikan TRUE.
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Bantuan untuk halaman properti.
void OnHelp();
Ambil alih fungsi anggota ini untuk menampilkan bantuan untuk halaman properti.
Fungsi anggota ini dipanggil ketika halaman tidak lagi menjadi halaman aktif.
BOOL OnKillActive();
Bukan nol jika data berhasil diperbarui; jika tidak, 0.
Ambil alih fungsi anggota ini untuk melakukan tugas validasi data khusus.
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Batal dan sebelum tindakan pembatalan terjadi.
BOOL OnQueryCancel();
Nonzero untuk mengizinkan operasi pembatalan; jika tidak, 0.
Ambil alih fungsi anggota ini untuk menentukan tindakan yang diambil program ketika pengguna mengklik tombol Batal .
Implementasi OnQueryCancel default mengembalikan TRUE.
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Batalkan .
void OnReset();
Ketika fungsi ini dipanggil, perubahan pada semua halaman properti yang dibuat oleh pengguna yang sebelumnya mengklik tombol Terapkan Sekarang dibuang, dan lembar properti mempertahankan fokus.
Ambil alih fungsi anggota ini untuk menentukan tindakan apa yang diambil program ketika pengguna mengklik tombol Batalkan .
Fungsi anggota ini dipanggil ketika halaman dipilih oleh pengguna dan menjadi halaman aktif.
BOOL OnSetActive();
Bukan nol jika halaman berhasil diatur aktif; jika tidak, 0.
Ambil alih fungsi anggota ini untuk melakukan tugas saat halaman diaktifkan. Penimpaan Anda atas fungsi anggota ini harus memanggil versi default sebelum pemrosesan lain selesai.
Implementasi default mengembalikan TRUE.
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Kembali dalam wizard.
BOOL OnWizardBack();
0 untuk secara otomatis maju ke halaman sebelumnya.
-1 untuk mencegah halaman berubah.
Untuk melompat ke halaman selain halaman berikutnya, kembalikan pengidentifikasi kotak dialog yang akan ditampilkan.
Ambil alih fungsi anggota ini untuk menentukan beberapa tindakan yang harus diambil pengguna saat tombol Kembali diklik.
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Selesai dalam wizard.
BOOL OnWizardFinish();
Bukan nol jika lembar properti dihancurkan ketika wizard selesai; jika tidak, nol.
Ambil alih fungsi anggota ini untuk menentukan beberapa tindakan yang harus diambil pengguna ketika tombol Selesai diklik.
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Berikutnya dalam wizard.
BOOL OnWizardNext();
0 untuk secara otomatis maju ke halaman berikutnya.
-1 untuk mencegah halaman berubah.
Untuk melompat ke halaman selain halaman berikutnya, kembalikan pengidentifikasi kotak dialog yang akan ditampilkan.
Ambil alih fungsi anggota ini untuk menentukan beberapa tindakan yang harus diambil pengguna saat tombol Berikutnya diklik.
Panggil fungsi anggota ini untuk meneruskan pesan ke setiap halaman di lembar properti.
LRESULT QuerySiblings(WPARAM wParam, LPARAM lParam);
wParam
[di] Menentukan informasi tambahan yang bergantung pada pesan.
lParam
[di] Menentukan informasi tambahan yang bergantung pada pesan.
Bukan nol jika pesan tidak boleh diteruskan ke halaman properti berikutnya; jika tidak, nol.
Jika halaman mengembalikan nilai bukan nol, lembar properti tidak mengirim pesan ke halaman berikutnya.
Panggil fungsi anggota ini untuk mengaktifkan atau menonaktifkan tombol Terapkan Sekarang , berdasarkan apakah pengaturan di halaman properti harus diterapkan ke objek eksternal yang sesuai.
void SetModified(BOOL bChanged = TRUE);
bChanged
[di] TRUE untuk menunjukkan bahwa pengaturan halaman properti telah dimodifikasi sejak terakhir kali diterapkan; FALSE untuk menunjukkan bahwa pengaturan halaman properti telah diterapkan, atau harus diabaikan.
Lembar properti melacak halaman mana yang "kotor," yaitu, halaman properti yang telah Anda panggil SetModified( TRUE ). Tombol Terapkan Sekarang akan selalu diaktifkan jika Anda memanggil SetModified( TRUE ) salah satu halaman. Tombol Terapkan Sekarang akan dinonaktifkan saat Anda memanggil SetModified( FALSE ) salah satu halaman, tetapi hanya jika tidak ada halaman lain yang "kotor."