Bagikan melalui


Kelas CMFCKeyMapDialog

Kelas CMFCKeyMapDialog mendukung kontrol yang memetakan perintah ke tombol pada keyboard.

Sintaks

class CMFCKeyMapDialog : public CDialogEx

Anggota

Konstruktor Publik

Nama Deskripsi
CMFCKeyMapDialog::CMFCKeyMapDialog Membuat CMFCKeyMapDialog objek.

Metode Publik

Nama Deskripsi
CMFCKeyMapDialog::D oModal Menampilkan kotak dialog pemetaan keyboard.

Metode yang Dilindungi

Nama Deskripsi
CMFCKeyMapDialog::FormatItem Dipanggil oleh kerangka kerja untuk membangun string yang menjelaskan pemetaan kunci. Secara default, string berisi nama perintah, kunci pintasan yang digunakan, dan deskripsi kunci pintasan.
CMFCKeyMapDialog::GetCommandKeys Mengambil string yang berisi daftar kunci pintasan yang terkait dengan perintah yang ditentukan.
CMFCKeyMapDialog::OnInsertItem Dipanggil oleh kerangka kerja sebelum item baru dimasukkan ke dalam kontrol daftar internal yang mendukung kontrol pemetaan keyboard.
CMFCKeyMapDialog::OnPrintHeader Dipanggil oleh kerangka kerja untuk mencetak header untuk peta keyboard pada halaman baru.
CMFCKeyMapDialog::OnPrintItem Dipanggil oleh kerangka kerja untuk mencetak item pemetaan keyboard.
CMFCKeyMapDialog::OnSetColumns Dipanggil oleh kerangka kerja untuk mengatur keterangan untuk kolom dalam kontrol daftar internal yang mendukung kontrol pemetaan keyboard.
CMFCKeyMapDialog::P rintKeyMap Dipanggil oleh kerangka kerja saat pengguna mengklik tombol Cetak .
CMFCKeyMapDialog::SetColumnsWidth Dipanggil oleh kerangka kerja untuk mengatur lebar kolom dalam kontrol daftar internal yang mendukung kontrol pemetaan keyboard.

Keterangan

CMFCKeyMapDialog Gunakan kelas untuk mengimplementasikan kotak dialog pemetaan keyboard yang dapat diubah bentuknya. Kotak dialog menggunakan kontrol tampilan daftar untuk menampilkan pintasan keyboard dan perintah terkaitnya.

Untuk menggunakan CMFCKeyMapDialog kelas dalam aplikasi, teruskan penunjuk ke jendela bingkai utama sebagai parameter ke CMFCKeyMapDialog konstruktor. Kemudian panggil DoModal metode untuk memulai kotak dialog modal.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

CMFCKeyMapDialog

Persyaratan

Header: afxkeymapdialog.h

CMFCKeyMapDialog::CMFCKeyMapDialog

Membuat CMFCKeyMapDialog objek.

CMFCKeyMapDialog(
    CFrameWnd* pWndParentFrame,
    BOOL bEnablePrint=FALSE);

Parameter

pWndParentFrame
[di] Penunjuk ke jendela CMFCKeyMapDialog induk objek.

bEnablePrint
[di] TRUE jika daftar kunci akselerator dapat dicetak; jika tidak, FALSE. Defaultnya adalah FALSE.

Keterangan

Contoh

Contoh berikut menunjukkan cara membuat objek CMFCKeyMapDialog kelas. Contoh ini adalah bagian dari sampel Demo Visual Studio.

// this points to a CMainFrame class which extends the 
// CMDIFrameWndEx class
CMFCKeyMapDialog dlg(this, TRUE /* Enable Print */);

CMFCKeyMapDialog::D oModal

Menampilkan kotak dialog pemetaan keyboard.

virtual INT_PTR DoModal();

Tampilkan Nilai

Bilangan bulat yang ditandatangani, seperti IDOK atau IDCANCEL, yang diteruskan ke metode CDialog::EndDialog . Metode ini, pada gilirannya, menutup kotak dialog. Untuk informasi selengkapnya, lihat CDialog::D oModal.

Keterangan

Kotak dialog pemetaan keyboard memungkinkan Anda memilih dan menetapkan tombol akselerator ke berbagai kategori perintah. Selain itu, Anda dapat menyalin kunci akselerator yang dipilih dan deskripsinya ke clipboard.

CMFCKeyMapDialog::FormatItem

Dipanggil oleh kerangka kerja untuk membangun string yang menjelaskan pemetaan kunci. Secara default, string berisi nama perintah, kunci pintasan yang digunakan, dan deskripsi kunci pintasan.

virtual CString FormatItem(int nItem) const;

Parameter

nItem
[di] Indeks berbasis nol item dalam daftar internal pemetaan kunci.

Tampilkan Nilai

