Compartilhar via


Função GetCaretPos (winuser.h)

Copia a posição do cursor para a estrutura POINT especificada.

Sintaxe

BOOL GetCaretPos(
  [out] LPPOINT lpPoint
);

Parâmetros

[out] lpPoint

Tipo: LPPOINT

Um ponteiro para a estrutura POINT que deve receber as coordenadas do cliente do cursor.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A posição do cursor é sempre fornecida nas coordenadas do cliente da janela que contém o cursor.

Virtualização de DPI

Essa API não participa da virtualização de DPI. Os valores retornados são interpretados como tamanhos lógicos em termos da janela em questão. O thread de chamada não é levado em consideração.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-caret-l1-1-0 (introduzido no Windows 8)

Confira também

Carets

Conceitual

Outros recursos

PONTO

Referência

Setcaretpos