SetCursor

הפונקציה SetCursor יוצר את צורת הסמן.

(HCURSOR SetCursor HCURSOR  hCursor / / לטפל עד לסמן);
 

פרמטרים

hCursor
לטפל לסמן. עליך הסמן שנוצרו על-ידי CreateCursor או נטען על-ידי הפונקציה LoadCursor או LoadImage . אם פרמטר זה הוא NULL, הסמן מוסר מן המסך.

Windows 95: הרוחב והגובה של הסמן חייבים להיות ערכים המוחזרים על-ידי GetSystemMetrics פונקציה עבור SM_CXCURSOR ו- SM_CYCURSOR. בנוסף, עומק סיביות של הסמן להתאים את עומק סיביות של התצוגה או הסמן להיות בשחור-לבן.

להחזיר ערכים

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

אם היה הסמן הקודם לא, הערך המוחזר הוא NULL.

הערות

הסמן מוגדר רק אם הסמן החדש שונה הסמן הקודם; אחרת, הפונקציה מחזירה מיד.

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

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

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

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

SetCursor (LoadCursor (NULL, IDC_WAIT));

השתמש ברכיב mcursor כשמתכוונים פלטפורמה תומכת סמני עכבר. רכיב זה אינו תומך בסמנים צבע.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.

ראה גם

סקירה כללית של סמנים, הסמן מתפקד, CreateCursor, GetCursor, GetSystemMetrics, LoadCursor, LoadImage, SetCursorPos, ShowCursor

Index