AutomationProperties.GetFlowsTo(DependencyObject) Methode

Definition

Namespace:

Windows.UI.Xaml.Automation

Ruft eine Liste von Automatisierungselementen ab, die die Lesereihenfolge nach dem angegebenen Automatisierungselement vorschlägt.

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)

Parameter

element

DependencyObject

Das Element, für das die folgenden Elemente der Lesereihenfolge abgerufen werden sollen.

Gibt zurück

IVector<DependencyObject>

IList<DependencyObject>

Eine Liste von Automatisierungselementen, die die Lesereihenfolge nach dem durch den Elementparameter angegebenen automation-Element vorschlägt.

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Beispiele

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

Hinweise

Rufen Sie die Liste ab, und rufen Sie dann die Add-Methode auf, um ein neues Element hinzuzufügen.

Wichtig

Achten Sie beim Ändern des Flows darauf, keine Situation zu erstellen, in der der Benutzer in einer Navigationsschleife stecken bleibt, die er nicht escapen kann, wenn er nur eine Tastatur verwendet.