FrameworkElement.FocusVisualStyle プロパティ

定義

キーボード フォーカスをキャプチャするときにこの要素に適用される外観、効果、またはその他のスタイル特性のカスタマイズを可能にするプロパティを取得または設定します。

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 は報告しません。 これは、視覚的な外観の変更はイベントドリブンであり、常に適用されない可能性があるため、通常はメタデータ内のビジュアルまたはレイアウト情報を報告しないでください。

概念的には、コントロールに適用されるフォーカスの視覚的な動作は、コントロールからコントロールまで一貫している必要があります。 一貫性を強制する最も賢明な方法は、テーマ全体を作成する場合にのみフォーカスの表示スタイルを変更することです。 テーマの一部ではなく、個々のコントロール スタイルにこのプロパティを設定することは、キーボード フォーカスに関するユーザー エクスペリエンスを混乱させる可能性があるため、このプロパティの使用目的ではありません。 テーマ間で意図的に一貫性のないコントロール固有の動作を意図している場合は、 IsFocusedIsKeyboardFocusWithinなどの個々の入力状態プロパティのスタイルでトリガーを使用し、既存のフォーカス表示スタイルに視覚的に干渉しない方法でトリガーを使用することをお勧めします。 FocusVisualStyleおよび代替フォーカス プロパティの設計意図の詳細については、「コントロールでのフォーカスのスタイル設定」および「FocusVisualStyle」を参照してください。

XAML 属性の使用法

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

XAML プロパティ要素の使用法

XAML 値

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

styleResourceKey 要求されるスタイルを識別するキー。 キーは、 ResourceDictionary内の既存のリソースを参照します。

Note

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

依存関係プロパティ情報

品目 価値
識別子フィールド FocusVisualStyleProperty
に設定されたメタデータ プロパティ true None

適用対象

こちらもご覧ください