按鈕 (Windows 功能區架構)

Button 是使用者可以按一下以將輸入提供給應用程式的控制項。

簡介

下列螢幕擷取畫面包含功能區按鈕元素的三個範例。

功能區架構會定義 Button 控制項的屬性索引鍵集合。

一般而言，Button 屬性會在功能區 UI 中更新，方法是透過呼叫 IUIFramework：：InvalidateUICommand 方法，使與控制項相關聯的命令失效。無效事件是由 IUICommandHandler：：UpdateProperty 回呼方法所定義的屬性更新處理。

IUICommandHandler：：UpdateProperty回呼方法不會執行，而且應用程式會查詢更新的屬性值，直到架構需要屬性為止。例如，當索引標籤啟動時，以及功能區 UI 中顯示的控制項，或顯示工具提示時。

注意

在某些情況下，可以透過 IUIFramework：：GetUICommandProperty 方法擷取屬性，並使用 IUIFramework：：SetUICommandProperty 方法進行設定。

下表列出與 Button 控制項相關聯的屬性鍵。

屬性索引鍵	備註
UI_PKEY_Enabled	支援 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_Keytip	只能透過失效來更新。
UI_PKEY_Label	只能透過失效來更新。
UI_PKEY_LabelDescription	只能透過失效來更新。
UI_PKEY_LargeHighContrastImage	只能透過失效來更新。
UI_PKEY_LargeImage	只能透過失效來更新。
UI_PKEY_SmallHighContrastImage	只能透過失效來更新。
UI_PKEY_SmallImage	只能透過失效來更新。
UI_PKEY_TooltipDescription	只能透過失效來更新。
UI_PKEY_TooltipTitle	只能透過失效來更新。