MessageBoxIndirect

הפונקציה MessageBoxIndirect יוצר, מציג ומפעילה תיבת הודעה. תיבת ההודעה מכיל טקסט ההודעה המוגדרת על-ידי יישום, כותרת, כל סמל ואת כל שילוב של לחצנים מוגדרים מראש.

int MessageBoxIndirect ( LPMSGBOXPARAMS  lpMsgBoxParams / / כתובת של מבנה עבור הודעה / / תיבה פרמטרים);
 

פרמטרים

lpMsgBoxParams
מצביע למבנה MSGBOXPARAMS המכיל מידע המשמש להצגת תיבת הודעה.

להחזיר ערכים

הערך המוחזר הוא אפס אם אין די זיכרון כדי ליצור את תיבת הודעה.

אם הפונקציה מצליחה, הערך המוחזר הוא אחד מהערכים פריט התפריט הבאים המוחזר על-ידי תיבת הדו-שיח:

ערך משמעות
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.

QuickInfo

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

ראה גם

סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, MessageBox, MessageBoxEx, MSGBOXPARAMS

Index