SgDynaMenuAddHistoryItem(3X)

     NAME
          SgDynaMenuAddHistoryItem - A DynaMenu function that adds an
          item to the DynaMenu 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 2.1.

     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 DynaMenu, 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 SgDynaMenu(3X).

     RELATED INFORMATION
          SgDynaMenu(3X).