wxRuby Documentation Home

# Wx::EraseEvent

An erase event is sent when a window’s background needs to be repainted.

On some platforms, such as GTK+, this event is simulated (simply generated just before the
paint event) and may cause flicker. It is therefore recommended that
you set the text background colour explicitly in order to prevent flicker.
The default background colour under GTK+ is grey.

To intercept this event, use the EVT_ERASE_BACKGROUND macro in an event table definition.

You must call EraseEvent::GetDC and use the returned device context if it is non-NULL.
If it is NULL, create your own temporary ClientDC object.

## Derived from

Event

Object

## Event table macros

To process an erase event, use this event handler macro to direct input to a member
function that takes a EraseEvent argument.

evt_erase_background() { | event | … } | Process a EVT_ERASE_BACKGROUND event.

## Remarks

Use the device context returned by GetDC to draw on,
don’t create a PaintDC in the event handler.

## See also

Event handling overview

## Methods

- EraseEvent.new
- EraseEvent#get_dc

### EraseEvent.new

EraseEvent.new(%(arg-type)Integer% id = 0, DC dc = nil)

Constructor.

### EraseEvent#get_dc

DC get_dc()

Returns the device context associated with the erase event to draw on.

[This page automatically generated from the Textile source at 2023-06-09 00:45:27 +0000]