SgDynaMenuAddHistoryItem(3X)

NAME
     SgDynaMenuAddHistoryItem --A DynaMenu function that adds an item to the Dy-
     naMenu history list

SYNOPSIS
     #include <Sgm/DynaMenu.h>

     void SgDynaMenuAddHistoryItem (widget, str)
          Widget    widget;
          char       * str;


VERSION
     This page documents the version of Sgm that accompanies Motif 1.2.

DESCRIPTION
     SgDynaMenuAddHistoryItem  adds  an item to the DynaMenu history list at the
     top position.  When the item is inserted into the list, it is compared with
     the current items. If the new item matches an item on  the  selected  Dyna-
     Menu, the item is removed from the old position, so it is not duplicated in
     the  history  list.  The programmer should call the appropriate free on the
     String passed to the widget after calling  SgDynaMenuAddHistoryItem,  since
     the widget creates its own XmString from the str argument.


     widget Specifies the ID of the DynaMenu to which an item is added.

     str    Specifies the item to be added to the DynaMenu.


     For a complete definition of DynaMenu and its associated resources, see Sg-
     DynaMenu(3X).

RELATED INFORMATION
     SgDynaMenu(3X).

                                                    SgDynaMenuAddHistoryItem(3X)