NAME

Tk::Multi::Manager - Tk composite widget managing Tk::Multi slaves

SYNOPSIS

 use Tk::Multi::Manager ;
 use Tk::Multi::Text ; # if you use MultiText as a slave

 my $manager = yourWindow -> MultiManager 
  (
   menu => $menu_ref , # optionnal
   title => "windows" # optionnal
  ) -> pack ();

 # Don't pack it, the managet will do it
 my $w1 = $manager -> newSlave('type' => 'MultiText', 'title' => 'a_label');

DESCRIPTION

The manager is a composite widget made of a menu cascade of check buttons and slaves which can be Tk::Multi::Text.

The user can add windows to the manager. Each window visibility is controled by a check button in the menu cascade. The check button actually tells the packer to forget the window. note that the window object is not destroyed.

Constructor configuration options

menu

The widget may use a 'menu' argument which will be used to create a menu item and releveant sub-menus to control the sub-window. If not provided, the widget will create a its own menu.

title

The optionnal title argument contains the title of the menu created by the manager.

Methods

newSlave('type' => 'MultiXXX', 'title'=> 'name', ['hidden' => 1] ) ;

Create a new slave to manager. Returns the slave widget object.

type

specifies the kind of Multi widget (ex MultiText).

title

specifies the title of the widget (mandatory).

hidden

specifies whether the widget is to be packed right now or not (default 0)

destroyable

a 'destroy' button is created if this parameter is defined (default no). Returns the slave widget reference.

hide('name of the slave');

Hide the slave.

show('name of the slave');

Show the slave.

destroySlave( 'name of the slave') ;

Destroy the slave

BUGS

When unpacking or destroying the last window, the enclosing frame does not reduce its size. It's probably a matter of geometry propagation to the enclosing frame.

AUTHOR

Dominique Dumont, Dominique_Dumont@grenoble.hp.com

Copyright (c) 1997-1998 Dominique Dumont. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

perl(1), Tk(3), Tk::Multi::Text(3)