CATGETGRAPHICSWINDOW

Name

CatGetGraphicsWindow

Purpose

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.

Author

FANNING SOFTWARE CONSULTING
1645 Sheely Drive
Fort Collins, CO 80526 USA
Phone: 970-221-0438
E-mail: davidf@dfanning.com

Calling Sequence

graphicsWindowObject = CatGetGraphicsWindow(object)

Return Value

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.

Inputs

object: The object which is requesting information and in whose hierarchy the
search is conducted. This object must be sub-classed from 'CATATOM'.

Keywords

None.

Modification History

Written by: David W. Fanning, 2 October 2008.