NAME

Tk::CollapsableFrame - a Frame that opens and closes via a mouse click.

SYNOPSIS

$cf = $parent->CollapsableFrame>(-option => value);

DESCRIPTION

This widget provides a switchable open or closed Frame that provides for the vertical arrangement of widget controls. This is an alternative to Notebook style tabbed widgets.

The following option/value pairs are supported:

-title

Title of the CollapsableFrame widget.

-height

The maximun open height of the CollapsableFrame.

METHODS

close

Closes the CollapsableFrame.

open

Opens the CollapsableFrame.

state

Returns the open/close state of the CollapsableFrame, either "open" or "close".

toggle

Toggles the open/close state of the CollapsableFrame.

ADVERTISED WIDGETS

Component subwidgets can be accessed via the Subwidget method. Valid subwidget names are listed below.

Name: colf, Class: Frame

Widget reference of the internal Frame widget within which user
widgets are managed.

EXAMPLE

use Tk::widgets qw/CollapsableFrame Pane/;

my $mw = MainWindow->new;

my $pane = $mw->Scrolled(
     qw/Pane -width 250 -height 50 -scrollbars osow -sticky nw/,
)->pack;

my $cf = $pane->CollapsableFrame(-title => 'Frame1 ', -height => 50);
$cf->pack(qw/-fill x -expand 1/);
$cf->toggle;

my $colf = $cf->Subwidget('colf');
my $but = $colf->Button(-text => 'Close Frame 1!');
$but->pack;
$but->bind('<Button-1>' => [sub {$_[1]->close}, $cf]);

AUTHOR and COPYRIGHT

Stephen.O.Lidie@Lehigh.EDU, 2000/11/27.

Copyright (C) 2000 - 2003, Stephen O. Lidie.

This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself.

Based on the Tck/Tk CollapsableFrame widget by William J Giddings.

KEYWORDS

CollapsableFrame, Frame, Pane