הפונקציה LoadCursorFromFile יוצרת סמן בהתבסס על הנתונים הכלולים בקובץ. הקובץ שצוין לפי שמו או על-ידי מזהה הסמן מערכת. הפונקציה מחזירה את מזהה ייחודי לסמן החדש שנוצר. ייתכן שקבצי המכיל נתונים הסמן בסמן או (.נוכחי) או סמן מונפש (.עיצוב ANI).
(HCURSOR LoadCursorFromFile LPCTSTR lpFileName / / מצביע שם קובץ הסמן, או מערכת / / מזהה הסמן);
אם המילה הגבוהות של lpszFileName אינו אפס, הוא מצביע מחרוזת שהוא שם מלא של קובץ המכיל נתונים הסמן.
אם המילה הגבוהות של lpszFileName הוא אפס, word מסדר נמוך הוא מזהה הסמן המערכת. הפונקציה מחפש את הערך [סמנים] ב הניצחון.קובץ INI עבור הקובץ המשויך השם את הסמן המערכת. הנה רשימה של מזהי ושמות הסמן של המערכת:
| שם הסמן של המערכת | מזהה מערכת הסמן |
|---|---|
| "AppStarting" | OCR_APPSTARTING |
| "חץ" | OCR_NORMAL |
| "צלב דק" | OCR_CROSS |
| "יד" | Windows NT 5.0 ואילך: OCR_HAND |
| "עזרה" | OCR_HELP |
| "IBeam" | OCR_IBEAM |
| "סמל" | OCR_ICON |
| "לא" | OCR_NO |
| "גודל" | OCR_SIZE |
| "SizeAll" | OCR_SIZEALL |
| "SizeNESW" | OCR_SIZENESW |
| "SizeNS" | OCR_SIZENS |
| "SizeNWSE" | OCR_SIZENWSE |
| "SizeWE" | OCR_SIZEWE |
| "UpArrow" | OCR_UP |
| "המתן" | OCR_WAIT |
לדוגמה, אם הניצחון.קובץ INI כוללת את הרכיבים הבאים:
[סמנים]
החץ = "arrow.ani"
לאחר מכן את השיחה
LoadCursorFromFile((LPWSTR)OCR_NORMAL)
גורם הפונקציה LoadCursorFromFile לקבלת סמן נתונים מקובץ החץ.ANI. אם הניצחון.קובץ INI שאינו מכיל ערך עבור הסמן המערכת שצוין, הפונקציה נכשלת ומחזירה NULL.
אם הפונקציה הושלמה בהצלחה, הערך המוחזר הוא נקודת אחיזה כדי סמן חדש.
אם הפעולה תיכשל, הערך המוחזר הוא NULL. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError. GetLastError עשויה להחזיר את הערך הבא
| ערך | משמעות |
|---|---|
| ERROR_FILE_NOT_FOUND | לא היתה אפשרות לאתר את הקובץ שצוין. |
nbsp; Windows &NT: מחייב גירסה 3.5 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
סקירה כללית של סמנים, פונקציות הסמן, LoadCursor, SetCursor, SetSystemCursor