Compartilhar via


Função DestroyCaret (winuser.h)

Destrói a forma atual do cursor, libera o cursor da janela e remove o cursor da tela.

Sintaxe

BOOL DestroyCaret();

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

DestroyCaret destruirá o cursor somente se uma janela na tarefa atual possuir o cursor. Se uma janela que não está na tarefa atual possuir o cursor, DestroyCaret não fará nada e retornará FALSE.

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.

Para obter um exemplo, consulte Destroying a Caret

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

Createcaret

Hidecaret

Referência

Showcaret