הפונקציה MessageBoxIndirect יוצר, מציג ומפעילה תיבת הודעה. תיבת ההודעה מכיל טקסט ההודעה המוגדרת על-ידי יישום, כותרת, כל סמל ואת כל שילוב של לחצנים מוגדרים מראש.
int MessageBoxIndirect ( LPMSGBOXPARAMS lpMsgBoxParams / / כתובת של מבנה עבור הודעה / / תיבה פרמטרים);
הערך המוחזר הוא אפס אם אין די זיכרון כדי ליצור את תיבת הודעה.
אם הפונקציה מצליחה, הערך המוחזר הוא אחד מהערכים פריט התפריט הבאים המוחזר על-ידי תיבת הדו-שיח:
| ערך | משמעות |
|---|---|
| IDABORT | לחצן ביטול נבחר. |
| IDCANCEL | לחצן ביטול נבחר. |
| IDIGNORE | התעלם לבחור לחצן. |
| IDNO | לחצן לא נבחר. |
| IDOK | לחצן אישור נבחר. |
| IDRETRY | נבחר לחצן נסה שנית. |
| IDYES | כן נבחר לחצן. |
אם תיבת הודעה יש לחצן ביטול, הפונקציה מחזירה את הערך IDCANCEL אם הקשה על מקש esc או לחצן ביטול נבחרה. אם תיבת ההודעה יש לחצן ביטול לא, הקשה על esc יש השפעה.
כאשר תשתמש תיבת הודעה מערכת-modal כדי לציין למערכת אין די זיכרון פנוי, המחרוזות הצביע על-ידי lpszText ו- lpszCaption חברים של מבנה MSGBOXPARAMS לא יילמד מתוך קובץ משאבים, משום ניסיון לטעון את המשאב עלול להיכשל.
כאשר יישום קורא MessageBoxIndirect מציין דגלים MB_ICONHAND ו- MB_SYSTEMMODAL עבור חבר dwStyle של מבנה MSGBOXPARAMS , המערכת תציג תיבת ההודעה המתקבלת להתחשב זיכרון זמין. כאשר צוינו דגלים אלה, המערכת תגביל את האורך של תיבת ההודעה הטקסט שלוש שורות. המערכת אינה לא יפצל אוטומטית את השורות להתאמה בתיבת ההודעה, עם זאת, כך מחרוזת הודעה חייב להכיל החזרות גררה לשבור את השורות במקומות המתאימים.
אם אתה יוצר תיבת הודעה כאשר תיבת דו-שיח קיים, השתמש בנקודת האחיזה של תיבת הדו-שיח כפרמטר hWnd . הפרמטר hWnd לא צריך לזהות חלון צאצא, כגון פקד תיבת דו-שיח.
Windows 95:המערכת יכול לתמוך מרבי של נקודות אחיזה של חלון 16,364.
nbsp; Windows &NT: מחייב גירסה 4.0 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, MessageBox, MessageBoxEx, MSGBOXPARAMS