winuser.h


LoadCursor

La función LoadCursor carga el recurso de cursor especificado desde el fichero ejecutable (.EXE) asociado con la instancia de la aplicación.

Sintaxis

HCURSOR LoadCursor(
    HINSTANCE hInstance,  // manipulador de instancia de aplicación
    LPCTSTR lpCursorName  // cadena con el nombre o identificador de recurso de cursor
   );

Parámetros

hInstance: identifica una instancia del módulo cuyo fichero ejecutable contiene el cursor a cargar.

lpCursorName: puntero a una cadena, terminada con cero, que contiene el nombre del recurso del cursor a cargar. De forma alternativa, este parámetro puede ser un identificador de recurso en la palabra de menor peso y cero en la de mayor peso. Se puede usar la macro MAKEINTRESOURCE para crear ese valor.

Para usar uno de los cursores predefinidos de Win32, la aplicación debe usar un valor NULL para el parámetro hInstance y para el parámetro lpCursorName uno de los siguientes:

Valor Descripción
IDC_APPSTARTING Flecha estándar y un pequeño reloj de arena.
IDC_ARROW Flecha estándar.
IDC_CROSS Cruz.
IDC_IBEAM I para texto.
IDC_ICON Sólo en Windows NT: icono vacío
IDC_NO Círculo barrado.
IDC_SIZE Sólo en Windows NT: flecha de cuatro puntas.
IDC_SIZEALL Igual que IDC_SIZE.
IDC_SIZENESW Flecha de dos puntas noreste y sudoeste.
IDC_SIZENS Flecha de dos puntas, norte y sur.
IDC_SIZENWSE Flecha de dos puntas, noroeste y sudeste.
IDC_SIZEWE Flecha de dos puntas, este y oeste.
IDC_UPARROW Flecha vertical.
IDC_WAIT Reloj de arena.

Valor de retorno

Si la función tiene éxito, el valor de retorno es un manipulador del nuevo cursor cargado.

Si la función falla, el valor de retorno es NULL. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

LoadCursor sólo carga el recurso del cursor si no ha sido cargado; en otro caso, recupera un manipulador al recurso existente. Esta función devuelve un manipulador de cursor válido sólo si el parámetro lpCursorName apunta a un recurso de cursor. Si lpCursorName apunta a otro tipo de recurso (como un icono), el valor de retorno no es NULL, aunque no se trate de un manipulador de cursor válido.

La función LoadCursor busca el recurso del cursor más apropiado para el tipo de display actual. El recurso del cursor puede ser un mapa de bits monocromo o en color.