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.