MGH_GUI_PDMENU__DEFINE Class
MGH_GUI_PDmenu Purpose
An object that implements pull-down menus.
Superclasses
None. Note that MGH_GUI_PDmenu shares much of is functionality of
other GUI objects but unlike them it is *not* a subclass of
MGH_GUI_Base. Properties
The following properties are supported:
BASE (Init*, Get)
Base widget ID. This argument must be specified when creating
a menu-bar menu, otherwise it is ignored.
CHECKED_MENU (Init)
During object initialisation a set of buttons is always added
to the top level of the menu object. The CHECKED_MENU keyword
specifies whether these buttons have check boxes associated
with them. The keyword should either be a scalar or a vector
with the same number of elements as the items
argument. Default is 0.
COLUMN (Init)
ROW (Init)
Children of a MGH_GUI_PDmenu are always organised in either a
row or a column and centred. Set one of these keyword for
column or row alignment. Default is "row". Ignored by menu-bar
menus.
CONTEXT (Init, Get)
Set this keyword to create a context-sensitive menu.
MENU (Init)
During object initialisation a set of buttons is always added
to the top level of the menu object. The MENU keyword
specifies whether these buttons are menu-buttons (i.e. they
will be parents of other buttons) or not. It should either be
a scalar or a vector with the same number of elements as the
items argument. Default is 1 for menu-bar menus and 0 otherwise.
PARENT (Init*, Get)
Parent widget ID. This argument must be specified when
creating a non-menu-bar menu, otherwise it is ignored.
MBAR (Init, Get)
Set this keyword to create a menu attached to a top-level
base's menu bar.
UNAME (Init, Get, Set)
A string that can be used to identify the widget. Default is
''.
UVALUE (Init, Get, Set)
User value. Default is undefined.
###########################################################################
This software is provided subject to the following conditions:
1. NIWA makes no representations or warranties regarding the
accuracy of the software, the use to which the software may
be put or the results to be obtained from the use of the
software. Accordingly NIWA accepts no liability for any loss
or damage (whether direct of indirect) incurred by any person
through the use of or reliance on the software.
2. NIWA is to be acknowledged as the original author of the
software where the software is used or presented in any form.
###########################################################################
Modification History
Mark Hadfield, 2001-06.
Written.
Mark Hadfield, 2003-06.
Added support for checked-menu functionality (IDL 6.0).
Mark Hadfield, 2004-05.
Added support for acelerator keys (IDL 6.1)