FrameworkElement.FocusVisualStyle プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この要素がキーボード フォーカスを受け取ったときに適用される外観、効果、またはその他のスタイル特性のカスタマイズを可能にするプロパティを取得または設定します。
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 されません。 これは、外観の変更はイベントドリブンであり、常に適用されない可能性があるため、通常はメタデータ内のビジュアルまたはレイアウト情報を報告しないでください。
概念的には、コントロールに適用されるフォーカスの視覚的な動作は、コントロールからコントロールまで一貫している必要があります。 一貫性を強制する最も賢明な方法は、テーマ全体を作成している場合にのみフォーカスの表示スタイルを変更することです。 このプロパティをテーマの一部としてではなく、個々のコントロール スタイルに設定することは、キーボード フォーカスに関するユーザー エクスペリエンスが混乱する可能性があるため、このプロパティの使用目的ではありません。 テーマ間で意図的に一貫性のないコントロール固有の動作を意図している場合は、個々の入力状態プロパティ (たとえば IsFocused 、または IsKeyboardFocusWithin) のスタイルでトリガーを使用し、既存のフォーカス表示スタイルに視覚的に干渉しない方法でトリガーを使用することをお勧めします。 デザインの意図と代替フォーカス プロパティの FocusVisualStyle 詳細については、「 コントロールのフォーカスのスタイル設定」および「FocusVisualStyle」を参照してください。
XAML 属性の使用方法
<object FocusVisualStyle="{resourceExtension styleResourceKey}"/>
XAML プロパティ要素の使用
XAML 値
resourceExtension
次のいずれか: または . 「XAML リソース」を参照してください。
styleResourceKey
要求されるスタイルを識別するキー。 キーは、 ResourceDictionary.
注意
プロパティ要素の構文は技術的には可能ですが、推奨されません。 「 インライン スタイルとテンプレート」を参照してください。 TemplateBinding を使用したバインディング参照、またはBinding可能ですが、一般的ではありません。
依存プロパティ情報
識別子フィールド | FocusVisualStyleProperty |
に設定されたメタデータ プロパティ true |
なし |