FocusManager.TryMoveFocus メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| TryMoveFocus(FocusNavigationDirection) |
フォーカスのある要素から、指定した方向の次のフォーカス可能な要素にフォーカスを変更しようとします。 |
| TryMoveFocus(FocusNavigationDirection, FindNextElementOptions) |
指定したナビゲーション オプションを使用して、フォーカスのある要素から、指定した方向の次のフォーカス可能な要素にフォーカスを変更しようとします。 |
TryMoveFocus(FocusNavigationDirection)
フォーカスのある要素から、指定した方向の次のフォーカス可能な要素にフォーカスを変更しようとします。
public:
static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection); static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);[Windows.Foundation.Metadata.Overload("TryMoveFocus")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);function tryMoveFocus(focusNavigationDirection)Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection) As Booleanパラメーター
- focusNavigationDirection
- FocusNavigationDirection
移動する方向 (タブ オーダー)。
戻り値
bool
フォーカスが移動した場合は true。それ以外の場合は false。
- 属性
注釈
タブ オーダーは、ユーザーが Tab キー (前方) または Shift + Tab (後方) を押して、あるコントロールから別のコントロールに移動する順序です。
このメソッドは、タブ オーダー シーケンスと動作を使用して、UI 内のすべてのフォーカス可能な要素を走査します。
フォーカスがタブ オーダーの最初の要素にあり、 FocusNavigationDirection.Previous が指定されている場合、フォーカスは最後の要素に移動します。
フォーカスがタブ オーダーの最後の要素にあり、 FocusNavigationDirection.Next が指定されている場合、フォーカスは最初の要素に移動します。
FindNextElement(FocusNavigationDirection, FindNextElementOptions) メソッドまたは FindNextElement(FocusNavigationDirection) メソッドを使用して、プログラムによってフォーカスを移動することもできます。 これらのメソッドは、指定したナビゲーション方向に基づいてフォーカスを受け取る要素 ( DependencyObject として) を取得します (方向ナビゲーションのみ、タブ ナビゲーションのエミュレートには使用できません)。
注意
FindNextFocusableElement は UIElement を取得するため、FindNextFocusableElement の代わりに FindNextElement メソッドを使用することをお勧めします。これは、次のフォーカス可能な要素が UIElement ( Hyperlink オブジェクトなど) でない場合は null を返します。
こちらもご覧ください
- TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)
- キーボード操作
- キーボード、ゲームパッド、リモコン、アクセシビリティ ツールのフォーカス ナビゲーション
- プログラムによるフォーカス ナビゲーション
適用対象
TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)
指定したナビゲーション オプションを使用して、フォーカスのある要素から、指定した方向の次のフォーカス可能な要素にフォーカスを変更しようとします。
public:
static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions ^ focusNavigationOptions);/// [Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection, FindNextElementOptions const& focusNavigationOptions);[Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions focusNavigationOptions);function tryMoveFocus(focusNavigationDirection, focusNavigationOptions)Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection, focusNavigationOptions As FindNextElementOptions) As Booleanパラメーター
- focusNavigationDirection
- FocusNavigationDirection
移動する方向 (タブ オーダー)。
- focusNavigationOptions
- FindNextElementOptions
キーボード/コントローラー/リモート ナビゲーションを使用してフォーカスを受け取る次の要素を識別するのに役立つオプション。
戻り値
bool
フォーカスが移動した場合は true。それ以外の場合は false。
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 Creators Update (10.0.15063.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v4.0 で導入)
|
注釈
タブ オーダーは、ユーザーが Tab キー (前方) または Shift + Tab (後方) を押して、あるコントロールから別のコントロールに移動する順序です。
このメソッドは、タブ オーダー シーケンスと動作を使用して、UI 内のすべてのフォーカス可能な要素を走査します。
フォーカスがタブ オーダーの最初の要素にあり、 FocusNavigationDirection.Previous が指定されている場合、フォーカスは最後の要素に移動します。
フォーカスがタブ オーダーの最後の要素にあり、 FocusNavigationDirection.Next が指定されている場合、フォーカスは最初の要素に移動します。
FindNextElement(FocusNavigationDirection, FindNextElementOptions) メソッドまたは FindNextElement(FocusNavigationDirection) メソッドを使用して、プログラムによってフォーカスを移動することもできます。 これらのメソッドは、指定したナビゲーション方向に基づいてフォーカスを受け取る要素 ( DependencyObject として) を取得します (方向ナビゲーションのみ、タブ ナビゲーションのエミュレートには使用できません)。
注意
FindNextFocusableElement は UIElement を取得するため、FindNextFocusableElement の代わりに FindNextElement メソッドを使用することをお勧めします。これは、次のフォーカス可能な要素が UIElement ( Hyperlink オブジェクトなど) でない場合は null を返します。
こちらもご覧ください
- TryMoveFocus(FocusNavigationDirection)
- キーボード操作
- キーボード、ゲームパッド、リモコン、アクセシビリティ ツールのフォーカス ナビゲーション
- プログラムによるフォーカス ナビゲーション