Função SetSystemCursor (winuser.h)

Artigo
05/20/2023

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