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

Artigo
02/29/2024

O aplicativo chama essa função para obter o local do pixel em relação ao canto superior esquerdo da caixa de layout dada a posição de texto e o lado lógico da posição. Essa função normalmente é usada como parte do posicionamento de cursor do texto em que o cursor é desenhado no local correspondente à posição de edição de texto atual. Ele também pode ser usado como uma maneira de obter programaticamente a geometria de uma posição de texto específica na automação da interface do usuário.

Sintaxe

HRESULT HitTestTextPosition(
        UINT32                  textPosition,
        BOOL                    isTrailingHit,
  [out] FLOAT                   *pointX,
  [out] FLOAT                   *pointY,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

Parâmetros

textPosition

Tipo: UINT32

A posição de texto usada para obter o local do pixel.

isTrailingHit

Tipo: BOOL

Um sinalizador booliano que indica se o local do pixel é do lado à esquerda ou à direita da posição de texto especificada.

[out] pointX

Tipo: FLOAT*

Quando esse método retorna, contém o local do pixel de saída X, em relação ao local superior esquerdo da caixa de layout.

[out] pointY

Tipo: FLOAT*

Quando esse método retorna, contém o local do pixel de saída Y, em relação ao local superior esquerdo da caixa de layout.

[out] hitTestMetrics

Tipo: DWRITE_HIT_TEST_METRICS*

Quando esse método retorna, contém a geometria de saída totalmente delimitando a posição de texto especificada.

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 Atualização de Plataforma 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