The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

UI::Dialog::Charts

SYNOPSIS

This Perl Document details, the various attributes, widgets and all the dialog variant-specific features made avaiable by UI::Dialog and the specific UI::Dialog::Backend:: modules.

This document is not complete and at this time serves only as a quick reference for the standard functions, attributes and of course the widget chart.

STANDARD ATTRIBUTES

These can be used during object construction (as defaults) or with any widget method call (override default).

 title         => "string"
 backtitle     => "string"
 height        => 20       #characters, not pixels
 width         => 65       #    ''       "    ''
 listheight    => 5        #    ''       "    ''
 menu          => [ 't1', 't1 desc', 't2', 't2 desc' ]
 list          => [ 't1', [ 't1 desc', 1 ], 't2', [ 't2 desc'. 0 ] ]
 beepbefore    => 0
 beepafter     => 0
 autoclear     => 0

STANDARD ATTRIBUTE NOTES

'autoclear' is only works in terminals and consoles (doesn't do anything for any of the GUI backends. 'menu' is only used with the menu() widget and 'list' is used for checklist() and radiolist() widgets.

META CLASSES

The following list of classes are the "wrappers" that perform a few simple tests that determine a suitable dialog variant to use. These allow the end- progammer to create an application using the standard widgets without having to force the end-user into any particular UI::Dialog::Backend::. End-users can override the meta-class via the environment variables listed further in this document.

This list makes references to the DISPLAY environment variable as well as to running in a CONSOLE (terminal, xterm, etc). The DISPLAY environment variable is not null when being run within an X-Windows session.

UI::Dialog (most flexible)
 ::Backend::
  (if DISPLAY != "") Zenity, XDialog, GDialog, KDialog
  (if DISPLAY == "") CDialog, Whiptail, ASCII
UI::Dialog::GNOME (GNOME oriented)
 ::Backend::
  (assumes DISPLAY) Zenity, XDialog, GDialog
UI::Dialog::KDE (KDE oriented)
 ::Backend::
  (assumed DISPLAY) KDialog, XDialog
UI::Dialog::Console (non-GUI only)
 ::Backend::
  (assumed CONSOLE) CDialog, Whiptail, ASCII
UI::Dialog::Gauged (flexible, has gauge methods)
 ::Backend::
  (if DISPLAY != "") Zenity, XDialog
  (if DISPLAY == "") CDialog, Whiptail

STANDARD WIDGETS

These widgets are provided by all backends and are the only methods made available by all meta classes.

 $switch = $d->yesno( text => 'A question?' );
 $switch = $d->msgbox( text => 'A message.' );
 $scalar = $d->inputbox( text => 'Type visible text.' );
 $scalar = $d->password( text => 'Type hidden text.' );
 $switch = $d->textbox( filename => '/path/to/regular/file' );
 $scalar = $d->fselect( path => '/path/to/start/browse' );
 $scaler = $d->dselect( path => '/path/to/start/browse' );
 $scalar = $d->menu( text => 'A message.',
                     menu => [ 't1', 't1 desc', 't2', 't2 desc' ] );
 $scalar = $d->radiolist( text => 'A message.',
                          list => [ 't1', [ 't1 desc', 1 ],
                                    't2', [ 't2 desc', 0 ] ] );
 @array  = $d->checklist( text => 'A message.',
                          list => [ 't1', [ 't1 desc', 1 ],
                                    't2', [ 't2 desc', 0 ] ] );

COMPLETE WIDGET CHART

  -----------------------------------+
   Zenity                             \
  ---------------------------------+   \
   XDialog                          \   \
  -------------------------------+   \   \
   Whiptail                       \   \   \
  -----------------------------+   \   \   \
   KDialog                      \   \   \   \
  ---------------------------+   \   \   \   \
   GDialog                    \   \   \   \   \
  -------------------------+   \   \   \   \   \
   CDialog                  \   \   \   \   \   \
  -----------------------+   \   \   \   \   \   \
   ASCII                  \   \   \   \   \   \   \
  ---------------------+   \   \   \   \   \   \   \
   Widget Method Name   \   \   \   \   \   \   \   \
  -----------------------+---+---+---+---+---+---+---+
  calendar               |   | C |   |   |   | X | Z |
  checklist              | A | C | G | K | W | X | Z |
  combobox               |   |   |   |   |   | X |   |
  draw_gauge             | A |   |   |   |   |   |   |
  dselect                | A | C | G | K | W | X | Z |
  editbox                |   |   |   |   |   | X | Z |
  end_gauge              | A |   |   |   |   |   |   |
  entry                  |   |   |   |   |   |   | Z |
  error                  |   |   |   | K |   |   | Z |
  fselect                | A | C | G | K | W | X | Z |
  gauge_dec              |   | C |   |   | W | X | Z |
  gauge_inc              |   | C |   |   | W | X | Z |
  gauge_set              |   | C |   |   | W | X | Z |
  gauge_start            |   | C |   |   | W | X | Z |
  gauge_stop             |   | C |   |   | W | X | Z |
  gauge_text             |   | C |   |   | W | X | Z |
  getexistingdirectory   |   |   |   | K |   |   |   |
  getopenfilename        |   |   |   | K |   |   |   |
  getopenurl             |   |   |   | K |   |   |   |
  getsavefilename        |   |   |   | K |   |   |   |
  getsaveurl             |   |   |   | K |   |   |   |
  info                   |   |   |   |   |   |   | Z |
  infobox                | A | C | G |   | W | X |   |
  inputbox               | A | C | G | K | W | X | Z |
  inputsbox2             |   |   |   |   |   | X |   |
  inputsbox3             |   |   |   |   |   | X |   |
  list                   |   |   |   |   |   | X |   |
  logbox                 |   |   |   |   |   |   | Z |
  menu                   |   |   |   |   |   | X |   |
  msgbox                 | A | C | G | K | W | X | Z |
  noyes                  |   |   |   | K |   |   | Z |
  password               | A | C |   | K | W | X | Z |
  passwords2             |   |   |   |   |   | X |   |
  passwords3             |   |   |   |   |   | X |   |
  progress_dec           |   |   |   |   |   | X |   |
  progress_inc           |   |   |   |   |   | X |   |
  progress_set           |   |   |   |   |   | X |   |
  progress_start         |   |   |   |   |   | X |   |
  progress_stop          |   |   |   |   |   | X |   |
  question               |   |   |   |   |   |   | Z |
  radiolist              | A | C | G | K | W | X | Z |
  rangebox               |   |   |   |   |   | X |   |
  rangesbox2             |   |   |   |   |   | X |   |
  rangesbox3             |   |   |   |   |   | X |   |
  sorry                  |   |   |   | K |   |   |   |
  spinbox                |   |   |   |   |   | X |   |
  spinner                |   |   |   |   |   | X |   |
  spinsbox2              |   |   |   |   |   | X |   |
  spinsbox3              |   |   |   |   |   | X |   |
  tailbox                |   | C |   |   |   | X |   |
  tailboxbg              |   | C |   |   |   |   |   |
  text_info              |   |   |   |   |   |   | Z |
  textbox                | A | C | G | K | W | X | Z |
  timebox                |   | C |   |   |   | X |   |
  treeview               |   |   |   |   |   | X |   |
  warning                |   |   |   |   |   |   | Z |
  warningyesno           |   |   |   | K |   |   |   |
  warningyesnocancel     |   |   |   | K |   |   |   |
  yesno                  | A | C | G | K | W | X | Z |
  yesnocancel            |   |   |   | K |   |   |   |