SetCursor

O SetCursor função estabelece a forma de cursor.

(HCURSOR SetCursor HCURSOR  hCursor / / identificador para o cursor);
 

Parâmetros

hCursor
Identificador para o cursor. O cursor deve foram criado pela CreateCursor ou carregado pela LoadCursor ou LoadImage função. Se este parâmetro é NULL, o cursor é removido da tela.

Windows 95: A largura e altura do cursor devem ser os valores retornados pelo GetSystemMetrics função para SM_CXCURSOR e SM_CYCURSOR. Além disso, a profundidade de bits de cursor deve coincidir com a profundidade de bits da tela ou o cursor deve ser monocromático.

Retornar valores

O valor de retorno é o identificador para o cursor anterior, se houvesse um.

Se houve não cursor anterior, o valor de retorno é NULL.

Observações

O cursor é definido somente se o cursor novo é diferente do cursor anterior; caso contrário, a função retorna imediatamente.

O cursor é um recurso compartilhado. Uma janela deve definir a forma cursor somente quando o cursor estiver na sua área de cliente ou quando a janela é capturar entrada mouse. Em sistemas sem um mouse, a janela deve restaurar o cursor anterior antes do cursor sai da área de cliente ou antes de ele abandona controle para outra janela.

Se seu aplicativo deve definir o cursor enquanto ele está em uma janela, certifique-se do que cursor classe para classe da janela de especificado é definido como NULL. Se o cursor classe não for NULL, o sistema restaura o cursor classe cada vez que o mouse é movido.

O cursor não é exibido na tela se a contagem exibir cursor interno é menor que zero. Isso ocorre se o aplicativo usa o ShowCursor função para ocultar o cursor mais vezes do que para mostrar o cursor.

Windows CE: Use o componente de cursor ao direcionamento uma plataforma que não oferece suporte a cursores de mouse. O cursor somente que oferece suporte a este componente é o cursor de espera. Use o código a seguir para definir o cursor de espera

SetCursor (LoadCursor (NULL, IDC_WAIT));

Use o componente mcursor ao direcionamento uma plataforma que oferece suporte a cursores de mouse. Este componente não oferece suporte a cursores de cor.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de cursores, funções de Cursor, CreateCursor, GetCursor, GetSystemMetrics, LoadCursor, LoadImage, SetCursorPos, ShowCursor

Index