.\
cgquery.pro
top cgQuery
Graphics
result = cgQuery( [COUNT=long] [, /CURRENT] [, DIMENSIONS=integer] [, OBJECTREF=object] [, TITLE=string] [, WIDGETID=long])
Provides information about any cgWindow applications currently on the display. Returns the window index numbers of any cgWindow applications current on the display.
Return value
windowIndexID: out, type=long An array of window index numbers for each cgWindow application currently on the display.
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.
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 information
- 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- Copyright:
Copyright (c) 2011, Fanning Software Consulting, Inc.
- 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.
File attributes
| Modification date: | Fri Mar 27 11:07:36 2015 |
| Lines: | 189 |
| Docformat: | rst rst |