IUIApplication::OnDestroyUICommand 方法 (uiribbon.h)

销毁应用程序窗口时,对 Windows 功能区框架标记中指定的每个命令调用。

语法

HRESULT OnDestroyUICommand(
  [in]           UINT32            commandId,
  [in]           UI_COMMANDTYPE    typeID,
  [in, optional] IUICommandHandler *commandHandler
);

参数

[in] commandId

类型: UINT32

命令的 ID,在标记资源文件中指定。

[in] typeID

类型: UI_COMMANDTYPE

与特定控件关联的 命令类型

[in, optional] commandHandler

类型: IUICommandHandler*

指向 IUICommandHandler 对象的指针。 此值可以为 NULL

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此回调通知由功能区框架发送到标记资源文件中每个 Command 声明的主机应用程序。

将释放与每个命令关联的主机应用程序中的所有资源。

示例

以下示例演示 IUIApplication::OnDestroyUICommand 方法的基本实现。

//
//  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;
}

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 uiribbon.h
DLL Mshtml.dll

另请参阅

IUIApplication

Windows 功能区框架示例