SgFinderRemoveHistoryItem(3X)

     NAME
          SgFinderRemoveHistoryItem - A Finder function that removes
          an item from the Finder history list

     SYNOPSIS
          #include <Sgm/Finder.h>

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


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

     DESCRIPTION
          SgFinderRemoveHistoryItem removes an item from the Finder
          history list.  The routine only manipulates the history list
          - it does not simultaneously remove the item from the Finder
          text field, if the text happens to be displaying the given
          item. The routines SgFinderGetTextString and
          SgFinderSetTextString can be used to check and set the text
          contents should this also be required. The programmer should
          call the appropriate free routine on the String passed to
          the SgFinderRemoveHistoryItem procedure, since the widget
          indirectly creates its own XmString from the str argument.


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

          str    Specifies the item to be removed from the Finder.


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

     RELATED INFORMATION
          SgFinder(3X).