UIElement.IsFocused プロパティ


この要素に論理フォーカスがあるかどうかを判断する値を取得します。Gets a value that determines whether this element has logical focus. これは依存関係プロパティです。This is a dependency property.

 property bool IsFocused { bool get(); };
public bool IsFocused { get; }
member this.IsFocused : bool
Public ReadOnly Property IsFocused As Boolean



この要素に論理フォーカスがある場合は true。それ以外の場合は falsetrue if this element has logical focus; otherwise, false.

次の例は、フォーカスされたときにコントロールの背景を変更するコードハンドラーです。The following example is a code handler that changes the background of a control when it is focused.

private void setColors(object sender, RoutedEventArgs e)
    if (myTextBox.IsFocused) myTextBox.Foreground = Brushes.Brown;

これと同じ効果を得るためのもう1つの一般的な方法は、をコントロールのに配置することです Trigger Style 。この方法では、分離コードで特定のイベントを処理する必要はありません。また、デザイナーは、UI の対話形式とグラフィカルな性質によりアクセスできるようになります。Another common way to achieve this same effect is to place a Trigger in the Style of a control; this approach does not require handling specific events with code-behind and allows designers greater access to the interactive and graphical nature of the UI. 例については、「 方法: 外側のグロー効果を作成する」を参照してください。For an example, see How to: Create an Outer Glow Effect.


アプリケーションに複数のフォーカス区分 (メニューコンテンツとアプリケーションの残りの部分など) がある場合、論理フォーカスはキーボードフォーカスとは異なる場合があります。Logical focus might differ from keyboard focus if an application has multiple focus divisions, such as between menu contents and the remainder of the application. このシナリオでは、キーボードフォーカスはアプリケーション UI の1つの要素にしか配置できませんが、他のフォーカス区分内の特定の要素は引き続き論理フォーカスを保持する場合があります。In this scenario, keyboard focus can only be on one element of the application UI, however, certain elements in other focus divisions might still retain logical focus. 論理フォーカスの詳細については、「 フォーカスの概要」を参照してください。For more information on logical focus, see Focus Overview.

このプロパティを設定することによってフォーカスを設定しません (読み取り専用)。You do not set focus by setting this property (it is read-only). このプロパティの一般的な使用方法は、またはの依存関係プロパティとして使用することです Setter EventTriggerThe typical use for this property is to use it as a dependency property for a Setter or EventTrigger. プログラムによってフォーカスを設定するには、を呼び出し Focus ます。To set focus programmatically, call Focus. フォーカスは、ユーザー操作またはコントロールの実装によって設定することもできます。これには、マウスキャプチャの動作が含まれる可能性があります。Focus can also be set by user action or by control implementations, which possibly include mouse capture behavior.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field IsFocusedProperty
メタデータプロパティがに設定される trueMetadata properties set to true なしNone