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