coyote: CGSET

Description
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.
Categories
Graphics
Params
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.
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.
widgetid: in, optional, type=boolean
    If this keyword is set, the selection is assumed to be a widget identifier.
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 forward on display
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.
   If selection match isn't provided, as like WShow to bring the current 
      window forward on display. 26 Jan 2011. DWF.
Copyright
Copyright (c) 2011, Fanning Software Consulting, Inc.