Função TextRange_ExpandToEnclosingUnit (uiautomationcoreapi.h)

  • Artigo
Nota Essa função foi preterida. Em vez disso, os aplicativos cliente devem usar as interfaces COM (Modelo de Objeto de Componente) do Microsoft Automação da Interface do Usuário.
 
Expande o intervalo de texto para uma unidade maior ou menor, como Caractere, Word, Linha ou Página.

Sintaxe

HRESULT TextRange_ExpandToEnclosingUnit(
  [in] HUIATEXTRANGE hobj,
  [in] TextUnit      unit
);

Parâmetros

[in] hobj

Tipo: HUIATEXTRANGE

Um objeto de intervalo de texto.

[in] unit

Tipo: TextUnit

A unidade para a qual o provedor deve expandir o intervalo de texto.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário.

Comentários

Se o intervalo já for um número integral das unidades especificadas, ele permanecerá inalterado.

Se o ponto de extremidade inicial não estiver em um limite textUnit , ele será movido para trás até que esteja em um limite. Posteriormente, se o ponto de extremidade final não estiver em um limite ou se estiver no mesmo limite que o ponto de extremidade inicial, o ponto de extremidade final será movido para frente até que esteja em um limite.

Nota É comum que um leitor de tela leia uma palavra completa, um parágrafo inteiro e assim por diante, no ponto de inserção ou em qualquer posição de cursor virtual.
 
TextRange_ExpandToEnclosingUnit respeita o texto oculto e visível. O Automationclient da interface do usuário pode marcar o atributo is-hidden (Text_IsHidden_Attribute_GUID) para visibilidade do texto.

TextRange_ExpandToEnclosingUnit padrão até o próximo TextUnit com suporte se o TextUnit especificado não for compatível com o controle .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationcoreapi.h
Biblioteca Uiautomationcore.lib
DLL Uiautomationcore.dll