Función SetSystemCursor (winuser.h)

  • Artículo

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

Consulte también

Conceptual

Cursores

DestroyCursor

LoadCursor

LoadCursorFromFile

Referencia

SetCursor