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

Weitere Informationen

IUIApplication

Windows-Menübandframeworkbeispiele