LoadCursor

Funcția LoadCursor încarcă resursa specificată cursorul la executabil (.Fișier EXE) asociate cu o instanta application.

Această funcție a fost înlocuit de funcția LoadImage

(HCURSOR LoadCursor HINSTANCE  hInstance, / / ocupa de instanta applicationLPCTSTRlpCursorName / / nume identificator de resursă șir sau cursorul);
 

Parametrii

hInstance
Mâner de instanta modulului ale căror executable dosar conține cursorul se încarcă.
lpCursorName
Indicatorul un șir null-terminated care conține numele resursei cursorul se încarcă. Alternativ, acest parametru poate consta identificatorul de resursă în cuvântul low-ordine și zero în cuvântul-high-comandă. Macrocomanda MAKEINTRESOURCE poate fi, de asemenea, folosit pentru a crea această valoare.

Pentru a utiliza una dintre cursoare Win32 predefinite, cererea trebuie să setați parametrul hInstance la NULĂ și parametrul lpCursorName la unul la următoarele valori:
Valoarea Descriere
IDC_APPSTARTING Clepsidră mici și săgeată standard
IDC_ARROW Săgeată standard
IDC_CROSS Crosshair
IDC_HAND Windows NT 5.0 și mai târziu: Mână
IDC_HELP Semn de întrebare și săgeată
IDC_IBEAM Liniar
IDC_ICON Obsolete pentru aplicații marcate versiunea 4.0 sau ulterioară.
IDC_NO Cerc slashed
IDC_SIZE Obsolete pentru aplicații marcate versiunea 4.0 sau ulterioară. Utilizarea IDC_SIZEALL.
IDC_SIZEALL Săgeată cu patru vârfuri spre nord, Sud, est și vest
IDC_SIZENESW Dublu-a subliniat săgeată spre est și sud-vest
IDC_SIZENS Dublu-a subliniat săgeată spre nord și de Sud
IDC_SIZENWSE Dublu-a subliniat săgeată spre nord-vest ?i sud-est
IDC_SIZEWE Dublu-a subliniat săgeată îndreptată vest si est
IDC_UPARROW Săgeata verticală
IDC_WAIT Clepsidră

Valorile întroarse

Dacă funcția reușește, valoarea returnată este ghidajul pentru cursorul nou încărcate.

Dacă funcția nu reușește, valoarea returnată este NULL. Pentru a obține extins informa?ii eroare, apel GetLastError.

Observații

Funcția LoadCursor încarcă resurse cursorul numai în cazul în care acesta nu a fost încărcat; în caz contrar, acesta regăsește ghidajul resursei existente. Această funcție întoarce un mâner cursorul valabile doar dacă punctele de parametru de lpCursorName la o resursă cursorul. Dacă lpCursorName puncte de la orice tip de resurse altele decât un cursor (cum ar fi o pictogramă), valoarea returnată nu este NULĂ, chiar dacă nu este un mâner cursorul valabile.

Funcția LoadCursor caută resursa cursorul cel mai potrivit pentru cursorul pentru dispozitivul de afișare curent. Resursa cursorul poate fi un bitmap color sau monocrom.

Windows CE: Utilizați componenta cursorul când o platformă care nu acceptă cursoare de mouse-ului de orientare. Cursor numai acceptă această componentă este așteptați cursorul (IDC_WAIT). Utilizați funcția LoadCursor împreună cu funcția SetCursor pentru a seta cursorul așteptați.

SetCursor (LoadCursor (NULL, IDC_WAIT))

Utilizați componenta de mcursor atunci când o platformă care acceptă cursoare de mouse-ului de orientare. Această componentă acceptă funcția de LoadCursor același mod Windows desktop platforme face, cu excepția faptului că acceptă numai cursoare în monocromă. Windows CE nu acceptă cursoarele de culoare. Încercarea de a încărca un cursor de culoare va avea rezultate neprevăzute.

A se vedea, de asemenea

Cursoare prezentare generală, funcții cursorul, LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor

Index