Constructor and Description |
---|
GCompound()
Creates a new
GCompound object with no internal components. |
GCompound(GCanvas canvas)
Creates a new
GCompound object with no internal components. |
Modifier and Type | Method and Description |
---|---|
GCompound |
add(GObject gobj)
Adds a new graphical object to this
GCompound . |
GCompound |
add(GObject gobj,
float x,
float y)
Adds the graphical object to this canvas and sets its location
to the point (
x , y ). |
GCompound |
add(GObject gobj,
GPoint pt)
Adds the graphical object to this canvas and sets its location to the specified point.
|
boolean |
contains(float x,
float y)
Checks to see whether a point is "inside" the compound, which means that it is
inside one of the components.
|
GRectangle |
getBounds()
Returns the bounding rectangle for this compound object, which consists of
the union of the bounding rectangles for each of the components.
|
GObject |
getElement(int index)
Returns the graphical object at the specified index, numbering from back
to front in the the z dimension.
|
GObject |
getElementAt(float x,
float y)
Returns the topmost graphical object that contains the point
(
x , y ), or null if no such
object exists. |
GObject |
getElementAt(GPoint pt)
Returns the topmost graphical object that contains the specified point,
or
null if no such object exists. |
int |
getElementCount()
Returns the number of graphical objects stored in this container.
|
Iterator<GObject> |
iterator()
Returns an
Iterator that cycles through the elements within
this container in the default direction, which is from back to front. |
GCompound |
markAsComplete()
Calling this method makes it illegal to add or remove elements from the
compound object.
|
void |
paint(Canvas canvas)
Implements the
paint operation for this graphical object. |
GCompound |
remove(GObject gobj)
Removes a graphical object from this
GCompound . |
GCompound |
removeAll()
Removes all graphical objects from this
GCompound . |
GObject |
scale(float sx,
float sy)
Scales every object contained in this compound by the scale factors
sx and sy . |
protected GCompound |
sendBackward(GObject gobj)
Implements the
sendBackward function from the GContainer
interface. |
protected GCompound |
sendForward(GObject gobj)
Implements the
sendForward function from the GContainer
interface. |
protected GCompound |
sendToBack(GObject gobj)
Implements the
sendToBack function from the GContainer
interface. |
protected GCompound |
sendToFront(GObject gobj)
Implements the
sendToFront function from the GContainer
interface. |
addTo, addTo, addTo, contains, getBottomY, getCenterX, getCenterY, getColor, getFillColor, getGCanvas, getHeight, getLeftX, getLocation, getPaint, getRightX, getSize, getTopY, getWidth, getX, getY, intersects, isFilled, isVisible, moveBy, moveByPolar, moveTo, moveTo, moveTo, moveToPolar, remove, repaint, scale, sendBackward, sendForward, sendToBack, sendToFront, setBottomY, setBounds, setBounds, setBounds, setCanvas, setColor, setFillColor, setFilled, setGCanvas, setLocation, setLocation, setLocation, setPaint, setRightX, setSize, setSize, setVisible, setX, setY, toString, translate
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
forEach, spliterator
public GCompound()
GCompound
object with no internal components.public GCompound(GCanvas canvas)
GCompound
object with no internal components.public GCompound add(GObject gobj)
GCompound
.gobj
- The graphical object to addNullPointerException
- if gobj is nullpublic final GCompound add(GObject gobj, float x, float y)
x
, y
).gobj
- The graphical object to addx
- The new x-coordinate for the objecty
- The new y-coordinate for the objectNullPointerException
- if gobj is nullpublic final GCompound add(GObject gobj, GPoint pt)
gobj
- The graphical object to addpt
- A GPoint
object giving the coordinates of the pointNullPointerException
- if gobj is nullpublic boolean contains(float x, float y)
public GRectangle getBounds()
public int getElementCount()
public GObject getElement(int index)
index
- The index of the component to returnpublic GObject getElementAt(float x, float y)
x
, y
), or null
if no such
object exists. Note that these coordinates are relative to the
location of the compound object and not to the canvas in which
it is displayed.x
- The x-coordinate of the point being testedy
- The y-coordinate of the point being testednull
if no such object existspublic final GObject getElementAt(GPoint pt)
null
if no such object exists.pt
- The coordinates being testednull
if no such object existspublic Iterator<GObject> iterator()
Iterator
that cycles through the elements within
this container in the default direction, which is from back to front.
You can also run the iterator in the opposite direction by using the
iterator
(
direction)
form of this method.public void paint(Canvas canvas)
paint
operation for this graphical object. This method
is not called directly by clients.paint
in class GObject
NullPointerException
- if canvas is nullpublic GCompound remove(GObject gobj)
GCompound
.gobj
- The graphical object to removeNullPointerException
- if gobj is nullpublic GCompound removeAll()
GCompound
.public GObject scale(float sx, float sy)
sx
and sy
. Automatic repaint is turned off
during the scaling operation so that at most one repaint is performed.scale
in interface GScalable
scale
in class GObject
sx
- The factor used to scale all coordinates in the x directionsy
- The factor used to scale all coordinates in the y directionIllegalArgumentException
- if sx or sy is not a positive numberpublic GCompound markAsComplete()
protected GCompound sendToFront(GObject gobj)
sendToFront
function from the GContainer
interface. Clients should not be calling this method, but the semantics of
interfaces forces it to be exported.NullPointerException
- if gobj is nullprotected GCompound sendToBack(GObject gobj)
sendToBack
function from the GContainer
interface. Clients should not be calling this method, but the semantics of
interfaces forces it to be exported.NullPointerException
- if gobj is nullprotected GCompound sendForward(GObject gobj)
sendForward
function from the GContainer
interface. Clients should not be calling this method, but the semantics of
interfaces forces it to be exported.NullPointerException
- if gobj is nullprotected GCompound sendBackward(GObject gobj)
sendBackward
function from the GContainer
interface. Clients should not be calling this method, but the semantics of
interfaces forces it to be exported.NullPointerException
- if gobj is null