SgFinderAddHistoryItem(3X)

     NAME
          SgFinderAddHistoryItem - A Finder function that adds an item
          to the Finder history list

     SYNOPSIS
          #include <Sgm/Finder.h>

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


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

     DESCRIPTION
          SgFinderAddHistoryItem adds an item to the Finder 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 Finder, 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
          SgFinderAddHistoryItem, since the widget creates its own
          XmString from the str argument.


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

          str    Specifies the item to be added to the Finder.


          For a complete definition of Finder and its associated
          resources, see SgFinder(3X).

     RELATED INFORMATION
          SgFinder(3X).