LoadCursor

Funksjonen LoadCursor laster den angitte markør ressursen fra den kjørbare filen (.EXE) arkiv forbundet med en programforekomst.

Denne funksjonen har blitt erstattet av LoadImage -funksjon

() HCURSOR LoadCursor HINSTANCE  hInstance, / / håndtere til programforekomstenLPCTSTRlpCursorName / / navn streng eller markøren ressursidentifikatoren);
 

Parametere

hInstance

Håndtere til en forekomst av modulen der kjørbare filen som inneholder markøren skal lastes inn.

lpCursorName

Pekeren til en null-terminert streng som inneholder navnet på ressursen markøren skal lastes inn. Denne parameteren kan eventuelt bestå av ressursidentifikatoren i signifikante ordet og null i signifikante ordet. MAKEINTRESOURCE makroen kan også brukes til å opprette denne verdien.

For å bruke en av markørene Win32 forhåndsdefinerte, må programmet sette parameteren hInstance til NULL og parameteren lpCursorName til en følgende verdier:

Verdi	Beskrivelse
IDC_APPSTARTING	Standard pilen og små Timeglass
IDC_ARROW	Standard pil
IDC_CROSS	Trådkors
IDC_HAND	Windows NT 5.0 og senere: Hånd
IDC_HELP	Pil og spørsmålstegn
IDC_IBEAM	Tekstmarkør
IDC_ICON	Utdatert for programmer som er markert versjon 4.0 eller senere.
IDC_NO	Slashed sirkel
IDC_SIZE	Utdatert for programmer som er markert versjon 4.0 eller senere. Bruk IDC_SIZEALL.
IDC_SIZEALL	Firehodet pil som peker mot nord, Sør, øst og vest
IDC_SIZENESW	Dobbelthodet pil som peker nordøst og sørvest
IDC_SIZENS	Dobbelthodet pil som peker mot nord og Sør
IDC_SIZENWSE	Dobbelthodet pil som peker mot nordvest og Sørøst
IDC_SIZEWE	Dobbelthodet pil som peker mot vest og øst
IDC_UPARROW	Vertikal pil
IDC_WAIT	Timeglass

Returverdier

Hvis funksjonen lykkes, er returverdien referanse til den nylig lastede markøren.

Hvis funksjonen mislykkes, er verdien som returneres NULL. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Funksjonen LoadCursor laster markøren ressursen bare hvis det ikke er lastet; Ellers henter det referansen til den eksisterende ressursen. Denne funksjonen returnerer en gyldig markøren håndtaket bare hvis poeng for lpCursorName -parameteren til en markør-ressurs. Hvis lpCursorName peker til hvilken som helst annen ressurs enn en markør (for eksempel et ikon), returverdien er ikke NULL, selv om det ikke er en gyldig markørreferanse.

Den LoadCursor -funksjonen søker etter markøren-ressursen som er best egnet for markør for gjeldende visningsenhet. Markøren ressursen kan være en farge eller svart/hvitt-punktgrafikk.

Windows CE: Bruk markøren komponenten når målretting en plattform som ikke støtter musepekere. Denne komponenten støtter bare markøren er vent markøren (IDC_WAIT). Bruk funksjonen LoadCursor sammen med SetCursor -funksjonen til å angi Vent markøren.

SetCursor (LoadCursor (NULL, IDC_WAIT))

Du kan bruke mcursor-komponenten når målretting en plattform som støtter musepekere. Denne komponenten støtter funksjonen LoadCursor den samme måten Windows stasjonære plattformer gjør, bortsett fra at det bare støtter monokrom markører. Windows CE støtter ikke farge markører. Et forsøk på å laste inn en farge markøren vil ha uforutsigbare resultater.

Se også

Markører oversikt, markøren funksjoner, LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor

Index