TreeWalker.GetParent Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Načte nadřazený prvek zadaného AutomationElementobjektu .
Přetížení
GetParent(AutomationElement) |
Načte nadřazený prvek zadaného AutomationElementobjektu . |
GetParent(AutomationElement, CacheRequest) |
Načte nadřazený prvek zadaných AutomationElement a ukládá do mezipaměti vlastnosti a vzory. |
Poznámky
Struktura stromu se AutomationElement mění při změně viditelných prvků uživatelského rozhraní (UI) na ploše. Není zaručeno, že prvek vrácený jako nadřazený prvek bude vrácen jako nadřazený při následných průchodech.
GetParent(AutomationElement)
Načte nadřazený prvek zadaného AutomationElementobjektu .
public:
System::Windows::Automation::AutomationElement ^ GetParent(System::Windows::Automation::AutomationElement ^ element);
public System.Windows.Automation.AutomationElement GetParent (System.Windows.Automation.AutomationElement element);
member this.GetParent : System.Windows.Automation.AutomationElement -> System.Windows.Automation.AutomationElement
Public Function GetParent (element As AutomationElement) As AutomationElement
Parametry
- element
- AutomationElement
Prvek, jehož nadřazený objekt má být vrácen.
Návraty
Nadřazený element nebo odkaz s hodnotou null (Nothing
v jazyce Visual Basic), pokud je zadaný element kořenovým prvkem ve stromu nebo pokud nadřazený prvek není viditelný v aktuálním zobrazení.
Příklady
Následující příklad ukazuje GetParent použití k vyhledání prvku okna, který obsahuje zadaný prvek.
/// <summary>
/// Retrieves the top-level window that contains the specified UI Automation element.
/// </summary>
/// <param name="element">The contained element.</param>
/// <returns>The containing top-level window element.</returns>
private AutomationElement GetTopLevelWindow(AutomationElement element)
{
TreeWalker walker = TreeWalker.ControlViewWalker;
AutomationElement elementParent;
AutomationElement node = element;
if (node == elementRoot) return node;
do
{
elementParent = walker.GetParent(node);
if (elementParent == AutomationElement.RootElement) break;
node = elementParent;
}
while (true);
return node;
}
''' <summary>
''' Retrieves the top-level window that contains the specified UI Automation element.
''' </summary>
''' <param name="element">The contained element.</param>
''' <returns>The containing top-level window element.</returns>
Private Function GetTopLevelWindow(ByVal element As AutomationElement) As AutomationElement
Dim walker As TreeWalker = TreeWalker.ControlViewWalker
Dim elementParent As AutomationElement
Dim node As AutomationElement = element
If node = elementRoot Then
Return node
End If
Do
elementParent = walker.GetParent(node)
If elementParent = AutomationElement.RootElement Then
Exit Do
End If
node = elementParent
Loop While True
Return node
End Function 'GetTopLevelWindow
End Class
Viz také
- Přehled stromu automatizace uživatelského rozhraní
- Pohyb mezi elementy automatizace uživatelského rozhraní pomocí třídy TreeWalker
- Získání elementů automatizace uživatelského rozhraní
Platí pro
GetParent(AutomationElement, CacheRequest)
Načte nadřazený prvek zadaných AutomationElement a ukládá do mezipaměti vlastnosti a vzory.
public:
System::Windows::Automation::AutomationElement ^ GetParent(System::Windows::Automation::AutomationElement ^ element, System::Windows::Automation::CacheRequest ^ request);
public System.Windows.Automation.AutomationElement GetParent (System.Windows.Automation.AutomationElement element, System.Windows.Automation.CacheRequest request);
member this.GetParent : System.Windows.Automation.AutomationElement * System.Windows.Automation.CacheRequest -> System.Windows.Automation.AutomationElement
Public Function GetParent (element As AutomationElement, request As CacheRequest) As AutomationElement
Parametry
- element
- AutomationElement
Prvek, jehož nadřazený objekt má být vrácen.
- request
- CacheRequest
Objekt požadavku na mezipaměť určující členy vrácených AutomationElement do mezipaměti.
Návraty
Nadřazený element nebo odkaz s hodnotou null (Nothing
v jazyce Visual Basic), pokud je zadaný element kořenovým elementem ve stromu nebo nadřazený prvek není v tomto zobrazení viditelný.
Poznámky
Struktura stromu se AutomationElement mění při změně viditelných prvků uživatelského rozhraní (UI) na ploše. Není zaručeno, že prvek vrácený jako nadřazený prvek bude vrácen jako nadřazený při následných průchodech.
Viz také
- Přehled stromu automatizace uživatelského rozhraní
- Pohyb mezi elementy automatizace uživatelského rozhraní pomocí třídy TreeWalker
- Získání elementů automatizace uživatelského rozhraní