IUIApplication::OnDestroyUICommand-Methode (uiribbon.h)
Wird für jeden Befehl aufgerufen, der im Windows-Menüband-Framework-Markup angegeben ist, wenn das Anwendungsfenster zerstört wird.
Syntax
HRESULT OnDestroyUICommand(
[in] UINT32 commandId,
[in] UI_COMMANDTYPE typeID,
[in, optional] IUICommandHandler *commandHandler
);
Parameter
[in] commandId
Typ: UINT32
Die ID für den Befehl, der in der Markupressourcendatei angegeben ist.
[in] typeID
Typ: UI_COMMANDTYPE
Der Befehlstyp , der einem bestimmten Steuerelement zugeordnet ist.
[in, optional] commandHandler
Typ: IUICommandHandler*
Ein Zeiger auf ein IUICommandHandler-Objekt . Dieser Wert 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
Diese Rückrufbenachrichtigung wird vom Menübandframework für jede Command-Deklaration in der Markupressourcendatei an die Hostanwendung gesendet.
Alle Ressourcen in der Hostanwendung, die jedem Befehl zugeordnet sind, werden freigegeben.
Beispiele
Im folgenden Beispiel wird eine grundlegende Implementierung der IUIApplication::OnDestroyUICommand-Methode veranschaulicht.
//
// FUNCTION: OnDestroyUICommand(UINT, UI_COMMANDTYPE, IUICommandHandler*)
//
// PURPOSE: Called for each Command specified in the Ribbon markup
// when the Ribbon host application window is destroyed.
//
// PARAMETERS:
// nCmdID - The Command identifier.
// typeID - The Command type.
// commandHandler - The Command handler.
//
// COMMENTS:
//
//
STDMETHODIMP CApplication::OnDestroyUICommand(
UINT32 nCmdID,
UI_COMMANDTYPE typeID,
IUICommandHandler* commandHandler)
{
return E_NOTIMPL;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | uiribbon.h |
| DLL | Mshtml.dll |