Função SetCursor (winuser.h)

Artigo
03/04/2024

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