CreateIcon

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

(HICON CreateIcon HINSTANCE  hInstance, / / לטפל מופע היישוםintnWidth, / / סמל רוחבintnHeight, / / גובה סמלשני בתיםcPlanes, / / מספר מטוסים מסיכת סיביות של XORשני בתיםcBitsPixel, / / מספר סיביות לפיקסל ב מסיכת סיביות של XORבית CONST* lpbANDbits, / / מצביע למערך מסכת סיביות ANDבית CONST* lpbXORbits / / מצביע למערך מסיכת סיביות של XOR);

פרמטרים

hInstance: לטפל למופע של מודול יצירת הסמל.
nWidth: ציון הרוחב, בפיקסלים, של סמל.
nHeight: ציון הגובה, בפיקסלים, של סמל.
cPlanes: מציין את מספר המטוסים XOR מסיכת הסיביות של הסמל.
cBitsPixel: מציין את מספר סיביות לפיקסל XOR מסיכת הסיביות של הסמל.
lpbANDbits: מצביע של מערך בתים המכיל את הערכים סיביות עבור AND מסיכת הסיביות של הסמל. מסיכת סיביות זה מתאר bitmap בשחור-לבן.
lpbXORbits: מצביע של מערך בתים המכיל את הערכים סיביות עבור XOR מסיכת הסיביות של הסמל. מסיכת סיביות זה מתאר חד-צבעית או מפת סיביות של צבע תלוי-התקן.

להחזיר ערכים

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

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

הערות

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

האמת שלהלן מתייחס CreateIcon AND ו XOR bitmasks:

ואת מסיכת סיביות	מסיכת סיביות של XOR	תצוגה
0	0	שחור
0	1	לבן
1	0	מסך
1	1	מסך הפוך

QuickInfo

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

ראה גם

סקירה כללית של סמלים, סמל פונקציות, GetSystemMetrics

Index