Language

UIElement3D.Focus メソッド

定義

この要素に論理フォーカスを設定しようとします。

public:
 virtual bool Focus();
public bool Focus();
abstract member Focus : unit -> bool
override this.Focus : unit -> bool
Public Function Focus () As Boolean

戻り値

true 論理フォーカスとキーボード フォーカスの両方がこの要素に設定されている場合。論理フォーカスのみが設定された場合に false します。

実装

注釈

フォーカス可能にするには、 Focusable と IsEnabled の両方を trueする必要があります。

要素がフォーカス可能で有効な場合でも、特定のツリー内のイベント処理 (複合コントロールなど) は、フォーカスを許可しないことによってプレビュー フォーカス イベントに応答する可能性があるため、このメソッドは falseを返します。

呼び出し Focus が trueを返す場合、 IsKeyboardFocused と IsKeyboardFocusWithin も true。

関連するプロパティがまだ trueされていない場合は、 Focusを呼び出すと、 PreviewLostKeyboardFocus、 PreviewGotKeyboardFocus (ソースは新しいフォーカス ターゲット)、 IsKeyboardFocusedChanged、 IsKeyboardFocusWithinChanged、 LostKeyboardFocus、 GotKeyboardFocus (ソースは新しいフォーカス ターゲット) の順序で 1 つ以上のイベントが発生します。

この呼び出しを成功させるには、アプリケーション内の他の要素に以前にフォーカスを置く必要があります。

フォーカスは一般に、キーボード フォーカスと論理フォーカスという 2 つの異なる概念によって管理されます。これは常に同じとは限りません。 このメソッドは、論理フォーカスを設定し、キーボード フォーカスの設定も試みます。 キーボード フォーカスを具体的に設定するプログラムによる手段はありません。これは、ユーザー入力が原因で発生します。 詳細については、「 入力の概要」を参照してください。

適用対象