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 dis-
     playing the given item. The routines SgFinderGetTextString and SgFinderSet-
     TextString 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).

                                                   SgFinderRemoveHistoryItem(3X)