home *** CD-ROM | disk | FTP | other *** search
/ CD Actual Thematic 7: Programming / CDAT7.iso / Share / Editores / Perl5 / perl / lib / site / Tk / Scrolled.pod < prev    next >
Encoding:
Text File  |  1997-08-10  |  1.3 KB  |  62 lines
  1.  
  2. =head1 NAME
  3.  
  4. Tk::Scrolled - Create a widget with attached scrollbar(s)
  5.  
  6. =for index_group Perl/Tk Constructs
  7.  
  8. =head1 SYNOPSIS
  9.  
  10.     $whatever = $parent->Scrolled('Whatever',
  11.                 -scrollbars = 'nw',
  12.                 ... widget options of Whatever here...
  13.                 );
  14.  
  15. =head1 DESCRIPTION
  16.  
  17. To stop a flood of B<ScrlWhatever> Perl/Tk introcuded the special constructor
  18. B<Scrolled>.  B<Scrolled> creates a widget of the given Class 'Whatever' with
  19. attached L<scrollbar>(s).
  20.  
  21. =head1 OPTIONS
  22.  
  23. =over 4
  24.  
  25. =item -scrollbars
  26.  
  27. Expects as argument the position where the scrollbars should be
  28. created.  C<'w'>, C<'e'> or C<'n'>, C<'s'> or a combination of
  29. them.  If the one or both positions are prefixed with C<'o'> the
  30. scrollbar will only show up if there is a 'real' need to scroll.
  31.  
  32. =item all other option
  33.  
  34. All options beside <-scrollbars> are passed to the 'Whatever' widget
  35. constructor.
  36.  
  37. =back
  38.  
  39.  
  40. =head1 BUGS
  41.  
  42. If a widget does not support C<-{x,y}scrollcommand> options,
  43. B<Scrolled> does not complain if the specified widget class does
  44. not support them. E.g.,
  45.  
  46.     $parent->Scrolled('Button', ...)
  47.  
  48. One does not get an error message or warning when one tries to
  49. configure scrollbars after the widget construction:
  50.  
  51.     $ascrolled->scrollbars('e')
  52.     $ascrolled->configure(-scrollbars => 'e');
  53.  
  54.  
  55. =head1 SEE ALSO
  56.  
  57. Scrollbar, Tk::Widget.pm(sub Scrollbars), Tk::Frame.pm(sub AddScrollbars)
  58.  
  59. =cut
  60.  
  61.  
  62.