Função ShowCaret (winuser.h)

Artigo
08/28/2023

Torna o cursor visível na tela na posição atual do cursor. Quando o cursor se torna visível, ele começa a piscar automaticamente.

Sintaxe

BOOL ShowCaret(
  [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, ShowCaret 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

ShowCaret mostra o cursor somente se a janela especificada possui o cursor, o cursor tem uma forma e o cursor não foi oculto duas ou mais vezes seguidas. Se uma ou mais dessas condições não forem atendidas, ShowCaret 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 reapareça.

O sistema fornece um cursor por fila. Uma janela deve criar um cursor somente quando tiver o foco do teclado ou estiver ativo. A janela deve destruir o cursor antes de perder o foco do teclado ou ficar inativo.

Exemplos

Para obter um exemplo, consulte Criando e exibindo 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)