IUIFramework：：InvalidateUICommand 方法 (uiribbon.h)

  • 發行項

使 Windows 功能區架構 Command 屬性、值或狀態失效。

語法

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

參數

[in] commandId

類型： UINT32

命令的標識碼，其指定於標記資源檔中。

[in] flags

類型： UI_INVALIDATIONS

識別要失效之命令的哪個 層面 。

注意 傳遞 UI_INVALIDATIONS_ALLPROPERTIES 會使系結至命令的所有屬性失效，包括值和狀態。
 

[in] key

類型： const PROPERTYKEY*

命令屬性或狀態的屬性索引鍵。 此參數可以是 Null。

傳回值

類型： HRESULT

如果成功，則傳回S_OK;否則，下列清單中的錯誤值。

值 描述
E_INVALIDARG 已提供 索引鍵 的無效值。
E_FAIL 作業失敗。 所有命令都無法失效，或不支援任何指定的屬性。

備註

功能區架構標記中定義的資源會儲存在將標記檔案編譯成二進位格式時所建立的資源數據表中。 資源失效之後，就無法從標記資源數據表中恢復資源。

失效之後，架構會查詢主應用程式以取得資源詳細數據。

當 Command 值無效時， (旗標 包含索引 鍵 的值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 功能區架構範例