DrawIconEx

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

 (BOOL DrawIconEx HDC  hdc, / / לטפל להקשר התקןintxLeft, / / קואורדינטת x של פינה הימנית העליונהintyTop, / / קואורדינטת y של פינה הימנית העליונהHICONhIcon, / / לטפל סמל כדי לצייר intcxWidth, / / רוחב של הסמל intcyWidth, / / גובה של הסמלUINTistepIfAniCur, / / אינדקס של מסגרת הנפשה הסמןHBRUSHhbrFlickerFreeDraw, / / לטפל למברשת רקע UINTdiFlags / / דגלי סמל-ציור);
 

פרמטרים

hdc
לטפל להקשר התקן עבור חלון.
xLeft
ציון לוגי הקואורדינטה x של הפינה השמאלית העליונה של הסמל או הסמן.
yTop
ציון לוגי קואורדינטת y של הפינה השמאלית העליונה של הסמל או הסמן.
hIcon
לטפל סמל או הסמן כדי לצייר. פרמטר זה ניתן לזהות סמנים מונפשים. יש סמל או סמן המשאב נטענו בעבר באמצעות הפונקציה LoadImage.
cxWidth
מציין את רוחב לוגי של סמל או של הסמן. אם פרמטר זה הוא אפס הפרמטר diFlags הוא DI_DEFAULTSIZE, הפונקציה משתמשת SM_CXICON SM_CXCURSOR מערכת מטרי הערך או כדי להגדיר את הרוחב. אם פרמטר זה הוא אפס, לא נעשה שימוש DI_DEFAULTSIZE, הפונקציה משתמשת רוחב משאב ממשי.
cyWidth
מציין את גובה לוגי של סמל או של הסמן. אם פרמטר זה הוא אפס הפרמטר diFlags הוא DI_DEFAULTSIZE, הפונקציה משתמשת SM_CYICON SM_CYCURSOR מערכת מטרי הערך או כדי להגדיר את הרוחב. אם פרמטר זה הוא אפס, לא נעשה שימוש DI_DEFAULTSIZE, הפונקציה משתמשת גובה משאב ממשי.
istepIfAniCur
מציין את האינדקס של המסגרת לציור, אם hIcon מזהה סמן מונפש. פרמטר זה תקף אם hIcon לא לזהות את סמן מונפש.
hbrFlickerFreeDraw
לטפל למברשת, המשמש את המערכת לצורך ציור ללא הבהוב. אם hbrFlickerFreeDraw הוא מזהה ייחודי חוקי מברשת, המערכת יוצר והפיכתו לתמונת bitmap בעזרת מברשת שצוין עבור צבע הרקע, מצייר את הסמל או את הסמן לתוך מפת הסיביות ולאחר מכן מעתיק את מפת הסיביות לתוך הקשר ההתקן המזוהה על-ידי hdc. אם hbrFlickerFreeDraw הוא NULL, המערכת מצייר את הסמל או את הסמן ישירות לתוך הקשר ההתקן.
diFlags
מציין את הדגלים הציור. פרמטר זה יכול להיות אחד מהבאים:
ערך משמעות
DI_COMPAT מצייר את הסמל או את הסמן באמצעות תמונת ברירת המחדל של המערכת במקום התמונה שצוין על-ידי המשתמש.
DI_DEFAULTSIZE מצייר את הסמל או את הסמן באמצעות רוחב וגובה שצוין על-ידי מערכת הערכים מטרי של סמנים או סמלים, אם פרמטרי cxWidth ו- cyWidth מוגדר כאפס. אם דגל זה לא צוין, cxWidth ו- cyWidth מוגדרים לאפס, הפונקציה משתמשת גודל משאב ממשי.
DI_IMAGE מצייר את הסמל או את הסמן באמצעות התמונה.
DI_MASK מצייר את הסמל או את הסמן באמצעות המסכה.
DI_NORMAL שילוב של DI_IMAGE ו- DI_MASK.

להחזיר ערכים

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

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

הערות

הפונקציה DrawIconEx מציב הסמל בפינה השמאלית העליונה במיקום שצוין על-ידי פרמטרים xLeft ו- yTop . המיקום הוא כפוף מצב מיפוי נוכחי של הקשר ההתקן.

חלונות CE: יש להשתמש בהגדרות הבאות של פרמטר

תומך Windows CE:

הפרמטר hIcon אין אפשרות לזהות סמנים מונפשים.

QuickInfo

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

ראה גם

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

Index