winuser.h


LoadCursorFromFile

La función LoadCursorFromFile crea un cursor basado en los datos contenidos en un fichero. El fichero se especifica por su nombre o por su identificador de cursor de sistema. La función devuelve un manipulador al nuevo cursor creado. Los ficheros que contengan datos de cursores pueden tener la extensión (.CUR) o (.ANI) si se trata de cursores animados.

Sintaxis

HCURSOR LoadCursorFromFile (
    LPCTSTR lpFileName	// puntero al nombre de fichero de cursor o identificador de cursor de sistema
   );

Parámetros

lpFileName: indica el fichero de datos a usar para crear el cursor. Los datos en el fichero pueden estar en los formatos .CUR o .ANI.

Si la palabra de mayor peso de lpszFileName es distinta de cero, se trata de un puntero a una cadena con el nombre del fichero que contiene los datos del cursor.

Si la palabra de mayor peso de lpszFileName es cero, la palabra de menor peso es un identificador de cursor de sistema. La función buscará entonces en la entrada [Cursors] del fichero WIN.INI el fichero asociado con el nombre de ese cursor de sistema. A continueción se muestra una lista de los nombres de los cursores de sistema y sus identificadores:

Nombres de cursores de sistema Identificadores de cursores de sistema
"Arrow" OCR_NORMAL
"IBeam" OCR_IBEAM
"Wait" OCR_WAIT
"Crosshair" OCR_CROSS
"UpArrow" OCR_UP
"Size" OCR_SIZE
"Icon" OCR_ICON
"SizeNWSE" OCR_SIZENWSE
"SizeNESW" OCR_SIZENESW
"SizeWE" OCR_SIZEWE
"SizeNS" OCR_SIZENS
"SizeAll" OCR_SIZEALL
"No" OCR_NO
"AppStarting" OCR_APPSTARTING

Por ejemplo, si el fichero WIN.INI contiene lo siguiente:

[Cursors]  
	Arrow = "arrow.ani"

Entonces, la llamada:

LoadCursorFromFile((LPWSTR)OCR_NORMAL)

hace que la función LoadCursorFromFile obtenga los datos de cursor desde el fichero ARROW.ANI. Si el fichero WIN.INI no contiene una entrada para el cursor de sistema especificado, la función falla y devuelve NULL.

Valor de retorno

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

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

Valor Significado
ERROR_FILE_NOT_FOUND El fichero especificado no se ha encontrado.