XamlSourceFocusNavigationRequest Constructors

  • Reference

Definition

Namespace:
Microsoft.UI.Xaml.Hosting

Overloads

XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason)

Initializes a new instance of a XamlSourceFocusNavigationRequest object for the the specified navigation request reason.
XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason, Rect)

Initializes a new instance of a XamlSourceFocusNavigationRequest object for the the specified navigation request reason and the bounding rectangle that will receive navigation focus.
XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason, Rect, Guid)

Initializes a new instance of the XamlSourceFocusNavigationRequest class with the reason for the navigation request, the bounding rectangle that will receive navigation focus, and the unique correlation ID for the request.

Initializes a new instance of a XamlSourceFocusNavigationRequest object for the the specified navigation request reason, the bounding rectangle that will receive navigation focus, and the unique correlation ID for the request.

XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason)

Edit

Initializes a new instance of a XamlSourceFocusNavigationRequest object for the the specified navigation request reason.

public:
 XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason reason);
 XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason const& reason);
public XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason reason);
function XamlSourceFocusNavigationRequest(reason)
Public Sub New (reason As XamlSourceFocusNavigationReason)

Parameters

reason
XamlSourceFocusNavigationReason

The reason for the navigation request.

Applies to

XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason, Rect)

Edit

Initializes a new instance of a XamlSourceFocusNavigationRequest object for the the specified navigation request reason and the bounding rectangle that will receive navigation focus.

public:
 XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason reason, Rect hintRect);
 XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason const& reason, Rect const& hintRect);
public XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason reason, Rect hintRect);
function XamlSourceFocusNavigationRequest(reason, hintRect)
Public Sub New (reason As XamlSourceFocusNavigationReason, hintRect As Rect)

Parameters

reason
XamlSourceFocusNavigationReason

The reason for the navigation request.

hintRect
Rect

The bounding rectangle of the element in the desktop application that is losing focus (that is, the element that had focus before the DesktopWindowXamlSource received focus). This parameter is used to provide context to the WinUI XAML framework when the user enters the DesktopWindowXamlSource using a 4-direction navigation experience, such as the keyboard arrow keys.

Remarks

An example use case for this object is where there are three WPF buttons to the left of the DesktopWindowXamlSource and there are three WinUI buttons inside the DesktopWindowXamlSource (a total of six buttons in a 3x2 grid across two UI frameworks). When the user presses the right arrow on the keyboard from the middle WPF button, focus should move to the middle WinUI button in the DesktopWindowXamlSource. To accomplish this, pass the bounding rectangle of the middle WPF button to the hintRect parameter and specify Right for the reason parameter.

Applies to

XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason, Rect, Guid)

Edit

Initializes a new instance of the XamlSourceFocusNavigationRequest class with the reason for the navigation request, the bounding rectangle that will receive navigation focus, and the unique correlation ID for the request.

Initializes a new instance of a XamlSourceFocusNavigationRequest object for the the specified navigation request reason, the bounding rectangle that will receive navigation focus, and the unique correlation ID for the request.

public:
 XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason reason, Rect hintRect, Platform::Guid correlationId);
 XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason const& reason, Rect const& hintRect, winrt::guid const& correlationId);
public XamlSourceFocusNavigationRequest(XamlSourceFocusNavigationReason reason, Rect hintRect, Guid correlationId);
function XamlSourceFocusNavigationRequest(reason, hintRect, correlationId)
Public Sub New (reason As XamlSourceFocusNavigationReason, hintRect As Rect, correlationId As Guid)

Parameters

reason
XamlSourceFocusNavigationReason

The reason for the navigation request.

hintRect
Rect

The bounding rectangle of the element in the desktop application that is losing focus (that is, the element that had focus before the DesktopWindowXamlSource received focus). This parameter is used to provide context to the WinUI XAML framework when the user enters the DesktopWindowXamlSource using a 4-direction navigation experience, such as the keyboard arrow keys.

correlationId
Guid

Platform::Guid

winrt::guid

The unique identifier for the navigation request. You can use this parameter for logging purposes, or if you have an existing correlation ID from an in-progress focus movement already in progress and you want to connect that focus movement with the current navigation request.

Remarks

An example use case for this object is where there are three WPF buttons to the left of the DesktopWindowXamlSource and there are three WinUI buttons inside the DesktopWindowXamlSource (a total of six buttons in a 3x2 grid across two UI frameworks). When the user presses the right arrow on the keyboard from the middle WPF button, focus should move to the middle WinUI button in the DesktopWindowXamlSource. To accomplish this, pass the bounding rectangle of the middle WPF button to the hintRect parameter and specify Right for the reason parameter.

Applies to