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