FrameworkElement.FocusVisualStyle 屬性

定義

取得或設定屬性,這個屬性可自訂外觀、效果或其他樣式特性,以在這個項目捕捉到鍵盤焦點時套用至項目。

C#
public System.Windows.Style FocusVisualStyle { get; set; }

屬性值

要在取得焦點時套用的樣式。 相依性屬性中所宣告的預設值是空的靜態 Style。 不過,執行階段的有效值通常是 (但不一定總是) 佈景主題支援為控制項所提供的樣式。

備註

此屬性會影響視覺外觀,但不會在中繼資料中報告 AffectsRender 。 這是因為視覺外觀變更為事件驅動,而且可能隨時都不適用,因此通常不應該在中繼資料中報告任何視覺效果或配置資訊。

在概念上,套用至控制項的焦點視覺行為應該從控制項到控制項之間一致。 強制執行一致性的最合理方式,就是只有在您撰寫整個主題時,才會變更焦點視覺樣式。 在個別控制項樣式上設定此屬性,而不是主題的一部分,並不是此屬性的預期用法,因為它可能會導致有關鍵盤焦點的混淆使用者體驗。 如果您想要刻意不一致于主題的控制項特定行為,最好是針對個別輸入狀態屬性使用樣式中的觸發程式,例如 IsFocusedIsKeyboardFocusWithin ,並以不會以視覺方式干擾任何現有焦點視覺樣式的方式執行此動作。 如需設計意圖 FocusVisualStyle 和替代焦點屬性的詳細資訊,請參閱 控制項中的焦點樣式和 FocusVisualStyle

XAML Attribute Usage

<object FocusVisualStyle="{resourceExtension styleResourceKey}"/>  

XAML 屬性項目用法

XAML 值

resourceExtension
下列其中一項:、 或 。 請參閱 XAML 資源

styleResourceKey
識別所要求樣式的索引鍵。 索引鍵是指 中的 ResourceDictionary 現有資源。

備註

屬性元素語法技術上可行,但不建議使用。 請參閱 內嵌樣式和範本。 您也可以使用 TemplateBindingBinding 的系結參考,但並不常見。

相依性屬性資訊

識別碼欄位 FocusVisualStyleProperty
設定為 的中繼資料屬性 true

適用於

產品 版本
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

另請參閱