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

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 indicat-
     ing 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 unpre-
     dictable 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:


              *  SgFINDER_DROP_POCKET

              *  SgFINDER_TEXT

              *  SgFINDER_ZOOM_BAR

              *  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).


                                                            SgFinderGetChild(3X)