UIElement.Focusable プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
要素がフォーカスを得ることができるかどうかを示す値を取得または設定します。 これは依存関係プロパティです。
public:
property bool Focusable { bool get(); void set(bool value); };
public bool Focusable { get; set; }
member this.Focusable : bool with get, set
Public Property Focusable As Boolean
プロパティ値
要素がフォーカス可能な場合は、true
。それ以外の場合は、false
。 既定値は、false
です。
実装
例
次のコード例は、特定のカスタム コントロールのコントロール テンプレートを示しています。このコントロールは、テンプレート内のいずれかの要素に設定Focusablefalse
されます。
<Window.Resources>
<Style x:Key="TextBoxNoScrollViewer" TargetType="{x:Type TextBoxBase}">
<Setter Property="Template">
<Setter.Value>
<ControlTemplate TargetType="{x:Type TextBoxBase}">
<Border
CornerRadius="2"
Background="{TemplateBinding Background}"
BorderThickness="{TemplateBinding BorderThickness}"
BorderBrush="{TemplateBinding BorderBrush}"
>
<!--
The control template for a TextBox or RichTextBox must
include an element tagged as the content host. An element is
tagged as the content host element when it has the special name
PART_ContentHost. The content host element must be a ScrollViewer,
or an element that derives from Decorator.
-->
<AdornerDecorator
x:Name="PART_ContentHost"
Focusable="False"
/>
</Border>
</ControlTemplate>
</Setter.Value>
</Setter>
</Style>
</Window.Resources>
注釈
フォーカスされた要素のみがキーボード入力を受け取ります。
Focusable は、実際には依存関係プロパティの Microsoft .NET プロパティ アクセサーです。 この特定の依存関係プロパティは、派生要素クラス、特にコントロールでは、明らかな "既定" 値が異なる方法で設定されることが非常に多いです。 これは通常、次の 2 つの方法のいずれかで発生します。
依存関係プロパティは特定の派生クラスによって継承されますが、その派生クラスは依存関係プロパティのメタデータをオーバーライドし、プロパティの既定値を変更します。
スタイルまたはテンプレートが要素に適用され、依存関係プロパティの値が異なる方法で設定されます。
たとえば、コントロールの Focusable Button "既定値" はtrue
、共通言語ランタイム (CLR) プロパティとして直接UIElement継承Focusableされる場合Buttonでも、次のようになります。 これは、依存関係プロパティに適用されたメタデータ値 Focusable が基底クラスの Control 静的コンストラクター内でオーバーライドされたためです。これは、クラス階層の間 Button と UIElement 階層内にあります。
派生クラスまたはその派生クラスによって Control 継承された場合は、 Control このプロパティの既定値を再定義します true
。
(派生クラス) Control によってLabel継承された場合、既定値は再び再定義されますfalse
。
依存プロパティ情報
識別子フィールド | FocusableProperty |
に設定されたメタデータ プロパティ true |
なし |
注意 (継承者)
(要素からではなくControl) 直接派生UIElementする場合は、既定では要素がフォーカス可能ではないため、要素をフォーカス可能にするかどうかを検討してください。 要素をフォーカス可能にする場合は、次のように型の静的コンストラクター内でこのプロパティのメタデータをオーバーライドします。
FocusableProperty.OverrideMetadata(typeof(myElement), new UIPropertyMetadata(true));
ここで myElement
、メタデータ値をオーバーライドする型のクラス名にする必要があります。