Função SetCursor (winuser.h)
Define a forma do cursor.
Sintaxe
HCURSOR SetCursor(
[in, optional] HCURSOR hCursor
);
Parâmetros
[in, optional] hCursor
Tipo: HCURSOR
Um identificador para o cursor.
O cursor deve ter sido criado pela função CreateCursor ou CreateIconIndirect ou carregado pela função LoadCursor ou LoadImage .
Se esse parâmetro for NULL, o cursor será removido da tela.
Retornar valor
Tipo: HCURSOR
O valor retornado é o identificador para o cursor anterior, se houver um.
Se não houver nenhum cursor anterior, o valor retornado será NULL.
Comentários
O cursor será definido somente se o novo cursor for diferente do cursor anterior; caso contrário, a função retornará imediatamente.
O cursor é um recurso compartilhado. Uma janela deve definir a forma do cursor somente quando o cursor estiver em sua área de cliente ou quando a janela estiver capturando a entrada do mouse. Em sistemas sem um mouse, a janela deve restaurar o cursor anterior antes que o cursor saia da área do cliente ou antes de abrir mão do controle para outra janela.
Se o aplicativo precisar definir o cursor enquanto ele estiver em uma janela, verifique se o cursor de classe da classe da janela especificada está definido como NULL. Se o cursor de classe não for NULL, o sistema restaurará o cursor de classe sempre que o mouse for movido.
O cursor não será mostrado na tela se a contagem de exibição do cursor interno for menor que zero. Isso ocorrerá se o aplicativo usar a função ShowCursor para ocultar o cursor mais vezes do que mostrar o cursor.
Exemplos
Para obter um exemplo, consulte Exibindo 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 |
Confira também
Conceitual
Referência