ספריית נפוצות של תיבת הדו-שיח מספקת פונקציה יצירת מבנה עבור כל סוג של תיבת דו-שיח נפוצות. כדי להשתמש בתיבת הדו-שיח נפוצות בצורתה הפשוטה ביותר, לפונקציה היצירה שלו וציין מצביע למבנה המכילים את הערכים ההתחלתיים ודגלים אפשרות. לאחר אתחול תיבת הדו-שיח, ההליך תיבת הדו-שיח משתמשת המבנה כדי להחזיר מידע אודות הקלט של המשתמש. באפשרותך גם להתאים אישית תיבת דו-שיח נפוצות בהתאם לצרכים של היישום שלך.
הטבלה הבאה מספקת תיאור קצר של הסוגים השונים של תיבות הדו-שיח המשותפות של ומציג את התפקיד והמבנה בשימוש עם כל סוג.
| בתיבת דו-שיח | תיאור |
|---|---|
| צבע | מציג את הצבעים הזמינים, באופן אופציונלי מאפשר למשתמש ליצור צבעים מותאמים אישית. המשתמש יכול לבחור צבע בסיסי או מותאם אישית. השתמש בפונקציה ChooseColor ומבנה CHOOSECOLOR. |
| חיפוש | מציג תיבת דו-שיח שבה המשתמש להקליד את מחרוזת לחיפוש. המשתמש יכול גם לציין אפשרויות חיפוש, כגון כיוון החיפוש אם החיפוש תלוי רישיות. השתמש בפונקציה FindText ומבנה FINDREPLACE. |
| גופן | הצגת רשימות של הגופנים הזמינים, גדלים נקודת תכונות גופן אחרות, המשתמש יכול לבחור. השתמש בפונקציה ChooseFont ומבנה CHOOSEFONT. |
| פתוח | הצגת רשימות של כוננים, ספריות, סיומות שם הקובץ שממנו המשתמש יכול לבחור כדי להציג רשימה של שמות קבצים. המשתמש יכול להקליד שם קובץ או בחר אחת מהרשימה כדי לזהות את הקובץ שיש לפתוח. השתמש בפונקציה GetOpenFileName ומבנה הפרמטר OPENFILENAME. |
| הדפסה | הצגת מידע אודות המדפסת המותקן והתצורה שלה. המשתמש לבחור אפשרויות משימת ההדפסה, כגון טווח העמודים שברצונך להדפיס ואת מספר העותקים, ולאחר להתחיל את תהליך ההדפסה. השתמש בפונקציה PrintDlg ומבנה PRINTDLG. Windows NT 5.0 ואילך: כדי להציג את גליון המאפיינים של הדפסה במקום תיבת דו-שיח הדפסה , השתמש בפונקציה PrintDlgEx עם מבנה PRINTDLGEX . דף כללי של גליון המאפיינים דומה תיבת הדו-שיח הדפסה . גליון המאפיינים שתהיה גם עמודי מאפיינים ספציפיים ליישום, ספציפיות למנהל התקן נוספים בעקבות עמוד כללי. |
| הגדרת עמוד | מציג את התצורה הנוכחית של הדף. המשתמש יכול לבחור אפשרויות תצורת עמוד, כגון כיוון הדפסת הנייר, גודל, מקור ושוליים. השתמש בפונקציה PageSetupDlg ומבנה PAGESETUPDLG. |
| החלף | מציג תיבת דו-שיח שבה המשתמש להקליד את מחרוזת לחיפוש מחרוזת החלפה. המשתמש יכול לציין אפשרויות חיפוש, כגון אם החיפוש תלוי רישיות, ואפשרויות חלופי, כגון הטווח של החלפת. השתמש בפונקציה החלפת טקסט תחת מבנה FINDREPLACE. |
| שמור בשם | הצגת רשימות של כוננים, ספריות, סיומות שם הקובץ שממנו המשתמש יכול לבחור כדי להציג רשימה של שמות קבצים. המשתמש יכול להקליד שם קובץ או בחר אחת מהרשימה כדי לציין את השם עם בה יש לשמור את הקובץ. השתמש בפונקציה GetSaveFileName ומבנה הפרמטר OPENFILENAME. |
הערהnbsp; למרות תיבת הדו-שיח הגדרת הדפסה גם זמין, הוא הוחלף בתיבת הדו-שיח הגדרת עמוד . יישומים חדשים שנכתבו עבור Windows 95 או גירסאות Windows &NT 3.51 ואילך עליך להשתמש בתיבת הדו-שיח הגדרת עמוד במקום את תיבת הדו-שיח הגדרת הדפסה .
בכל תיבות הדו-שיח המשותפות הן מודאלי, למעט תיבות הדו-שיח חיפוש והחלפה . יש לסגור תיבות דו-שיח מודאליות על-ידי המשתמש לפני להחזיר הפונקציה נעשה שימוש כדי ליצור את תיבת הדו-שיח. תיבות הדו שיח חיפוש והחלפה הן modeless; הפונקציה מחזירה לפני סגירת תיבת הדו-שיח. אם אתה משתמש בתיבת הדו-שיח חיפוש והחלפה , עליך להשתמש בפונקציה IsDialogMessage בלולאה המסר העיקרי של היישום שלך כדי להבטיח כי תיבות דו-שיח אלה לעבד כהלכה קלט של לוח מקשים, כגון tab ומקשי esc.