Método ITextRangeProvider::GetEnclosingElement (uiautomationcore.h)

Retorna o elemento mais interno que inclui o intervalo de texto especificado.

Sintaxe

HRESULT GetEnclosingElement(
  [out, retval] IRawElementProviderSimple **pRetVal
);

Parâmetros

[out, retval] pRetVal

Tipo: IRawElementProviderSimple**

O provedor Automação da Interface do Usuário do elemento mais interno que inclui o ITextRangeProvider especificado.

Observação

O elemento delimitador pode abranger mais do que apenas o ITextRangeProvider especificado.

Se nenhum elemento delimitador for encontrado, o pai ITextProvider do ITextRangeProvider será retornado.

Este parâmetro é passado não inicializado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Exemplos

1. Este exemplo mostra um fluxo de texto que contém um link de imagem. O link é um filho da imagem, mas ambos abrangem o mesmo intervalo de texto e são expostos como objetos inseridos no fluxo de texto.

   Olá <, Mundo do Link> de Imagem

   • A imagem e o link também são descendentes do ITextProvider do fluxo e podem ser especificados como childElement em uma chamada para ITextProvider::RangeFromChild.
   • Chamar ITextRangeProvider::RangeFromChild, usando a imagem ou o link, retorna o mesmo intervalo de texto (Intervalo1).
   • GetChildren não retorna o link.
   • GetEnclosingElement não retorna a imagem para nenhum intervalo de texto.
   • GetEnclosingElement em Range1 retorna o link.
   • GetChildren em Range1 não retorna nenhum filho.
   • GetEnclosingElement no intervalo de texto do ITextProvider do fluxo retorna o provedor.
   • GetChildren no intervalo de texto do ITextProvider do fluxo retorna apenas a imagem.

2. Este exemplo mostra um fluxo de texto que contém uma tabela de duas células cercada por texto.

   Iniciar texto

   Célula 1 da Tabela

   Célula 2 da Tabela

   Texto final

   • Caso 1: O ITextProvider do fluxo e todo o intervalo de texto
     • ITextRangeProvider::GetEnclosingElement em todo o intervalo de texto retorna o ITextProvider do fluxo.
     • GetChildren retorna todos os elementos filho do ITextProvider do fluxo, somente o elemento de tabela nesse caso.
   • Caso 2: intervalo de texto obtido chamando ITextProvider::RangeFromChild no elemento table:
     • ITextRangeProvider::GetEnclosingElement retorna o elemento table.
     • ITextRangeProvider::GetChildren retorna ambas as células da tabela.
   • Caso 3: intervalo de texto que abrange o conteúdo visual da Célula da Tabela 1 Célula da Tabela 2:
     • ITextRangeProvider::GetEnclosingElement retorna o elemento table.
     • ITextRangeProvider::GetChildren retorna ambas as células da tabela.
   • Caso 4: intervalo de texto que abrange a palavra Célula da Célula da Tabela 1:
     • ITextRangeProvider::GetEnclosingElement retorna o primeiro elemento de célula.
     • ITextRangeProvider::GetChildren não retorna elementos.
   • Caso 5: um intervalo de texto degenerado (vazio) que representa as duas inicializações (tabela e primeira célula):
     • ITextRangeProvider::GetEnclosingElement retorna o primeiro elemento de célula (o elemento mais interno com um intervalo que inclui o intervalo degenerado).
     • ITextRangeProvider::GetChildren não retorna elementos.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcore.h (include UIAutomation.h)

Confira também

Visão geral de ITextProvider, ITextRangeProvider, ITextRangeProvider::GetChildrenAutomação da Interface do Usuário Providers