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 属性の使用方法

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

XAML プロパティ要素の使用

XAML 値

resourceExtension
次のいずれか: または . 「XAML リソース」を参照してください。

styleResourceKey
要求されるスタイルを識別するキー。 キーは、 ResourceDictionary.

注意

プロパティ要素の構文は技術的には可能ですが、推奨されません。 「 インライン スタイルとテンプレート」を参照してください。 TemplateBinding を使用したバインディング参照、またはBinding可能ですが、一般的ではありません。

依存プロパティ情報
識別子フィールド FocusVisualStyleProperty
に設定されたメタデータ プロパティ true なし

適用対象

こちらもご覧ください