Kelas COleCmdUI

Menerapkan metode untuk MFC untuk memperbarui status objek antarmuka pengguna yang terkait dengan IOleCommandTargetfitur -driven aplikasi Anda.

Sintaks

class COleCmdUI : public CCmdUI

Anggota

Konstruktor Publik

Nama	Deskripsi
COleCmdUI::COleCmdUI	Membuat COleCmdUI objek.

Metode Publik

Nama	Deskripsi
COleCmdUI::Aktifkan	Mengatur atau menghapus bendera perintah aktifkan.
COleCmdUI::SetCheck	Mengatur status perintah aktif/nonaktif.
COleCmdUI::SetText	Mengembalikan nama teks atau string status untuk perintah.

Keterangan

Dalam aplikasi yang tidak diaktifkan untuk DocObjects, ketika pengguna melihat menu di aplikasi, MFC memproses UPDATE_COMMAND_UI pemberitahuan. Setiap pemberitahuan diberikan objek CCmdUI yang dapat dimanipulasi untuk mencerminkan status perintah tertentu. Namun, ketika aplikasi Anda diaktifkan untuk DocObjects, MFC memproses UPDATE_OLE_COMMAND_UI pemberitahuan dan menetapkan COleCmdUI objek.

COleCmdUI memungkinkan DocObject untuk menerima perintah yang berasal dari antarmuka pengguna kontainernya (seperti FileNew, Open, Print, dan sebagainya), dan memungkinkan kontainer untuk menerima perintah yang berasal dari antarmuka pengguna DocObject. Meskipun IDispatch dapat digunakan untuk mengirimkan perintah yang sama, IOleCommandTarget menyediakan cara yang lebih sederhana untuk mengkueri dan menjalankan karena bergantung pada sekumpulan perintah standar, biasanya tanpa argumen, dan tidak ada informasi jenis yang terlibat. COleCmdUI dapat digunakan untuk mengaktifkan, memperbarui, dan mengatur properti lain dari perintah antarmuka pengguna DocObject. Saat Anda ingin memanggil perintah, panggil COleServerDoc::OnExecOleCmd.

Untuk informasi lebih lanjut tentang DocObjects, lihat CDocObjectServer dan CDocObjectServerItem.

Hierarki Warisan

CCmdUI

COleCmdUI

Persyaratan

Header: afxdocob.h

COleCmdUI::COleCmdUI

Membuat objek yang COleCmdUI terkait dengan perintah antarmuka pengguna tertentu.

COleCmdUI(
    OLECMD* rgCmds,
    ULONG cCmds,
    const GUID* m_pGroup);

Parameter

rgCmds
Daftar perintah yang didukung yang terkait dengan GUID yang diberikan. Struktur OLECMD mengaitkan perintah dengan bendera perintah.

cCmds
Jumlah perintah dalam rgCmds.

pGroup
Penunjuk ke GUID yang mengidentifikasi sekumpulan perintah.

Keterangan

Objek COleCmdUI menyediakan antarmuka terprogram untuk memperbarui objek antarmuka pengguna DocObject seperti item menu atau tombol bilah kontrol. Objek antarmuka pengguna dapat diaktifkan, dinonaktifkan, diperiksa, dan/atau dibersihkan melalui COleCmdUI objek.

COleCmdUI::Aktifkan

Panggil fungsi ini untuk mengatur bendera COleCmdUI perintah objek ke OLECOMDF_ENABLED, yang memberi tahu antarmuka bahwa perintah tersedia dan diaktifkan, atau untuk menghapus bendera perintah.

virtual void Enable(BOOL bOn);

Parameter

Bon
Menunjukkan apakah perintah yang terkait dengan COleCmdUI objek harus diaktifkan atau dinonaktifkan. Nonzero memungkinkan perintah; 0 menonaktifkan perintah.

COleCmdUI::SetCheck

Panggil fungsi ini untuk mengatur status perintah aktif/nonaktif.

virtual void SetCheck(int nCheck);

Parameter

nCheck
Nilai yang menentukan status untuk mengatur perintah aktif/nonaktif. Nilainya adalah:

Nilai	Description
1	Mengatur perintah ke aktif.
2	Mengatur perintah untuk tidak ditentukan; status tidak dapat ditentukan karena atribut perintah ini berada dalam status aktif dan nonaktif dalam pilihan yang relevan.
nilai lainnya	Mengatur perintah ke nonaktif.

COleCmdUI::SetText

Panggil fungsi ini untuk mengembalikan nama teks atau string status untuk perintah.

virtual void SetText(LPCTSTR lpszText);

Parameter

lpszText
Penunjuk ke teks yang akan digunakan dengan perintah .

Lihat juga

Kelas CCmdUI
Bagan Hierarki