FrameworkElement.FocusVisualStyle 屬性
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定屬性,這個屬性可自訂外觀、效果或其他樣式特性,以在這個項目捕捉到鍵盤焦點時套用至項目。
public:
property System::Windows::Style ^ FocusVisualStyle { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };
public System.Windows.Style FocusVisualStyle { get; set; }
member this.FocusVisualStyle : System.Windows.Style with get, set
Public Property FocusVisualStyle As Style
要在取得焦點時套用的樣式。 相依性屬性中所宣告的預設值是空的靜態 Style。 不過,執行階段的有效值通常是 (但不一定總是) 佈景主題支援為控制項所提供的樣式。
此屬性會影響視覺外觀,但不會在中繼資料中報告 AffectsRender 。 這是因為視覺外觀變更為事件驅動,而且可能隨時都不適用,因此通常不應該在中繼資料中報告任何視覺效果或配置資訊。
在概念上,套用至控制項的焦點視覺行為應該從控制項到控制項之間一致。 強制執行一致性的最合理方式,就是只有在您撰寫整個主題時,才會變更焦點視覺樣式。 在個別控制項樣式上設定此屬性,而不是主題的一部分,並不是此屬性的預期用法,因為它可能會導致有關鍵盤焦點的混淆使用者體驗。 如果您想要刻意不一致于主題的控制項特定行為,最好是針對個別輸入狀態屬性使用樣式中的觸發程式,例如 IsFocused 或 IsKeyboardFocusWithin ,並以不會以視覺方式干擾任何現有焦點視覺樣式的方式執行此動作。 如需設計意圖 FocusVisualStyle 和替代焦點屬性的詳細資訊,請參閱 控制項中的焦點樣式和 FocusVisualStyle。
<object FocusVisualStyle="{resourceExtension styleResourceKey}"/>
resourceExtension
下列其中一項:、 或 。 請參閱 XAML 資源。
styleResourceKey
識別所要求樣式的索引鍵。 索引鍵是指 中的 ResourceDictionary 現有資源。
備註
屬性元素語法技術上可行,但不建議使用。 請參閱 內嵌樣式和範本。 您也可以使用 TemplateBinding 或 Binding 的系結參考,但並不常見。
識別碼欄位 | 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 |