Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

al_show_native_message_box(3)			 al_show_native_message_box(3)

NAME
       al_show_native_message_box - Allegro 5 API

SYNOPSIS
	      #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 infor‐
       mative  dialog boxes usually have on the native system.	If the 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
       buttons is not NULL.  ALLEGRO_MESSAGEBOX_YES_NO
       Instead	of the "OK" button display Yes/No buttons.  Ignored if 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:

       · 0 if the dialog window was closed without activating a button.

       · 1 if the OK or Yes button was pressed.

       · 2 if the Cancel or No button was pressed.

       If 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:

		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
		);

Allegro reference manual			 al_show_native_message_box(3)

Vote for polarhome