GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AL_SHOW_NATIVE_MESSAGE_BOX (3)

NAME

al_show_native_message_box - Allegro 5 API

CONTENTS

Synopsis
Description

SYNOPSIS

C]
#include <allegro5/allegro_native_dialog.h>

int al_show_native_message_box(ALLEGRO_DISPLAY *display, char const *title, char const *heading, char const *text, char const *buttons, int flags) ]

DESCRIPTION

Show a native GUI message box. This can be used for example to display an error message if creation of an initial display fails. The display may be NULL, otherwise the given display is treated as the parent if possible.

The message box will have a single "OK" button and use the style informative dialog boxes usually have on the native system. If the C]buttons] parameter is not NULL, you can instead specify the button text in a string, with buttons separated by a vertical bar (|).
ALLEGRO_MESSAGEBOX_WARN
  The message is a warning. This may cause a different icon (or other effects). ALLEGRO_MESSAGEBOX_ERROR The message is an error. ALLEGRO_MESSAGEBOX_QUESTION The message is a question. ALLEGRO_MESSAGEBOX_OK_CANCEL Instead of the "OK" button also display a cancel button. Ignored if C]buttons] is not NULL. ALLEGRO_MESSAGEBOX_YES_NO Instead of the "OK" button display Yes/No buttons. Ignored if C]buttons] is not NULL.
al_show_native_message_box(3) may be called without Allegro being installed. This is useful to report an error to initialise Allegro itself.
Returns:
[bu] 0 if the dialog window was closed without activating a button.
[bu] 1 if the OK or Yes button was pressed.
[bu] 2 if the Cancel or No button was pressed.
If
C]buttons] is not NULL, the number of the pressed button is returned, starting with 1.

If a message box could not be created then this returns 0, as if the window was dismissed without activating a button.

Example:
C]
  button = al_show_native_message_box(
     display,
     "Warning",
     "Are you sure?",
     "If you click yes then you are confirming that \"Yes\""
     "is your response to the query which you have"
     "generated by the action you took to open this"
     "message box.",
     NULL,
     ALLEGRO_MESSAGEBOX_YES_NO
  );
]

Search for    or go to Top of page |  Section 3 |  Main Index


Allegro reference manual AL_SHOW_NATIVE_MESSAGE_BOX (3)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.