Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ XmCreatePopupMenu(3X) — DG/UX 5.4R2.01

Media Vault

Software Library

Restoration Projects

Artifacts Sought



     XmCreatePopupMenu(3X)     UNIX System V     XmCreatePopupMenu(3X)



     NAME
          XmCreatePopupMenu-A RowColumn widget convenience creation
          function

     SYNOPSIS
          #include <Xm/RowColumn.h>

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


     DESCRIPTION
          XmCreatePopupMenu creates an instance of a RowColumn widget
          of type XmMENUPOPUP and returns the associated widget ID.
          When using this function to create the Popup MenuPane, a
          MenuShell widget is automatically created as the parent of
          the MenuPane.  The parent of the MenuShell widget is the
          widget indicated by the parent parameter.

          XmCreatePopupMenu is provided as a convenience function for
          creating RowColumn widgets configured to operate as Popup
          MenuPanes and is not implemented as a separate widget class.

          The PopupMenu is used as the first MenuPane within a
          PopupMenu system; all other MenuPanes are of the Pulldown
          type.  A Popup MenuPane displays a 3-D shadow, unless the
          feature is disabled by the application.  The shadow appears
          around the edge of the MenuPane.

          The Popup MenuPane must be created as the child of a
          MenuShell widget in order to function properly when it is
          incorporated into a menu.  If the application uses this
          convenience function for creating a Popup MenuPane, the
          MenuShell is automatically created as the real parent of the
          MenuPane.  If the application does not use this convenience
          function to create the RowColumn to function as a Popup
          MenuPane, it is the application's responsibility to create
          the MenuShell widget.

          To access the PopupMenu, the application must first position
          the widget using the XmMenuPosition function and then manage
          it using XtManageChild.


          parent Specifies the parent widget ID

          name   Specifies the name of the created widget

          arglistSpecifies the argument list



     1                                                (printed 6/8/92)





     XmCreatePopupMenu(3X)     UNIX System V     XmCreatePopupMenu(3X)



          argcount
                 Specifies the number of attribute/value pairs in the
                 argument list (arglist)


          Popup MenuPanes support tear-off capabilities for tear-off
          menus through XmRowColumn resources.  For a complete
          definition of RowColumn and its associated resources, see
          XmRowColumn(3X).

     RETURN VALUE
          Returns the RowColumn widget ID.

     RELATED INFORMATION
          XmCreateSimplePopupMenu(3X), XmMenuPosition(3X),
          XmMenuShell(3X), XmRowColumn(3X), and
          XmVaCreateSimplePopupMenu(3X).






































     2                                                (printed 6/8/92)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026