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)
Check Out this Related Man Page
Widgets::TextField(3pm) User Contributed Perl Documentation Widgets::TextField(3pm) NAME
Curses::Widgets::TextField - Text Field Widgets MODULE VERSION
$Id: TextField.pm,v 1.103 2002/11/04 00:35:44 corliss Exp corliss $ SYNOPSIS
use Curses::Widgets::TextField; $tf = Curses::Widgets::TextField->new({ CAPTION => 'Name', CAPTIONCOL => 'yellow', COLUMNS => 10, MAXLENGTH => 255, MASK => undef, VALUE => '', INPUTFUNC => &scankey, FOREGROUND => undef, BACKGROUND => 'black', BORDER => 1, BORDERCOL => 'red', FOCUSSWITCH => " ", CURSORPOS => 0, TEXTSTART => 0, PASSWORD => 0, X => 1, Y => 1, READONLY => 0, }); $tf->draw($mwh, 1); See the Curses::Widgets pod for other methods. REQUIREMENTS
Curses Curses::Widgets DESCRIPTION
Curses::Widgets::TextField provides simplified OO access to Curses-based single line text fields. Each object maintains its own state information. METHODS
new (inherited from Curses::Widgets) $tf = Curses::Widgets::TextField->new({ CAPTION => 'Name', CAPTIONCOL => 'yellow', COLUMNS => 10, MAXLENGTH => 255, MASK => undef, VALUE => '', INPUTFUNC => &scankey, FOREGROUND => undef, BACKGROUND => 'black', BORDER => 1, BORDERCOL => 'red', FOCUSSWITCH => " ", CURSORPOS => 0, TEXTSTART => 0, PASSWORD => 0, X => 1, Y => 1, READONLY => 0, }); The new method instantiates a new TextField object. The only mandatory key/value pairs in the configuration hash are X and Y. All others have the following defaults: Key Default Description ============================================================ CAPTION undef Caption superimposed on border CAPTIONCOL undef Foreground colour for caption text COLUMNS 10 Number of columns displayed MAXLENGTH 255 Maximum string length allowed MASK undef Not yet implemented VALUE '' Current field text INPUTFUNC &scankey Function to use to scan for keystrokes FOREGROUND undef Default foreground colour BACKGROUND undef Default background colour BORDER 1 Display a border around the field BORDERCOL undef Foreground colour for border FOCUSSWITCH " " Characters which signify end of input CURSORPOS 0 Starting position of the cursor TEXTSTART 0 Position in string to start displaying PASSWORD 0 Subsitutes '*' instead of characters READONLY 0 Prevents alteration to content The CAPTION is only valid when the BORDER is enabled. If the border is disabled, the field will be underlined, provided the terminal sup- ports it. If MAXLENGTH is undefined, no limit will be placed on the string length. If BORDER is true, the widget will be enlarged to three columns and two more columns to make room for the border. draw $tf->draw($mwh, 1); 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. The optional second argument, if true, will cause the field's text cursor to be rendered as well. HISTORY
1999/12/29 -- Original text field 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::TextField(3pm)