COleServerDoc::OnExecOleCmd

Il framework chiama la funzione per eseguire una guida specificata per la visualizzazione o il comando per il comando.

virtual HRESULT OnExecOleCmd( 
   const GUID* pguidCmdGroup, 
   DWORD nCmdID, 
   DWORD nCmdExecOpt, 
   VARIANTARG* pvarargIn, 
   VARIANTARG* pvarargOut 
);

Parametri

  • pguidCmdGroup
    Un puntatore a un GUID che identificano un insieme di controlli.Può essere NULL per indicare il gruppo di controlli predefinito.

  • nCmdID
    Comando da eseguire.Deve appartenere al gruppo identificato da pguidCmdGroup.

  • nCmdExecOut
    La modalità l'oggetto deve eseguire il comando, uno o più dei seguenti valori dell'enumerazione OLECMDEXECOPT :

  •    OLECMDEXECOPT_DODEFAULT

  •    OLECMDEXECOPT_PROMPTUSER

  •    OLECMDEXECOPT_DONTPROMPTUSER

  •    OLECMDEXECOPT_SHOWHELP

  • pvarargIn
    Puntatore a VARIANTARG contenente gli argomenti per il comando.Può essere NULL.

  • pvarargOut
    Puntatore a VARIANTARG per ricevere valori restituiti di output del comando.Può essere NULL.

Valore restituito

Restituisce S_OK caso di esito positivo; in caso contrario, uno dei seguenti codici di errore:

Valore

Descrizione

E_UNEXPECTED

L'errore non si è verificato

E_FAIL

Si è verificato l'errore

E_NOTIMPL

Indica che la libreria MFC deve tentare di convertire e inviare il comando

OLECMDERR_E_UNKNOWNGROUP

pguidCmdGroup èNULL ma non specifica un gruppo di controlli riconosciuto

OLECMDERR_E_NOTSUPPORTED

nCmdID non viene riconosciuto come un comando valido nel gruppo pguidCmdGroup

OLECMDERR_DISABLED

Il comando identificato da nCmdID è disabilitato e non può essere eseguito

OLECMDERR_NOHELP

Il chiamante richiesto la guida sul comando identificato da nCmdID ma nessuna guida è disponibile

OLECMDERR_CANCELED

l'utente ha annullato l'esecuzione

Note

COleCmdUI può essere utilizzato per attivare, aggiornare e impostare altre proprietà dei controlli dell'interfaccia utente di DocObject.Dopo che i controlli vengono inizializzati, è possibile eseguirli con OnExecOleCmd.

Il framework chiama la funzione prima di tentare di convertire e inviare un comando di documenti OLE.Non è necessario eseguire l'override della funzione per gestire i controlli documento OLE standard, ma è necessario fornire un override a questa funzione per gestire i propri controlli personalizzati o i controlli di handle che accettano parametri o restituire i risultati.

La maggior parte dei controlli non accetta argomenti o i valori restituiti.Per la maggior parte dei comandi il chiamante può passare NULLoggetti per pvarargIn e pvarargOut.Per i controlli che prevedono valori di input, il chiamante può dichiarare e inizializzare una variabile VARIANTARG e passare un puntatore alla variabile in pvarargIn.Per i controlli che richiedono un singolo valore, l'argomento può essere memorizzato direttamente in VARIANTARG ed essere passato alla funzione.Gli argomenti devono più essere compressi in VARIANTARG utilizzando uno dei tipi supportati (come IDispatch e SAFEARRAY ).

Analogamente, se un comando restituisce gli argomenti il chiamante deve dichiarare VARIANTARG, per inizializzarla a VT_EMPTYe passare il relativo indirizzo in pvarargOut.Se un comando restituisce un valore, l'oggetto può archiviare il valore direttamente in pvarargOut.I valori a l input devono trovarsi in qualche modo appropriato compressa per VARIANTARG.

L'implementazione della classe base di questa funzione verificherà le strutture OLE_COMMAND_MAP associate alla destinazione comando e tentare di inviare il comando a un gestore appropriato.Funzionamento di implementazione della classe base solo con i controlli che non accetta argomenti e valori restituiti.Se è necessario gestire i controlli che accettano argomenti o i valori restituiti, è necessario eseguire l'override di questi funzione e utilizzare i parametri pvarargOut e pvarargIn manualmente.

Requisiti

Header: afxole.h

Vedere anche

Riferimenti

Classe di COleServerDoc

Grafico della gerarchia

Classe di COleCmdUI