GettingFocusEventArgs.TrySetNewFocusedElement(DependencyObject) メソッド

定義

元のターゲット要素ではなく、指定した要素にフォーカスをリダイレクトしようとします。

public:
 virtual bool TrySetNewFocusedElement(DependencyObject ^ element) = TrySetNewFocusedElement;
bool TrySetNewFocusedElement(DependencyObject const& element);
public bool TrySetNewFocusedElement(DependencyObject element);
function trySetNewFocusedElement(element)
Public Function TrySetNewFocusedElement (element As DependencyObject) As Boolean

パラメーター

element
DependencyObject

フォーカスを設定するオブジェクト。

戻り値

Boolean

bool

True を指定すると、フォーカス アクションがリダイレクトされます。それ以外の場合は false。

Windows の要件

デバイス ファミリ
Windows 10, version 1803 (10.0.17134.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v6.0 で導入)

注釈

GotFocus ルーティング イベントは、フォーカスを受け取った後に要素で発生し、LostFocus ルーティング イベントはフォーカスを失った後に要素で発生します。

GettingFocus および LosingFocus ルーティング イベントは、フォーカスの変更が行われる前に発生します。これにより、アプリケーションでフォーカス変更の動作を変更またはキャンセルできます。

GettingFocusLosingFocus は同期的に発生し、 GotFocusLostFocus は非同期で発生します。 たとえば、アプリがコントロールの Focus メソッドを呼び出した場合、呼び出し中に GettingFocus が発生しますが、呼び出しの完了後に GotFocus が発生します。

これらのイベントがまだバブリングしている間にフォーカスが移動されると、例外がスローされます。

適用対象

こちらもご覧ください