Función SetSystemCursor (winuser.h)

Artículo
05/20/2023

Permite a una aplicación personalizar los cursores del sistema. Reemplaza el contenido del cursor del sistema especificado por el parámetro id por el contenido del cursor especificado por el parámetro hcur y, a continuación, destruye hcur.

Sintaxis

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

Parámetros

[in] hcur

Tipo: HCURSOR

Identificador del cursor. La función reemplaza el contenido del cursor del sistema especificado por id . por el contenido del cursor controlado por hcur.

El sistema destruye hcur llamando a la función DestroyCursor . Por lo tanto, hcur no puede ser un cursor cargado mediante la función LoadCursor . Para especificar un cursor cargado desde un recurso, copie el cursor mediante la función CopyCursor y, a continuación, pase la copia a SetSystemCursor.

[in] id

Tipo: DWORD

Cursor del sistema que se va a reemplazar por el contenido de hcur. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
OCR_NORMAL `32512`	Selección normal
OCR_IBEAM `32513`	Selección de texto
OCR_WAIT `32514`	Ocupado
OCR_CROSS `32515`	Selección de precisión
OCR_UP `32516`	Selección alternativa
OCR_SIZENWSE `32642`	Cambio de tamaño diagonal 1
OCR_SIZENESW `32643`	Cambio de tamaño diagonal 2
OCR_SIZEWE `32644`	Cambio de tamaño horizontal
OCR_SIZENS `32645`	Cambio de tamaño vertical
OCR_SIZEALL `32646`	Move
OCR_NO `32648`	No disponible
OCR_HAND `32649`	Selección de vínculo
OCR_APPSTARTING `32650`	Trabajar en segundo plano

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Para que una aplicación use cualquiera de las constantes de OCR_, la constante OEMRESOURCE debe definirse antes de que se incluya el archivo de encabezado Windows.h.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll