COleCmdUI – třída
Implementuje metodu, která mfc aktualizuje stav objektů uživatelského rozhraní souvisejících s IOleCommandTarget
funkcemi ří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
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.