prima::nox11(3) [debian man page]

Prima::noX11(3) 					User Contributed Perl Documentation					   Prima::noX11(3)

NAME

       Prima::noX11 - Use Prima without X11

SYNOPSIS

	  use Prima::noX11;
	  use Prima;

	  my $error = Prima::XOpenDisplay();
	  if ( defined $error) {
	       print "not connected to display: $error
";
	  } else {
	       print "connected to display
";
	  }

DESCRIPTION

       Prima will by default connect to X11 server on unix. To use Prima functionality in modules or programs where this default behavior is
       undesired, please follow the guidelines below.

   No connection
       In the beginning of a script or a module that is never intended to connect to X11 display, add this:

	 use Prima::noX11;
	 use Prima;

       It will be possible to connect to X11 server later on manually.

   Manual connect to X11
       If connection to X11 is optional, use this code after "use Prima::noX11" was invoked:

	  my $error = Prima::XOpenDisplay();
	  if ( defined $error) {
	       print "not connected to display: $error
";
	  } else {
	       print "connected to display
";
	  }

   Checking if GUI functionality is accesiible.
       Without X11 connection, no GUI functionality such as screen grabbing will be accessible. In addition to that functionality, windowing
       functions will only become accessible after Prima::Application creates a single instance $::application.

       Therefore, if $::application is defined, then all GUI functions can be safely used. If, on the contrary, it is not defined, initiate it as
       this:

	       unless ( $::application) {
		       my $error = Prima::XOpenDisplay();
		       die $error if defined $error;
		       require Prima::Application;
		       import Prima::Application;
	       }

AUTHOR

       Dmitry Karasik, <dmitry@karasik.eu.org>.

SEE ALSO

       Prima::X11

perl v5.14.2							    2009-02-24							   Prima::noX11(3)

Prima::StdDlg(3)					User Contributed Perl Documentation					  Prima::StdDlg(3)

NAME

       Prima::StdDlg - wrapper module to the toolkit standard dialogs

DESCRIPTION

       Provides a unified access to the toolkit dialogs, so there is no need to "use" the corresponding module explicitly.

SYNOPSIS

	       use Prima::StdDlg;

	       Prima::FileDialog-> create-> execute;
	       Prima::FontDialog-> create-> execute;

	       # open standard file open dialog
	       my $file = Prima::open_file;
	       print "You've selected: $file
" if defined $file;

API

       The module accesses the following dialog classes:

       Prima::open_file
	   Invokes standard file open dialog and return the selected file(s).  Uses system-specific standard file open dialog, if available.

       Prima::save_file
	   Invokes standard file save dialog and return the selected file(s).  Uses system-specific standard file save dialog, if available.

       Prima::OpenDialog
	   File open dialog.

	   See "Prima::OpenDialog" in Prima::FileDialog

       Prima::SaveDialog
	   File save dialog.

	   See "Prima::SaveDialog" in Prima::FileDialog

       Prima::ChDirDialog
	   Directory change dialog.

	   See "Prima::ChDirDialog" in Prima::FileDialog

       Prima::FontDialog
	   Font selection dialog.

	   See Prima::FontDialog.

       Prima::FindDialog
	   Generic 'find text' dialog.

	   See Prima::EditDialog.

       Prima::ReplaceDialog
	   Generic 'find and replace text' dialog.

	   See Prima::EditDialog.

       Prima::PrintSetupDialog
	   Printer selection and setup dialog.

	   See Prima::PrintDialog.

       Prima::ColorDialog
	   Color selection dialog.

	   See "Prima::ColorDialog" in Prima::ColorDialog.

       Prima::ImageOpenDialog
	   Image file load dialog.

	   See "Prima::ImageOpenDialog" in Prima::ImageDialog.

       Prima::ImageSaveDialog
	   Image file save dialog.

	   See "Prima::ImageSaveDialog" in Prima::ImageDialog.

AUTHORS

       Anton Berezin <tobez@plab.ku.dk>, Dmitry Karasik, <dmitry@karasik.eu.org>.

SEE ALSO

       Prima, Prima::Classes

perl v5.14.2							    2009-02-24							  Prima::StdDlg(3)