Função HideCaret (winuser.h)

Artigo
08/27/2023

Remove o cursor da tela. Ocultar um cursor não destrói sua forma atual nem invalida o ponto de inserção.

Sintaxe

BOOL HideCaret(
  [in, optional] HWND hWnd
);

Parâmetros

[in, optional] hWnd

Digite: HWND

Um identificador para a janela que possui o cursor. Se esse parâmetro for NULL, HideCaret pesquisará a tarefa atual para a janela que possui o cursor.

Valor retornado

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

HideCaret oculta o cursor somente se a janela especificada possuir o cursor. Se a janela especificada não possuir o cursor, HideCaret não fará nada e retornará FALSE.

Ocultar é cumulativo. Se o aplicativo chamar HideCaret cinco vezes seguidas, ele também deverá chamar ShowCaret cinco vezes antes que o cursor seja exibido.

Para obter um exemplo, consulte Ocultando um cursor.

Requisitos


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)