GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TK::DOCKFRAME (3)

.ds Aq ’

NAME

Tk::DockFrame - A multicolumn list widget with sortable & sizeable columns

CONTENTS

SYNOPSIS



    use Tk::DockFrame;

    $DockPort = $parent->DockPort();

    $DockPort->pack();

    $DockFrame = $parent->DockFrame
       (
        -dock => $DockPort,
        -trimcount => 1,
        -sensitivity => 10,
        -decorate => 0,
        -trimgap => 2
       );

    $DockFrame->Widget (...)->pack();

    ...

    Tk::MainLoop;



DESCRIPTION

The two public classes in this module combine to implement a dockable widget subsystem.

Objects of class DockFrame are simple frames which can be made to float free as Toplevel widgets or packed as Frames. Dockframes can have any number of direct children but the favored use is to pack a single Frame based child widget and add widgets to that using any geometry manager.

DockPorts are simple frame widgets which must be managed by the packer. They normally have no width or height and are thus rendered invisible. DockFrame children of the same parentage, when dragged over them, will be converted from floating Toplevels into Frame widgets rendered within the DockPort, resizing it accordingly.
IMPORTANT UPDATE The DockFrames are now managed WITHIN the DockPorts, therefore any geometry manager can be used with all the widgets described here

STANDARD OPTIONS

DockFrame -background -borderwidth -relief -bg -width -height
DockPort none
See Tk for details of the standard options.

WIDGET-SPECIFIC OPTIONS

Name:  <B>dockB>
Class: <B>DockB>
Switch:        <B>-dockB> Used to dock a DockFrame to a DockPort. The parameter passed must be a reference to a DockPort and nothing else. If a DockPort is not specified in this manner on creation, then the DockFrame will initially float free.
Name:  <B>trimcountB>
Class: <B>TrimCountB>
Switch:        <B>-trimcountB> Specifies the number of button trim drag ’handles’. Specifying 0 will prevent attachment/detachment of the DockFrame.
Name:  <B>sensitivityB>
Class: <B>SensitivityB>
Switch:        <B>-sensitivityB> The DockFrame will dock when it gets within the specified number of pixels of the DockPort.
Name:  <B>decorateB>
Class: <B>DecorateB>
Switch:        <B>-decorateB> Boolean value indicating whether or not to instruct the window manager to add decoration (titlebar, etc) to the undocked DockFrame. It is important to note here that, due to the nature of the event handling, dragging the DockFrame by the titlebar will not cause it to dock.
Name:  <B>trimgapB>
Class: <B>TrimgapB>
Switch:        <B>-trimgapB> This option specifies the number of pixels to leave between the handles and the first child widget

WIDGET METHODS

$DockFrame-><B>dockB> (<B>B>$DockPort<B>B>) Immediately docks the DockFrame to the specified DockPort
$DockFrame-><B>undockB>() Immediately undocks the DockFrame

BINDINGS

<B>[1]B> Pressing and holding the left mouse button on a DockFrame trim element allows movement of that DockFrame. If the DockFrame is dragged over a DockPort, it will dock and dragging will cease until the handle is released and then selected again.

AUTHORS

Damion K. Wilson, dwilson@ibl.bm, http://pwp.ibl.bm/~dkw

COPYRIGHT

Copyright (c) 1999 Damion K. Wilson.

All rights reserved.

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

HISTORY

<B>October 1, 1999B>: Written to replace experimental Tk::DockingGroup with no legacy support

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 630: =cut found outside a pod block. Skipping to next block.
Around line 673: ’=item’ outside of any ’=over’
Around line 678: You forgot a ’=back’ before ’=head1’
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 DOCKFRAME (3) 1999-11-26

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.