COleCmdUI – třída

Implementuje metodu, která mfc aktualizuje stav objektů uživatelského rozhraní souvisejících s IOleCommandTargetfunkcemi řízenými vaší aplikací.

Syntaxe

class COleCmdUI : public CCmdUI

Členové

Veřejné konstruktory

Název	Popis
COleCmdUI::COleCmdUI	COleCmdUI Vytvoří objekt.

Veřejné metody

Název	Popis
COleCmdUI::Enable	Nastaví nebo vymaže příznak příkazu enable.
COleCmdUI::SetCheck	Nastaví stav přepínače zapnuto/vypnuto.
COleCmdUI::SetText	Vrátí textový název nebo stavový řetězec pro příkaz.

Poznámky

V aplikaci, která není povolena pro DocObjects, když uživatel zobrazí nabídku v aplikaci, MFC zpracuje UPDATE_COMMAND_UI oznámení. Každé oznámení má objekt CCmdUI , který lze manipulovat tak, aby odrážel stav konkrétního příkazu. Pokud je však vaše aplikace povolena pro DocObjects, MFC zpracovává UPDATE_OLE_COMMAND_UI oznámení a přiřazuje COleCmdUI objekty.

COleCmdUI Umožňuje objektu DocObject přijímat příkazy pocházející z uživatelského rozhraní kontejneru (například FileNew, Open, Print atd.) a umožňuje kontejneru přijímat příkazy pocházející z uživatelského rozhraní DocObjectu. I když IDispatch je možné použít k odeslání stejných příkazů, poskytuje jednodušší způsob dotazování a provádění, IOleCommandTarget protože spoléhá na standardní sadu příkazů, obvykle bez argumentů, a neobsahuje žádné informace o typu. COleCmdUI lze použít k povolení, aktualizaci a nastavení dalších vlastností příkazů uživatelského rozhraní DocObject. Pokud chcete vyvolat příkaz, zavolejte COleServerDoc::OnExecOleCmd.

Další informace o DocObjects najdete v tématu CDocObjectServer a CDocObjectServerItem.

Hierarchie dědičnosti

CCmdUI

COleCmdUI

Požadavky

Hlavička: afxdocob.h

COleCmdUI::COleCmdUI

COleCmdUI Vytvoří objekt přidružený k určitému příkazu uživatelského rozhraní.

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

Parametry

rgCmds
Seznam podporovaných příkazů přidružených k danému identifikátoru GUID Struktura OLECMD přidruží příkazy k příznakům příkazů.

cCmds
Počet příkazů v rgCmds.

pGroup
Ukazatel na identifikátor GUID, který identifikuje sadu příkazů.

Poznámky

Objekt COleCmdUI poskytuje programové rozhraní pro aktualizaci objektů uživatelského rozhraní DocObject, jako jsou položky nabídky nebo tlačítka řídicího panelu. Objekty uživatelského rozhraní je možné povolit, zakázat, zaškrtnuto nebo vymazat prostřednictvím objektu COleCmdUI .

COleCmdUI::Enable

Voláním této funkce nastavíte příznak příkazu objektu COleCmdUI na OLECOMDF_ENABLED, který říká rozhraní, které příkaz je k dispozici a povoleno, nebo k vymazání příznaku příkazu.

virtual void Enable(BOOL bOn);

Parametry

Bon
Určuje, jestli má být příkaz přidružený k objektu COleCmdUI povolený nebo zakázaný. Nenulové povolení příkazu; 0 zakáže příkaz.

COleCmdUI::SetCheck

Voláním této funkce nastavíte stav přepínače zapnuto/vypnuto.

virtual void SetCheck(int nCheck);

Parametry

nCheck
Hodnota určující stav pro nastavení přepínacího příkazu zapnuto/vypnuto. Hodnoty jsou:

Hodnota	Description
1	Nastaví příkaz na zapnuto.
2	Nastaví příkaz na neurčité; stav nelze určit, protože atribut tohoto příkazu je ve stavu zapnuto i vypnuto v příslušném výběru.
libovolná jiná hodnota	Nastaví příkaz na vypnuto.

COleCmdUI::SetText

Voláním této funkce vrátíte textový název nebo stavový řetězec příkazu.

virtual void SetText(LPCTSTR lpszText);

Parametry

lpszText
Ukazatel na text, který se má použít s příkazem.

Viz také

CCmdUI – třída
Graf hierarchie