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 1.2.

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  his-
     tory  list.  The  programmer should call the appropriate free on the String
     passed to the widget after calling SgFinderAddHistoryItem, since the widget
     indirectly 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).

                                                      SgFinderAddHistoryItem(3X)