Função GetClipCursor (winuser.h)

Artigo
03/04/2024

Recupera as coordenadas da tela da área retangular à qual o cursor está confinado.

Sintaxe

BOOL GetClipCursor(
  [out] LPRECT lpRect
);

Parâmetros

[out] lpRect

Tipo: LPRECT

Um ponteiro para uma estrutura RECT que recebe as coordenadas de tela do retângulo de confinamento. A estrutura receberá as dimensões da tela se o cursor não estiver confinado a um retângulo.

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

O cursor é um recurso compartilhado. Se um aplicativo limitar o cursor com a função ClipCursor , ele deverá liberar posteriormente o cursor usando ClipCursor antes de abrir mão do controle para outro aplicativo.

O processo de chamada deve ter WINSTA_READATTRIBUTES acesso à estação de janela.

Exemplos

Para obter um exemplo, consulte Confinando um cursor.

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