Compartilhar via


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

  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 TabelaCélula 2 da Tabela

    Texto final

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