COleCmdUI Sınıfı
Uygulamanızın -driven özellikleriyle ilgili kullanıcı arabirimi nesnelerinin durumunu güncelleştirmek için IOleCommandTarget
MFC için bir yöntem uygular.
Sözdizimi
class COleCmdUI : public CCmdUI
Üyeler
Ortak Oluşturucular
Veri Akışı Adı | Açıklama |
---|---|
COleCmdUI::COleCmdUI | Bir COleCmdUI nesne oluşturur. |
Genel Yöntemler
Veri Akışı Adı | Açıklama |
---|---|
COleCmdUI::Enable | Etkinleştir komut bayrağını ayarlar veya temizler. |
COleCmdUI::SetCheck | Açık/kapalı iki durumlu düğmesinin durumunu ayarlar. |
COleCmdUI::SetText | Bir komut için bir metin adı veya durum dizesi döndürür. |
Açıklamalar
DocObjects için etkinleştirilmemiş bir uygulamada, kullanıcı uygulamada bir menü görüntülediğinde, MFC UPDATE_COMMAND_UI bildirimleri işler. Her bildirime belirli bir komutun durumunu yansıtacak şekilde değiştirilebilen bir CCmdUI nesnesi verilir. Ancak, uygulamanız DocObjects için etkinleştirildiğinde, MFC bildirimleri UPDATE_OLE_COMMAND_UI işler ve nesneler atar COleCmdUI
.
COleCmdUI
Bir DocObject'in kapsayıcısının kullanıcı arabiriminden (FileNew, Open, Print vb.) kaynaklanan komutları almasına izin verir ve kapsayıcının DocObject'in kullanıcı arabiriminden kaynaklanan komutları almasına izin verir. Aynı komutları göndermek için kullanılabilse de IDispatch
, IOleCommandTarget
genellikle bağımsız değişkenler olmadan standart bir komut kümesine bağlı olduğundan ve hiçbir tür bilgisi söz konusu olmadığından sorgulamak ve yürütmek için daha basit bir yol sağlar. COleCmdUI
, DocObject kullanıcı arabirimi komutlarının diğer özelliklerini etkinleştirmek, güncelleştirmek ve ayarlamak için kullanılabilir. komutunu çağırmak istediğinizde COleServerDoc::OnExecOleCmd öğesini çağırın.
DocObjects hakkında daha fazla bilgi için bkz . CDocObjectServer ve CDocObjectServerItem.
Devralma Hiyerarşisi
COleCmdUI
Gereksinimler
Üst bilgi: afxdocob.h
COleCmdUI::COleCmdUI
Belirli bir COleCmdUI
kullanıcı arabirimi komutuyla ilişkilendirilmiş bir nesne oluşturur.
COleCmdUI(
OLECMD* rgCmds,
ULONG cCmds,
const GUID* m_pGroup);
Parametreler
rgCmds
Verilen GUID ile ilişkili desteklenen komutların listesi. Yapısı OLECMD
komutları komut bayraklarıyla ilişkilendirir.
cCmds
rgCmds içindeki komutların sayısı.
pGroup
Bir komut kümesini tanımlayan BIR GUID işaretçisi.
Açıklamalar
nesnesi, COleCmdUI
menü öğeleri veya denetim çubuğu düğmeleri gibi DocObject kullanıcı arabirimi nesnelerini güncelleştirmek için programlı bir arabirim sağlar. Kullanıcı arabirimi nesneleri nesne aracılığıyla COleCmdUI
etkinleştirilebilir, devre dışı bırakılabilir, denetlenebilir ve/veya temizlenebilir.
COleCmdUI::Enable
Nesnesinin komut bayrağını COleCmdUI
OLECOMDF_ENABLED olarak ayarlamak, arabirime komutun kullanılabilir ve etkin olduğunu bildiren veya komut bayrağını temizlemek için bu işlevi çağırın.
virtual void Enable(BOOL bOn);
Parametreler
Bon
Nesneyle ilişkili komutun COleCmdUI
etkinleştirilip etkinleştirilmeymeyeceğini veya devre dışı bırakılıp bırakılmayacağını gösterir. Sıfır olmayan komutu etkinleştirir; 0 komutu devre dışı bırakır.
COleCmdUI::SetCheck
Açma/kapatma iki durumlu düğmesinin durumunu ayarlamak için bu işlevi çağırın.
virtual void SetCheck(int nCheck);
Parametreler
nCheck
Açma/kapatma iki durumlu komutunun durumunu belirleyen değer. Değerler şunlardır:
Value | Description |
---|---|
1 | Komutu açık olarak ayarlar. |
2 | komutu belirsiz olarak ayarlar; bu komutun özniteliği ilgili seçimde hem açık hem de kapalı durumda olduğundan durum belirlenemiyor. |
başka bir değer | Komutu kapalı olarak ayarlar. |
COleCmdUI::SetText
Komutun metin adını veya durum dizesini döndürmek için bu işlevi çağır.
virtual void SetText(LPCTSTR lpszText);
Parametreler
lpszText
komutuyla kullanılacak metnin işaretçisi.