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)

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

NAME

       Prima::KeySelector - key combination widget and routines

DESCRIPTION

       The module provides a standard widget for selecting a user-defined key combination. The widget class allows import, export, and
       modification of key combinations.

       The module provides a set of routines, useful for conversion of a key combination between representations.

SYNOPSIS

	       my $ks = Prima::KeySelector-> create( );
	       $ks-> key( km::Alt | ord('X'));
	       print Prima::KeySelector::describe( $ks-> key );

API

   Properties
       key INTEGER
	   Selects a key combination in integer format. The format is described in "Hot key" in Prima::Menu, and is a combination of "km::XXX" key
	   modifiers and either a "kb::XXX" virtual key, or a character code value.

	   The property allows almost, but not all possible combinations of key constants. Only "km::Ctrl", "km::Alt", and "km::Shift" modifiers
	   are allowed.

   Methods
       All methods here can ( and must ) be called without the object syntax; - the first parameter must not be neither package nor widget.

       describe KEY
	   Accepts KEY in integer format, and returns string description of the key combination in human readable format. Useful for supplying an
	   accelerator text to a menu.

		   print describe( km::Shift|km::Ctrl|km::F10);
		   Ctrl+Shift+F10

       export KEY
	   Accepts KEY in integer format, and returns string with a perl-evaluable expression, which after evaluation resolves to the original KEY
	   value. Useful for storing a key into text config files, where value must be both human readable and easily passed to a program.

		   print export( km::Shift|km::Ctrl|km::F10);
		   km::Shift|km::Ctrl|km::F10

       shortcut KEY
	   Converts KEY from integer format to a string, acceptable by "Prima::AbstractMenu" input methods.

		   print shortcut( km::Ctrl|ord('X'));
		   ^X

       translate_codes KEY, [ USE_CTRL = 0 ]
	   Converts KEY in integer format to three integers in the format accepted by "KeyDown" in Prima::Widget event: code, key, and modifier.
	   USE_CTRL is only relevant when KEY first byte ( "KEY & 0xFF" ) is between 1 and 26, what means that the key is a combination of an
	   alpha key with the control key.  If USE_CTRL is 1, code result is unaltered, and is in range 1 - 26.  Otherwise, code result is
	   converted to the character code ( 1 to ord('A'), 2 to ord('B') etc ).

AUTHOR

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

SEE ALSO

       Prima, Prima::Widget, Prima::Menu.

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