LoadCursor

Die Funktion LoadCursor lädt die angegebenen Cursor-Ressource aus der ausführbaren Datei (.(EXE) Datei einer Anwendungsinstanz zugeordnet.

Diese Funktion wurde von der LoadImage -Funktion ersetzt

HCURSOR LoadCursor-) HINSTANCE  hInstance, / / handle für die AnwendungsinstanzLPCTSTRLpCursorName / / name-Zeichenfolge oder Cursor Ressourcenbezeichner);
 

Parameter

hInstance

Behandeln Sie, um eine Instanz des Moduls deren ausführbare Datei enthält den Cursor geladen werden.

lpCursorName

Zeiger auf eine auf Null endende Zeichenfolge, die enthält den Namen der der Cursor-Ressource geladen werden. Alternativ kann dieser Parameter der Ressourcenbezeichner im niederwertigen Wort und NULL im höherwertigen Wort bestehen. Das MAKEINTRESOURCE -Makro kann auch verwendet werden, um diesen Wert zu erstellen.

Um eine vordefinierte Win32 Cursor verwenden, muss die Anwendung dem hInstance -Parameter NULL und der LpCursorName -Parameter an eine der folgenden Werte festlegen:

Wert	Beschreibung
IDC_APPSTARTING	Standardpfeil und kleine Sanduhr
IDC_ARROW	Standardpfeil
IDC_CROSS	Fadenkreuz
IDC_HAND	Windows NT 5.0 und höher: Hand
IDC_HELP	Pfeil- und Fragezeichen
IDC_IBEAM	Faltwerkzeug
IDC_ICON	Veraltete Anwendungen gekennzeichnet Version 4.0 oder höher.
IDC_NO	Durchgestrichene Kreis
IDC_SIZE	Veraltete Anwendungen gekennzeichnet Version 4.0 oder höher. Verwendung IDC_SIZEALL.
IDC_SIZEALL	Vier Spitzen Pfeil Norden, Süden, Osten und Westen
IDC_SIZENESW	Doppelpfeil nach Nordosten und Südwesten
IDC_SIZENS	Doppelpfeil nach Norden und Süden
IDC_SIZENWSE	Doppelpfeil nach Nordwesten und Südosten
IDC_SIZEWE	Doppelpfeil zeigt West und Ost
IDC_UPARROW	Vertikaler Pfeil
IDC_WAIT	Sanduhr

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für den neu geladenen cursor.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Die Funktion LoadCursor lädt die Cursor-Ressource nur dann, wenn es nicht geladen wurde. Andernfalls ruft es das Handle für die vorhandene Ressource. Diese Funktion gibt einem gültige Cursor-Handle nur, wenn die LpCursorName Parameter zeigt auf eine Cursor-Ressource zurück. Wenn LpCursorName auf jede Art von Ressource als ein Cursor (z. B. ein Symbol) zeigt, ist der Rückgabewert nicht NULL, auch wenn es keine gültige Cursor-Handle.

Die Funktion LoadCursor sucht die Cursor-Ressource für den Cursor für die aktuelle Anzeigegerät am besten geeignet. Die Cursor-Ressource kann eine Farbe oder Monochrom-Bitmap sein.

Windows CE: Verwenden Sie die Cursor-Komponente, wenn eine Plattform, die Mauscursor nicht unterstützt. Der einzige Cursor, die, den diese Komponente unterstützt, ist der Wartecursor (IDC_WAIT). Mithilfe der Funktion LoadCursor in Verbindung mit der SetCursor -Funktion den Wartecursor fest.

SetCursor (LoadCursor (NULL, IDC_WAIT))

Verwenden Sie die Mcursor-Komponente, wenn eine Plattform, die Mauscursor unterstützt. Diese Komponente unterstützt die Funktion LoadCursor dem Weg Windows PC-Plattformen zu tun, außer dass es nur monochrome Cursor unterstützt. Windows CE unterstützt keine Farben Cursor. Versuch, einen Farbe Cursor laden wird unvorhersehbare Auswirkungen haben.

Siehe auch

Übersicht über die Cursor, Cursor-Funktionen, LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor

Index