COleDocObjectItem::ExecCommand

Rufen Sie die Memberfunktion auf, um den Befehl auszuführen, der vom Benutzer angegeben wird.

HRESULT ExecCommand(
   DWORD nCmdID,
   DWORD nCmdExecOpt = OLECMDEXECOPT_DONTPROMPTUSER,
   const GUID* pguidCmdGroup = NULL 
);

Parameter

  • nCmdID
    Der Bezeichner des Befehls auszuführen.Muss in der Gruppe sein, die von pguidCmdGroup identifiziert wird.

  • nCmdExecOpt
    Gibt Befehlausführung Optionen an.Standardmäßig festgelegt, um den Befehl auszuführen, ohne den Benutzer aufzufordern.Siehe OLECMDEXECOPT für eine Liste von Werten.

  • pguidCmdGroup
    Eindeutiger Bezeichner der Befehlsgruppe.Standardmäßig NULL, das die Standardgruppe angibt.Der Befehl, der in nCmdID übergeben wird, muss der Gruppe gehören.

Rückgabewert

Gibt zurück, wenn S_OK erfolgreich; andernfalls gibt eine der folgenden Fehlercodes.

Wert

Description

E_UNEXPECTED

Unerwarteter Fehler.

E_FAIL

Fehler aufgetreten.

E_NOTIMPL

Gibt MFC selbst sollte versuchen, den Befehl zu übersetzen und Weiterleiten an.

OLECMDERR_E_UNKNOWNGROUP

pguidCmdGroup ist, Nicht --NULL gibt jedoch keine bekannte Befehlsgruppe an.

OLECMDERR_E_NOTSUPPORTED

nCmdID wird nicht als gültiger Befehl im Gruppe pGroup erkannt.

OLECMDERR_DISABLED

Der Befehl, der von nCmdID identifiziert wird, wird deaktiviert und kann nicht ausgeführt werden.

OLECMDERR_NOHELP

Der Aufrufer der, um Hilfe zum Befehl identifiziert wird durch nCmdID aber keine Hilfe angefordert wird, ist verfügbar.

OLECMDERR_CANCELLED

Benutzer hat die Ausführung ab.

Hinweise

pguidCmdGroup und die nCmdID-Parameter eindeutig identifizieren zusammen den Befehl aufzurufen.Der nCmdExecOpt-Parameter wird die genaue Aktion an.

Anforderungen

Header: afxole.h

Siehe auch

Referenz

COleDocObjectItem-Klasse

Hierarchien-Diagramm

IOleCommandTarget::Exec