The purpose of this utility routine is to allow objects lower down in a graphics
hierarchy to obtain the object reference of a drawable graphics window (either
a PIXMAPWIDGET or a DRAWWIDGET or a subclass of one of these) in the graphics
hierarchy. The FIRST_PARENT of each object in the hierarchy is traversed in the
search for a PIXMAPWIDGET or a DRAWWIDGET object.
FANNING SOFTWARE CONSULTING
1645 Sheely Drive
Fort Collins, CO 80526 USA
graphicsWindowObject = CatGetGraphicsWindow(object)
graphicsWindowObject: The first PIXMAPWIDGET or DRAWWIDGET object found in the object's hierarchy.
A null object is returned if a PIXMAPWIDGET or DRAWWIDGET cannot be found.
object: The object which is requesting information and in whose hierarchy the
search is conducted. This object must be sub-classed from 'CATATOM'.
Written by: David W. Fanning, 2 October 2008.