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

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

NAME

       Prima::Header - a multi-tabbed header widget.

DESCRIPTION

       The widget class provides functionality of several button-like caption tabs, that can be moved and resized by the user.	The class was
       implemented with a view to serve as a table header for list and grid widgets.

API

   Events
       Click INDEX
	   Called when the user clicks on the tab, positioned at INDEX.

       DrawItem CANVAS, INDEX, X1, Y1, X2, Y2, TEXT_BASELINE
	   A callback used to draw the tabs. CANVAS is the output object; INDEX is the index of a tab.	X1,Y2,X2,Y2 are the coordinates of the
	   boundaries of the tab rectangle; TEXT_BASELINE is a pre-calculated vertical position for eventual centered text output.

       MeasureItem INDEX, RESULT
	   Stores in scalar, referenced by RESULT, the width or height ( depending on vertical property value ) of the tab in pixels.

       MoveItem OLD_INDEX, NEW_INDEX
	   Called when the user moves a tab from its old location, specified by OLD_INDEX, to the NEW_INDEX position. By the time of call, all
	   internal structures are updated.

       SizeItem INDEX, OLD_EXTENT, NEW_EXTENT
	   Called when the user resizes a tab in INDEX position. OLD_EXTENT and NEW_EXTENT are either width or height of the tab, depending on
	   vertical property value.

       SizeItems
	   Called when more than one tab has changed its extent. This might happen as a result of user action, as well as an effect of set-calling
	   to some properties.

   Properties
       clickable BOOLEAN
	   Selects if the user is allowed to click the tabs.

	   Default value: 1

       dragable BOOLEAN
	   Selects if the user is allowed to move of the tabs.

	   Default value: 1

       items ARRAY
	   Array of scalars, representing the internal data of the tabs.  By default the scalars are treated as text strings.

       minTabWidth INTEGER
	   A minimal extent in pixels a tab must occupy.

	   Default value: 2

       offset INTEGER
	   An offset on the major axis ( depends on vertical property value ) that the widget is drawn with. Used for the conjunction with list
	   widgets ( see Prima::DetailedList ), when the list is horizontally or vertically scrolled.

	   Default value: 0

       pressed INTEGER
	   Contains the index of the currently pressed tab. A -1 value is selected when no tabs are pressed.

	   Default value: -1

       scalable BOOLEAN
	   Selects if the user is allowed to resize the tabs.

	   Default value: 1

       vertical BOOLEAN
	   If 1, the tabs are aligned vertically; the offset, widths property and extent parameters of the callback notification assume heights of
	   the tabs.

	   If 0, the tabs are aligned horizontally, and the extent properties and parameters assume tab widths.

       widths ARRAY
	   Array of integer values, corresponding to the extents of the tabs.  The extents are widths ( "vertical" is 0 ) or heights ( "vertical"
	   is 1 ).

   Methods
       tab2offset INDEX
	   Returns offset of the INDEXth tab ( without regard to offset property value ).

       tab2rect INDEX
	   Returns four integers, representing the rectangle area, occupied by the INDEXth tab ( without regard to offset property value ).

AUTHOR

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

SEE ALSO

       Prima, Prima::Widget, Prima::DetailedList, examples/sheet.pl.

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

Check Out this Related 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)

Linux and UNIX Man Pages

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

Check Out this Related Man Page