TreeWalker.Normalize Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die am nächsten zum angegebenen AutomationElement liegenden übergeordneten Elemente in der Strukturansicht ab, die in dieser Instanz von TreeWalker verwendet wird.
Überlädt
Normalize(AutomationElement) |
Ruft den Knoten selbst ab, wenn er die Condition erfüllt, oder den nächsten übergeordneten Knoten, der die Condition erfüllt. |
Normalize(AutomationElement, CacheRequest) |
Ruft den Knoten selbst ab, wenn er die Condition erfüllt, oder den nächsten übergeordneten Knoten, der die Condition erfüllt, und speichert Eigenschaften und Muster zwischen. |
Hinweise
Das Element wird normalisiert, indem die Vorgängerkette in der Struktur navigiert wird, bis ein Element, das die Ansichtsbedingung für das TreeWalker Objekt erfüllt, erreicht wird. Wenn das Stammelement erreicht ist, wird das Stammelement zurückgegeben, auch wenn es die Ansichtsbedingung nicht erfüllt.
Diese Methode ist nützlich für Anwendungen, die Verweise auf Benutzeroberflächenautomatisierung Elemente durch Treffertests abrufen. Die Anwendung möchte möglicherweise nur mit bestimmten Arten von Elementen arbeiten und kann verwenden Normalize , um sicherzustellen, dass unabhängig davon, welches Element zunächst abgerufen wird (z. B. wenn eine Bildlaufleiste den Eingabefokus erhält), nur das Element des Interesses (z. B. ein Inhaltselement) letztendlich abgerufen wird.
Normalize(AutomationElement)
public:
System::Windows::Automation::AutomationElement ^ Normalize(System::Windows::Automation::AutomationElement ^ element);
public System.Windows.Automation.AutomationElement Normalize (System.Windows.Automation.AutomationElement element);
member this.Normalize : System.Windows.Automation.AutomationElement -> System.Windows.Automation.AutomationElement
Public Function Normalize (element As AutomationElement) As AutomationElement
Parameter
- element
- AutomationElement
Das Element, bei dem die Normalisierung gestartet werden soll.
Gibt zurück
Das nächste AutomationElement in der aktuellen Ansicht. Wenn bei der Navigation in der Vorgängerkette nach oben das Stammelement erreicht wird, wird das Stammelement zurückgegeben.
Hinweise
Das Element wird normalisiert, indem die Vorgängerkette in der Struktur navigiert wird, bis ein Element, das die Ansichtsbedingung für das TreeWalker Objekt erfüllt, erreicht wird. Wenn das Stammelement erreicht ist, wird das Stammelement zurückgegeben, auch wenn es die Ansichtsbedingung nicht erfüllt.
Diese Methode ist nützlich für Anwendungen, die Verweise auf Benutzeroberflächenautomatisierung Elemente durch Treffertests abrufen. Die Anwendung möchte möglicherweise nur mit bestimmten Arten von Elementen arbeiten und kann verwenden Normalize , um sicherzustellen, dass unabhängig davon, welches Element zunächst abgerufen wird (z. B. wenn eine Bildlaufleiste den Eingabefokus erhält), nur das Element des Interesses (z. B. ein Inhaltselement) letztendlich abgerufen wird.
Siehe auch
- Übersicht über die Benutzeroberflächenautomatisierungs-Struktur
- Navigieren zwischen Benutzeroberflächenautomatisierungs-Elementen mit TreeWalker
- Abrufen von Benutzeroberflächenautomatisierungs-Elementen
Gilt für
Normalize(AutomationElement, CacheRequest)
public:
System::Windows::Automation::AutomationElement ^ Normalize(System::Windows::Automation::AutomationElement ^ element, System::Windows::Automation::CacheRequest ^ request);
public System.Windows.Automation.AutomationElement Normalize (System.Windows.Automation.AutomationElement element, System.Windows.Automation.CacheRequest request);
member this.Normalize : System.Windows.Automation.AutomationElement * System.Windows.Automation.CacheRequest -> System.Windows.Automation.AutomationElement
Public Function Normalize (element As AutomationElement, request As CacheRequest) As AutomationElement
Parameter
- element
- AutomationElement
Das Element, bei dem die Normalisierung gestartet werden soll.
- request
- CacheRequest
Ein Cacheanforderungsobjekt, das Eigenschaften und Muster für das zurückgegebene AutomationElement angibt, das zwischengespeichert werden soll.
Gibt zurück
Das nächste AutomationElement in der aktuellen Ansicht. Wenn bei der Navigation in der Vorgängerkette nach oben das Stammelement erreicht wird, wird das Stammelement zurückgegeben.
Hinweise
Das Element wird normalisiert, indem die Vorgängerkette in der Struktur navigiert wird, bis ein Element, das die Ansichtsbedingung für das TreeWalker Objekt erfüllt, erreicht wird. Wenn das Stammelement erreicht ist, wird das Stammelement zurückgegeben, auch wenn es die Ansichtsbedingung nicht erfüllt.
Diese Methode ist nützlich für Anwendungen, die Verweise auf Benutzeroberflächenautomatisierung Elemente durch Treffertests abrufen. Die Anwendung möchte möglicherweise nur mit bestimmten Arten von Elementen arbeiten und kann verwenden Normalize , um sicherzustellen, dass unabhängig davon, welches Element zunächst abgerufen wird (z. B. wenn eine Bildlaufleiste den Eingabefokus erhält), nur das Element des Interesses (z. B. ein Inhaltselement) letztendlich abgerufen wird.
Siehe auch
- Übersicht über die Benutzeroberflächenautomatisierungs-Struktur
- Navigieren zwischen Benutzeroberflächenautomatisierungs-Elementen mit TreeWalker
- Abrufen von Benutzeroberflächenautomatisierungs-Elementen