projects / wxWidgets.git / blame
| Commit | Line | Data |
|---|---|---|
| a660d684 KB |
1 | \section{\class{wxScreenDC}}\label{wxscreendc} |
| 2 | ||
| 3 | A wxScreenDC can be used to paint on the screen. | |
| 4 | This should normally be constructed as a temporary stack object; don't store | |
| 5 | a wxScreenDC object. | |
| 6 | ||
| 7 | \wxheading{Derived from} | |
| 8 | ||
| 7376079d VZ |
9 | \helpref{wxDC}{wxdc}\\ |
| 10 | \helpref{wxObject}{wxobject} | |
| a660d684 | 11 | |
| 954b8ae6 JS |
12 | \wxheading{Include files} |
| 13 | ||
| 14 | <wx/dcscreen.h> | |
| 15 | ||
| a7af285d VZ |
16 | \wxheading{Library} |
| 17 | ||
| 18 | \helpref{wxCore}{librarieslist} | |
| 19 | ||
| a660d684 KB |
20 | \wxheading{See also} |
| 21 | ||
| 22 | \helpref{wxDC}{wxdc}, \helpref{wxMemoryDC}{wxmemorydc}, \helpref{wxPaintDC}{wxpaintdc},\rtfsp | |
| 23 | \helpref{wxClientDC}{wxclientdc}, \helpref{wxWindowDC}{wxwindowdc} | |
| 24 | ||
| 25 | \latexignore{\rtfignore{\wxheading{Members}}} | |
| 26 | ||
| 39275175 | 27 | \membersection{wxScreenDC::wxScreenDC}\label{wxscreendcctor} |
| a660d684 KB |
28 | |
| 29 | \func{}{wxScreenDC}{\void} | |
| 30 | ||
| 31 | Constructor. | |
| 32 | ||
| 33 | \membersection{wxScreenDC::StartDrawingOnTop}\label{wxscreendcstartdrawingontop} | |
| 34 | ||
| 35 | \func{bool}{StartDrawingOnTop}{\param{wxWindow*}{ window}} | |
| 36 | ||
| 37 | \func{bool}{StartDrawingOnTop}{\param{wxRect*}{ rect = NULL}} | |
| 38 | ||
| 39 | Use this in conjunction with \helpref{EndDrawingOnTop}{wxscreendcenddrawingontop} to | |
| 40 | ensure that drawing to the screen occurs on top of existing windows. Without this, | |
| 41 | some window systems (such as X) only allow drawing to take place underneath | |
| 42 | other windows. | |
| 43 | ||
| 44 | By using the first form of this function, an application is specifying that | |
| 45 | the area that will be drawn on coincides with the given window. | |
| 46 | ||
| 47 | By using the second form, an application can specify an area of the screen | |
| 48 | which is to be drawn on. If NULL is passed, the whole screen is available. | |
| 49 | ||
| 50 | It is recommended that an area of the screen is specified because with large regions, | |
| 51 | flickering effects are noticeable when destroying the temporary transparent window used | |
| 52 | to implement this feature. | |
| 53 | ||
| 54 | You might use this pair of functions when implementing a drag feature, for example | |
| 55 | as in the \helpref{wxSplitterWindow}{wxsplitterwindow} implementation. | |
| 56 | ||
| fa482912 JS |
57 | \wxheading{Remarks} |
| 58 | ||
| 59 | This function is probably obsolete since the X implementations | |
| 60 | allow drawing directly on the screen now. However, the fact that this | |
| 61 | function allows the screen to be refreshed afterwards, may be useful to | |
| 62 | some applications. | |
| 63 | ||
| a660d684 KB |
64 | \membersection{wxScreenDC::EndDrawingOnTop}\label{wxscreendcenddrawingontop} |
| 65 | ||
| 66 | \func{bool}{EndDrawingOnTop}{\void} | |
| 67 | ||
| 68 | Use this in conjunction with \helpref{StartDrawingOnTop}{wxscreendcstartdrawingontop}. | |
| 69 | ||
| 70 | This function destroys the temporary window created to implement on-top drawing (X only). | |
| 71 |