LoadCursorFromFile

Die LoadCursorFromFile -Funktion erstellt einen Cursor auf der Grundlage von Daten in einer Datei enthalten. Die Datei wird durch seinen Namen oder durch einen System-Cursor-Bezeichner angegeben. Die Funktion gibt einen Handle auf den neu erstellten Cursor. Dateien mit Cursor Daten möglicherweise in entweder Cursor (.CUR) oder animierte Cursor (.ANI) format.

HCURSOR LoadCursorFromFile) LPCTSTR  zu / / Zeiger auf den Namen des Cursor-Datei, oder System / / Cursor-ID);
 

Parameter

zu
Gibt die Quelle der Dateidaten verwendet werden, um den Cursor zu erstellen. Die Daten in der Datei müssen entweder sein.CUR oder.ANI-format.

Wenn das hohe Word der LpszFileName ungleich NULL ist, ist es ein Zeiger auf eine Zeichenfolge, die einen voll gekennzeichneten Namen einer Datei mit Cursor Daten ist.

Wenn das hohe Word der LpszFileName NULL ist, ist das niedrige Word ein System Cursor Bezeichner. Die Funktion sucht dann den Eintrag [Cursor] in den Sieg.INI-Datei für die Datei mit dem Namen von diesem Systemcursor verknüpft. Hier ist eine Liste der System-Cursornamen und IDs:
System-Cursor-Namen Cursor-System-ID
"AppStarting" OCR_APPSTARTING
"Pfeil" OCR_NORMAL
"Fadenkreuz" OCR_CROSS
"Hand" Windows NT 5.0 und höher: OCR_HAND
"Hilfe" OCR_HELP
"IBeam" OCR_IBEAM
"Symbol" OCR_ICON
"Nein" OCR_NO
"Größe" OCR_SIZE
"SizeAll" OCR_SIZEALL
"SizeNESW" OCR_SIZENESW
"SizeNS" OCR_SIZENS
"SizeNWSE" OCR_SIZENWSE
"SizeWE" OCR_SIZEWE
"Nach-oben" OCR_UP
"Warten" OCR_WAIT

Zum Beispiel, wenn der Sieg.INI-Datei enthält die folgenden:

[Cursor] 
    Pfeil = "arrow.ani" 

 

Dann den Anruf

LoadCursorFromFile((LPWSTR)OCR_NORMAL) 

 

bewirkt, dass die LoadCursorFromFile -Funktion die Datei Pfeil Cursor Daten einzuholen.ANI. Wenn der Sieg.INI-Datei enthält einen Eintrag für den angegebenen Systemcursor nicht, die Funktion schlägt fehl und gibt NULL zurück.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den neuen cursor.

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

Wert Bedeutung
ERROR_FILE_NOT_FOUND Die angegebene Datei konnte nicht gefunden werden.

QuickInfo

&Nbsp; Windows NT: erfordert Version 3.5 oder höher.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Übersicht über die Cursor, Cursor-Funktionen, LoadCursor, SetCursor, SetSystemCursor

Index