LoadCursorFromFile

A LoadCursorFromFile função cria um cursor com base nos dados contidos em um arquivo. O arquivo é especificado por seu nome ou por um identificador de cursor do sistema. A função retorna um identificador para o cursor recém-criado. Arquivos que contêm dados de cursor podem ser em qualquer cursor (.CUR) ou cursor animado (.Formato de ANI).

(HCURSOR LoadCursorFromFile LPCTSTR  lpFileName / / ponteiro para nome do sistema ou arquivo de cursor / / identificador cursor);
 

Parâmetros

lpFileName
Indica a fonte de dados de arquivo a ser usado para criar o cursor. Os dados no arquivo devem estar em qualquer um.CUR ou.Formato de ANI.

Se o alto-ordem palavra de lpszFileName é diferente de zero, é um ponteiro para uma Cadeia de caracteres que é um nome totalmente qualificado de um arquivo que contém dados do cursor.

Se o alto-ordem palavra de lpszFileName for zero, a baixa-ordem palavra é um identificador de cursor do sistema. A função, em seguida, procura a entrada [cursores] na vitória.Arquivo INI para o arquivo associado com o nome de cursor nesse sistema. Aqui está uma lista de nomes de cursor do sistema e identificadores:
Nome de sistema de Cursor Identificador de Cursor de sistema
"AppStarting" OCR_APPSTARTING
"Seta" OCR_NORMAL
"Mira" OCR_CROSS
"Mão" Windows NT 5.0 e posterior: OCR_HAND
"Ajuda" OCR_HELP
"IBeam" OCR_IBEAM
"Ícone" OCR_ICON
"Não" OCR_NO
"Tamanho" OCR_SIZE
"SizeAll" OCR_SIZEALL
"SizeNESW" OCR_SIZENESW
"SizeNS" OCR_SIZENS
"SizeNWSE" OCR_SIZENWSE
"SizeWE" OCR_SIZEWE
"UpArrow" OCR_UP
"Wait" OCR_WAIT

Por exemplo, se a vitória.Arquivo INI contém os seguintes:

[Cursores] 
    Seta = "arrow.ani" 

 

Em seguida, a chamada

LoadCursorFromFile((LPWSTR)OCR_NORMAL) 

 

faz com que a função de LoadCursorFromFile obter dados do cursor do arquivo de seta.ANI. Se a vitória.Arquivo INI não contém uma entrada para o cursor de sistema especificado, a função falha e retorna NULL.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é um identificador para o cursor novo.

Se a função falhar, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError. GetLastError pode retornar o seguinte valor

Valor Significado
ERROR_FILE_NOT_FOUND O arquivo especificado não pôde ser encontrado.

QuickInfo

nbsp; Windows &NT: requer a versão 3.5 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de cursores, funções de Cursor, LoadCursor, SetCursor, SetSystemCursor