Microsoft KB Archive/67210

{|
 * width="100%"|

HOWTO: Create a Multiple Line Message Box

 * }

Q67210

-

The information in this article applies to:


 * Microsoft Win32 Application Programming Interface (API), on platform(s):
 * the operating system: Microsoft Windows NT, versions 3.51, 4.0
 * Microsoft Windows 95
 * Microsoft Windows 98
 * the operating system: Microsoft Windows 2000

-

SUMMARY
Message boxes are used to provide information to the user of an application. Error messages and warnings are also provided through message boxes. This article provides details on using message boxes in applications.

MORE INFORMATION
Message boxes are modal windows. When an application displays an application modal message box, which is the default message box type, the user cannot interact with any part of that application until the message box has been dismissed. However, the user may use the mouse or keyboard to activate another application and interact with it while the message box is displayed. Certain critical errors that may affect all of Windows are displayed in system modal message boxes. Windows will not perform any operations until the error condition is acknowledged and the system modal message box is dismissed.

There are times where it is necessary to display a long message in a message box. Windows does this when you start an MS-DOS-based application that uses graphics from inside an MS-DOS window. To break a message into many lines, insert a newline character into the message text. Here is a sample MessageBox call:

  MessageBox(hWnd, &quot;This is line 1.\nThis is line 2.&quot;, &quot;App&quot;,       MB_OK | MB_ICONQUESTION); If the text of a message is too long for a single line, Windows will break the text into multiple lines.

System modal message boxes treat the newline character as any other. A newline character is displayed as a black block in the text. Because system modal message boxes are designed to work at all times, even under extremely low memory conditions, it does not provide the ability to display more than one line of text.

Additional query words:

Keywords : kbDlg kbMessageBox kbOSWinNT351 kbOSWinNT400 kbOSWin2000 kbGrpDSUser kbOSWin95 kbOSWin98

Issue type : kbhowto

Technology : kbAudDeveloper kbWin32sSearch kbWin32API