tk::menu::item(3) [suse man page]

Menu::Item(3)						User Contributed Perl Documentation					     Menu::Item(3)

NAME

       Tk::Menu::Item - Base class for Menu items

SYNOPSIS

	  require Tk::Menu::Item;

	  my $but = $menu->Button(...);
	  $but->configure(...);
	  my $what = $but->cget();

	  package Whatever;
	  require Tk::Menu::Item;
	  @ISA = qw(Tk::Menu::Item);

	  sub PreInit
	  {
	   my ($class,$menu,$info) = @_;
	   $info->{'-xxxxx'} = ...
	   my $y = delete $info->{'-yyyy'};
	  }

DESCRIPTION

       Tk::Menu::Item is the base class from which Tk::Menu::Button, Tk::Menu::Cascade, Tk::Menu::Radiobutton and Tk::Menu::Checkbutton are
       derived.  There is also a Tk::Menu::Separator.

       Constructors are declared so that $menu->Button(...) etc. do what you would expect.

       The "-label" option is pre-processed allowing ~ to be prefixed to the character to derive a "-underline" value. Thus

	   $menu->Button(-label => 'Goto ~Home',...)

	   is equivalent to

	   $menu->Button(-label => 'Goto Home', -underline => 6, ...)

       The "Cascade" menu item creates a sub-menu and accepts these options:

       -menuitems
	   A list of items for the sub-menu.  Within this list (which is also accepted by Menu and Menubutton) the first two elements of each item
	   should be the "constructor" name and the label:

	       -menuitems => [
			      [Button	   => '~Quit', -command => [destroy => $mw]],
			      [Checkbutton => '~Oil',  -variable => $oil],
			     ]

       -postcommand
	   A callback to be invoked before posting the menu.

       -tearoff
	   Specifies whether sub-menu can be torn-off or not.

       -menuvar
	   Scalar reference that will be set to the newly-created sub-menu.

       The returned object is currently a blessed reference to an array of two items: the containing Menu and the 'label'.  Methods "configure"
       and "cget" are mapped onto underlying "entryconfigure" and "entrycget".

       The main purpose of the OO interface is to allow derived item classes to be defined which pre-set the options used to create a more basic
       item.

BUGS

       This OO interface is very new. Using the label as the "key" is a problem for separaror items which don't have one. The alternative would be
       to use an index into the menu but that is a problem if items are deleted (or inserted other than at the end).

       There should probably be a PostInit entry point too, or a more widget like defered 'configure'.

perl v5.12.1							    2007-05-05							     Menu::Item(3)

Check Out this Related Man Page

XmCreateSimpleOptionMenu(3X)											      XmCreateSimpleOptionMenu(3X)

NAME

       XmCreateSimpleOptionMenu - A RowColumn widget convenience creation function

SYNOPSIS

       #include <Xm/RowColumn.h>

       Widget XmCreateSimpleOptionMenu (parent, name, arglist, argcount)
	       Widget parent;
	       String name;
	       ArgList arglist;
	       Cardinal argcount;

DESCRIPTION

       XmCreateSimpleOptionMenu creates an instance of a RowColumn widget of type XmMENU_OPTION and returns the associated widget ID.

       This routine creates an Option Menu and its submenu containing PushButtonGadget or CascadeButtonGadget children. The name of each button is
       button_n, where n is an integer from 0 to one minus the number of buttons in the menu. The name of each separator is separator_n,  where  n
       is  an integer from 0 to one minus the number of separators in the menu. Buttons and separators are named and created in the order in which
       they are specified in the RowColumn simple menu creation resources supplied in the argument list.  Specifies the parent widget ID Specifies
       the name of the created widget Specifies the argument list Specifies the number of attribute/value pairs in the argument list (arglist)

       The  user  can specify resources in a resource file for the automatically created widgets and gadgets of an OptionMenu.	The following list
       identifies the names of these widgets (or gadgets) and the associated OptionMenu areas.	Option	Menu  Label  Gadget--"OptionLabel"  Option
       Menu Cascade Button--"OptionButton"

       A  number  of  resources exist specifically for use with this and other simple menu creation routines. The only button types allowed in the
       XmNbuttonType resource are XmPUSHBUTTON, XmCASCADEBUTTON, XmSEPARATOR, and XmDOUBLE_SEPARATOR. For a complete definition of  RowColumn  and
       its associated resources, see XmRowColumn(3X).

RETURN VALUE

       Returns the RowColumn widget ID.

SEE ALSO

       XmCreateOptionMenu(3X), XmCreateRowColumn(3X), XmRowColumn(3X), XmVaCreateSimpleOptionMenu(3X)

														      XmCreateSimpleOptionMenu(3X)

Linux and UNIX Man Pages

tk::menu::item(3) [suse man page]

Check Out this Related Man Page