LoadCursor

הפונקציה LoadCursor טוען את המשאב שצוין הסמן מתוך קובץ ההפעלה (.קובץ EXE) המשויך מופע של יישום.

פונקציה זו הוחלף על-ידי הפונקציה LoadImage

(HCURSOR LoadCursor HINSTANCE  hInstance, / / לטפל מופע היישוםLPCTSTRlpCursorName / / שם מזהה משאב מחרוזת או הסמן);
 

פרמטרים

hInstance
לטפל למופע של קובץ ההפעלה שלה מכיל את הסמן טעינת המודול.
lpCursorName
המצביע למחרוזת המסתיימת ב- null המכיל את השם של משאב הסמן שיש לטעון. לחלופין, פרמטר זה עשוי לכלול מזהה המשאב ב- word מסדר נמוך, ואפס את המילה הגבוהות. המאקרו MAKEINTRESOURCE יכול לשמש גם כדי ליצור ערך זה.

כדי להשתמש באחד סמנים Win32 מראש, היישום עליך להגדיר הפרמטר hInstance NULL, את הפרמטר lpCursorName לאחד את הערכים הבאים:
ערך תיאור
IDC_APPSTARTING חץ רגיל ו חול קטן
IDC_ARROW חץ רגיל
IDC_CROSS צלב דק
IDC_HAND Windows NT 5.0 ואילך: יד
IDC_HELP סימן השאלה וחץ
IDC_IBEAM מצביע i
IDC_ICON מיושנים עבור יישומים שסומנו גירסה 4.0 ואילך.
IDC_NO עיגול עם לוכסן
IDC_SIZE מיושנים עבור יישומים שסומנו גירסה 4.0 או גירסה מתקדמת יותר. שימוש IDC_SIZEALL.
IDC_SIZEALL ארבעה ראשים הצבעה צפון, דרום, מזרח ומערב
IDC_SIZENESW לחץ דו-ראשי הצבעה מצפון־מזרח ו דרום מערב
IDC_SIZENS לחץ דו-ראשי הצבעה צפון ודרום
IDC_SIZENWSE לחץ דו-ראשי הצבעה מצפון־מערב ובדרום־מזרח קולומביה
IDC_SIZEWE לחץ דו-ראשי הצבעה מזרח ומערב
IDC_UPARROW חץ אנכי
IDC_WAIT שעון החול

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר הוא נקודת האחיזה כדי הסמן הטעון החדש.

אם הפעולה תיכשל, הערך המוחזר הוא NULL. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.

הערות

הפונקציה LoadCursor טוען את המשאב הסמן רק אם הוא לא נטען; אחרת, היא מאחזרת את נקודת האחיזה כדי משאב קיים. פונקציה זו מחזירה מזהה ייחודי חוקי הסמן רק אם נקודות הפרמטר lpCursorName למשאב הסמן. אם lpCursorName מצביע על כל סוג של משאב מלבד הסמן (כגון סמל), ערך ההחזרה אינה NULL, למרות שזה לא מזהה ייחודי חוקי הסמן.

הפונקציה LoadCursor מחפש את המשאב הסמן המתאים ביותר עבור הסמן עבור התקן התצוגה הנוכחית. המשאב הסמן יכול להיות מפת סיביות בצבע או בשחור-לבן.

חלונות CE: השתמש ברכיב הסמן כשמתכוונים פלטפורמה תומכת סמני עכבר. הסמן רק שרכיב זה תומך נמצא הסמן ההמתנה (IDC_WAIT). השתמש בפונקציה LoadCursor בשילוב עם הפונקציה SetCursor כדי להגדיר את הסמן ההמתנה.

SetCursor (LoadCursor (NULL, IDC_WAIT))

השתמש ברכיב mcursor כשמתכוונים פלטפורמה תומכת סמני עכבר. רכיב זה תומך הפונקציה LoadCursor Windows באופן זהה פלטפורמות שולחן עבודה לעשות, פרט לכך הוא תומך רק ב סמנים בשחור-לבן. Windows CE אינו תומך בסמנים צבע. ניסיון לטעון את סמן צבע תהיה לתוצאות בלתי צפויות.

ראה גם

סקירה כללית של סמנים, פונקציות הסמן, LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor

Index