TreeWalker.GetParent Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera element nadrzędny określonego AutomationElementelementu .
Przeciążenia
GetParent(AutomationElement) |
Pobiera element nadrzędny określonego AutomationElementelementu . |
GetParent(AutomationElement, CacheRequest) |
Pobiera element nadrzędny określonych AutomationElement właściwości i wzorców pamięci podręcznej. |
Uwagi
AutomationElement Struktura drzewa zmienia się jako widoczne elementy interfejsu użytkownika na pulpicie. Nie ma gwarancji, że element zwrócony jako element nadrzędny zostanie zwrócony jako element nadrzędny po kolejnych przejściach.
GetParent(AutomationElement)
Pobiera element nadrzędny określonego AutomationElementelementu .
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
Element, którego element nadrzędny ma zostać zwrócony.
Zwraca
Element nadrzędny lub odwołanie o wartości null (Nothing
w Visual Basic), jeśli określony element jest elementem głównym w drzewie lub jeśli element nadrzędny nie jest widoczny w bieżącym widoku.
Przykłady
Poniższy przykład pokazuje GetParent , że jest używany do znajdowania elementu okna zawierającego określony element.
/// <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
Zobacz też
- Przegląd drzewa automatyzacji interfejsu użytkownika
- Nawigowanie po elementach automatyzacji interfejsu użytkownika przy użyciu opcji TreeWalker
- Uzyskiwanie elementów automatyzacji interfejsu użytkownika
Dotyczy
GetParent(AutomationElement, CacheRequest)
Pobiera element nadrzędny określonych AutomationElement właściwości i wzorców pamięci podręcznej.
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
Element, którego element nadrzędny ma zostać zwrócony.
- request
- CacheRequest
Obiekt żądania pamięci podręcznej określający elementy członkowskie zwrócone AutomationElement do pamięci podręcznej.
Zwraca
Element nadrzędny lub odwołanie o wartości null (Nothing
w Visual Basic), jeśli określony element jest elementem głównym w drzewie lub element nadrzędny nie jest widoczny w tym widoku.
Uwagi
AutomationElement Struktura drzewa zmienia się jako widoczne elementy interfejsu użytkownika na pulpicie. Nie ma gwarancji, że element zwrócony jako element nadrzędny zostanie zwrócony jako element nadrzędny po kolejnych przejściach.
Zobacz też
- Przegląd drzewa automatyzacji interfejsu użytkownika
- Nawigowanie po elementach automatyzacji interfejsu użytkownika przy użyciu opcji TreeWalker
- Uzyskiwanie elementów automatyzacji interfejsu użytkownika