Objek CString yang berisi teks item yang diformat.

Keterangan

CMFCKeyMapDialog::GetCommandKeys

Mengambil nilai string. String berisi daftar kunci pintasan yang terkait dengan perintah tertentu.

virtual CString GetCommandKeys(UINT uiCmdID) const;

Parameter

uiCmdID
[di] ID perintah.

Tampilkan Nilai

Daftar kunci pintasan yang dibatasi (';') titik koma yang terkait dengan perintah yang ditentukan.

Keterangan

CMFCKeyMapDialog::OnInsertItem

Dipanggil oleh kerangka kerja sebelum item baru dimasukkan ke dalam kontrol daftar internal yang mendukung kontrol pemetaan keyboard.

virtual void OnInsertItem(
    CMFCToolBarButton* pButton,
    int nItem);

Parameter

pButton
[di] Penunjuk ke tombol toolbar yang digunakan untuk memetakan kombinasi tombol keyboard ke nama perintah dan deskripsi. Item peta kunci disimpan dalam kontrol daftar internal.

nItem
[di] Indeks berbasis nol yang menentukan tempat menyisipkan item peta kunci baru dalam kontrol daftar internal.

Keterangan

CMFCKeyMapDialog::OnPrintHeader

Dipanggil oleh kerangka kerja untuk mencetak header untuk peta keyboard pada halaman baru.

virtual int OnPrintHeader(
    CDC& dc,
    int nPage,
    int cx) const;

Parameter

arus searah
[di] Konteks perangkat untuk printer.

nPage
[di] Nomor halaman yang akan dicetak.

cx
[di] Offset horizontal header, dalam piksel.

Tampilkan Nilai

Jika berhasil, tinggi teks yang dicetak. Untuk informasi selengkapnya, lihat bagian Nilai Pengembalian CDC ::D rawText.

Keterangan

Kerangka kerja menggunakan metode ini untuk mencetak peta keyboard. Secara default, metode ini mencetak nomor halaman, nama aplikasi, dan judul kotak dialog.

CMFCKeyMapDialog::OnPrintItem

Dipanggil oleh kerangka kerja untuk mencetak item pemetaan keyboard.

virtual int OnPrintItem(
    CDC& dc,
    int nItem,
    int y,
    int cx,
    BOOL bCalcHeight) const;

Parameter

arus searah
[di] Konteks perangkat printer.

nItem
[di] Indeks berbasis nol dari item yang akan dicetak.

y
[di] Offset vertikal antara bagian atas halaman dan posisi item.

cx
[di] Offset horizontal antara kiri halaman dan posisi item.

bCalcHeight
[di] TRUE untuk menghitung tinggi terbaik untuk item cetak; FALSE untuk memotong item cetak sehingga pas dengan ruang default.

Tampilkan Nilai

Tinggi item yang dicetak.

Keterangan

Kerangka kerja memanggil metode ini untuk mencetak item kotak dialog peta kunci. Secara default, metode ini mencetak nama perintah item, kunci pintasan, dan deskripsi perintah.

CMFCKeyMapDialog::OnSetColumns

Dipanggil oleh kerangka kerja untuk mengatur keterangan untuk kolom dalam kontrol daftar internal yang mendukung kontrol pemetaan keyboard.

virtual void OnSetColumns();

Keterangan

Secara default, metode ini mendapatkan keterangan untuk kolom dari tiga sumber daya. Keterangan kolom perintah berasal dari IDS_AFXBARRES_COMMAND, keterangan kolom kunci berasal dari IDS_AFXBARRES_KEYS, dan keterangan kolom deskripsi berasal dari IDS_AFXBARRES_DESCRIPTION.

CMFCKeyMapDialog::P rintKeyMap

Dipanggil oleh kerangka kerja saat pengguna mengklik tombol Cetak .

virtual void PrintKeyMap();

Keterangan

Metode PrintKeyMap mencetak peta kunci. Ini memulai pekerjaan cetak baru dan kemudian berulang kali memanggil metode CMFCKeyMapDialog::OnPrintHeader dan CMFCKeyMapDialog::OnPrintItem hingga semua pemetaan kunci dicetak.

CMFCKeyMapDialog::SetColumnsWidth

Dipanggil oleh kerangka kerja untuk mengatur lebar kolom dalam kontrol daftar internal yang mendukung kontrol pemetaan keyboard.

virtual void SetColumnsWidth();

Keterangan

Metode ini mengatur kolom kontrol daftar internal ke lebar default. Pertama, lebar kolom tombol pintasan dihitung. Kemudian sepertiga dari lebar yang tersisa dialokasikan ke kolom perintah dan dua pertiga sisanya dialokasikan ke kolom deskripsi.

Lihat juga

Bagan Hierarki
Kelas
Kelas CKeyboardManager