IUIFramework::InvalidateUICommand 方法 (uiribbon.h)

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

语法

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

参数

[in] commandId

类型: UINT32

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

[in] flags

类型: UI_INVALIDATIONS

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

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

[in] key

类型: const PROPERTYKEY*

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

返回值

类型: HRESULT

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

Value 说明
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 功能区框架示例