Coyote Graphics Routines

Date: Fri Mar 27 12:14:20 2015

single page | use frames     summary     class     fields     routine details     file attributes

.\

cgset.pro


top cgSet

Graphics

cgSet [, selection] [, /DISPLAY] [, /OBJECT] [, /WIDGETID] [, /TITLE]

Allows the user to select the cgWindow application to be the "current" application. Selection can be made based on window index number, widget identifier, object reference, or window title.

Parameters

selection in optional type=varies

Normally, a window index number of an cgWindow application. But, the selection can be a widget identifier, an object reference, or a window title, depending on which keywords are set. The cgWindow matching the selection is made the "current" cgWindow and the application is moved forward on the display.

Keywords

DISPLAY in optional type=boolean default=0

If this keyword is set, the selection is made the "current" application, and then the graphics window of the application is made the current graphics window. If there is no selection, then the current cgWindow graphics window is made the current graphics window.

OBJECT in optional type=boolean

If this keyword is set, the selection is assumed to be an object reference.

WIDGETID in optional type=boolean

If this keyword is set, the selection is assumed to be a widget identifier.

TITLE in optional type=boolean

If this keyword is set, the selection is assumed to be a window title. All matching is done in uppercase characters.

Examples

Used with 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 IDL> cgSet ; Bring current window forwad on display

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. If selection match isn't provided, as like WShow to bring the current window forward on display. 26 Jan 2011. DWF.

File attributes

Modification date: Fri Mar 27 11:07:38 2015
Lines: 165
Docformat: rst rst