TreeWalker.GetNextSibling Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Recupera o próximo elemento irmão do .AutomationElement
Sobrecargas
| Nome | Descrição |
|---|---|
| GetNextSibling(AutomationElement, CacheRequest) |
Recupera o próximo elemento irmão das propriedades e padrões especificados AutomationElement e em cache. |
| GetNextSibling(AutomationElement) |
Recupera o próximo elemento irmão do .AutomationElement |
Comentários
É AutomationElement possível ter elementos irmãos adicionais que não correspondem à condição de exibição atual e, portanto, não são retornados ao navegar na árvore de elementos.
A estrutura da AutomationElement árvore muda conforme os elementos de interface do usuário (interface do usuário) visíveis na área de trabalho são alterados. Não é garantido que um elemento retornado como o próximo elemento irmão será retornado como o próximo irmão em passagens subsequentes.
GetNextSibling(AutomationElement, CacheRequest)
Recupera o próximo elemento irmão das propriedades e padrões especificados AutomationElement e em cache.
public:
System::Windows::Automation::AutomationElement ^ GetNextSibling(System::Windows::Automation::AutomationElement ^ element, System::Windows::Automation::CacheRequest ^ request);
public System.Windows.Automation.AutomationElement GetNextSibling(System.Windows.Automation.AutomationElement element, System.Windows.Automation.CacheRequest request);
member this.GetNextSibling : System.Windows.Automation.AutomationElement * System.Windows.Automation.CacheRequest -> System.Windows.Automation.AutomationElement
Public Function GetNextSibling (element As AutomationElement, request As CacheRequest) As AutomationElement
Parâmetros
- element
- AutomationElement
O elemento do qual recuperar o próximo irmão.
- request
- CacheRequest
Um objeto de solicitação de cache que especifica propriedades e padrões no cache retornado AutomationElement .
Retornos
O próximo elemento irmão ou uma referência nula (Nothing em Visual Basic) se não houver esse elemento.
Comentários
É AutomationElement possível ter elementos irmãos adicionais que não correspondem à condição de exibição atual e, portanto, não são retornados ao navegar na árvore de elementos.
A estrutura da AutomationElement árvore muda conforme os elementos de interface do usuário (interface do usuário) visíveis na área de trabalho são alterados. Não é garantido que um elemento retornado como o próximo elemento irmão será retornado como o próximo irmão em passagens subsequentes.
Confira também
- Visão geral da árvore de automação da interface do usuário
- Navegar entre elementos de automação da interface do usuário com TreeWalker
- Obtaining Automação da Interface do Usuário Elements
Aplica-se a
GetNextSibling(AutomationElement)
Recupera o próximo elemento irmão do .AutomationElement
public:
System::Windows::Automation::AutomationElement ^ GetNextSibling(System::Windows::Automation::AutomationElement ^ element);
public System.Windows.Automation.AutomationElement GetNextSibling(System.Windows.Automation.AutomationElement element);
member this.GetNextSibling : System.Windows.Automation.AutomationElement -> System.Windows.Automation.AutomationElement
Public Function GetNextSibling (element As AutomationElement) As AutomationElement
Parâmetros
- element
- AutomationElement
Do AutomationElement qual recuperar o próximo irmão.
Retornos
O próximo elemento irmão ou uma referência nula (Nothing em Visual Basic) se não houver esse elemento.
Exemplos
O exemplo a seguir mostra GetNextSibling como ser usado para construir uma exibição de árvore de elementos em uma subárvore.
/// <summary>
/// Walks the UI Automation tree and adds the control type of each element it finds
/// in the control view to a TreeView.
/// </summary>
/// <param name="rootElement">The root of the search on this iteration.</param>
/// <param name="treeNode">The node in the TreeView for this iteration.</param>
/// <remarks>
/// This is a recursive function that maps out the structure of the subtree beginning at the
/// UI Automation element passed in as rootElement on the first call. This could be, for example,
/// an application window.
/// CAUTION: Do not pass in AutomationElement.RootElement. Attempting to map out the entire subtree of
/// the desktop could take a very long time and even lead to a stack overflow.
/// </remarks>
private void WalkControlElements(AutomationElement rootElement, TreeNode treeNode)
{
// Conditions for the basic views of the subtree (content, control, and raw)
// are available as fields of TreeWalker, and one of these is used in the
// following code.
AutomationElement elementNode = TreeWalker.ControlViewWalker.GetFirstChild(rootElement);
while (elementNode != null)
{
TreeNode childTreeNode = treeNode.Nodes.Add(elementNode.Current.ControlType.LocalizedControlType);
WalkControlElements(elementNode, childTreeNode);
elementNode = TreeWalker.ControlViewWalker.GetNextSibling(elementNode);
}
}
''' <summary>
''' Walks the UI Automation tree and adds the control type of each element it finds
''' in the control view to a TreeView.
''' </summary>
''' <param name="rootElement">The root of the search on this iteration.</param>
''' <param name="treeNode">The node in the TreeView for this iteration.</param>
''' <remarks>
''' This is a recursive function that maps out the structure of the subtree beginning at the
''' UI Automation element passed in as rootElement on the first call. This could be, for example,
''' an application window.
''' CAUTION: Do not pass in AutomationElement.RootElement. Attempting to map out the entire subtree of
''' the desktop could take a very long time and even lead to a stack overflow.
''' </remarks>
Private Sub WalkControlElements(ByVal rootElement As AutomationElement, ByVal treeNode As TreeNode)
' Conditions for the basic views of the subtree (content, control, and raw)
' are available as fields of TreeWalker, and one of these is used in the
' following code.
Dim elementNode As AutomationElement = TreeWalker.ControlViewWalker.GetFirstChild(rootElement)
While (elementNode IsNot Nothing)
Dim childTreeNode As TreeNode = treeNode.Nodes.Add(elementNode.Current.ControlType.LocalizedControlType)
WalkControlElements(elementNode, childTreeNode)
elementNode = TreeWalker.ControlViewWalker.GetNextSibling(elementNode)
End While
End Sub
Comentários
É AutomationElement possível ter elementos irmãos adicionais que não correspondem à condição de exibição atual e, portanto, não são retornados ao navegar na árvore de elementos.
A estrutura da AutomationElement árvore muda conforme os elementos de interface do usuário (interface do usuário) visíveis na área de trabalho são alterados. Não é garantido que um elemento retornado como o próximo elemento irmão será retornado como o próximo irmão em passagens subsequentes.
Confira também
- Visão geral da árvore de automação da interface do usuário
- Navegar entre elementos de automação da interface do usuário com TreeWalker
- Obtaining Automação da Interface do Usuário Elements