Compartilhar via


Função SetSystemCursor (winuser.h)

Permite que um aplicativo personalize os cursores do sistema. Ele substitui o conteúdo do cursor do sistema especificado pelo parâmetro id pelo conteúdo do cursor especificado pelo parâmetro hcur e, em seguida, destrói hcur.

Sintaxe

BOOL SetSystemCursor(
  [in] HCURSOR hcur,
  [in] DWORD   id
);

Parâmetros

[in] hcur

Tipo: HCURSOR

Um identificador para o cursor. A função substitui o conteúdo do cursor do sistema especificado pela ID pelo conteúdo do cursor manipulado por hcur.

O sistema destrói hcur chamando a função DestroyCursor . Portanto, hcur não pode ser um cursor carregado usando a função LoadCursor . Para especificar um cursor carregado de um recurso, copie o cursor usando a função CopyCursor e passe a cópia para SetSystemCursor.

[in] id

Tipo: DWORD

O cursor do sistema a ser substituído pelo conteúdo do hcur. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
OCR_NORMAL
32512
Seleção normal
OCR_IBEAM
32513
Seleção de texto
OCR_WAIT
32514
Ocupado
OCR_CROSS
32515
Seleção de precisão
OCR_UP
32516
Seleção alternativa
OCR_SIZENWSE
32642
Redimensionamento diagonal 1
OCR_SIZENESW
32643
Redimensionamento diagonal 2
OCR_SIZEWE
32644
Redimensionamento horizontal
OCR_SIZENS
32645
Redimensionamento vertical
OCR_SIZEALL
32646
Mover
OCR_NO
32648
Indisponível
OCR_HAND
32649
Link select
OCR_APPSTARTING
32650
Trabalhando em segundo plano

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

Para que um aplicativo use qualquer uma das constantes OCR_, a constante OEMRESOURCE deve ser definida antes que o arquivo de cabeçalho Windows.h seja incluído.

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

Cursores

DestroyCursor

Loadcursor

LoadCursorFromFile

Referência

Setcursor