Share via


AutomationProperties.GetFlowsTo(DependencyObject) Method

Definition

Gets a list of automation elements that suggests the reading order after the specified automation element.

public:
 static IVector<DependencyObject ^> ^ GetFlowsTo(DependencyObject ^ element);
 static IVector<DependencyObject> GetFlowsTo(DependencyObject const& element);
public static IList<DependencyObject> GetFlowsTo(DependencyObject element);
function getFlowsTo(element)
Public Shared Function GetFlowsTo (element As DependencyObject) As IList(Of DependencyObject)

Parameters

element
DependencyObject

The element for which to get the following reading order elements.

Returns

A list of automation elements that suggests the reading order after the automation element specified by the element parameter.

Windows requirements

Device family
Windows 10 Anniversary Edition (introduced in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v3.0)

Examples

<StackPanel>
    <Button x:Name="first">First</Button>
    <Button x:Name="third">Third</Button>
    <Button x:Name="second">Second</Button>
    <Button x:Name="fourth">Fourth</Button>
</StackPanel>
public sealed partial class MainPage : Page
{
    public MainPage()
    {
        this.InitializeComponent();

        // Override the default flow for next/previous items in 
        // UI Automation to differ from the sequence of items 
        // declared in markup
        FlowBetween(first, second);
        FlowBetween(second, third);
        FlowBetween(third, fourth);
    }

    public void FlowBetween(UIElement fromElement, UIElement toElement)
    {
        // Set up the flow as bi-directional so that moving next/previous is
        // consistent.
        var flowsToList = AutomationProperties.GetFlowsTo(fromElement);
        var flowsFromList = AutomationProperties.GetFlowsFrom(toElement);

        flowsToList.Add(toElement);
        flowsFromList.Add(fromElement);
    }
}

Remarks

Get the list, then call the Add method to add a new element.

Important

When modifying the flow, be careful not to create a situation where the user gets stuck in a navigation loop that they can't escape if they are only using a keyboard.

Applies to