CreateCursor

הפונקציה CreateCursor יוצרת סמן נתקל הגודל שצוין, דפוסים של סיביות מגע.

(HCURSOR CreateCursor HINSTANCE  hInst, / / לטפל מופע היישוםintxHotSpot, / / המיקום האופקי של חמים ספוטintyHotSpot, / / המיקום האנכי של חמים ספוטintnWidth, / / רוחב הסמן intnHeight, / / גובה הסמןהאין CONST* pvANDPlane, / / מצביע למערך מסכת סיביות ANDהאין CONST* pvXORPlane / / מצביע למערך מסיכת סיביות של XOR);
 

פרמטרים

hInst
לטפל על המופע הנוכחי של היישום יוצר את הסמן.
xHotSpot
מציין את המיקום האופקי של נקודת המגע של הסמן.
yHotSpot
ציון המיקום האנכי של נקודת המגע של הסמן.
nWidth
ציון הרוחב, בפיקסלים, של הסמן.
nHeight
ציון הגובה, בפיקסלים, של הסמן.
pvANDplane
מצביע של מערך בתים המכיל את הערכים סיביות עבור מסיכת הסיביות AND של הסמן, כמו ב- bitmap בשחור-לבן של תלוי-התקן.
pvXORplane
מצביע של מערך בתים המכיל את הערכים סיביות עבור מסיכת הסיביות של XOR של הסמן, כמו ב- bitmap בשחור-לבן של תלוי-התקן.

להחזיר ערכים

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

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

הערות

פרמטרים nWidth ו- nHeight עליך לציין רוחב וגובה הנתמכים על-ידי מנהל התצוגה הנוכחי, מכיוון המערכת אין אפשרות ליצור סמנים של גדלים אחרים. כדי לקבוע את הרוחב והגובה נתמכת על-ידי מנהל התצוגה, השתמש בפונקציה GetSystemMetrics , המציין את הערך SM_CXCURSOR או SM_CYCURSOR.

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

QuickInfo

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

ראה גם

סקירה כללית של סמנים, הסמן מתפקד, CreateIcon, DestroyCursor, GetModuleHandle, GetSystemMetrics, SetCursor