Função ShowCaret (winuser.h)
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) |
Confira também
Conceitual
Referência