Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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.
Sintaks
template <class T, bool bAutoDelete = true>
class ATL_NO_VTABLE CSnapInPropertyPageImpl : public CDialogImplBase
Anggota
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
| CSnapInPropertyPageImpl::CSnapInPropertyPageImpl | Konstruktor. |
Metode Publik
| 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 . |
Anggota Data Publik
| Nama | Deskripsi |
|---|---|
| CSnapInPropertyPageImpl::m_psp | Struktur Windows PROPSHEETPAGE yang CSnapInPropertyPageImpl digunakan oleh objek. |
Keterangan
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.
Hierarki Warisan
CDialogImplBase
CSnapInPropertyPageImpl
Persyaratan
Header: atlsnap.h
CSnapInPropertyPageImpl::CancelToClose
Panggil fungsi ini setelah perubahan yang tidak dapat dipulihkan dilakukan pada data di halaman lembar properti modal.
void CancelToClose();
Keterangan
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.
CSnapInPropertyPageImpl::CSnapInPropertyPageImpl
Membuat CSnapInPropertyPageImpl objek.
CSnapInPropertyPageImpl(LPCTSTR lpszTitle = NULL);
Parameter
lpszTitle
[di] Judul halaman properti.
Keterangan
Untuk menginisialisasi struktur yang mendasar, panggil CSnapInPropertyPageImpl::Create.
CSnapInPropertyPageImpl::Create
Panggil fungsi ini untuk menginisialisasi struktur yang mendasar dari halaman properti.
HPROPSHEETPAGE Create();
Tampilkan Nilai
Handel ke struktur yang PROPSHEETPAGE berisi atribut lembar properti yang baru dibuat.
Keterangan
Anda harus terlebih dahulu memanggil CSnapInPropertyPageImpl::CSnapInPropertyPageImpl sebelum memanggil fungsi ini.
CSnapInPropertyPageImpl::m_psp
m_psp adalah struktur yang anggotanya menyimpan karakteristik PROPSHEETPAGE.
PROPSHEETPAGE m_psp;
Keterangan
Gunakan struktur ini untuk menginisialisasi tampilan halaman properti setelah dibangun.
Untuk informasi selengkapnya tentang struktur ini, termasuk daftar anggotanya, lihat PROPSHEETPAGE di Windows SDK.
CSnapInPropertyPageImpl::OnApply
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol OK atau Terapkan Sekarang .
BOOL OnApply();
Tampilkan Nilai
Bukan nol jika perubahan diterima; jika tidak, 0.
Keterangan
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.
CSnapInPropertyPageImpl::OnHelp
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Bantuan untuk halaman properti.
void OnHelp();
Keterangan
Ambil alih fungsi anggota ini untuk menampilkan bantuan untuk halaman properti.
CSnapInPropertyPageImpl::OnKillActive
Fungsi anggota ini dipanggil ketika halaman tidak lagi menjadi halaman aktif.
BOOL OnKillActive();
Tampilkan Nilai
Bukan nol jika data berhasil diperbarui; jika tidak, 0.
Keterangan
Ambil alih fungsi anggota ini untuk melakukan tugas validasi data khusus.
CSnapInPropertyPageImpl::OnQueryCancel
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Batal dan sebelum tindakan pembatalan terjadi.
BOOL OnQueryCancel();
Tampilkan Nilai
Nonzero untuk mengizinkan operasi pembatalan; jika tidak, 0.
Keterangan
Ambil alih fungsi anggota ini untuk menentukan tindakan yang diambil program ketika pengguna mengklik tombol Batal .
Implementasi OnQueryCancel default mengembalikan TRUE.
CSnapInPropertyPageImpl::OnReset
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Batalkan .
void OnReset();
Keterangan
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 .
CSnapInPropertyPageImpl::OnSetActive
Fungsi anggota ini dipanggil ketika halaman dipilih oleh pengguna dan menjadi halaman aktif.
BOOL OnSetActive();
Tampilkan Nilai
Bukan nol jika halaman berhasil diatur aktif; jika tidak, 0.
Keterangan
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.
CSnapInPropertyPageImpl::OnWizardBack
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Kembali dalam wizard.
BOOL OnWizardBack();
Tampilkan Nilai
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.
Keterangan
Ambil alih fungsi anggota ini untuk menentukan beberapa tindakan yang harus diambil pengguna saat tombol Kembali diklik.
CSnapInPropertyPageImpl::OnWizardFinish
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Selesai dalam wizard.
BOOL OnWizardFinish();
Tampilkan Nilai
Bukan nol jika lembar properti dihancurkan ketika wizard selesai; jika tidak, nol.
Keterangan
Ambil alih fungsi anggota ini untuk menentukan beberapa tindakan yang harus diambil pengguna ketika tombol Selesai diklik.
CSnapInPropertyPageImpl::OnWizardNext
Fungsi anggota ini dipanggil ketika pengguna mengklik tombol Berikutnya dalam wizard.
BOOL OnWizardNext();
Tampilkan Nilai
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.
Keterangan
Ambil alih fungsi anggota ini untuk menentukan beberapa tindakan yang harus diambil pengguna saat tombol Berikutnya diklik.
CSnapInPropertyPageImpl::QuerySiblings
Panggil fungsi anggota ini untuk meneruskan pesan ke setiap halaman di lembar properti.
LRESULT QuerySiblings(WPARAM wParam, LPARAM lParam);
Parameter
wParam
[di] Menentukan informasi tambahan yang bergantung pada pesan.
lParam
[di] Menentukan informasi tambahan yang bergantung pada pesan.
Tampilkan Nilai
Bukan nol jika pesan tidak boleh diteruskan ke halaman properti berikutnya; jika tidak, nol.
Keterangan
Jika halaman mengembalikan nilai bukan nol, lembar properti tidak mengirim pesan ke halaman berikutnya.
CSnapInPropertyPageImpl::SetModified
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);
Parameter
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.
Keterangan
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."