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

FreeBSD Manual Pages

  
 
  

home | help
al_create_native_file_dialog(3)		       al_create_native_file_dialog(3)

NAME
       al_create_native_file_dialog - Allegro 5	API

SYNOPSIS
	      #include <allegro5/allegro_native_dialog.h>

	      ALLEGRO_FILECHOOSER *al_create_native_file_dialog(
		 char const *initial_path,
		 char const *title,
		 char const *patterns,
		 int mode)

DESCRIPTION
       Creates a new native file dialog.  You should only have one such	dialog
       opened at a time.

       Parameters:

       o initial_path: The initial search path and filename.  Can be NULL.  To
	 start	with  a	blank file name	the string should end with a directory
	 separator (this should	be the common case).

       o title:	Title of the dialog.

       o patterns: A list of semi-colon	 separated  patterns  to  match.   You
	 should	 always	include	the pattern "*.*" as usually the MIME type and
	 not the file pattern is relevant.  If no file patterns	are  supported
	 by the	native dialog, this parameter is ignored.

       o mode: 0, or a combination of the flags	below.

       Possible	flags for the 'flags' parameter	are:

       ALLEGRO_FILECHOOSER_FILE_MUST_EXIST
	      If  supported  by	 the native dialog, it will not	allow entering
	      new names, but just allow	existing files to be  selected.	  Else
	      it is ignored.  ALLEGRO_FILECHOOSER_SAVE
       If  the native dialog system has	a different dialog for saving (for ex-
       ample one which allows creating new directories), it is used.  Else ig-
       nored.  ALLEGRO_FILECHOOSER_FOLDER
       If there	is support for a separate dialog to select a folder instead of
       a file, it will be used.	 ALLEGRO_FILECHOOSER_PICTURES
       If a different dialog is	available for selecting	pictures, it is	 used.
       Else ignored.  ALLEGRO_FILECHOOSER_SHOW_HIDDEN
       If  the	platform  supports it, also hidden files will be shown.	 ALLE-
       GRO_FILECHOOSER_MULTIPLE
       If supported, allow selecting multiple files.

       Returns:

       A handle	to the dialog which you	can pass  to  al_show_native_file_dia-
       log(3)  to  display  it,	and from which you then	can query the results.
       When you	are done, call al_destroy_native_file_dialog(3)	on it.

       If a dialog window could	not be	created	 then  this  function  returns
       NULL.

Allegro	reference manual		       al_create_native_file_dialog(3)

NAME | SYNOPSIS | DESCRIPTION

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

home | help