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_STATE 和 UI_INVALIDATIONS_ALLPROPERTIES），则仅创建一个对主机应用程序的回调。

要求

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

另请参阅

IUIFramework

UI_INVALIDATIONS

Windows 功能区框架示例