FrameworkContentElement.FocusVisualStyle FrameworkContentElement.FocusVisualStyle FrameworkContentElement.FocusVisualStyle FrameworkContentElement.FocusVisualStyle Property


この要素がキーボード フォーカスを受け取ったときに適用される外観、効果、またはその他のスタイル特性のカスタマイズを可能にするオブジェクトを取得または設定します。Gets or sets an object that enables customization of appearance, effects, or other style characteristics that will apply to this element when it captures keyboard focus.

 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


フォーカスに適用する目的のスタイル。The desired style to apply on focus. 依存関係プロパティで宣言されている既定値は、空の静的 Style です。The default value as declared in the dependency property is an empty static Style. ただし、実行時の有効値は、多くの場合、コントロールのテーマ サポートによって提供されたスタイルです (ただし、常にそうであるとは限りません)。However, the effective value at run time is often (but not always) a style as supplied by theme support for controls.


このプロパティを設定するとXAMLXAMLとして参照されているリソースが通常は、スタイルはほぼ常に、要素としてのインラインではなく、リソースとして定義されます、StaticResourceExtensionします。When setting this property in XAMLXAML, styles are almost always defined as a resource, rather than inline as an element, and that resource is usually referenced as a StaticResourceExtension.

このプロパティが視覚的な外観に影響を与えますが、ようにメタデータで報告されないことに注意してください。Note that this property affects visual appearance but does not report so in metadata. 視覚的な外観の変更はイベント ドリブンし、常に適用され、したがっては限らないメタデータ内の任意のビジュアルやレイアウト情報があるためにです。This is because the visual appearance change is event-driven and may not apply at all times, and thus should not generally report any visual or layout information in metadata.

概念的には、コントロールに適用されたフォーカスの視覚的な動作は、要素間で一貫している必要があります。Conceptually, the visual behavior of focus applied to a control should be coherent from element to element. 一貫性を実現する最も実用的な方法は、全体のテーマを作成する場合にのみフォーカス表示スタイルを変更します。The most sensible way to enforce coherence is to only change the focus visual style if you are composing an entire theme. 個々 のスタイルとテーマの一部ではなく、このプロパティを設定キーボード フォーカスに関するユーザー エクスペリエンスに混乱には、このプロパティの使用目的はありません。Setting this property on individual styles and not as part of a theme is not the intended usage of this property, because it may lead to a confusing user experience regarding keyboard focus. 入力状態の個々 のプロパティのスタイルでトリガーをなど、使用するはるかに優れた方法は、要素固有の動作は意図的に一貫性のあるテーマである場合、IsFocusedまたはIsKeyboardFocusWithinとにはない方法で実行するには視覚的に既存のフォーカス ビジュアル スタイルに干渉します。If you are intending element-specific behavior that is deliberately not coherent across a theme, a much better approach is to use triggers in styles for individual input state properties, such as IsFocused or IsKeyboardFocusWithin, and to do so in a way that does not visually interfere with any existing focus visual style. 目的で設計の詳細についてはFocusVisualStyleと代替プロパティの焦点は、「コントロール、および FocusVisualStyle フォーカスのスタイルします。For more information on the design intention of FocusVisualStyle and alternative focus properties, see Styling for Focus in Controls, and FocusVisualStyle.

XAML 属性の使用方法XAML Attribute Usage

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

XAML プロパティ要素の使用XAML Property Element Usage


次のいずれか: または。One of the following: , or . 参照してくださいXAML リソースします。See XAML Resources.

要求されているスタイルを識別するキー。The key that identifies the style being requested. このキーは、既存のリソースで、ResourceDictionaryします。The key refers to an existing resource in a ResourceDictionary.


プロパティ要素構文は技術的に可能であれば、推奨されません。Property element syntax is technically possible, but not recommended. 参照してくださいインライン スタイルおよびテンプレートします。See Inline Styles and Templates. 使用してバインディング参照TemplateBindingまたはBindingも可能ですが、一般的ではありません。A binding reference using TemplateBinding or Binding is also possible, but uncommon.

依存プロパティ情報Dependency Property Information

識別子フィールドです。Identifier field FocusVisualStyleProperty
メタデータのプロパティを設定するには trueMetadata properties set to true NoneNone