Método IDWriteTextLayout::HitTestPoint (dwrite.h)

Artigo
02/26/2024

O aplicativo chama essa função passando um local de pixel específico em relação ao local superior esquerdo da caixa de layout e obtém as informações sobre as métricas de teste de clique correspondente da cadeia de caracteres de texto em que o teste de clique ocorreu. Quando o local de pixel especificado está fora da cadeia de caracteres de texto, a função define o valor de saída *isInside como FALSE.

Sintaxe

HRESULT HitTestPoint(
        FLOAT                   pointX,
        FLOAT                   pointY,
  [out] BOOL                    *isTrailingHit,
  [out] BOOL                    *isInside,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

Parâmetros

pointX

Tipo: FLOAT

O local do pixel X para teste de clique, em relação ao local superior esquerdo da caixa de layout.

pointY

Tipo: FLOAT

O local do pixel Y para teste de clique, em relação ao local superior esquerdo da caixa de layout.

[out] isTrailingHit

Tipo: BOOL*

Um sinalizador de saída que indica se o local do teste de clique está no lado à esquerda ou à direita do caractere. Quando o valor de saída *isInside é definido como FALSE, esse valor é definido de acordo com o valor de saída hitTestMetrics-textPosition> para representar a borda mais próxima do local do teste de clique.

[out] isInside

Tipo: BOOL*

Um sinalizador de saída que indica se o local do teste de clique está dentro da cadeia de caracteres de texto. Quando FALSE, a posição mais próxima da borda do texto é retornada.

[out] hitTestMetrics

Tipo: DWRITE_HIT_TEST_METRICS*

A geometria de saída inclui totalmente o local do teste de clique. Quando o valor de saída *isInside é definido como FALSE, essa estrutura representa a geometria que circunda a borda mais próxima do local do teste de clique.

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.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	dwrite.h
Biblioteca	Dwrite.lib
DLL	Dwrite.dll

Confira também

IDWriteTextLayout

Compartilhar via