SgFinderGetChild(3X)

     NAME
          SgFinderGetChild - A Finder function used to access a widget
          component

     SYNOPSIS
          #include <Sgm/Finder.h>

          Widget SgFinderGetChild (widget, child)
               Widget    widget;
               int       child;


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

     DESCRIPTION
          SgFinderGetChild is used to access a widget component within
          a Finder.  The parameters given to the function are the
          Finder widget and a value indicating which component to
          access.

          The Finder widget generally provides the functionality and
          access to child behavior through other means.  Accessing the
          children of the Finder and modifying their callbacks or
          resources significantly may cause unpredictable results.  It
          is suggested that applications not modify the state of the
          Finder children.


          widget Specifies the Finder widget ID.

          child  Specifies a component within the Finder. The
                 following are legal values for this parameter:


                   o  SgFINDER_DROP_POCKET

                   o  SgFINDER_TEXT

                   o  SgFINDER_ZOOM_BAR

                   o  SgFINDER_HISTORY_MENUBAR


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

     RETURN VALUE
          Returns the widget ID of the specified Finder component.  An
          application should not assume that the returned widget will
          be of any particular class.
     RELATED INFORMATION
          SgFinder(3X).