wx.ScreenDC

Inheritance diagram for wx.ScreenDC:

Description

A wx.ScreenDC can be used to paint on the screen. This should normally be constructed as a temporary stack object; don’t store a wx.ScreenDC object.

See also

wx.DC, wx.MemoryDC, wx.PaintDC, wx.ClientDC, wx.WindowDC

Derived From

• wx.DC

Methods Summary

• __init__
• EndDrawingOnTop
• StartDrawingOnTop
• StartDrawingOnTopWin

Class API

Methods

__init__()

A wx.ScreenDC can be used to paint anywhere on the screen. This should normally be constructed as a temporary stack object; don’t store a wx.ScreenDC object.

Returns:

wx.ScreenDC

---

EndDrawingOnTop()

Use this in conjunction with StartDrawingOnTop or StartDrawingOnTopWin 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.

You might use this pair of functions when implementing a drag feature, for example as in the wx.SplitterWindow implementation.

Returns:

bool

Note

This function is probably obsolete since the X implementations allow drawing directly on the screen now. However, the fact that this function allows the screen to be refreshed afterwards, may be useful to some applications.

---

StartDrawingOnTop(rect=None)

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.

An application can specify an area of the screen which is to be drawn on. If None 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 wx.SplitterWindow implementation.

Parameters:

• rect (wx.Rect)

Returns:

bool

Note

This function is probably obsolete since the X implementations allow drawing directly on the screen now. However, the fact that this function allows the screen to be refreshed afterwards, may be useful to some applications.

See also

EndDrawingOnTop

---

StartDrawingOnTopWin(window)

Specify that the area of the screen to be drawn upon coincides with the given window.

Parameters:

• window (wx.Window)

Returns:

bool

Note

This function is probably obsolete since the X implementations allow drawing directly on the screen now. However, the fact that this function allows the screen to be refreshed afterwards, may be useful to some applications.

See also

EndDrawingOnTop