SetCursor

9/9/2008

Essa função estabelece a forma cursor.

Syntax

HCURSOR SetCursor(
  HCURSOR hCursor
);

Parameters

• hCursor
  [no] Identificador para o cursor. O cursor deve ter sido criado pela CreateCursor ou carregados pela LoadCursor Ou LoadImage função. Se este parâmetro é NULL, o cursor é removido de Tela.

  A largura e altura do cursor devem ser os valores retornados pela GetSystemMetrics função para SM_CXCURSOR e SM_CYCURSOR.

Return Value

O identificador para o cursor anterior indica sucesso. NULL Indica que houve não cursor anterior.

Remarks

Usar Cursor.lib ao direcionamento uma plataforma que faz não mouse suporte cursores. O cursor somente oferece suporte a essa biblioteca componente é a cursor de espera. Use o seguinte codificar para definir a cursor de espera.

SetCursor(LoadCursor(NULL, IDC_WAIT));

Usar Mcursor.lib ao direcionamento uma plataforma que não suporte mouse cursores. Esta biblioteca não suporte cor cursores.

Se SetCursor é chamado após CreateCursor Cria um zero cursor dimensão, ele ainda mostrará o cursor antigo, não o cursor novo.

O cursor é definido somente se o cursor nova é diferente de 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 é em sua área cliente ou quando a janela é capturar entrada mouse. Em sistemas sem um mouse, a janela deve restaurar o cursor anterior antes de cursor deixa a área cliente ou antes de ele abandona controle para outra janela.

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

O cursor não é exibido sobre a Tela se a contagem exibir cursor interno é menor que zero. Isso ocorre se o aplicativo usa o ShowCursor função para ocultar o cursor more times que a apresentação de cursor.

Requirements

Header	winuser.h
Library	Cursor.lib, Mcursor.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CreateCursor
GetCursor
GetSystemMetrics
LoadCursor
LoadImage
SetCursorPos
ShowCursor