FrameworkContentElement.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 です。 ただし、実行時の有効値は、多くの場合、コントロールのテーマ サポートによって提供されたスタイルです (ただし、常にそうであるとは限りません)。

注釈

XAML でこのプロパティを設定する場合、スタイルはほとんどの場合、要素としてインラインではなくリソースとして定義され、そのリソースは通常 として StaticResourceExtension参照されます。

このプロパティは視覚的な外観に影響しますが、メタデータではレポートされないことに注意してください。 これは、視覚的な外観の変更はイベント ドリブンであり、常に適用されない可能性があるため、一般的にメタデータ内のビジュアルまたはレイアウト情報を報告しないようにするためです。

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

XAML 属性の使用方法

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

XAML プロパティ要素の使用

XAML 値

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

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

注意

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

依存プロパティ情報

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

適用対象