Share via


FocusManager.TryMoveFocus Metode

Definisi

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);
 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

Parameter

focusNavigationDirection
FocusNavigationDirection

Arah untuk melintasi (dalam urutan tab).

Mengembalikan

Boolean

bool

true jika fokus dipindahkan; jika tidak, salah.

Atribut

Keterangan

Urutan tab adalah urutan pengguna berpindah dari satu kontrol ke kontrol lainnya 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 fokus berada 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 (hanya navigasi arah, tidak dapat digunakan untuk meniru navigasi tab).

Catatan

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

Lihat juga

Berlaku untuk

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, salah.

Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 Creators Update (diperkenalkan dalam 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v4.0)

Keterangan

Urutan tab adalah urutan pengguna berpindah dari satu kontrol ke kontrol lainnya 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 fokus berada 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 (hanya navigasi arah, tidak dapat digunakan untuk meniru navigasi tab).

Catatan

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

Lihat juga

Berlaku untuk