Klasse COleCmdUI

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Implementeert een methode voor MFC om de status van gebruikersinterfaceobjecten bij te werken die betrekking hebben op de IOleCommandTarget-driven functies van uw toepassing.

Syntaxis

class COleCmdUI : public CCmdUI

Leden

Openbare constructors

Naam	Description
COleCmdUI::COleCmdUI	Maakt een COleCmdUI object.

Openbare methoden

Naam	Description
COleCmdUI::Enable	Hiermee stelt u de opdrachtvlag in of wist u deze.
COleCmdUI::SetCheck	Hiermee stelt u de status van een in-/uit-wisselknop in.
COleCmdUI::SetText	Retourneert een tekstnaam of statustekenreeks voor een opdracht.

Opmerkingen

In een toepassing die niet is ingeschakeld voor DocObjects, wanneer de gebruiker een menu in de toepassing bekijkt, verwerkt MFC UPDATE_COMMAND_UI meldingen. Elke melding krijgt een CCmdUI-object dat kan worden gemanipuleerd om de status van een bepaalde opdracht weer te geven. Wanneer uw toepassing echter is ingeschakeld voor DocObjects, verwerkt MFC UPDATE_OLE_COMMAND_UI meldingen en wijst objecten toe COleCmdUI .

COleCmdUI staat een DocObject toe om opdrachten te ontvangen die afkomstig zijn uit de gebruikersinterface van de container (zoals FileNew, Openen, Afdrukken enzovoort), en waarmee een container opdrachten kan ontvangen die afkomstig zijn uit de gebruikersinterface van DocObject. Hoewel IDispatch kan worden gebruikt voor het verzenden van dezelfde opdrachten, IOleCommandTarget biedt een eenvoudigere manier om query's uit te voeren omdat deze afhankelijk is van een standaardset opdrachten, meestal zonder argumenten, en er geen typegegevens betrokken zijn. COleCmdUI kan worden gebruikt voor het inschakelen, bijwerken en instellen van andere eigenschappen van DocObject-opdrachten voor de gebruikersinterface. Als u de opdracht wilt aanroepen, roept u COleServerDoc::OnExecOleCmd aan.

Zie CDocObjectServer en CDocObjectServerItem voor meer informatie over DocObjects.

Overnamehiërarchie

CCmdUI

COleCmdUI

Requirements

Koptekst: afxdocob.h

COleCmdUI::COleCmdUI

Hiermee maakt u een COleCmdUI object dat is gekoppeld aan een bepaalde opdracht van de gebruikersinterface.

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

Parameterwaarden

rgCmds
Een lijst met ondersteunde opdrachten die zijn gekoppeld aan de opgegeven GUID. De OLECMD structuur koppelt opdrachten aan opdrachtvlagmen.

cCmds
Het aantal opdrachten in rgCmds.

pGroup
Een aanwijzer naar een GUID die een set opdrachten identificeert.

Opmerkingen

Het COleCmdUI object biedt een programmatische interface voor het bijwerken van DocObject-gebruikersinterfaceobjectobjecten, zoals menu-items of knoppen op de besturingsbalk. De gebruikersinterfaceobjecten kunnen worden ingeschakeld, uitgeschakeld, gecontroleerd en/of gewist via het COleCmdUI object.

COleCmdUI::Enable

Roep deze functie aan om de opdrachtvlag van het COleCmdUI object in te stellen op OLECOMDF_ENABLED, waarmee wordt aangegeven welke interface de opdracht beschikbaar en ingeschakeld is, of om de opdrachtvlag te wissen.

virtual void Enable(BOOL bOn);

Parameterwaarden

Bon
Hiermee wordt aangegeven of de opdracht die aan het COleCmdUI object is gekoppeld, moet worden ingeschakeld of uitgeschakeld. Nonzero schakelt de opdracht in; 0 schakelt de opdracht uit.

COleCmdUI::SetCheck

Roep deze functie aan om de status van een in-/uit-wisselknop in te stellen.

virtual void SetCheck(int nCheck);

Parameterwaarden

nCheck
Een waarde die de status bepaalt om een in-/uit-opdracht in te stellen. Waarden zijn:

Waarde	Description
1	Hiermee stelt u de opdracht in op aan.
2	Hiermee stelt u de opdracht in op onbepaalde tijd; de status kan niet worden bepaald omdat het kenmerk van deze opdracht zowel in- als uitgeschakeld is in de relevante selectie.
elke andere waarde	Hiermee stelt u de opdracht uit.

COleCmdUI::SetText

Roep deze functie aan om een tekstnaam of statustekenreeks voor een opdracht te retourneren.

virtual void SetText(LPCTSTR lpszText);

Parameterwaarden

lpszText
Een aanwijzer naar de tekst die moet worden gebruikt met de opdracht.

Zie ook

CCmdUI-klasse
Hiërarchiegrafiek