TreeWalker.GetParent Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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
- Información general sobre el árbol de la UI Automation
- Navegar entre elementos de UI Automation con TreeWalker
- Obtener elementos de UI Automation
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
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
- Información general sobre el árbol de la UI Automation
- Navegar entre elementos de UI Automation con TreeWalker
- Obtener elementos de UI Automation