UIElement.IsFocused プロパティ

定義

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

public:
 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つの一般的な方法は、コントロールの StyleTrigger を配置することです。この方法では、分離コードを使用して特定のイベントを処理する必要はありません。また、デザイナーでは、UIUIの対話形式とグラフィカルな性質によりアクセスできます。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 UIUI. 例については、「方法: 光彩 (外側) の効果を作成します。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 または EventTriggerの依存関係プロパティとして使用することです。The 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
メタデータプロパティが true に設定されるMetadata properties set to true なしNone

適用対象

こちらもご覧ください