FocusManager.TryMoveFocus Metode

Definisi

Ruang nama:

Microsoft.UI.Xaml.Input

Overload

TryMoveFocus(FocusNavigationDirection)	Mencoba mengubah fokus dari elemen dengan fokus ke elemen yang dapat difokuskan berikutnya ke arah yang ditentukan.
TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)	Mencoba mengubah fokus dari elemen dengan fokus ke elemen yang dapat difokuskan berikutnya ke arah yang ditentukan, menggunakan opsi navigasi yang ditentukan.

TryMoveFocus(FocusNavigationDirection)

Mencoba mengubah fokus dari elemen dengan fokus ke elemen yang dapat difokuskan berikutnya ke arah yang ditentukan.

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);

/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);

[Windows.Foundation.Metadata.Overload("TryMoveFocus")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);

function tryMoveFocus(focusNavigationDirection)

Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection) As Boolean

Parameter

focusNavigationDirection

FocusNavigationDirection

Arah untuk melintasi (dalam urutan tab).

Mengembalikan

Boolean

bool

true jika fokus dipindahkan; jika tidak, false.

Atribut

OverloadAttribute

Keterangan

Urutan tab adalah urutan di mana pengguna berpindah dari satu kontrol ke kontrol lain dengan menekan tombol Tab (maju) atau Shift+Tab (mundur).

Metode ini menggunakan urutan dan perilaku urutan tab untuk melintasi semua elemen yang dapat difokuskan di UI.

• Jika fokusnya adalah pada elemen pertama dalam urutan tab dan FocusNavigationDirection.Previous ditentukan, fokus berpindah ke elemen terakhir.
• Jika fokusnya adalah pada elemen terakhir dalam urutan tab dan FocusNavigationDirection.Next ditentukan, fokus berpindah ke elemen pertama.

Anda juga dapat menggunakan metode FindNextElement(FocusNavigationDirection, FindNextElementOptions) atau metode FindNextElement(FocusNavigationDirection) untuk memindahkan fokus secara terprogram. Metode ini mengambil elemen (sebagai DependencyObject) yang akan menerima fokus berdasarkan arah navigasi yang ditentukan (navigasi arah saja, tidak dapat digunakan untuk meniru navigasi tab).

Catatan

Sebaiknya gunakan metode FindNextElement alih-alih FindNextFocusableElement karena FindNextFocusableElement mengambil UIElement, yang mengembalikan jika elemen yang dapat difokuskan null berikutnya bukan UIElement (seperti objek Hyperlink ).

Lihat juga

• TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)
• Interaksi keyboard
• Navigasi fokus untuk keyboard, gamepad, remote control, dan alat aksesibilitas
• Navigasi fokus terprogram

TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

Mencoba mengubah fokus dari elemen dengan fokus ke elemen yang dapat difokuskan berikutnya ke arah yang ditentukan, menggunakan opsi navigasi yang ditentukan.

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

Parameter

focusNavigationDirection

FocusNavigationDirection

Arah untuk melintasi (dalam urutan tab).

focusNavigationOptions

FindNextElementOptions

Opsi untuk membantu mengidentifikasi elemen berikutnya untuk menerima fokus dengan keyboard/pengontrol/navigasi jarak jauh.

Mengembalikan

Boolean

bool

true jika fokus dipindahkan; jika tidak, false.

Atribut

OverloadAttribute

Keterangan

Urutan tab adalah urutan di mana pengguna berpindah dari satu kontrol ke kontrol lain dengan menekan tombol Tab (maju) atau Shift+Tab (mundur).

Metode ini menggunakan urutan dan perilaku urutan tab untuk melintasi semua elemen yang dapat difokuskan di UI.

• Jika fokusnya adalah pada elemen pertama dalam urutan tab dan FocusNavigationDirection.Previous ditentukan, fokus berpindah ke elemen terakhir.
• Jika fokusnya adalah pada elemen terakhir dalam urutan tab dan FocusNavigationDirection.Next ditentukan, fokus berpindah ke elemen pertama.

Anda juga dapat menggunakan metode FindNextElement(FocusNavigationDirection, FindNextElementOptions) atau metode FindNextElement(FocusNavigationDirection) untuk memindahkan fokus secara terprogram. Metode ini mengambil elemen (sebagai DependencyObject) yang akan menerima fokus berdasarkan arah navigasi yang ditentukan (navigasi arah saja, tidak dapat digunakan untuk meniru navigasi tab).

Catatan

Sebaiknya gunakan metode FindNextElement alih-alih FindNextFocusableElement karena FindNextFocusableElement mengambil UIElement, yang mengembalikan jika elemen yang dapat difokuskan null berikutnya bukan UIElement (seperti objek Hyperlink ).

Lihat juga

• TryMoveFocus(FocusNavigationDirection)
• Interaksi keyboard
• Navigasi fokus untuk keyboard, gamepad, remote control, dan alat aksesibilitas
• Navigasi fokus terprogram