Aracılığıyla paylaş


COleCmdUI Sınıfı

Uygulamanızın -driven özellikleriyle ilgili kullanıcı arabirimi nesnelerinin durumunu güncelleştirmek için IOleCommandTargetMFC 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

CCmdUI

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.

Ayrıca bkz.

CCmdUI Sınıfı
Hiyerarşi Grafiği