VtPulldown(VTCL)

VtPulldown -- create Pulldown Menu, return widget name

Synopsis

VtPulldown widgetName [options]

Description

Creates a Pulldown Menu. (Label resources can be used to title the Menu.)

Options

-cascadeButton (G): This flag can be used only with VtGet(VTCL). It returns the widget name of the pulldown's cascadeButton. Use this widget to set options such as -font.
-help (C): Describes this Pulldown to the MenuBar as containing the Help Menu pane. A simpler alternative is to use either the VtMenuBar(VTCL) -helpMenuItemList option or the VxMenu(VTCL) convenience routine.
-radioBehavior boolean (CS): Specify that the Pulldown should act like a radiobox.
-tearoff (CSG): Specifies that this Pulldown Menu can be torn off the MenuBar.

For example, to make a Cascade Menu within a pulldown:

   ...
   set menubar [VtMenuBar $form.menubar]
   
   set pm [VtPulldown $menubar.phonemenu -label "Phone"]
   

   set check [VtPulldown $pm.check -label "Check"]
   	set check_yes [VtPushButton $check.yes -label "Yes"]
   	set check_no  [VtPushButton $check.no  -label "No"]
   ...

This creates a Menu (Phone) containing the button check, which cascades to another Menu that contains the buttons Yes and No.

Return values

If VtPulldown fails, it returns one of the following error messages:

Standard errors: See ``Tcl widget creation errors'' in Developing Visual Tcl applications.