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 |