FrameworkElement.FocusVisualStyle 屬性

  • 參考

定義

命名空間:
System.Windows
組件:
PresentationFramework.dll

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

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

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

備註

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

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

XAML Attribute Usage

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

XAML 屬性項目用法

XAML 值

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

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

注意

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

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

適用於

另請參閱