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

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

NAME

       Prima::Tie - tie widget properties to scalars or arrays.

DESCRIPTION

       Prima::Tie contains two abstract classes, "Prima::Tie::Array" and "Prima::Tie::Scalar", which tie an array or a scalar to a widget's
       arbitrary array or scalar property.  Also, it contains classes "Prima::Tie::items", "Prima::Tie::text", and "Prima::Tie::value", which tie
       a variable to a widget's items, text, and value property respectively.

SYNOPSIS

	       use Prima::Tie;

	       tie @items, 'Prima::Tie::items', $widget;

	       tie @some_property, 'Prima::Tie::Array', $widget, 'some_property';

	       tie $text, 'Prima::Tie::text', $widget;

	       tie $some_property, 'Prima::Tie::Scalar', $widget, 'some_property';

USAGE

       These classes provide immediate access to a widget's array and scalar property, in particular to popular properties as items and text. It
       is considerably simpler to say

	       splice(@items,3,1,'new item');

       than to say

	       my @i = @{$widget->items};
	       splice(@i,3,1,'new item');
	       $widget->items(@i);

       You can work directly with the text or items rather than at a remove.  Furthermore, if the only reason you keep an object around after
       creation is to access its text or items, you no no longer need to do so:

	       tie @some_array, 'Prima::Tie::items', Prima::ListBox->create(@args);

       As opposed to:

	       my $widget = Prima::ListBox->create(@args);
	       tie @some_array, 'Prima::Tie::items', $widget;

       "Prima::Tie::items" requires "::items" property to be available on the widget.  Also, it takes advantage of additional "get_items",
       "add_items", and the like if available.

   Prima::Tie::items
       The class is applicable to "Prima::ListViewer", "Prima::ListBox", "Prima::Header", and their descendants, and in limited fashion to
       "Prima::OutlineViewer" and its descendants "Prima::StringOutline" and "Prima::Outline".

   Prima::Tie::text
       The class is applicable to any widget.

   Prima::Tie::value
       The class is applicable to "Prima::GroupBox", "Prima::ColorDialog", "Prima::SpinEdit", "Prima::Gauge", "Prima::Slider",
       "Prima::CircularSlider", and "Prima::ScrollBar".

COPYRIGHT

       Copyright 2004 Teo Sankaro

       You may redistribute and/or modify this module under the same terms as Perl itself.  (Although a credit would be nice.)

AUTHORS

       Teo Sankaro, <teo_sankaro@hotmail.com>.	Dmitry Karasik, <dmitry@karasik.eu.org>.

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

Check Out this Related Man Page

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)

Linux and UNIX Man Pages

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

Check Out this Related Man Page