Compartilhar via


Método IUIAutomationTextPattern::RangeFromChild (uiautomationclient.h)

Recupera um intervalo de texto que inclui um elemento filho, como uma imagem, hiperlink, planilha do Microsoft Excel ou outro objeto inserido.

Sintaxe

HRESULT RangeFromChild(
  [in]          IUIAutomationElement   *child,
  [out, retval] IUIAutomationTextRange **range
);

Parâmetros

[in] child

Tipo: IUIAutomationElement*

Um ponteiro para o elemento filho a ser colocado no intervalo de texto.

[out, retval] range

Tipo: IUIAutomationTextRange**

Recebe um ponteiro para um intervalo de texto que inclui o elemento filho.

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

Se não houver nenhum texto no intervalo que coloque o elemento filho, um intervalo degenerado (vazio) será retornado.

O parâmetro filho é um filho do elemento associado a um IUIAutomationTextPattern ou da matriz de filhos de um IUIAutomationTextRange.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationclient.h (inclua UIAutomation.h)

Confira também

IUIAutomationTextPattern

suporte Automação da Interface do Usuário para conteúdo textual