IUICommandHandler::Execute-Methode (uiribbon.h)

Antwortet auf Ausführungsereignisse für Befehle, die an den Command-Handler gebunden sind.

Syntax

HRESULT Execute(
  [in]           UINT32               commandId,
  [in]           UI_EXECUTIONVERB     verb,
  [in, optional] const PROPERTYKEY    *key,
  [in, optional] const PROPVARIANT    *currentValue,
  [in, optional] IUISimplePropertySet *commandExecutionProperties
);

Parameter

[in] commandId

Typ: UINT32

Die ID für den Befehl, der in der Markupressourcendatei angegeben ist.

[in] verb

Typ: UI_EXECUTIONVERB

Die UI_EXECUTIONVERB oder Aktion, die vom Benutzer initiiert wird.

[in, optional] key

Typ: const PROPERTYKEY*

Ein Zeiger auf einen Eigenschaftsschlüssel , der den Wert geändert hat. Dieser Parameter kann NULL sein.

[in, optional] currentValue

Typ: const PROPVARIANT*

Ein Zeiger auf den aktuellen Wert für key. Dieser Parameter kann NULL sein.

[in, optional] commandExecutionProperties

Typ: IUISimplePropertySet*

Ein Zeiger auf ein IUISimplePropertySet-Objekt , das Command-Zustandseigenschaften und Eigenschaftswerte wie Bildschirmkoordinaten und Listenelementindizes enthält. Dieser Parameter kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Jeder Befehl in einer Ansicht muss an einen neuen oder vorhandenen Command-Handler in der Hostanwendung gebunden sein.

Anforderungen

Weitere Informationen

IUICommandHandler

Windows-Menübandframeworkbeispiele