java.awt.event
Class PaintEvent
- java.lang.Object
-
- java.util.EventObject
-
- java.awt.AWTEvent
-
- java.awt.event.ComponentEvent
-
- java.awt.event.PaintEvent
-
- All Implemented Interfaces:
- Serializable
public class PaintEvent extends ComponentEvent
The component-level paint event. This event is a special type which is used to ensure that paint/update method calls are serialized along with the other events delivered from the event queue. This event is not designed to be used with the Event Listener model; programs should continue to override paint/update methods in order render themselves properly.An unspecified behavior will be caused if the
id
parameter of any particularPaintEvent
instance is not in the range fromPAINT_FIRST
toPAINT_LAST
.- Since:
- 1.1
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field and Description static int
PAINT
The paint event type.static int
PAINT_FIRST
Marks the first integer id for the range of paint event ids.static int
PAINT_LAST
Marks the last integer id for the range of paint event ids.static int
UPDATE
The update event type.-
Fields inherited from class java.awt.event.ComponentEvent
COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN
-
Fields inherited from class java.awt.AWTEvent
ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK
-
Fields inherited from class java.util.EventObject
source
-
-
Constructor Summary
Constructors Constructor and Description PaintEvent(Component source, int id, Rectangle updateRect)
Constructs aPaintEvent
object with the specified source component and type.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description Rectangle
getUpdateRect()
Returns the rectangle representing the area which needs to be repainted in response to this event.String
paramString()
Returns a parameter string identifying this event.void
setUpdateRect(Rectangle updateRect)
Sets the rectangle representing the area which needs to be repainted in response to this event.-
Methods inherited from class java.awt.event.ComponentEvent
getComponent
-
Methods inherited from class java.util.EventObject
getSource
-
-
-
-
Field Detail
PAINT_FIRST
public static final int PAINT_FIRST
Marks the first integer id for the range of paint event ids.- See Also:
- Constant Field Values
PAINT_LAST
public static final int PAINT_LAST
Marks the last integer id for the range of paint event ids.- See Also:
- Constant Field Values
PAINT
public static final int PAINT
The paint event type.- See Also:
- Constant Field Values
UPDATE
public static final int UPDATE
The update event type.- See Also:
- Constant Field Values
-
Constructor Detail
PaintEvent
public PaintEvent(Component source, int id, Rectangle updateRect)
Constructs aPaintEvent
object with the specified source component and type.This method throws an
IllegalArgumentException
ifsource
isnull
.- Parameters:
-
source
- The object where the event originated -
id
- The integer that identifies the event type. For information on allowable values, see the class description forPaintEvent
-
updateRect
- The rectangle area which needs to be repainted - Throws:
-
IllegalArgumentException
- ifsource
is null - See Also:
-
EventObject.getSource()
,AWTEvent.getID()
,getUpdateRect()
-
Method Detail
getUpdateRect
public Rectangle getUpdateRect()
Returns the rectangle representing the area which needs to be repainted in response to this event.
setUpdateRect
public void setUpdateRect(Rectangle updateRect)
Sets the rectangle representing the area which needs to be repainted in response to this event.- Parameters:
-
updateRect
- the rectangle area which needs to be repainted
paramString
public String paramString()
Description copied from class:ComponentEvent
Returns a parameter string identifying this event. This method is useful for event-logging and for debugging.- Overrides:
-
paramString
in classComponentEvent
- Returns:
- a string identifying the event and its attributes
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.