Compartilhar via

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

  • Artigo

Move um ponto de extremidade do intervalo de texto conforme o número especificado de unidades de texto dentro do intervalo do documento.

Sintaxe

HRESULT MoveEndpointByUnit(
  [in]          TextPatternRangeEndpoint endpoint,
  [in]          TextUnit                 unit,
  [in]          int                      count,
  [out, retval] int                      *moved
);

Parâmetros

[in] endpoint

Tipo: TextPatternRangeEndpoint

Um valor que especifica o ponto de extremidade (início ou fim) a ser movido.

[in] unit

Tipo: TextUnit

Um valor que especifica a unidade textual para movimentação, como linha ou parágrafo.

[in] count

Tipo: int

O número de unidades a serem movidas. Uma contagem positiva move o ponto de extremidade para frente. Uma contagem negativa move para trás. Uma contagem de 0 não tem nenhum efeito.

[out, retval] moved

Tipo: int*

Recebe a contagem de unidades realmente movidas. Esse valor poderá ser menor que o número solicitado se a movimentação do ponto de extremidade for executada no início ou no final do documento.

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

O ponto de extremidade é movido para frente ou para trás, conforme especificado, para o próximo limite de unidade disponível. Se o ponto de extremidade original estiver no limite da unidade de texto especificada, o ponto de extremidade será movido para o próximo limite de unidade de texto disponível, conforme mostrado na ilustração a seguir.

Ilustração mostrando pontos de extremidade de um intervalo de texto se movendo Se o ponto de extremidade que está sendo movido cruzar o outro ponto de extremidade do mesmo intervalo de texto, o outro ponto de extremidade também será movido, resultando em um intervalo degenerado e garantindo a ordenação correta do ponto de extremidade (ou seja, que o início seja sempre menor ou igual ao final).

MoveEndpointByUnit substituirá até a próxima unidade de texto com suporte se a unidade de texto fornecida não tiver suporte do controle.

A ordem, da menor unidade para a maior, está listada aqui.

  • Caractere
  • Formato
  • Word
  • Linha
  • Paragraph
  • Página
  • Documento

Comportamento do intervalo quando a unidade é TextUnit::Format

TextUnit::Format como um valor unitário posiciona o limite de um intervalo de texto para expandir ou mover o intervalo com base em atributos de texto compartilhado (formato) do texto dentro do intervalo. No entanto, o uso da unidade de texto de formato não moverá ou expandirá um intervalo de texto através do limite de um objeto inserido, como uma imagem ou hiperlink. Para obter mais informações, consulte Automação da Interface do Usuário Unidades de Texto ou Suporte Automação da Interface do Usuário para Conteúdo Textual.

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 (include UIAutomation.h)

Confira também

IUIAutomationTextRange

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