XmUpdateDisplay(library call) XmUpdateDisplay(library call)
NAME
XmUpdateDisplay -- A function that processes all pending exposure events immediately
SYNOPSIS
void XmUpdateDisplay (widget)
Widget widget;
(void)
DESCRIPTION
XmUpdateDisplay provides the application with a mechanism for forcing all pending exposure events to be removed from the input queue and
processed immediately. When a user selects a button within a menu pane, the menu panes are unposted and then any activation callbacks reg-
istered by the application are invoked. If one of the callbacks performs a time-consuming action, the portion of the application window
that was covered by the menu panes will not have been redrawn; normal exposure processing does not occur until all of the callbacks have
been invoked. If the application writer suspects that a callback will take a long time, then the callback may choose to invoke XmUpdateDis-
play before starting its time-consuming operation. This function is also useful any time a transient window, such as a dialog box, is
unposted; callbacks are invoked before normal exposure processing can occur.
widget Specifies any widget or gadget.
XmUpdateDisplay(library call)
Check Out this Related Man Page
XmCreatePulldownMenu(library call) XmCreatePulldownMenu(library call)
NAME
XmCreatePulldownMenu -- A RowColumn widget convenience creation function
SYNOPSIS
#include <Xm/RowColumn.h>
Widget XmCreatePulldownMenu(
Widget parent,
String name,
ArgList arglist,
Cardinal argcount);
DESCRIPTION
XmCreatePulldownMenu creates an instance of a RowColumn widget of type XmMENU_PULLDOWN and returns the associated widget ID.
parent Specifies the parent widget ID
name Specifies the name of the created widget
arglist Specifies the argument list
argcount Specifies the number of attribute/value pairs in the argument list (arglist)
Specifies the number of attribute/value pairs in the argument list (arglist). When this function is used to create the Pulldown menu pane,
a MenuShell widget is automatically created as the parent of the menu pane. If the widget specified by the parent parameter is a Popup or a
Pulldown menu pane, the MenuShell widget is created as a child of the parent MenuShell; otherwise, it is created as a child of the speci-
fied parent widget.
XmCreatePulldownMenu is provided as a convenience function for creating RowColumn widgets configured to operate as Pulldown menu panes and
is not implemented as a separate widget class.
A Pulldown menu pane displays a 3-D shadow, unless the feature is disabled by the application. The shadow appears around the edge of the
menu pane.
A Pulldown menu pane is used with submenus that are to be attached to a CascadeButton or a CascadeButtonGadget. This is the case for all
menu panes that are part of a PulldownMenu system (a MenuBar), the menu pane associated with an OptionMenu, and any menu panes that cascade
from a Popup menu pane. Pulldown menu panes that are to be associated with an OptionMenu must be created before the OptionMenu is created.
The Pulldown menu pane must be attached to a CascadeButton or CascadeButtonGadget that resides in a MenuBar, a Popup menu pane, a Pulldown
menu pane, or an OptionMenu. It is attached with the button resource XmNsubMenuId.
A MenuShell widget is required between the Pulldown menu pane and its parent. If the application uses this convenience function for creat-
ing a Pulldown menu pane, the MenuShell is automatically created as the real parent of the menu pane; otherwise, it is the application's
responsibility to create the MenuShell widget.
To function correctly when incorporated into a menu, the Pulldown menu pane's hierarchy must be considered. This hierarchy depends on the
type of menu system that is being built, as follows:
o If the Pulldown menu pane is to be pulled down from a MenuBar, its parent must be the MenuBar.
o If the Pulldown menu pane is to be pulled down from a Popup or another Pulldown menu pane, its parent must be that Popup or Pulldown
menu pane.
o If the Pulldown menu pane is to be pulled down from an OptionMenu, its parent must be the same as the OptionMenu parent.
PullDown menu panes support tear-off capabilities for tear-off menus through XmRowColumn resources. For a complete definition of RowColumn
and its associated resources, see XmRowColumn(3).
RETURN
Returns the RowColumn widget ID.
RELATED XmCascadeButton(3), XmCascadeButtonGadget(3), XmCreateOptionMenu(3), XmCreatePopupMenu(3), XmCreateSimplePulldownMenu(3), XmMenuShell(3),
XmRowColumn(3), and XmVaCreateSimplePulldownMenu(3).
XmCreatePulldownMenu(library call)