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

Normaliza o intervalo de texto pela unidade de texto especificada. O intervalo será expandido se for menor que a unidade especificada ou reduzido se for maior que a unidade especificada.

Sintaxe

HRESULT ExpandToEnclosingUnit(
  [in] TextUnit textUnit
);

Parâmetros

[in] textUnit

Tipo: TextUnit

A unidade de texto, como linha ou parágrafo.

Retornar valor

Tipo: HRESULT

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

Comentários

Aplicativos cliente, como leitores de tela, usam esse método para recuperar a palavra completa, a frase ou o parágrafo que existe no ponto de inserção ou na posição de cursor.

Apesar do nome, o método ExpandToEnclosingUnit não necessariamente expande um intervalo de texto. Em vez disso, ele "normaliza" um intervalo de texto movendo os pontos de extremidade para que o intervalo engloba a unidade de texto especificada. O intervalo será expandido se for menor que a unidade especificada ou reduzido se for maior que a unidade especificada. Se o intervalo já for uma quantidade exata das unidades especificadas, ele permanecerá inalterado. O diagrama a seguir mostra como ExpandToEnclosingUnit normaliza um intervalo de texto movendo os pontos de extremidade do intervalo.

Diagrama mostrando pontos de extremidade antes e depois de ExpandToEnclosingUnit

ExpandToEnclosingUnit usará como padrão a próxima maior unidade de texto com suporte se a unidade de texto especificada não for compatível com o controle.

A ordem, da menor unidade para a maior, é a seguinte:

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

ExpandToEnclosingUnit respeita texto visível e oculto.

Comportamento de 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 (ou formato) do texto dentro do intervalo. No entanto, a Format unidade de texto não move nem expande um intervalo de texto no 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 (inclua UIAutomation.h)

Confira também

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