função TextPattern_RangeFromPoint (uiautomationcoreapi.h)

  • Artigo
Nota Essa função foi preterida. Os aplicativos cliente devem usar as interfaces COM (Modelo de Objeto do Componente de Automação da Interface do Usuário) da Microsoft.
 
Recupera o intervalo de texto degenerado (vazio) mais próximo das coordenadas de tela especificadas.

Sintaxe

HRESULT TextPattern_RangeFromPoint(
  [in]  HUIAPATTERNOBJECT hobj,
  [in]  UiaPoint          point,
  [out] HUIATEXTRANGE     *pRetVal
);

Parâmetros

[in] hobj

Tipo: HUIAPATTERNOBJECT

Um objeto padrão de controle.

[in] point

Tipo: HiaPoint

Uma estrutura do UiaPoint que contém o local nas coordenadas da tela.

[out] pRetVal

Tipo: HUIATEXTRANGE*

Quando essa função retorna, contém o intervalo de texto que o nó abrange. Este parâmetro é passado não inicializado.

Valor retornado

Tipo: HRESULT

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

Comentários

Um intervalo de texto que encapsula um objeto filho será retornado se as coordenadas da tela estiverem dentro das coordenadas de uma imagem, hiperlink, planilha do Microsoft Excel ou outro objeto inserido.

Como o texto oculto não é ignorado, esse método recupera um intervalo degenerado do texto visível mais próximo das coordenadas especificadas.

Requisitos

   
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