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

FreeBSD Manual Pages

  
 
  

home | help 
al_show_na...essage_box(3) Library Functions Manual al_show_na...essage_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	(|).

	      Note:  The  buttons parameter is currently unimplemented on Win-
	      dows.

       The flags available are:

       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
	      Display  a  cancel button	alongside the "OK" button.  Ignored if
	      buttons is not NULL.

       ALLEGRO_MESSAGEBOX_YES_NO
	      Display Yes/No buttons instead of	the "OK" button.   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  during  initialisation  of
       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.

       All of the remaining parameters must not	be NULL.

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

       Example:

	      int 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_na...essage_box(3)

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

home | help