OpenEuphoria: Euphoria v4.1

# OpenEuphoria Manual

## Euphoria v4.1

routine or constant name search

| Up |  |  | TOC | Index
<< 7 Included Tools | < 8.55 Debugging tools | Up: 8 API Reference | 8.57 Windows Sound > | 9 Release Notes >>

## 8.56 Windows Message Box

### 8.56.1 Style Constants

Possible style values for message_box() style sequence

#### 8.56.1.1 MB_ABORTRETRYIGNORE

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

Abort, Retry, Ignore

#### 8.56.1.2 MB_APPLMODAL

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

User must respond before doing something else

#### 8.56.1.3 MB_DEFAULT_DESKTOP_ONLY

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

#### 8.56.1.4 MB_DEFBUTTON1

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

First button is default button

#### 8.56.1.5 MB_DEFBUTTON2

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

Second button is default button

#### 8.56.1.6 MB_DEFBUTTON3

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

Third button is default button

#### 8.56.1.7 MB_DEFBUTTON4

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

Fourth button is default button

#### 8.56.1.8 MB_HELP

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

Windows 95: Help button generates help event

#### 8.56.1.9 MB_ICONASTERISK

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

#### 8.56.1.10 MB_ICONERROR

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

#### 8.56.1.11 MB_ICONEXCLAMATION

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

Exclamation-point appears in the box

#### 8.56.1.12 MB_ICONHAND

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

A hand appears

#### 8.56.1.13 MB_ICONINFORMATION

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

Lowercase letter i in a circle appears

#### 8.56.1.14 MB_ICONQUESTION

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

A question-mark icon appears

#### 8.56.1.15 MB_ICONSTOP

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

#### 8.56.1.16 MB_ICONWARNING

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

#### 8.56.1.17 MB_OK

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

Message box contains one push button: OK

#### 8.56.1.18 MB_OKCANCEL

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

Message box contains OK and Cancel

#### 8.56.1.19 MB_RETRYCANCEL

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

Message box contains Retry and Cancel

#### 8.56.1.20 MB_RIGHT

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

Windows 95: The text is right-justified

#### 8.56.1.21 MB_RTLREADING

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

Windows 95: For Hebrew and Arabic systems

#### 8.56.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.56.1.23 MB_SETFOREGROUND

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

Message box becomes the foreground window

#### 8.56.1.24 MB_SYSTEMMODAL

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

All applications suspended until user responds

#### 8.56.1.25 MB_TASKMODAL

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

Similar to MB_APPLMODAL

#### 8.56.1.26 MB_YESNO

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

Message box contains Yes and No

#### 8.56.1.27 MB_YESNOCANCEL

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

Message box contains Yes, No, and Cancel

### 8.56.2 Return Value Constants

possible values returned by MessageBox(). 0 means failure

#### 8.56.2.1 IDABORT

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

Abort button was selected.

#### 8.56.2.2 IDCANCEL

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

Cancel button was selected.

#### 8.56.2.3 IDIGNORE

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

Ignore button was selected.

#### 8.56.2.4 IDNO

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

No button was selected.

#### 8.56.2.5 IDOK

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

OK button was selected.

#### 8.56.2.6 IDRETRY

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

Retry button was selected.

#### 8.56.2.7 IDYES

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

Yes button was selected.

### 8.56.3 Routines

#### 8.56.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.

| Up |  |  | TOC | Index
<< 7 Included Tools | < 8.55 Debugging tools | Up: 8 API Reference | 8.57 Windows Sound > | 9 Release Notes >>