IUIFramework::InvalidateUICommand 方法 (uiribbon.h)

使 Windows 功能区框架命令属性、值或状态失效。

语法

HRESULT InvalidateUICommand(
  [in] UINT32            commandId,
  [in] UI_INVALIDATIONS  flags,
  [in] const PROPERTYKEY *key
);

参数

[in] commandId

类型: UINT32

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

[in] flags

类型: UI_INVALIDATIONS

标识要使命令的哪个 方面 失效。

注意 传递 UI_INVALIDATIONS_ALLPROPERTIES 会使绑定到命令的所有属性(包括值和状态)失效。
 

[in] key

类型: const PROPERTYKEY*

命令属性或状态的属性键。 此参数可以为 NULL。

返回值

类型: HRESULT

如果成功,则返回S_OK;否则,以下列表中的错误值。

说明
E_INVALIDARG 提供的 值无效。
E_FAIL 此操作失败。 所有命令都未能失效,或者不支持任何指定的属性。

注解

功能区框架标记中定义的资源存储在资源表中,该资源表是在将标记文件编译为二进制格式时创建的。 资源在失效后无法从标记资源表恢复。

失效后,框架会向主机应用程序查询资源详细信息。

当命令值无效时, (标志 包含UI_INVALIDATIONS_VALUE) 的值为 NULL

如果多次调用 IUIFramework::InvalidateUICommand ,并且每次调用中传递 的UI_INVALIDATIONS 值指定重叠属性(如 UI_INVALIDATIONS_STATEUI_INVALIDATIONS_ALLPROPERTIES),则仅创建一个对主机应用程序的回调。

要求

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

另请参阅

IUIFramework

UI_INVALIDATIONS

Windows 功能区框架示例