Compartilhar via

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

  • Artigo

Move o intervalo de texto para frente ou para trás pelo número especificado de unidades de texto .

Sintaxe

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

Parâmetros

[in] unit

Tipo: TextUnit

Um valor que especifica o tipo de unidades de texto, como caractere, palavra, parágrafo e assim por diante.

[in] count

Tipo: int

O número de unidades de texto a serem movidas. Um valor positivo move o intervalo de texto para frente. Um valor negativo move o intervalo de texto para trás. Zero não tem efeito.

[out, retval] moved

Tipo: int*

Recebe o número de unidades de texto realmente movidas. Isso poderá ser menor do que o número solicitado se um dos novos pontos de extremidade de intervalo de texto for maior ou menor que os pontos de extremidade recuperados pelo método IUIAutomationTextPattern::D ocumentRange . Esse valor poderá ser negativo se a navegação estiver ocorrendo na direção anterior.

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

IUIAutomationTextRange::Move move o intervalo de texto para abranger uma parte diferente do texto; ele não altera o texto de forma alguma.

Para um intervalo de texto não degenerado (não vazio), IUIAutomationTextRange::Move normaliza e move o intervalo executando as etapas a seguir.

  1. O intervalo de texto é recolhido para um intervalo degenerado (vazio) no ponto de extremidade inicial.
  2. Se necessário, o intervalo de texto resultante é movido para trás no documento para o início do limite de unidade de texto solicitado.
  3. O intervalo de texto é movido para frente ou para trás no documento pelo número solicitado de limites de unidade de texto.
  4. O intervalo de texto é expandido do estado degenerado movendo o ponto de extremidade final para frente por um limite de unidade de texto solicitado.
Se qualquer uma das etapas anteriores falhar, o intervalo de texto permanecerá inalterado. Se o intervalo de texto não puder ser movido até o número solicitado de unidades de texto, mas puder ser movido por um número menor de unidades de texto, o intervalo de texto será movido pelo número menor de unidades de texto e movido será definido como o número de unidades de texto movidas.

Para um intervalo de texto degenerado, IUIAutomationTextRange::Move simplesmente move o ponto de inserção de texto pelo número especificado de unidades de texto.

Ao mover um intervalo de texto, IUIAutomationTextRange::Move ignora os limites de qualquer objeto inserido no texto.

IUIAutomationTextRange::Move respeita o texto oculto e visível.

Se um controle baseado em texto não der suporte à unidade de texto especificada pelo parâmetro unit , IUIAutomationTextRange::Move substituirá a próxima unidade de texto maior com suporte.

O tamanho das unidades de texto, da menor unidade para a maior, é o seguinte.

  • Caractere
  • Formatar
  • 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