Kelas CDialog
Kelas dasar yang digunakan untuk menampilkan kotak dialog di layar.
Sintaks
class CDialog : public CWnd
Anggota
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
| CDialog::CDialog | Membuat CDialog objek. |
Metode Publik
| Nama | Deskripsi |
|---|---|
| CDialog::Create | Menginisialisasi objek CDialog. Membuat kotak dialog tanpa mode dan melampirkannya ke CDialog objek. |
| CDialog::CreateIndirect | Membuat kotak dialog tanpa mode dari templat kotak dialog dalam memori (bukan berbasis sumber daya). |
| CDialog::D oModal | Memanggil kotak dialog modal dan kembali setelah selesai. |
| CDialog::EndDialog | Menutup kotak dialog modal. |
| CDialog::GetDefID | Mendapatkan ID kontrol tombol dorong default untuk kotak dialog. |
| CDialog::GotoDlgCtrl | Memindahkan fokus ke kontrol kotak dialog tertentu dalam kotak dialog. |
| CDialog::InitModalIndirect | Membuat kotak dialog modal dari templat kotak dialog dalam memori (bukan berbasis sumber daya). Parameter disimpan sampai fungsi DoModal dipanggil. |
| CDialog::MapDialogRect | Mengonversi unit kotak dialog persegi menjadi unit layar. |
| CDialog::NextDlgCtrl | Memindahkan fokus ke kontrol kotak dialog berikutnya dalam kotak dialog. |
| CDialog::OnInitDialog | Ganti ke inisialisasi kotak dialog augment. |
| CDialog::OnSetFont | Ambil alih untuk menentukan font yang digunakan kontrol kotak dialog saat menggambar teks. |
| CDialog::P revDlgCtrl | Memindahkan fokus ke kontrol kotak dialog sebelumnya dalam kotak dialog. |
| CDialog::SetDefID | Mengubah kontrol tombol dorong default untuk kotak dialog ke tombol dorong tertentu. |
| CDialog::SetHelpID | Mengatur ID bantuan peka konteks untuk kotak dialog. |
Metode yang Dilindungi
| Nama | Deskripsi |
|---|---|
| CDialog::OnCancel | Ambil alih untuk melakukan tombol Batalkan atau tindakan kunci ESC. Default menutup kotak dialog dan DoModal mengembalikan IDCANCEL. |
| CDialog::OnOK | Ambil alih untuk melakukan tindakan tombol OK dalam kotak dialog modal. Default menutup kotak dialog dan DoModal mengembalikan IDOK. |
Keterangan
Kotak dialog terdiri dari dua jenis: modal dan modeless. Kotak dialog modal harus ditutup oleh pengguna sebelum aplikasi berlanjut. Kotak dialog tanpa mode memungkinkan pengguna menampilkan kotak dialog dan kembali ke tugas lain tanpa membatalkan atau menghapus kotak dialog.
Objek CDialog adalah kombinasi templat dialog dan CDialogkelas -turunan. Gunakan editor dialog untuk membuat templat dialog dan menyimpannya dalam sumber daya, lalu gunakan wizard Tambahkan Kelas untuk membuat kelas yang berasal dari CDialog.
Kotak dialog, seperti jendela lainnya, menerima pesan dari Windows. Dalam kotak dialog, Anda sangat tertarik untuk menangani pesan pemberitahuan dari kontrol kotak dialog karena itulah cara pengguna berinteraksi dengan kotak dialog Anda. Gunakan Panduan Kelas untuk memilih pesan mana yang ingin Anda tangani dan akan menambahkan entri peta pesan dan fungsi anggota penanganan pesan yang sesuai ke kelas untuk Anda. Anda hanya perlu menulis kode khusus aplikasi dalam fungsi anggota handler.
Jika mau, Anda selalu dapat menulis entri peta pesan dan fungsi anggota secara manual.
Dalam semua kotak dialog kecuali yang paling sepele, Anda menambahkan variabel anggota ke kelas dialog turunan Anda untuk menyimpan data yang dimasukkan dalam kontrol kotak dialog oleh pengguna atau untuk menampilkan data untuk pengguna. Anda bisa menggunakan wizard Tambahkan Variabel untuk membuat variabel anggota dan mengaitkannya dengan kontrol. Pada saat yang sama, Anda memilih jenis variabel dan rentang nilai yang diizinkan untuk setiap variabel. Wizard kode menambahkan variabel anggota ke kelas dialog turunan Anda.
Peta data dihasilkan untuk menangani pertukaran data secara otomatis antara variabel anggota dan kontrol kotak dialog. Peta data menyediakan fungsi yang menginisialisasi kontrol dalam kotak dialog dengan nilai yang tepat, mengambil data, dan memvalidasi data.
Untuk membuat kotak dialog modal, buat objek pada tumpukan menggunakan konstruktor untuk kelas dialog turunan Anda lalu panggil DoModal untuk membuat jendela dialog dan kontrolnya. Jika Anda ingin membuat dialog tanpa mode, panggil Create konstruktor kelas dialog Anda.
Anda juga dapat membuat templat dalam memori dengan menggunakan struktur data DLGTEMPLATE seperti yang dijelaskan di Windows SDK. Setelah Anda membuat CDialog objek, panggil CreateIndirect untuk membuat kotak dialog tanpa mode, atau panggil InitModalIndirect dan DoModal untuk membuat kotak dialog modal.
Peta data pertukaran dan validasi ditulis dalam penimpaan CWnd::DoDataExchange yang ditambahkan ke kelas dialog baru Anda. Lihat fungsi anggota DoDataExchange untuk CWnd informasi selengkapnya tentang fungsionalitas pertukaran dan validasi.
Baik programmer maupun kerangka kerja memanggil DoDataExchange secara tidak langsung melalui panggilan ke CWnd::UpdateData.
Kerangka kerja memanggil UpdateData saat pengguna mengklik tombol OK untuk menutup kotak dialog modal. (Data tidak diambil jika tombol Batal diklik.) Implementasi default OnInitDialog juga memanggil UpdateData untuk mengatur nilai awal kontrol. Anda biasanya mengambil alih OnInitDialog untuk menginisialisasi kontrol lebih lanjut. OnInitDialog dipanggil setelah semua kontrol dialog dibuat dan tepat sebelum kotak dialog ditampilkan.
Anda dapat memanggil CWnd::UpdateData kapan saja selama eksekusi kotak dialog modal atau tanpa mode.
Jika Anda mengembangkan kotak dialog dengan tangan, Anda menambahkan variabel anggota yang diperlukan ke kelas kotak dialog turunan sendiri, dan Anda menambahkan fungsi anggota untuk mengatur atau mendapatkan nilai-nilai ini.
Kotak dialog modal ditutup secara otomatis saat pengguna menekan tombol OK atau Batal atau saat kode Anda memanggil EndDialog fungsi anggota.
Saat Anda menerapkan kotak dialog tanpa mode, selalu ambil alih OnCancel fungsi anggota dan panggil DestroyWindow dari dalamnya. Jangan panggil kelas CDialog::OnCanceldasar , karena memanggil EndDialog, yang akan membuat kotak dialog tidak terlihat tetapi tidak akan menghancurkannya. Anda juga harus mengambil PostNcDestroy alih kotak dialog tanpa mode untuk menghapus this, karena kotak dialog tanpa mode biasanya dialokasikan dengan new. Kotak dialog modal biasanya dibangun pada bingkai dan tidak perlu PostNcDestroy dibersihkan.
Untuk informasi selengkapnya tentang CDialog, lihat Kotak Dialog.
Hierarki Warisan
CDialog
Persyaratan
Header: afxwin.h
CDialog::CDialog
Untuk membuat kotak dialog modal berbasis sumber daya, panggil salah satu bentuk publik konstruktor.
explicit CDialog(
LPCTSTR lpszTemplateName,
CWnd* pParentWnd = NULL);
explicit CDialog(
UINT nIDTemplate,
CWnd* pParentWnd = NULL);
CDialog();
Parameter
lpszTemplateName
Berisi string null-terminated yang merupakan nama sumber daya templat kotak dialog.
nIDTemplate
Berisi nomor ID sumber daya templat kotak dialog.
pParentWnd
Arahkan ke objek jendela induk atau pemilik (jenis CWnd) tempat objek dialog berada. Jika NULL, jendela induk objek dialog diatur ke jendela aplikasi utama.
Keterangan
Salah satu bentuk konstruktor menyediakan akses ke sumber daya dialog berdasarkan nama templat. Konstruktor lain menyediakan akses berdasarkan nomor ID templat, biasanya dengan awalan IDD_ (misalnya, IDD_DIALOG1).
Untuk membuat kotak dialog modal dari templat dalam memori, pertama-tama panggil konstruktor tanpa parameter dan dilindungi lalu panggil InitModalIndirect.
Setelah Anda membuat kotak dialog modal dengan salah satu metode di atas, panggil DoModal.
Untuk membuat kotak dialog tanpa mode, gunakan bentuk konstruktor yang CDialog dilindungi. Konstruktor dilindungi karena Anda harus memperoleh kelas kotak dialog Anda sendiri untuk mengimplementasikan kotak dialog tanpa mode. Konstruksi kotak dialog tanpa mode adalah proses dua langkah. Pertama panggil konstruktor; lalu panggil Create fungsi anggota untuk membuat kotak dialog berbasis sumber daya, atau panggil CreateIndirect untuk membuat kotak dialog dari templat dalam memori.
CDialog::Create
Panggil Create untuk membuat kotak dialog tanpa mode menggunakan templat kotak dialog dari sumber daya.
virtual BOOL Create(
LPCTSTR lpszTemplateName,
CWnd* pParentWnd = NULL);
virtual BOOL Create(
UINT nIDTemplate,
CWnd* pParentWnd = NULL);
Parameter
lpszTemplateName
Berisi string null-terminated yang merupakan nama sumber daya templat kotak dialog.
pParentWnd
Arahkan ke objek jendela induk (tipe CWnd) tempat objek dialog berada. Jika NULL, jendela induk objek dialog diatur ke jendela aplikasi utama.
nIDTemplate
Berisi nomor ID sumber daya templat kotak dialog.
Tampilkan Nilai
Kedua formulir mengembalikan bukan nol jika pembuatan kotak dialog dan inisialisasi berhasil; jika tidak, 0.
Keterangan
Anda dapat melakukan panggilan ke Create dalam konstruktor atau memanggilnya setelah konstruktor dipanggil.
Dua bentuk Create fungsi anggota disediakan untuk akses ke sumber daya templat kotak dialog dengan nama templat atau nomor ID templat (misalnya, IDD_DIALOG1).
Untuk salah satu formulir, teruskan penunjuk ke objek jendela induk. Jika pParentWnd ADALAH NULL, kotak dialog akan dibuat dengan jendela induk atau pemiliknya diatur ke jendela aplikasi utama.
Fungsi Create anggota kembali segera setelah membuat kotak dialog.
Gunakan gaya WS_VISIBLE dalam templat kotak dialog jika kotak dialog akan muncul saat jendela induk dibuat. Jika tidak, Anda harus memanggil ShowWindow. Untuk gaya kotak dialog lebih lanjut dan aplikasinya, lihat struktur DLGTEMPLATE di Windows SDK dan Window Styles di Referensi MFC.
CWnd::DestroyWindow Gunakan fungsi untuk menghancurkan kotak dialog yang dibuat oleh Create fungsi.
Contoh
void CMyDialog::OnMenuShowSimpleDialog()
{
//m_pSimpleDialog initialized to NULL in the constructor of CMyDialog class
m_pSimpleDlg = new CSimpleDlg();
//Check if new succeeded and we got a valid pointer to a dialog object
if (m_pSimpleDlg != NULL)
{
BOOL ret = m_pSimpleDlg->Create(IDD_SIMPLEDIALOG, this);
if (!ret) //Create failed.
{
AfxMessageBox(_T("Error creating Dialog"));
}
m_pSimpleDlg->ShowWindow(SW_SHOW);
}
else
{
AfxMessageBox(_T("Error Creating Dialog Object"));
}
}
CDialog::CreateIndirect
Panggil fungsi anggota ini untuk membuat kotak dialog tanpa mode dari templat kotak dialog dalam memori.
virtual BOOL CreateIndirect(
LPCDLGTEMPLATE lpDialogTemplate,
CWnd* pParentWnd = NULL,
void* lpDialogInit = NULL);
virtual BOOL CreateIndirect(
HGLOBAL hDialogTemplate,
CWnd* pParentWnd = NULL);
Parameter
lpDialogTemplate
Menunjuk ke memori yang berisi templat kotak dialog yang digunakan untuk membuat kotak dialog. Templat ini dalam bentuk struktur dan informasi kontrol DLGTEMPLATE , seperti yang dijelaskan dalam Windows SDK.
pParentWnd
Menunjuk ke objek jendela induk objek dialog (tipe CWnd). Jika NULL, jendela induk objek dialog diatur ke jendela aplikasi utama.
lpDialogInit
Menunjuk ke sumber daya DLGINIT.
hDialogTemplate
Berisi handel ke memori global yang berisi templat kotak dialog. Templat ini dalam bentuk DLGTEMPLATE struktur dan data untuk setiap kontrol dalam kotak dialog.
Tampilkan Nilai
Bukan nol jika kotak dialog dibuat dan berhasil diinisialisasi; jika tidak, 0.
Keterangan
Fungsi CreateIndirect anggota kembali segera setelah membuat kotak dialog.
Gunakan gaya WS_VISIBLE dalam templat kotak dialog jika kotak dialog akan muncul saat jendela induk dibuat. Jika tidak, Anda harus memanggil ShowWindow untuk menyebabkannya muncul. Untuk informasi selengkapnya tentang bagaimana Anda dapat menentukan gaya kotak dialog lainnya dalam templat, lihat struktur DLGTEMPLATE di Windows SDK.
CWnd::DestroyWindow Gunakan fungsi untuk menghancurkan kotak dialog yang dibuat oleh CreateIndirect fungsi.
Kotak dialog yang berisi kontrol ActiveX memerlukan informasi tambahan yang disediakan dalam sumber daya DLGINIT.
CDialog::D oModal
Panggil fungsi anggota ini untuk memanggil kotak dialog modal dan mengembalikan hasil kotak dialog setelah selesai.
virtual INT_PTR DoModal();
Tampilkan Nilai
Nilai int yang menentukan nilai parameter nResult yang diteruskan ke fungsi anggota CDialog::EndDialog , yang digunakan untuk menutup kotak dialog. Nilai pengembalian adalah -1 jika fungsi tidak dapat membuat kotak dialog, atau IDABORT jika beberapa kesalahan lain terjadi, dalam hal ini jendela output akan berisi informasi kesalahan dari GetLastError.
Keterangan
Fungsi anggota ini menangani semua interaksi dengan pengguna saat kotak dialog aktif. Inilah yang membuat kotak dialog modal; artinya, pengguna tidak dapat berinteraksi dengan jendela lain hingga kotak dialog ditutup.
Jika pengguna mengklik salah satu tombol push dalam kotak dialog, seperti OK atau Batal, fungsi anggota penanganan pesan, seperti OnOK atau OnCancel, dipanggil untuk mencoba menutup kotak dialog. Fungsi anggota default OnOK akan memvalidasi dan memperbarui data kotak dialog dan menutup kotak dialog dengan IDOK hasil, dan fungsi anggota default OnCancel akan menutup kotak dialog dengan IDCANCEL hasil tanpa memvalidasi atau memperbarui data kotak dialog. Anda dapat mengambil alih fungsi penanganan pesan ini untuk mengubah perilakunya.
Catatan
PreTranslateMessage sekarang dipanggil untuk pemrosesan pesan kotak dialog modal.
Contoh
void CMyDialog::OnMenuShowAboutDialog()
{
// Construct the dialog box passing the
// ID of the dialog template resource
CDialog aboutDlg(IDD_ABOUTBOX);
// Create and show the dialog box
INT_PTR nRet = -1;
nRet = aboutDlg.DoModal();
// Handle the return value from DoModal
switch (nRet)
{
case -1:
AfxMessageBox(_T("Dialog box could not be created!"));
break;
case IDABORT:
// Do something
break;
case IDOK:
// Do something
break;
case IDCANCEL:
// Do something
break;
default:
// Do something
break;
};
}
CDialog::EndDialog
Panggil fungsi anggota ini untuk mengakhiri kotak dialog modal.
void EndDialog(int nResult);
Parameter
nResult
Berisi nilai yang akan dikembalikan dari kotak dialog ke pemanggil DoModal.
Keterangan
Fungsi anggota ini mengembalikan nResult sebagai nilai pengembalian .DoModal Anda harus menggunakan EndDialog fungsi untuk menyelesaikan pemrosesan setiap kali kotak dialog modal dibuat.
Anda dapat menghubungi EndDialog kapan saja, bahkan di OnInitDialog, dalam hal ini Anda harus menutup kotak dialog sebelum ditampilkan atau sebelum fokus input diatur.
EndDialog tidak segera menutup kotak dialog. Sebaliknya, ini mengatur bendera yang mengarahkan kotak dialog untuk menutup segera setelah handler pesan saat ini kembali.
Contoh
void CMyDialog::OnMenuShowSimpleModal()
{
CSimpleDlg myDlg;
INT_PTR nRet = myDlg.DoModal();
if (nRet == IDOK || nRet == 5)
{
AfxMessageBox(_T("Dialog closed successfully"));
}
}
void CSimpleDlg::OnRButtonUp(UINT nFlags, CPoint point)
{
UNREFERENCED_PARAMETER(nFlags);
// Do something
int nRet = point.x; // Just any value would do!
EndDialog(nRet); // This value is returned by DoModal!
// Do something
return; // Dialog closed and DoModal returns only here!
}
CDialog::GetDefID
GetDefID Panggil fungsi anggota untuk mendapatkan ID kontrol tombol dorong default untuk kotak dialog.
DWORD GetDefID() const;
Tampilkan Nilai
Nilai 32-bit ( DWORD). Jika tombol dorong default memiliki nilai ID, kata urutan tinggi berisi DC_HASDEFID dan kata urutan rendah berisi nilai ID. Jika tombol dorong default tidak memiliki nilai ID, nilai yang dikembalikan adalah 0.
Keterangan
Ini biasanya merupakan tombol OK.
CDialog::GotoDlgCtrl
Memindahkan fokus ke kontrol yang ditentukan dalam kotak dialog.
void GotoDlgCtrl(CWnd* pWndCtrl);
Parameter
pWndCtrl
Mengidentifikasi jendela (kontrol) yang akan menerima fokus.
Keterangan
Untuk mendapatkan penunjuk ke kontrol (jendela anak) untuk diteruskan sebagai pWndCtrl, panggil CWnd::GetDlgItem fungsi anggota, yang mengembalikan penunjuk ke objek CWnd.
Contoh
Lihat contoh untuk CWnd::GetDlgItem.
CDialog::InitModalIndirect
Panggil fungsi anggota ini untuk menginisialisasi objek dialog modal menggunakan templat kotak dialog yang Anda buat dalam memori.
BOOL InitModalIndirect(
LPCDLGTEMPLATE lpDialogTemplate,
CWnd* pParentWnd = NULL,
void* lpDialogInit = NULL);
BOOL InitModalIndirect(
HGLOBAL hDialogTemplate,
CWnd* pParentWnd = NULL);
Parameter
lpDialogTemplate
Menunjuk ke memori yang berisi templat kotak dialog yang digunakan untuk membuat kotak dialog. Templat ini dalam bentuk struktur dan informasi kontrol DLGTEMPLATE , seperti yang dijelaskan dalam Windows SDK.
hDialogTemplate
Berisi handel ke memori global yang berisi templat kotak dialog. Templat ini dalam bentuk DLGTEMPLATE struktur dan data untuk setiap kontrol dalam kotak dialog.
pParentWnd
Arahkan ke objek jendela induk atau pemilik (jenis CWnd) tempat objek dialog berada. Jika NULL, jendela induk objek dialog diatur ke jendela aplikasi utama.
lpDialogInit
Menunjuk ke sumber daya DLGINIT.
Tampilkan Nilai
Bukan nol jika objek dialog dibuat dan berhasil diinisialisasi; jika tidak, 0.
Keterangan
Untuk membuat kotak dialog modal secara tidak langsung, pertama-tama alokasikan blok memori global dan isi dengan templat kotak dialog. Kemudian panggil konstruktor kosong CDialog untuk membuat objek kotak dialog. Selanjutnya, panggil InitModalIndirect untuk menyimpan handel Anda ke templat kotak dialog dalam memori. Kotak dialog Windows dibuat dan ditampilkan nanti, ketika fungsi anggota DoModal dipanggil.
Kotak dialog yang berisi kontrol ActiveX memerlukan informasi tambahan yang disediakan dalam sumber daya DLGINIT.
CDialog::MapDialogRect
Panggil untuk mengonversi unit kotak dialog persegi menjadi unit layar.
void MapDialogRect(LPRECT lpRect) const;
Parameter
lpRect
Arahkan ke struktur RECT atau objek CRect yang berisi koordinat kotak dialog yang akan dikonversi.
Keterangan
Unit kotak dialog dinyatakan dalam hal unit dasar kotak dialog saat ini yang berasal dari lebar rata-rata dan tinggi karakter dalam font yang digunakan untuk teks kotak dialog. Satu unit horizontal adalah sebelas dari unit lebar dasar kotak dialog, dan satu unit vertikal adalah satu perdelapan dari unit tinggi dasar kotak dialog.
Fungsi GetDialogBaseUnits Windows mengembalikan informasi ukuran untuk font sistem, tetapi Anda dapat menentukan font yang berbeda untuk setiap kotak dialog jika Anda menggunakan gaya DS_SETFONT dalam file definisi sumber daya. Fungsi MapDialogRect Windows menggunakan font yang sesuai untuk kotak dialog ini.
Fungsi MapDialogRect anggota menggantikan unit kotak dialog di lpRect dengan unit layar (piksel) sehingga persegi panjang dapat digunakan untuk membuat kotak dialog atau memosisikan kontrol dalam kotak.
CDialog::NextDlgCtrl
Memindahkan fokus ke kontrol berikutnya dalam kotak dialog.
void NextDlgCtrl() const;
Keterangan
Jika fokus berada di kontrol terakhir dalam kotak dialog, fokus akan berpindah ke kontrol pertama.
CDialog::OnCancel
Kerangka kerja memanggil metode ini ketika pengguna mengklik Batal atau menekan tombol ESC dalam kotak dialog modal atau tanpa mode.
virtual void OnCancel();
Keterangan
Ambil alih metode ini untuk melakukan tindakan (seperti memulihkan data lama) saat pengguna menutup kotak dialog dengan mengklik Batalkan atau menekan kunci ESC. Default menutup kotak dialog modal dengan memanggil EndDialog dan menyebabkan DoModal mengembalikan IDCANCEL.
Jika Anda menerapkan tombol Batal dalam kotak dialog tanpa mode, Anda harus mengambil alih OnCancel metode dan memanggil DestroyWindow di dalamnya. Jangan panggil metode kelas dasar, karena memanggil EndDialog, yang akan membuat kotak dialog tidak terlihat tetapi tidak menghancurkannya.
Catatan
Anda tidak dapat mengambil alih metode ini ketika Anda menggunakan CFileDialog objek dalam program yang dikompilasi di bawah Windows XP. Untuk informasi selengkapnya tentang CFileDialog, lihat Kelas CFileDialog.
Contoh
void CSimpleDlg::OnCancel()
{
// TODO: Add extra cleanup here
// Ensure that you reset all the values back to the
// ones before modification. This handler is called
// when the user doesn't want to save the changes.
if (AfxMessageBox(_T("Are you sure you want to abort the changes?"),
MB_YESNO) == IDNO)
{
// Give the user a chance if he has unknowingly hit the
// Cancel button. If he says No, return. Don't reset. If
// Yes, go ahead and reset the values and close the dialog.
return;
}
m_nMyValue = m_nPrevValue;
m_pMyString = NULL;
CDialog::OnCancel();
}
CDialog::OnInitDialog
Metode ini dipanggil sebagai respons terhadap WM_INITDIALOG pesan.
virtual BOOL OnInitDialog();
Tampilkan Nilai
Menentukan apakah aplikasi telah mengatur fokus input ke salah satu kontrol dalam kotak dialog. Jika OnInitDialog mengembalikan nonzero, Windows mengatur fokus input ke lokasi default, kontrol pertama dalam kotak dialog. Aplikasi dapat mengembalikan 0 hanya jika telah secara eksplisit mengatur fokus input ke salah satu kontrol dalam kotak dialog.
Keterangan
Windows mengirim WM_INITDIALOG pesan ke kotak dialog selama panggilan Buat, CreateIndirect, atau DoModal , yang terjadi segera sebelum kotak dialog ditampilkan.
Ambil alih metode ini jika Anda ingin melakukan pemrosesan khusus saat kotak dialog diinisialisasi. Dalam versi yang ditimpa, pertama-tama panggil kelas OnInitDialog dasar tetapi abaikan nilai pengembaliannya. Anda biasanya akan kembali TRUE dari metode penimpaan Anda.
Windows memanggil OnInitDialog fungsi dengan menggunakan prosedur kotak dialog global standar yang umum untuk semua kotak dialog Pustaka Kelas Microsoft Foundation. Ini tidak memanggil fungsi ini melalui peta pesan Anda, dan oleh karena itu Anda tidak memerlukan entri peta pesan untuk metode ini.
Catatan
Anda tidak dapat mengambil alih metode ini ketika Anda menggunakan CFileDialog objek dalam program yang dikompilasi di bawah Windows Vista atau sistem operasi yang lebih baru. Untuk informasi selengkapnya tentang perubahan CFileDialog pada Windows Vista dan yang lebih baru, lihat Kelas CFileDialog.
Contoh
BOOL CSimpleDlg::OnInitDialog()
{
CDialog::OnInitDialog();
// TODO: Add extra initialization here
m_cMyEdit.SetWindowText(_T("My Name")); // Initialize control values
m_cMyList.ShowWindow(SW_HIDE); // Show or hide a control, etc.
return TRUE; // return TRUE unless you set the focus to a control
// EXCEPTION: OCX Property Pages should return FALSE
}
CDialog::OnOK
Dipanggil ketika pengguna mengklik tombol OK (tombol dengan ID IDOK).
virtual void OnOK();
Keterangan
Ambil alih metode ini untuk melakukan tindakan ketika tombol OK diaktifkan. Jika kotak dialog menyertakan validasi dan pertukaran data otomatis, implementasi default metode ini memvalidasi data kotak dialog dan memperbarui variabel yang sesuai dalam aplikasi Anda.
Jika Anda menerapkan tombol OK dalam kotak dialog tanpa mode, Anda harus mengambil alih OnOK metode dan memanggil DestroyWindow di dalamnya. Jangan panggil metode kelas dasar, karena memanggil EndDialog yang membuat kotak dialog tidak terlihat tetapi tidak menghancurkannya.
Catatan
Anda tidak dapat mengambil alih metode ini ketika Anda menggunakan CFileDialog objek dalam program yang dikompilasi di bawah Windows XP. Untuk informasi selengkapnya tentang CFileDialog, lihat Kelas CFileDialog.
Contoh
void CSimpleDlg::OnOK()
{
// TODO: Add extra validation here
// Ensure that your UI got the necessary input
// from the user before closing the dialog. The
// default OnOK will close this.
if (m_nMyValue == 0) // Is a particular field still empty?
{
// Inform the user that he can't close the dialog without
// entering the necessary values and don't close the
// dialog.
AfxMessageBox(_T("Please enter a value for MyValue"));
return;
}
CDialog::OnOK(); // This will close the dialog and DoModal will return.
}
CDialog::OnSetFont
Menentukan font yang akan digunakan kontrol kotak dialog saat menggambar teks.
Virtual void OnSetFont(CFont* pFont);
Parameter
pFont
[di] Menentukan penunjuk ke font yang akan digunakan sebagai font default untuk semua kontrol dalam kotak dialog ini.
Keterangan
Kotak dialog akan menggunakan font yang ditentukan sebagai default untuk semua kontrolnya.
Editor dialog biasanya mengatur font kotak dialog sebagai bagian dari sumber daya templat kotak dialog.
Catatan
Anda tidak dapat mengambil alih metode ini ketika Anda menggunakan CFileDialog objek dalam program yang dikompilasi di bawah Windows Vista atau sistem operasi yang lebih baru. Untuk informasi selengkapnya tentang perubahan CFileDialog pada Windows Vista dan yang lebih baru, lihat Kelas CFileDialog.
CDialog::P revDlgCtrl
Mengatur fokus ke kontrol sebelumnya dalam kotak dialog.
void PrevDlgCtrl() const;
Keterangan
Jika fokus berada pada kontrol pertama dalam kotak dialog, fokus akan berpindah ke kontrol terakhir dalam kotak.
CDialog::SetDefID
Mengubah kontrol tombol dorong default untuk kotak dialog.
void SetDefID(UINT nID);
Parameter
Nid
Menentukan ID kontrol tombol dorong yang akan menjadi default.
CDialog::SetHelpID
Mengatur ID bantuan peka konteks untuk kotak dialog.
void SetHelpID(UINT nIDR);
Parameter
nIDR
Menentukan ID bantuan sensitif konteks.
Baca juga
Sampel DLGCBR32 MFC
Sampel MFC DLGTEMPL
Kelas CWnd
Bagan Hierarki
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk