curses::widgets::listbox::multicolumn(3pm) [debian man page]

Widgets::ListBox::MultiColumn(3pm)			User Contributed Perl Documentation			Widgets::ListBox::MultiColumn(3pm)

NAME

       Curses::Widgets::ListBox::MultiColumn - Multi-Column List Box Widgets

MODULE VERSION

       $Id: MultiColumn.pm,v 0.1 2002/11/14 01:28:49 corliss Exp corliss $

SYNOPSIS

	 use Curses::Widgets::ListBox::MultiColumn;

	 $lb = Curses::Widgets::ListBox::MultiColumn->new({
	   COLUMNS     => [0, 5, 10, 3, 3],
	   LISTITEMS   => [@list],
	   });

	 $lb->draw($mwh, 1);

	 See the Curses::Widgets pod for other methods.

REQUIREMENTS

       Curses
       Curses::Widgets
       Curses::Widgets::ListBox

DESCRIPTION

       Curses::Widgets::ListBox::MultiColumn is an extension of the standard Curses::Widgets::ListBox that allows a list of columns, with each
       column a specified width.

METHODS

       new (inherited from Curses::Widgets)

	 $tm = Curses::Widgets::ListBox->new({
	   COLUMNS     => [0, 5, 10, 3, 3],
	   LISTITEMS   => [@list],
	   HEADERS     => [@headers],
	   HEADERCOLFG => 'white',
	   HEADERCOLBG => 'green',
	   BIGHEADER   => 1,
	   });

       All of the same key values apply here as they do for the parent class Curses::Widgets::ListBox.	In addition, the following new keys are
       defined:

	 Key	       Default	 Description
	 ============================================================
	 COLUMNS	    []	 Column widths
	 LISTITEMS	    []	 List of list values
	 HEADERS	    []	 Column header labels
	 HEADERFGCOL	 undef	 Header foreground colour
	 HEADERBGCOL	 undef	 Header background colour
	 BIGHEADER	     0	 Use more graphics for the header
	 KEYINDX	     0	 Index of key column

       If headers are defined but one or both of the header colours are not, then they will default to the widget fore and background.

       NOTE:  Headers take up more lines in addition to the border (one line for the normal, small header, two lines for the larger).  You need to
       take that into account when setting the geometry.  If no labels are passed in the HEADERS array, no space will be used for the headers.

       The KEYINDX value is currently only used to match keystrokes against for quick navigation.

       draw

	 $lb->draw($mwh, 1);

       The draw method renders the list box in its current state.  This requires a valid handle to a curses window in which it will render itself.
       The optional second argument, if true, will cause the field's text cursor to be rendered as well.

HISTORY

       1999/12/29 -- Original list box widget in functional model
       2001/07/05 -- First incarnation in OO architecture

AUTHOR
/COPYRIGHT
       (c) 2001 Arthur Corliss (corliss@digitalmages.com)

perl v5.8.8							    2006-09-14					Widgets::ListBox::MultiColumn(3pm)

Widgets::ButtonSet(3pm) 				User Contributed Perl Documentation				   Widgets::ButtonSet(3pm)

NAME

       Curses::Widgets::ButtonSet - Button Set Widgets

MODULE VERSION

       $Id: ButtonSet.pm,v 1.103 2002/11/03 23:31:26 corliss Exp corliss $

SYNOPSIS

	 use Curses::Widgets::ButtonSet;

	 $btns = Curses::Widgets::ButtonSet->({
	   LENGTH      => 10,
	   VALUE       => 0,
	   INPUTFUNC   => &scankey,
	   FOREGROUND  => 'white',
	   BACKGROUND  => 'black',
	   BORDER      => 1,
	   BORDERCOL   => 'red',
	   FOCUSSWITCH => "	
",
	   HORIZONTAL  => 1,
	   PADDING     => 1,
	   X	       => 1,
	   Y	       => 1,
	   LABELS      => [qw(OK CANCEL)],
	   });

	 $btns->draw($mwh, 1);

	 See the Curses::Widgets pod for other methods.

REQUIREMENTS

       Curses
       Curses::Widgets

DESCRIPTION

       Curses::Widgets::ButtonSet provides simplified OO access to Curses-based button sets.  Each object maintains it's own state information.

METHODS

       new (inherited from Curses::Widgets)

	 $btns = Curses::Widgets::ButtonSet->({
	   LENGTH      => 10,
	   VALUE       => 0,
	   INPUTFUNC   => &scankey,
	   FOREGROUND  => 'white',
	   BACKGROUND  => 'black',
	   BORDER      => 1,
	   BORDERCOL   => 'red',
	   FOCUSSWITCH => "	
",
	   HORIZONTAL  => 1,
	   PADDING     => 1,
	   X	       => 1,
	   Y	       => 1,
	   LABELS      => [qw(OK CANCEL)],
	   });

       The new method instantiates a new ButtonSet object.  The only mandatory key/value pairs in the configuration hash are X, Y, and LABELS.
       All others have the following defaults:

	 Key	     Default	Description
	 ============================================================
	 LENGTH 	    10	Number of columns for each button label
	 VALUE		     0	Button selected (0-based indexing)
	 INPUTFUNC   &scankey	Function to use to scan for keystrokes
	 FOREGROUND	 undef	Default foreground colour
	 BACKGROUND	 undef	Default blackground colour
	 BORDER 	     1	Display border around the set
	 BORDERCOL	 undef	Foreground colour for border
	 FOCUSSWITCH	"	
"	Characters which signify end of input
	 HORIZONTAL	     1	Horizontal orientation for set
	 PADDING	     1	Number of spaces between buttons

       The last option, PADDING, is only applicable to horizontal sets without borders.

       draw

	 $btns->draw($mwh, 1);

       The draw method renders the button set in its current state.  This requires a valid handle to a curses window in which it will render
       itself.	The optional second argument, if true, will cause the set's selected button to be rendered in standout mode (inverse video).

HISTORY

       1999/12/29 -- Original button set widget in functional model
       2001/07/05 -- First incarnation in OO architecture

AUTHOR
/COPYRIGHT
       (c) 2001 Arthur Corliss (corliss@digitalmages.com)

perl v5.8.8							    2006-09-14						   Widgets::ButtonSet(3pm)