הפונקציה ChooseColor יוצרת צבע נפוצות תיבת דו-שיח המאפשרת למשתמש לבחור צבע.
(BOOL ChooseColor LPCHOOSECOLOR lpcc / / מצביע למבנה עם אתחול / / נתונים);
אם המשתמש לוחץ על לחצן ' אישור ' של תיבת הדו-שיח, הערך המוחזר הוא שונה מאפס. חבר rgbResult של מבנה CHOOSECOLOR מכיל ערך צבע RGB של צבע שנבחר על-ידי המשתמש.
אם המשתמש מבטל או סוגר את תיבת הדו-שיח צבע או שתתרחש שגיאה, הערך המוחזר הוא אפס. כדי לקבל מידע שגיאות מורחב, לבצע קריאה לפונקציה CommDlgExtendedError , אשר יכול להחזיר את אחד הערכים הבאים:
| CDERR_FINDRESFAILURE | CDERR_MEMLOCKFAILURE |
| CDERR_INITIALIZATION | CDERR_NOHINSTANCE |
| CDERR_LOCKRESFAILURE | CDERR_NOHOOK |
| CDERR_LOADRESFAILURE | CDERR_NOTEMPLATE |
| CDERR_LOADSTRFAILURE | CDERR_STRUCTSIZE |
| CDERR_MEMALLOCFAILURE |
תיבת הדו-שיח צבע אינו תומך לוחות. אפשרויות צבע המוצעות על-ידי תיבת הדו-שיח מוגבלות לצבעי המערכת וגירסאות ממוזג של צבעים אלה.
באפשרותך לספק שגרה הוו CCHookProc עבור תיבת הדו-שיח צבע . ההליך הוו ניתן לעבד הודעות שנשלחו אל תיבת הדו-שיח. כדי לאפשר שגרה הוו, הגדרת הדגל CC_ENABLEHOOK החבר בדגלים של מבנה CHOOSECOLOR , ציין את הכתובת של ההליך הוו חבר lpfnHook.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:מחייב גירסה 2.0 או גירסה מתקדמת יותר.
כותרת עליונה:להצהיר על commdlg.h.
ייבוא ספריית:השתמש comdlg32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
סקירה נפוצות על תיבת הדו-שיח ספריית, פונקציות נפוצות של תיבת הדו-שיח, CCHookProc, CHOOSECOLOR, CommDlgExtendedError