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

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)

Check Out this Related Man Page

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

NAME

       Curses::Widgets::Label - Label Widgets

MODULE VERSION

       $Id: Label.pm,v 1.102 2002/11/03 23:36:21 corliss Exp corliss $

SYNOPSIS

	 use Curses::Widgets::Label;

	 $lbl = Curses::Widgets::Label->new({
	   COLUMNS	=> 10,
	   LINES       => 1,
	   VALUE       => 'Name:',
	   FOREGROUND  => undef,
	   BACKGROUND  => 'black',
	   X	       => 1,
	   Y	       => 1,
	   ALIGNMENT   => 'R',
	   });

	 $tf->draw($mwh);

	 See the Curses::Widgets pod for other methods.

REQUIREMENTS

       Curses
       Curses::Widgets

DESCRIPTION

       Curses::Widgets::Label provides simplified OO access to Curses-based single or multi-line labels.

METHODS

       new (inherited from Curses::Widgets)

	 $lbl = Curses::Widgets::Label->new({
	   COLUMNS	=> 10,
	   LINES       => 1,
	   VALUE       => 'Name:',
	   FOREGROUND  => undef,
	   BACKGROUND  => 'black',
	   X	       => 1,
	   Y	       => 1,
	   ALIGNMENT   => 'R',
	   });

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

	 Key	     Default   Description
	 ============================================================
	 COLUMNS	   10	Number of columns displayed
	 LINES		   1   Number of lines displayed
	 VALUE		  ''   Label text
	 FOREGROUND    undef   Default foreground colour
	 BACKGROUND    undef   Default background colour
	 ALIGNMENT	   L   'R'ight, 'L'eft, or 'C'entered

       If the label is a multi-line label it will filter the current VALUE through the Curses::Widgets::textwrap function to break it along white-
       space and newlines.

       draw

	 $tf->draw($mwh);

       The draw method renders the text field in its current state.  This requires a valid handle to a curses window in which it will render
       itself.

HISTORY

       2002/10/18 -- First implementation

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

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

Linux and UNIX Man Pages

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

Check Out this Related Man Page