'\"!  tbl | mmdoc
'\"macro stdmacro
.if n .pH g3w.olAbbMenuBtn @(#)olAbbMenuBtn	40.2 of 1/8/90
.SO BP.HEADER \" Read in definition to allow use of .BP/.EP
.ig
Modified 10/18/89 lmh
Modified 10/23/89 lmh
Modified 10/27/89 lmh
..
.ds cW ABBREVBUTTON
.ds rW AbbrevMenuButton
.ds nW AbbrevMenu
.ds wW abbrevMenuButton
.ds bW \fB\*(rW\fP
.ds iW \fI\*(rW\fP
.ds oS \*(cW
.nr oN 0
.nr X
.if \nX=0 .ds x} ""ABBREVIATED MENUBUTTON" 3W "\&"
.if \nX=1 .ds x} ""ABBREVIATED MENUBUTTON" 3W
.if \nX=2 .ds x} ""ABBREVIATED MENUBUTTON" "" "\&"
.if \nX=3 .ds x} ""ABBREVIATED "" "" "\&"
.TH \*(x}
.SH "WIDGET CLASS NAME"
\*(bW
.SH "SYNOPSIS"
.nf
\s-1\f4#include <Intrinsic.h>
#include <StringDefs.h>
#include <OpenLook.h>
#include <\*(nW.h>\f1\s+1\f1
.fi
.nf
.P
\s-1\f4static Widget stack, menupane, w;
.P
\s-1\f4Arg args[1];
.P
\s-1\f4stack = XtCreateWidget(\f2name\f4, \*(wWWidgetClass, ...);
XtSetArg(args[0], XtNmenuPane, &menupane);
XtGetValues(stack, args, 1);
.P
\s-1\f4w = XtCreateWidget(\f2name\f4, \f2widget-class\f4, menupane, ...);\s+1\f1
.fi
.SH "DESCRIPTION"
The \*(bW widget provides the end user the same features as the
\f3MenuButton\f1
widget (menu default selection, menu previewing, menu
selection), plus current selection viewing, and the ability to
add a new selection by typing in its name.
.sp
\f3\*(rW Components\f1
.P
Each abbreviated menu button has a submenu.  An application 
typically identifies an additional component,
the Current Selection Widget,
where previewing of the default menu choice can be done.
.br
.ne 3.5i
.BP PSART/ps.abbr1
.P
.ce
\f3Figure 1.\f1  Abbreviated Menu Button 
.P
Each abbreviated menu button also has the components of a
\f3Menu\f1
widget.
These are not shown in Figure 1.
.sp
\f3\*(rW Sensitive Area\f1
.P
While on the Abbreviated Menu Button and the power-user option is on: 
.sp 
\(en  Pressing SELECT previews the default menu item (if a preview
widget exists), and releasing it will activate the default menu item.
.sp 0.5
\(en  Clicking SELECT briefly previews the default menu item (if a
preview widget exists) and then activates the default menu item.
.sp 0.5
\(en  Pressing MENU brings up a pop-up menu.
.sp 0.5
\(en  Clicking MENU produces a stayup menu.
.P
If the power-user option is off:
.sp 0.5
\(en  Pressing SELECT or MENU brings up a pop-up menu.
.sp 0.5
\(en  Clicking SELECT or MENU produces a stayup menu.
.sp
(The power-user option is set in the property sheet of the 
Window Manager.  See the \f2AT&T OPEN LOOK\(tm GUI User's Guide\f1
for more information on setting this option.)
.bp 
\f3All Features of Menu Button Widget\f1
.P
The \*(bW widget includes all the features of the
\f3MenuButton\f1 widget,
except for the previewing
(done instead in the Current Select Widget)
and the behavior in a menu
(the \*(bW widget cannot be used in a menu).
The features for the
\f3MeuButton\f1
widget apply here.
.sp
\f3Current Selection Widget\f1
.P
The Current Selection Widget is created by the application.
Typically, the Current Selection Widget and the \*(bW widget
are placed together in a
composite widget that manages their side-by-side placement.
The \*(bW widget uses the Current Selection Widget only for
previewing the default item in the menu.
The application is responsible for using it to implement the
OPEN LOOK user interface needs of showing the current menu
selection and acquiring a new item to add to the menu,
as appropriate.
.sp
\f3\*(rW Coloration\f1
.P
Figure 2 illustrates the resources that affect the coloration
of the \*(bW widget.
.br
.ne 3.5i
.BP PSART/ps.abbr2
.P
.ce
\f3Figure 2.\f1  Abbreviated Menu Button Coloration
.bp
.SH "SUBSTRUCTURE"
.sp
\f3Menu component\f1
.P
.nf
Name: menu
Class: Menu
.fi
.ne3.2i 
.ds cO
.TS H
expand,allbox;
cB s s s s.
Application Resources\\\\*(cO
.T&
lBp-2 lBp-2 lBp-2 lBp-2 lBp-2.
Name	Class	Type	Default	Access
_
.TH
.ds cO " (cont'd)
.T&
lp-2 lp-2 lp-2 lp-2 lp-2.
*XtNcenter	XtCCenter	Boolean	TRUE	I
*XtNhPad	XtCHPad	Dimension	4	I
*XtNhSpace	XtCHSpace	Dimension	4	I
*XtNlayoutType	XtCLayoutType	OlDefine	OL_FIXEDROWS	I
*XtNmeasure	XtCMeasure	int	1	I
XtNpushpin	XtCPushpin	OlDefine	OL_NONE	I
XtNpushpinDefault	XtCPushpinDefault	Boolean	FALSE	I
*XtNsameSize	XtCSameSize	OlDefine	OL_COLUMNS	I
XtNtitle	XtCTitle	String	(widget's name)	I
*XtNvPad	XtCVPad	Dimension	4	I
*XtNvSpace	XtCVSpace	Dimension	4	I
.TE
.sp -0.5
\s-1* See the \f3Menu\f1 and \f3ControlArea\f1 widgets
for more information on these resources.\s+1
.sp
.SH "RESOURCES"
.ds cO
.TS H
expand,allbox;
cB s s s s.
\*(bW Resource Set\\\\*(cO
.T&
lBp-2 lBp-2 lBp-2 lBp-2 lBp-2.
Name	Class	Type	Default	Access
_
.TH
.ds cO " (cont'd)
.T&
lp-2 lp-2 lp-2 lp-2 lp-2.
XtNancestorSensitive	XtCSenstitive	Boolean	TRUE	G*
XtNbackground	XtCBackground	Pixel	White	SGI\(dg
XtNbackgroundPixmap	XtCPixmap	Pixmap	(none)	SGI\(dg
XtNdepth	XtCDepth	int	(parent's)	GI
XtNdestroyCallback	XtCCallback	XtCallbackList	NULL	SI
XtNforeground	XtCForeground	Pixel	Black	SGI\(dg
XtNheight	XtCHeight	Dimension	(calculated)	SGI
XtNmappedWhenManaged	XtCMappedWhenManaged	Boolean	TRUE	SGI
XtNmenuPane	XtCMenuPane	Widget	(none)	G
XtNpreviewWidget	XtCPreviewWidget	Widget	NULL	SGI
XtNsensitive	XtCSensitive	Boolean	TRUE	GI*
XtNuserData	XtCUserData	XtPointer	NULL	SGI
XtNwidth	XtCWidth	Dimension	(calculated)	SGI
XtNx	XtCPosition	Position	0	SGI
XtNy	XtCPosition	Position	0	SGI
.TE
.bp
\f3XtNforeground\f1
.P
This resource defines the foreground color for the widget.
.P
See the note about the interaction of this resource with other
color resources under the description of the
\f4XtNbackground\f1
resource in \f3CORE RESOURCES(3W)\f1.
.sp
\f3XtNmenuPane\f1
.P
This is the widget where menu items can be attached;
its value is available once the \*(bW widget has been created.
.sp
\f3XtNpreviewWidget\f1
.PP
Range of Values:
.br
.in +5
.nf
\f1(ID of existing widget)\f1
.in -5
.fi
.PP
This resource identifies the Current Selection Widget that the
\*(bW can use for previewing the Default Item.
.P
When the end user presses SELECT over the \*(bW widget,
the \*(bW widget uses the location and size of the Current
Selection Widget to display the label of the Default Item.
The preview is constrained to be within the height and
width of the Current Selection Widget.
.P
If the Current Selection Widget is not defined or is not mapped,
previewing does not take place.
