Share via


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。

注釈

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

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

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

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

適用対象

こちらもご覧ください