Share via


TreeWalker.GetParent Método

Definición

Recupera el elemento primario del objeto AutomationElement especificado.

Sobrecargas

GetParent(AutomationElement)

Recupera el elemento primario del objeto AutomationElement especificado.

GetParent(AutomationElement, CacheRequest)

Recupera el elemento primario del objeto AutomationElement especificado y almacena en memoria caché propiedades y modelos.

Comentarios

La estructura del AutomationElement árbol cambia a medida que cambian los elementos de la interfaz de usuario (UI) visibles en el escritorio. No se garantiza que se devuelva un elemento como elemento primario como elemento primario como elemento primario en los pasos posteriores.

GetParent(AutomationElement)

Recupera el elemento primario del objeto AutomationElement especificado.

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

Parámetros

element
AutomationElement

Elemento cuyo elemento primario se debe devolver.

Devoluciones

AutomationElement

Elemento primario o una referencia nula (Nothing en Visual Basic) si el elemento especificado es el elemento raíz en el árbol o si el elemento primario no está visible en la vista actual.

Ejemplos

En el ejemplo siguiente se muestra GetParent cómo se usa para buscar el elemento de ventana que contiene un elemento especificado.

/// <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

Consulte también

Se aplica a

GetParent(AutomationElement, CacheRequest)

Recupera el elemento primario del objeto AutomationElement especificado y almacena en memoria caché propiedades y modelos.

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

Parámetros

element
AutomationElement

Elemento cuyo elemento primario se debe devolver.

request
CacheRequest

Objeto de solicitud de caché que especifica los miembros del objeto AutomationElement devuelto para almacenar en memoria caché.

Devoluciones

AutomationElement

Elemento primario o una referencia nula (Nothing en Visual Basic) si el elemento especificado es el elemento raíz en el árbol o si el elemento principal no está visible en esta vista.

Comentarios

La estructura del AutomationElement árbol cambia a medida que cambian los elementos de la interfaz de usuario (UI) visibles en el escritorio. No se garantiza que se devuelva un elemento como elemento primario como elemento primario como elemento primario en los pasos posteriores.

Consulte también

Se aplica a