Drop-Down 按鈕
Drop-Down Button 是由按兩下時顯示互斥專案的下拉式清單的按鈕所組成。
詳
如果沒有明顯的預設值可用,以及個別專案可以以影像、文字或兩者來表示,這個控件對於公開密切相關的專案很有用。
下列螢幕快照說明範例功能區中的功能區 Drop-Down 按鈕。
Drop-Down 按鈕屬性
功能區架構會定義 Drop-Down Button 控制項 屬性索引鍵的集合。
一般而言,Drop-Down Button 屬性會在功能區 UI 中更新,方法是透過呼叫 IUIFramework::InvalidateUICommand 方法,使與控件相關聯的命令失效。 無效事件會由 IUICommandHandler::UpdateProperty 回呼方法所定義,並處理屬性更新。
IUICommandHandler::UpdateProperty 回呼方法不會執行,而且應用程式會查詢更新的屬性值,直到架構需要屬性為止。 例如,當索引標籤啟動時,以及在功能區 UI 中顯示控件,或顯示工具提示時。
注意
在某些情況下,您可以透過 IUIFramework::GetUICommandProperty 方法來擷取屬性,並使用 IUIFramework::SetUICommandProperty 方法進行設定。
下表列出與 Drop-Down Button 控制項相關聯的屬性索引鍵。
屬性索引鍵 | 筆記 |
---|---|
UI_PKEY_Categories | 支援 IUIFramework::GetUICommandProperty 和 IUIFramework::SetUICommandProperty。 |
UI_PKEY_Enabled | 支援 IUIFramework::GetUICommandProperty 和 IUIFramework::SetUICommandProperty。 如果停用所有子項目,架構會將 UI_PKEY_Enabled 設定為 false (0)。 否則,如果啟用一或多個子專案,UI_PKEY_Enabled會設定為 true (-1)。 重要事項: Drop-Down Button 控件的 UI_PKEY_Enabled 屬性應該在啟用或停用一或多個子項目之後失效。 這可確保架構會查詢更新的屬性值,並在功能區 UI 中重新整理 Drop-Down Button 控件的狀態。 |
UI_PKEY_ItemsSource | 支援 IUIFramework::GetUICommandProperty 和 IUIFramework::SetUICommandProperty。 |
UI_PKEY_Keytip | 只能透過無效更新。 |
UI_PKEY_Label | 只能透過無效更新。 |
UI_PKEY_LargeHighContrastImage | 只能透過無效更新。 |
UI_PKEY_LargeImage | 只能透過無效更新。 |
UI_PKEY_SelectedItem | 支援 IUIFramework::GetUICommandProperty 和 IUIFramework::SetUICommandProperty。
注意: 如果與控件相關聯的命令透過呼叫 IUIFramework::InvalidateUICommand而失效,當 UI_INVALIDATIONS_VALUE 傳遞為 旗標的值時,架構會查詢此屬性。 |
UI_PKEY_SmallHighContrastImage | 只能透過無效更新。 |
UI_PKEY_SmallImage | 只能透過無效更新。 |
UI_PKEY_TooltipDescription | 只能透過無效更新。 |
UI_PKEY_TooltipTitle | 只能透過無效更新。 |