Allows the user to select the cgWindow application to be the brought forward on the display.
  Selection can be made based on window index number, widget identifier, object reference,
  or window title. This is the equivalent of WShow for normal graphics windows.

Categories

---

    Graphics
   

Params

---

    selection: in, required, 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

---

    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> cgShow ; Bring current window forwad 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, 1 February 2011. DWF.

Copyright

---

    Copyright (c) 2011, Fanning Software Consulting, Inc.