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

  • Artigo

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

Sintaxe

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

Parâmetros

[in] endpoint

Tipo: TextPatternRangeEndpoint

O ponto de extremidade a ser movido.

[in] unit

Tipo: textUnit

O tipo de unidades de texto, como caractere, palavra, parágrafo e assim por diante.

[in] count

Tipo: int

O número de unidades a serem movidas. Um valor positivo move o ponto de extremidade para frente. Um valor negativo é movido para trás. Um valor de 0 não tem efeito.

[out, retval] pRetVal

Tipo: int*

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

Valor de retorno

Tipo: HRESULT

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

Observações

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

ITextRangeProvider::MoveEndpointByUnit será preterido até a próxima unidade de texto com suporte se a unidade de texto fornecida não tiver suporte pelo controle.

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

  • de caracteres
  • Formatar
  • word
  • Line
  • do parágrafo
  • página
  • de Documento

Comportamento do intervalo quando de unidade é TextUnit::Format

TextUnit::Format como uma unidade valor 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 deve mover ou expandir um intervalo de texto no limite de um objeto inserido, como uma imagem ou hiperlink. Para obter mais informações, consulte unidades de texto de automação de interface do usuário ou padrões de controle text and textRange.

Requisitos

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

Consulte também

Conceitual

ITextProvider

ITextRangeProvider

de referência de

padrões de controle text and textRange

Visão geral dos provedores de automação da interface do usuário