Método IUIAutomationTextRange::MoveEndpointByRange (uiautomationclient.h)

  • Artigo

Move um ponto de extremidade do intervalo de texto atual para o ponto de extremidade especificado de um segundo intervalo de texto.

Sintaxe

HRESULT MoveEndpointByRange(
  [in] TextPatternRangeEndpoint srcEndPoint,
  [in] IUIAutomationTextRange   *range,
  [in] TextPatternRangeEndpoint targetEndPoint
);

Parâmetros

[in] srcEndPoint

Tipo: TextPatternRangeEndpoint

Um ponto de extremidade (início ou fim) do intervalo de texto atual. Esse é o ponto de extremidade a ser movido.

[in] range

Tipo: IUIAutomationTextRange*

Um segundo intervalo de texto do mesmo provedor de texto que o intervalo de texto atual.

[in] targetEndPoint

Tipo: TextPatternRangeEndpoint

Um ponto de extremidade (inicial ou final) do segundo intervalo de texto. O srcEndPoint do intervalo de texto atual é movido para esse ponto de extremidade.

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 o ponto de extremidade que está sendo movido cruzar o outro ponto de extremidade do mesmo intervalo de texto, esse outro ponto de extremidade também será movido, resultando em um intervalo degenerado (vazio) e garantindo a ordenação correta dos pontos de extremidade (ou seja, o início é sempre menor ou igual ao final).

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

IUIAutomationTextRange

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