Classe COleCmdUI
Implementa un metodo per MFC per aggiornare lo stato degli oggetti dell'interfaccia utente relativi alle funzionalità dell'applicazione basate su IOleCommandTarget.
Sintassi
class COleCmdUI : public CCmdUI
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| COleCmdUI::COleCmdUI | Costruisce un oggetto COleCmdUI. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| COleCmdUI::Enable | Imposta o cancella il flag di comando enable. |
| COleCmdUI::SetCheck | Imposta lo stato di un comando attivato/disattivato. |
| COleCmdUI::SetText | Restituisce un nome di testo o una stringa di stato per un comando. |
Osservazioni:
In un'applicazione non abilitata per DocObjects, quando l'utente visualizza un menu nell'applicazione, MFC elabora UPDATE_COMMAND_UI notifiche. A ogni notifica viene assegnato un oggetto CCmdUI che può essere modificato per riflettere lo stato di un comando specifico. Tuttavia, quando l'applicazione è abilitata per DocObjects, MFC elabora le notifiche UPDATE_OLE_COMMAND_UI e assegna oggetti COleCmdUI .
COleCmdUI consente a un DocObject di ricevere comandi che hanno origine nell'interfaccia utente del contenitore , ad esempio FileNew, Open, Print e così via, e consente a un contenitore di ricevere comandi che hanno origine nell'interfaccia utente di DocObject. Anche se IDispatch può essere usato per inviare gli stessi comandi, IOleCommandTarget offre un modo più semplice per eseguire query ed eseguire perché si basa su un set standard di comandi, in genere senza argomenti e non sono coinvolte informazioni sul tipo. COleCmdUI può essere usato per abilitare, aggiornare e impostare altre proprietà dei comandi dell'interfaccia utente docObject. Quando si vuole richiamare il comando, chiamare COleServerDoc::OnExecOleCmd.
Per altre informazioni su DocObjects, vedere CDocObjectServer e CDocObjectServerItem.
Gerarchia di ereditarietà
COleCmdUI
Requisiti
Intestazione: afxdocob.h
COleCmdUI::COleCmdUI
Costruisce un COleCmdUI oggetto associato a un particolare comando dell'interfaccia utente.
COleCmdUI(
OLECMD* rgCmds,
ULONG cCmds,
const GUID* m_pGroup);
Parametri
rgCmds
Elenco di comandi supportati associati al GUID specificato. La OLECMD struttura associa i comandi ai flag di comando.
cCmds
Conteggio dei comandi in rgCmds.
pGroup
Puntatore a un GUID che identifica un set di comandi.
Osservazioni:
L'oggetto COleCmdUI fornisce un'interfaccia programmatica per l'aggiornamento di oggetti dell'interfaccia utente DocObject, ad esempio voci di menu o pulsanti della barra di controllo. Gli oggetti dell'interfaccia utente possono essere abilitati, disabilitati, controllati e/o cancellati tramite l'oggetto COleCmdUI .
COleCmdUI::Enable
Chiamare questa funzione per impostare il flag di comando dell'oggetto COleCmdUI su OLECOMDF_ENABLED, che indica all'interfaccia che il comando è disponibile e abilitato oppure per cancellare il flag di comando.
virtual void Enable(BOOL bOn);
Parametri
Bon
Indica se il comando associato all'oggetto COleCmdUI deve essere abilitato o disabilitato. Diverso da zero abilita il comando; 0 disabilita il comando.
COleCmdUI::SetCheck
Chiamare questa funzione per impostare lo stato di un comando attivato/disattivato.
virtual void SetCheck(int nCheck);
Parametri
nCheck
Valore che determina lo stato per impostare un comando attivato/disattivato. I valori sono:
| valore | Description |
|---|---|
| 1 | Imposta il comando su attivato. |
| 2 | Imposta il comando su indeterminato; Non è possibile determinare lo stato perché l'attributo di questo comando si trova sia negli stati on che off nella selezione pertinente. |
| qualsiasi altro valore | Imposta il comando su off. |
COleCmdUI::SetText
Chiamare questa funzione per restituire un nome di testo o una stringa di stato per un comando.
virtual void SetText(LPCTSTR lpszText);
Parametri
lpszText
Puntatore al testo da usare con il comando .