Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  er-
	      ror.   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.	 ALLE-
	      GRO_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 in-
       stalled.	 This is useful	to report an error to initialise  Allegro  it-
       self.

       Returns:

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

       o 1 if the OK or	Yes button was pressed.

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

NAME | SYNOPSIS | DESCRIPTION

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=al_show_native_message_box&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help