IUICommandHandler::Execute 方法 (uiribbon.h)

响应绑定到命令处理程序的命令上的执行事件。

语法

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

参数

[in] commandId

类型: UINT32

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

[in] verb

类型: UI_EXECUTIONVERB

用户启动 的UI_EXECUTIONVERB 或操作。

[in, optional] key

类型: const PROPERTYKEY*

指向已更改值 的属性键 的指针。 此参数可以为 NULL。

[in, optional] currentValue

类型: const PROPVARIANT*

指向 的当前值的指针。 此参数可以为 NULL。

[in, optional] commandExecutionProperties

类型: IUISimplePropertySet*

指向 IUISimplePropertySet 对象的指针,该对象包含命令状态属性和属性值,例如屏幕坐标和列表项索引。 此参数可以为 NULL。

返回值

类型: HRESULT

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

注解

视图中的每个命令都必须绑定到主机应用程序中新的或现有的命令处理程序。

要求

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

另请参阅

IUICommandHandler

Windows 功能区框架示例