coyote: CGQUERY

Description
Provides information about any cgWindow applications currently on the display. Returns
the window index numbers of any cgWindow applications current on the display.
Categories
Graphics
Keywords
count: out, optional, type=long
    The number of cgWindow applications currently on the display.
current: in, optional, type=boolean
    If set, the current cgWindow application information is returned in the result
    of the function and in the information keywords.
dimensions: out, optional, type=integer
    The dimensions of the ctWindow application, [xdim, ydim, n].
objectref: out, optional, type=object
    A vector of FSC_CMDWINDOW object references for each cgWindow application currently 
    on the display.
title: out, optional, type=string
    A vector of window titles for each cgWindow application currently on the display.
widgetID: out, optional, type=long
    A vector of widget identifiers of the top-level base widget for each cgWindow
    application currently on the display.
Returns
windowIndexID: out, type=long
    An array of window index numbers for each cgWindow application currently on the display.
Examples
Used as a query routine::
   IDL> wids = cgQuery(TITLE=titles, COUNT=count)
   IDL> index = Where(StrUpCase(titles) EQ 'PLOT WINDOW', tcnt)
   IDL> IF tcnt GT 0 THEN cgSet, wids[index]
   IDL> cgWindow, 'Oplot', thisData, /AddCmd
Author
FANNING SOFTWARE CONSULTING::
    David W. Fanning 
    1645 Sheely Drive
    Fort Collins, CO 80526 USA
    Phone: 970-221-0438
    E-mail: david@idlcoyote.com
    Coyote's Guide to IDL Programming: http://www.idlcoyote.com
History
Change History::
   Written, 23 January 2011. DWF.
   Added DIMENSIONS keyword to return current dimensions of cgWindows. 24 Feb 2011. DWF.
   Made sure this program only returns information on devices that support windows. 20 July 2011. DWF.
Copyright
Copyright (c) 2011, Fanning Software Consulting, Inc.