LoadCursorFromFile

LoadCursorFromFile -funksjonen oppretter en markør som er basert på data i en fil. Filen er angitt ved sitt navn, eller ved en systemidentifikatoren markøren. Funksjonen returnerer et håndtak til den nylig opprettede markøren. Filer som inneholder markøren data kan være i enten markøren (.CUR) eller animerte markører (.ANI)-format.

() HCURSOR LoadCursorFromFile LPCTSTR  lpFileName / / peker til navnet på markøren fil eller systemet / / markøren identifikator);
 

Parametere

lpFileName
Angir kilden til filen dataene skal brukes til å opprette markøren. Dataene i filen må være i ett.CUR eller.ANI-format.

Hvis signifikante ordet av lpszFileName er ikke-null, er det en peker til en streng som er et fullstendig kvalifisert navn på en fil som inneholder markøren data.

Hvis ordet signifikante av lpszFileName er null, er signifikante ordet en systemidentifikatoren markøren. Funksjonen søker deretter oppføringen [markører] i seier.INI-filen for filen som er knyttet til navnet på systemmarkøren. Her er en liste over navn på markøren og identifikatorer:
Markøren systemnavn Markøren systemidentifikatoren
"AppStarting" OCR_APPSTARTING
«Venstre pil» OCR_NORMAL
"Trådkors" OCR_CROSS
"Hånd" Windows NT 5.0 og senere: OCR_HAND
"Hjelp" OCR_HELP
"IBeam" OCR_IBEAM
"Ikon" OCR_ICON
"Nei" OCR_NO
"Størrelse" OCR_SIZE
"SizeAll" OCR_SIZEALL
"SizeNESW" OCR_SIZENESW
"SizeNS" OCR_SIZENS
"SizeNWSE" OCR_SIZENWSE
"SizeWE" OCR_SIZEWE
"UpArrow" OCR_UP
"Vent" OCR_WAIT

For eksempel hvis seier.INI-filen inneholder følgende:

[Markører] 
    Pilen = "arrow.ani" 

 

Deretter samtalen

LoadCursorFromFile((LPWSTR)OCR_NORMAL) 

 

fører til at LoadCursorFromFile -funksjonen til å hente data for markøren i filen PILEN.ANI. Hvis seier.INI-filen inneholder ikke en oppføring for angitte systemmarkøren, funksjonen mislykkes og returnerer NULL.

Returverdier

Hvis funksjonen er vellykket, er returverdien en referanse til nye markøren.

Hvis funksjonen mislykkes, er verdien som returneres NULL. Til å vise utvidet feilinformasjon, kan du ringe GetLastError. GetLastError kan returnere følgende verdi

Verdi Betydning
ERROR_FILE_NOT_FOUND Finner ikke den angitte filen.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.5 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.

Se også

Markører oversikt, markøren funksjoner, LoadCursor, SetCursor, SetSystemCursor