UIElement.Focusable プロパティ

定義

要素がフォーカスを得ることができるかどうかを示す値を取得または設定します。 これは依存関係プロパティです。

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

プロパティ値

Boolean

要素がフォーカス可能な場合は、true。それ以外の場合は、false。 既定値は、false です。

実装

次のコード例は、特定のカスタム コントロールのコントロール テンプレートを示しています。このコントロールは、テンプレート内の要素の 1 Focusable false つを設定します。

<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 つの方法の 1 つで発生します。

  • 依存関係プロパティは特定の派生クラスによって継承されますが、その派生クラスは依存関係プロパティのメタデータをオーバーライドし、プロパティの既定値を変更します。

  • スタイルまたはテンプレートが要素に適用され、依存関係プロパティの値が異なる方法で設定されます。

たとえば、コントロールのの明らかな "既定値" は になりますが、 は から直接共通言語ランタイム Focusable Button (CLR) プロパティとして true Button Focusable 継承されます UIElement 。 これは、依存関係プロパティに適用されたメタデータ値が、クラス階層内の と の間に位置する基本クラスの静的コンストラクター内でオーバーライドされた Focusable Control Button UIElement ためです。

または 派生クラスによって継承された場合、このプロパティの既定値を Control Control に再定義します true

(派生クラス) によって継承された場合、既定値は に Label Control 再定義されます false

依存プロパティ情報

識別子フィールド FocusableProperty
メタデータ プロパティが に設定されている true なし

注意 (継承者)

から直接 (からではなく) から派生する場合は、要素をフォーカス可能にするかどうかを検討してください。既定では、要素はフォーカス可能ではないので UIElement Control です。 要素をフォーカス可能にしたい場合は、型の静的コンストラクター内のこのプロパティのメタデータを次のようにオーバーライドします。

FocusableProperty.OverrideMetadata(typeof(myElement), new UIPropertyMetadata(true));

myElement 、メタデータ値をオーバーライドする型のクラス名である必要があります。

適用対象

こちらもご覧ください