.\" This is a wxWidgets manpage page generated from the XML docs
.TH wxScreenDC 3wx 2005-02-15 "wxWidgets" "wxWidgets class documentation"
.SH NAME
wxScreenDC \- 
  A device context to access the entire screen
 
.SH DESCRIPTION

  


   A wxScreenDC can be used to paint on the screen. This should normally be
   constructed as a temporary stack object; don't store a wxScreenDC object.
  
 
.SH "PARENTS"

  wxDC
 
.SH "INCLUDE FILES"
wx/dcscreen.h
.SH MEMBERS

  
.SS  wxScreenDC ()

     


      Constructor.
     
    
   
  
.SS bool StartDrawingOnTop (wxWindow* window)

.SS bool StartDrawingOnTop (wxRect* rect = NULL)

     


      Use this in conjunction with
      EndDrawingOnTop
      to ensure that drawing to the screen occurs on top of existing windows.
      Without this, some window systems (such as X) only allow drawing to take
      place underneath other windows.
     
     


      By using the first form of this function, an application is specifying
      that the area that will be drawn on coincides with the given window.
     
     


      By using the second form, an application can specify an area of the screen
      which is to be drawn on. If NULL is passed, the whole screen is available.
     
     


      It is recommended that an area of the screen is specified because with
      large regions, flickering effects are noticeable when destroying the
      temporary transparent window used to implement this feature.
     
     


      You might use this pair of functions when implementing a drag feature, for
      example as in the
      wxSplitterWindow
      implementation.
     
    
   
  
.SS bool EndDrawingOnTop ()

     


      Use this in conjunction with
      StartDrawingOnTop
      .
     
     


      This function destroys the temporary window created to implement on-top
      drawing (X only).
     
    
 
.SH "SEE ALSO"

  wxDC
 
  wxDC
  wxMemoryDC
  wxPaintDC
  , 
  wxClientDC
  wxWindowDC
 
.SH "AUTHORS"
Documentation content by Julian Smart, Robert Roebling, Vadim Zeitlin, Robin Dunn, et al

Conversion to manpage format by Arnout Engelen (http://bzzt.net), bugreports welcome.