GettingFocusEventArgs.TrySetNewFocusedElement(DependencyObject) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
元のターゲット要素ではなく、指定した要素にフォーカスをリダイレクトしようとします。
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 ルーティング イベントは、フォーカスの変更が行われる前に発生します。これにより、アプリケーションでフォーカス変更の動作を変更またはキャンセルできます。
GettingFocus と LosingFocus は同期的に発生し、 GotFocus と LostFocus は非同期で発生します。 たとえば、アプリがコントロールの Focus メソッドを呼び出した場合、呼び出し中に GettingFocus が発生しますが、呼び出しの完了後に GotFocus が発生します。
これらのイベントがまだバブリングしている間にフォーカスが移動されると、例外がスローされます。