OpenEuphoria

8.52 Windows Message Box

8.52.1 Style Constants

Possible style values for message_box() style sequence

8.52.1.1 MB_ABORTRETRYIGNORE

include std/win32/msgbox.e
namespace msgbox
public constant MB_ABORTRETRYIGNORE

Abort, Retry, Ignore

8.52.1.2 MB_APPLMODAL

include std/win32/msgbox.e
namespace msgbox
public constant MB_APPLMODAL

User must respond before doing something else

8.52.1.3 MB_DEFAULT_DESKTOP_ONLY

include std/win32/msgbox.e
namespace msgbox
public constant MB_DEFAULT_DESKTOP_ONLY

8.52.1.4 MB_DEFBUTTON1

include std/win32/msgbox.e
namespace msgbox
public constant MB_DEFBUTTON1

First button is default button

8.52.1.5 MB_DEFBUTTON2

include std/win32/msgbox.e
namespace msgbox
public constant MB_DEFBUTTON2

Second button is default button

8.52.1.6 MB_DEFBUTTON3

include std/win32/msgbox.e
namespace msgbox
public constant MB_DEFBUTTON3

Third button is default button

8.52.1.7 MB_DEFBUTTON4

include std/win32/msgbox.e
namespace msgbox
public constant MB_DEFBUTTON4

Fourth button is default button

8.52.1.8 MB_HELP

include std/win32/msgbox.e
namespace msgbox
public constant MB_HELP

Windows 95: Help button generates help event

8.52.1.9 MB_ICONASTERISK

include std/win32/msgbox.e
namespace msgbox
public constant MB_ICONASTERISK

8.52.1.10 MB_ICONERROR

include std/win32/msgbox.e
namespace msgbox
public constant MB_ICONERROR

8.52.1.11 MB_ICONEXCLAMATION

include std/win32/msgbox.e
namespace msgbox
public constant MB_ICONEXCLAMATION

Exclamation-point appears in the box

8.52.1.12 MB_ICONHAND

include std/win32/msgbox.e
namespace msgbox
public constant MB_ICONHAND

A hand appears

8.52.1.13 MB_ICONINFORMATION

include std/win32/msgbox.e
namespace msgbox
public constant MB_ICONINFORMATION

Lowercase letter i in a circle appears

8.52.1.14 MB_ICONQUESTION

include std/win32/msgbox.e
namespace msgbox
public constant MB_ICONQUESTION

A question-mark icon appears

8.52.1.15 MB_ICONSTOP

include std/win32/msgbox.e
namespace msgbox
public constant MB_ICONSTOP

8.52.1.16 MB_ICONWARNING

include std/win32/msgbox.e
namespace msgbox
public constant MB_ICONWARNING

8.52.1.17 MB_OK

include std/win32/msgbox.e
namespace msgbox
public constant MB_OK

Message box contains one push button: OK

8.52.1.18 MB_OKCANCEL

include std/win32/msgbox.e
namespace msgbox
public constant MB_OKCANCEL

Message box contains OK and Cancel

8.52.1.19 MB_RETRYCANCEL

include std/win32/msgbox.e
namespace msgbox
public constant MB_RETRYCANCEL

Message box contains Retry and Cancel

8.52.1.20 MB_RIGHT

include std/win32/msgbox.e
namespace msgbox
public constant MB_RIGHT

Windows 95: The text is right-justified

8.52.1.21 MB_RTLREADING

include std/win32/msgbox.e
namespace msgbox
public constant MB_RTLREADING

Windows 95: For Hebrew and Arabic systems

8.52.1.22 MB_SERVICE_NOTIFICATION

include std/win32/msgbox.e
namespace msgbox
public constant MB_SERVICE_NOTIFICATION

Windows NT: The caller is a service

8.52.1.23 MB_SETFOREGROUND

include std/win32/msgbox.e
namespace msgbox
public constant MB_SETFOREGROUND

Message box becomes the foreground window

8.52.1.24 MB_SYSTEMMODAL

include std/win32/msgbox.e
namespace msgbox
public constant MB_SYSTEMMODAL

All applications suspended until user responds

8.52.1.25 MB_TASKMODAL

include std/win32/msgbox.e
namespace msgbox
public constant MB_TASKMODAL

Similar to MB_APPLMODAL

8.52.1.26 MB_YESNO

include std/win32/msgbox.e
namespace msgbox
public constant MB_YESNO

Message box contains Yes and No

8.52.1.27 MB_YESNOCANCEL

include std/win32/msgbox.e
namespace msgbox
public constant MB_YESNOCANCEL

Message box contains Yes, No, and Cancel

8.52.2 Return Value Constants

possible values returned by MessageBox(). 0 means failure

8.52.2.1 IDABORT

include std/win32/msgbox.e
namespace msgbox
public constant IDABORT

Abort button was selected.

8.52.2.2 IDCANCEL

include std/win32/msgbox.e
namespace msgbox
public constant IDCANCEL

Cancel button was selected.

8.52.2.3 IDIGNORE

include std/win32/msgbox.e
namespace msgbox
public constant IDIGNORE

Ignore button was selected.

8.52.2.4 IDNO

include std/win32/msgbox.e
namespace msgbox
public constant IDNO

No button was selected.

8.52.2.5 IDOK

include std/win32/msgbox.e
namespace msgbox
public constant IDOK

OK button was selected.

8.52.2.6 IDRETRY

include std/win32/msgbox.e
namespace msgbox
public constant IDRETRY

Retry button was selected.

8.52.2.7 IDYES

include std/win32/msgbox.e
namespace msgbox
public constant IDYES

Yes button was selected.

8.52.3 Routines

8.52.3.1 message_box

include std/win32/msgbox.e
namespace msgbox
public function message_box(sequence text, sequence title, object style)

Displays a window with a title, message, buttons and an icon, usually known as a message box.

Parameters:

1. text: a sequence, the message to be displayed
2. title: a sequence, the title the box should have
3. style: an object which defines which,icon should be displayed, if any, and which buttons will be presented.

Returns:

An integer, the button which was clicked to close the message box, or 0 on failure.

Comments:

See Style Constants above for a complete list of possible values for style and Return Value Constants for the returned value. If style is a sequence, its elements will be or'ed together.