Poster of Linux kernelThe best gift for a Linux geek
Prima::Tie

Prima::Tie

Section: User Contributed Perl Documentation (3) Updated: 2009-02-24
Local index Up
 

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>.


 

Index

NAME
DESCRIPTION
SYNOPSIS
USAGE
Prima::Tie::items
Prima::Tie::text
Prima::Tie::value
COPYRIGHT
AUTHORS

This document was created by man2html, using the manual pages.
Time: 21:53:01 GMT, April 16, 2011