Método IUIAutomationTextRange::Move (uiautomationclient.h)
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.
- O intervalo de texto é recolhido para um intervalo degenerado (vazio) no ponto de extremidade inicial.
- 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.
- O intervalo de texto é movido para frente ou para trás no documento pelo número solicitado de limites de unidade de texto.
- O intervalo de texto é expandido do estado degenerado movendo o ponto de extremidade final para frente por um limite de unidade de texto solicitado.
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
suporte Automação da Interface do Usuário para conteúdo textual