Tk::LabFrame3pm

Usage

Overview

LabFrame is exactly like Frame and additionaly allows to add a label to the frame.

Options

LabFrame supports the same options as the Frame widget.

Additional options of LabFrame are:

-font => font

Specifies the label's font

-foreground => color

Specifies the label's foreground color

-label => text

The text of the label to be placed with the Frame.

-labelside => where

Where can be one of left, right, top, bottom or acrosstop. The first four work as might be expected and place the label to the left, right, above or below the frame respectively. The acrosstop creates a grooved frame around the central frame and puts the label near the northwest corner such that it appears to "overwrite" the groove.

-labelvariable => scalar_ref

Specifies a reference to a variable and used as an alternative to -label. If the value of the variable changes, then the widget will be updated automatically to reflect the change. Used like -textvariable.

Advertised subwidgets

See "Subwidget" in Tk::mega how to use advertised widgets.

border

  Frame used to display the border

frame

  Frame used to create new LabFrame children.

label

  Label used for displaying text

Examples

Run the following test program to see this in action:

    use strict;
    use Tk;
    require Tk::LabFrame;
    require Tk::LabEntry;
    my $test = 'Test this';
    my $mw = Tk::MainWindow->new;
    my $f = $mw->LabFrame(-label => "This is a label",
                           -labelside => "acrosstop");
    $f->LabEntry(-label => "Testing", -textvariable => \$test)->pack;
    $f->pack;
    Tk::MainLoop;