FrameworkContentElement.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。 不過，執行階段的有效值通常是 (但不一定總是) 佈景主題支援為控制項所提供的樣式。

備註

在 XAML 中設定此屬性時，樣式幾乎一律定義為資源，而不是內嵌為元素，而且通常會將該資源參考為 StaticResourceExtension 。

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

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

XAML Attribute Usage

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

XAML 屬性項目用法

XAML 值

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

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

注意

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

相依性屬性資訊

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