|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.awt.Component java.awt.Container
A generic Abstract Window Toolkit(AWT) container object is a component that can contain other AWT components.
Components added to a container are tracked in a list. The order of the list will define the components' front-to-back stacking order within the container. If no index is specified when adding a component to a container, it will be added to the end of the list (and hence to the bottom of the stacking order).
add(java.awt.Component, int)
,
getComponent(int)
,
LayoutManager
,
Serialized FormNested Class Summary | |
protected class |
Container.AccessibleAWTContainer
Inner class of Container used to provide default support for accessibility. |
(package private) static class |
Container.DropTargetEventTargetFilter
|
(package private) static interface |
Container.EventTargetFilter
|
(package private) static class |
Container.MouseEventTargetFilter
|
Nested classes inherited from class java.awt.Component |
Component.AccessibleAWTComponent, Component.AWTTreeLock, Component.BltBufferStrategy, Component.FlipBufferStrategy |
Field Summary | |
(package private) Component[] |
component
The components in this container. |
(package private) ContainerListener |
containerListener
|
private int |
containerSerializedDataVersion
Container Serial Data Version. |
private static sun.awt.DebugHelper |
dbg
|
(package private) int |
descendantsCount
|
private LightweightDispatcher |
dispatcher
Event router for lightweight components. |
private boolean |
focusCycleRoot
Indicates whether this Component is the root of a focus traversal cycle. |
private FocusTraversalPolicy |
focusTraversalPolicy
The focus traversal policy that will manage keyboard traversal of this Container's children, if this Container is a focus cycle root. |
(package private) static boolean |
INCLUDE_SELF
A constant which toggles one of the controllable behaviors of getMouseEventTarget . |
(package private) LayoutManager |
layoutMgr
Layout manager for this container. |
(package private) int |
listeningBoundsChildren
|
(package private) int |
listeningChildren
|
private Dimension |
maxSize
|
(package private) int |
ncomponents
The number of components in this container. |
private boolean |
printing
|
private Set |
printingThreads
|
(package private) static boolean |
SEARCH_HEAVYWEIGHTS
A constant which toggles one of the controllable behaviors of getMouseEventTarget . |
private static long |
serialVersionUID
JDK 1.1 serialVersionUID |
Fields inherited from interface java.awt.image.ImageObserver |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
Constructor Summary | |
Container()
Constructs a new Container. |
Method Summary | |
Component |
add(Component comp)
Appends the specified component to the end of this container. |
Component |
add(Component comp,
int index)
Adds the specified component to this container at the given position. |
void |
add(Component comp,
Object constraints)
Adds the specified component to the end of this container. |
void |
add(Component comp,
Object constraints,
int index)
Adds the specified component to this container with the specified constraints at the specified index. |
Component |
add(String name,
Component comp)
Adds the specified component to this container. |
void |
addContainerListener(ContainerListener l)
Adds the specified container listener to receive container events from this container. |
protected void |
addImpl(Component comp,
Object constraints,
int index)
Adds the specified component to this container at the specified index. |
void |
addNotify()
Makes this Container displayable by connecting it to a native screen resource. |
void |
addPropertyChangeListener(java.beans.PropertyChangeListener listener)
Adds a PropertyChangeListener to the listener list. |
void |
addPropertyChangeListener(String propertyName,
java.beans.PropertyChangeListener listener)
Adds a PropertyChangeListener to the listener list for a specific property. |
(package private) void |
adjustDecendantsOnParent(int num)
|
(package private) void |
adjustDescendants(int num)
|
(package private) void |
adjustListeningChildren(long mask,
int num)
|
void |
applyComponentOrientation(ComponentOrientation o)
Sets the ComponentOrientation property of this container
and all components contained within it. |
boolean |
areFocusTraversalKeysSet(int id)
Returns whether the Set of focus traversal keys for the given focus traversal operation has been explicitly defined for this Container. |
(package private) void |
checkGD(String stringID)
Checks that all Components that this Container contains are on the same GraphicsDevice as this Container. |
(package private) void |
clearCurrentFocusCycleRootOnHide()
|
(package private) void |
clearMostRecentFocusOwnerOnHide()
|
(package private) boolean |
containsFocus()
|
int |
countComponents()
Deprecated. As of JDK version 1.1, replaced by getComponentCount(). |
(package private) int |
countHierarchyMembers()
|
(package private) void |
createChildHierarchyEvents(int id,
long changeFlags,
boolean enabledOnToolkit)
|
(package private) int |
createHierarchyEvents(int id,
Component changed,
Container changedParent,
long changeFlags,
boolean enabledOnToolkit)
|
void |
deliverEvent(Event e)
Deprecated. As of JDK version 1.1, replaced by dispatchEvent(AWTEvent e) |
(package private) void |
dispatchEventImpl(AWTEvent e)
|
(package private) void |
dispatchEventToSelf(AWTEvent e)
|
void |
doLayout()
Causes this container to lay out its components. |
(package private) boolean |
eventEnabled(AWTEvent e)
|
Component |
findComponentAt(int x,
int y)
Locates the visible child component that contains the specified position. |
(package private) Component |
findComponentAt(int x,
int y,
boolean ignoreEnabled)
Private version of findComponentAt which has a controllable behavior. |
Component |
findComponentAt(Point p)
Locates the visible child component that contains the specified point. |
private Container |
findTraversalRoot()
|
(package private) javax.accessibility.Accessible |
getAccessibleAt(Point p)
Returns the Accessible child contained at the local
coordinate Point , if one exists. |
(package private) javax.accessibility.Accessible |
getAccessibleChild(int i)
Returns the nth Accessible child of the object. |
(package private) int |
getAccessibleChildrenCount()
Returns the number of accessible children in the object. |
float |
getAlignmentX()
Returns the alignment along the x axis. |
float |
getAlignmentY()
Returns the alignment along the y axis. |
Component |
getComponent(int n)
Gets the nth component in this container. |
Component |
getComponentAt(int x,
int y)
Locates the component that contains the x,y position. |
Component |
getComponentAt(Point p)
Gets the component that contains the specified point. |
int |
getComponentCount()
Gets the number of components in this panel. |
(package private) Component[] |
getComponents_NoClientCode()
|
Component[] |
getComponents()
Gets all the components in this container. |
ContainerListener[] |
getContainerListeners()
Returns an array of all the container listeners registered on this container. |
(package private) Component |
getDropTargetEventTarget(int x,
int y,
boolean includeSelf)
Fetches the top-most (deepest) component to receive SunDropTargetEvents. |
Set |
getFocusTraversalKeys(int id)
Returns the Set of focus traversal keys for a given traversal operation for this Container. |
FocusTraversalPolicy |
getFocusTraversalPolicy()
Returns the focus traversal policy that will manage keyboard traversal of this Container's children, or null if this Container is not a focus cycle root. |
Insets |
getInsets()
Determines the insets of this container, which indicate the size of the container's border. |
LayoutManager |
getLayout()
Gets the layout manager for this container. |
EventListener[] |
getListeners(Class listenerType)
Returns an array of all the objects currently registered as FooListener s
upon this Container .
|
Dimension |
getMaximumSize()
Returns the maximum size of this container. |
Dimension |
getMinimumSize()
Returns the minimum size of this container. |
(package private) Component |
getMouseEventTarget(int x,
int y,
boolean includeSelf)
Fetchs the top-most (deepest) lightweight component that is interested in receiving mouse events. |
private Component |
getMouseEventTarget(int x,
int y,
boolean includeSelf,
Container.EventTargetFilter filter,
boolean searchHeavyweights)
A private version of getMouseEventTarget which has two additional controllable behaviors. |
private Component |
getMouseEventTargetImpl(int x,
int y,
boolean includeSelf,
Container.EventTargetFilter filter,
boolean searchHeavyweightChildren,
boolean searchHeavyweightDescendants)
A private version of getMouseEventTarget which has three additional controllable behaviors. |
Dimension |
getPreferredSize()
Returns the preferred size of this container. |
(package private) void |
initializeFocusTraversalKeys()
|
private static void |
initIDs()
Initialize JNI field and method IDs for fields that may be called from C. |
Insets |
insets()
Deprecated. As of JDK version 1.1, replaced by getInsets() . |
void |
invalidate()
Invalidates the container. |
(package private) void |
invalidateTree()
Recursively descends the container tree and invalidates all contained components. |
boolean |
isAncestorOf(Component c)
Checks if the component is contained in the component hierarchy of this container. |
boolean |
isFocusCycleRoot()
Returns whether this Container is the root of a focus traversal cycle. |
boolean |
isFocusCycleRoot(Container container)
Returns whether the specified Container is the focus cycle root of this Container's focus traversal cycle. |
boolean |
isFocusTraversalPolicySet()
Returns whether the focus traversal policy has been explicitly set for this Container. |
(package private) boolean |
isParentOf(Component comp)
Check if this component is the child of this container or its children. |
void |
layout()
Deprecated. As of JDK version 1.1, replaced by doLayout() . |
(package private) void |
lightweightPaint(Graphics g)
Simulates the peer callbacks into java.awt for printing of lightweight Containers. |
(package private) void |
lightweightPrint(Graphics g)
Simulates the peer callbacks into java.awt for printing of lightweight Containers. |
void |
list(PrintStream out,
int indent)
Prints a listing of this container to the specified output stream. |
void |
list(PrintWriter out,
int indent)
Prints out a list, starting at the specified indention, to the specified print writer. |
Component |
locate(int x,
int y)
Deprecated. As of JDK version 1.1, replaced by getComponentAt(int, int) . |
Dimension |
minimumSize()
Deprecated. As of JDK version 1.1, replaced by getMinimumSize() . |
(package private) boolean |
nextFocusHelper()
|
(package private) int |
numListening(long mask)
|
void |
paint(Graphics g)
Paints the container. |
void |
paintComponents(Graphics g)
Paints each of the components in this container. |
(package private) void |
paintHeavyweightComponents(Graphics g)
Prints all the heavyweight subcomponents. |
protected String |
paramString()
Returns a string representing the state of this Container .
|
(package private) void |
postProcessKeyEvent(KeyEvent e)
|
(package private) boolean |
postsOldMouseEvents()
|
Dimension |
preferredSize()
Deprecated. As of JDK version 1.1, replaced by getPreferredSize() . |
(package private) void |
preProcessKeyEvent(KeyEvent e)
|
void |
print(Graphics g)
Prints the container. |
void |
printComponents(Graphics g)
Prints each of the components in this container. |
(package private) void |
printHeavyweightComponents(Graphics g)
Prints all the heavyweight subcomponents. |
protected void |
processContainerEvent(ContainerEvent e)
Processes container events occurring on this container by dispatching them to any registered ContainerListener objects. |
protected void |
processEvent(AWTEvent e)
Processes events on this container. |
(package private) void |
proxyEnableEvents(long events)
This is called by lightweight components that want the containing windowed parent to enable some kind of events on their behalf. |
private void |
readObject(ObjectInputStream s)
Deserializes this Container from the specified
ObjectInputStream .
|
void |
remove(Component comp)
Removes the specified component from this container. |
void |
remove(int index)
Removes the component, specified by index ,
from this container. |
void |
removeAll()
Removes all the components from this container. |
void |
removeContainerListener(ContainerListener l)
Removes the specified container listener so it no longer receives container events from this container. |
void |
removeNotify()
Makes this Container undisplayable by removing its connection to its native screen resource. |
void |
setFocusCycleRoot(boolean focusCycleRoot)
Sets whether this Container is the root of a focus traversal cycle. |
void |
setFocusTraversalKeys(int id,
Set keystrokes)
Sets the focus traversal keys for a given traversal operation for this Container. |
void |
setFocusTraversalPolicy(FocusTraversalPolicy policy)
Sets the focus traversal policy that will manage keyboard traversal of this Container's children, if this Container is a focus cycle root. |
void |
setFont(Font f)
Sets the font of this container. |
void |
setLayout(LayoutManager mgr)
Sets the layout manager for this container. |
(package private) void |
setZOrder(Component comp,
int index)
|
void |
transferFocusBackward()
Transfers the focus to the previous component, as though this Component were the focus owner. |
void |
transferFocusDownCycle()
Transfers the focus down one focus traversal cycle. |
void |
update(Graphics g)
Updates the container. |
void |
validate()
Validates this container and all of its subcomponents. |
protected void |
validateTree()
Recursively descends the container tree and recomputes the layout for any subtrees marked as needing it (those marked as invalid). |
private void |
writeObject(ObjectOutputStream s)
Serializes this Container to the specified
ObjectOutputStream .
|
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
int ncomponents
getComponent(int)
,
getComponents()
,
getComponentCount()
Component[] component
add(java.awt.Component)
,
getComponents()
LayoutManager layoutMgr
doLayout()
,
setLayout(java.awt.LayoutManager)
,
getLayout()
private LightweightDispatcher dispatcher
private Dimension maxSize
private transient FocusTraversalPolicy focusTraversalPolicy
If this Container is not a focus cycle root, the value will be remembered, but will not be used or inherited by this or any other Containers until this Container is made a focus cycle root.
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
,
getFocusTraversalPolicy()
private boolean focusCycleRoot
setFocusCycleRoot(boolean)
,
isFocusCycleRoot(java.awt.Container)
private transient Set printingThreads
private transient boolean printing
transient ContainerListener containerListener
transient int listeningChildren
transient int listeningBoundsChildren
transient int descendantsCount
private static final long serialVersionUID
private static final sun.awt.DebugHelper dbg
static final boolean INCLUDE_SELF
getMouseEventTarget
. It is used to specify whether
the method can return the Container on which it is originally called
in case if none of its children are the current mouse event targets.
#getMouseEventTarget(int, int, boolean, boolean, boolean)
,
Constant Field Valuesstatic final boolean SEARCH_HEAVYWEIGHTS
getMouseEventTarget
. It is used to specify whether
the method should search only lightweight components.
#getMouseEventTarget(int, int, boolean, boolean, boolean)
,
Constant Field Valuesprivate int containerSerializedDataVersion
Constructor Detail |
public Container()
Method Detail |
private static void initIDs()
void initializeFocusTraversalKeys()
initializeFocusTraversalKeys
in class Component
public int getComponentCount()
getComponent(int)
public int countComponents()
public Component getComponent(int n)
n
- the index of the component to get.
ArrayIndexOutOfBoundsException
- if the nth value does not exist.public Component[] getComponents()
final Component[] getComponents_NoClientCode()
public Insets getInsets()
A Frame
object, for example, has a top inset that
corresponds to the height of the frame's title bar.
Insets
,
LayoutManager
public Insets insets()
getInsets()
.
public Component add(Component comp)
addImpl(java.awt.Component, java.lang.Object, int)
.
Note: If a component has been added to a container that
has been displayed, validate
must be
called on that container to display the new component.
If multiple components are being added, you can improve
efficiency by calling validate
only once,
after all the components have been added.
comp
- the component to be added
addImpl(java.awt.Component, java.lang.Object, int)
,
validate()
,
JComponent.revalidate()
public Component add(String name, Component comp)
addImpl(java.awt.Component, java.lang.Object, int)
.
This method is obsolete as of 1.1. Please use the
method add(Component, Object)
instead.
add(Component, Object)
public Component add(Component comp, int index)
addImpl(java.awt.Component, java.lang.Object, int)
.
Note: If a component has been added to a container that
has been displayed, validate
must be
called on that container to display the new component.
If multiple components are being added, you can improve
efficiency by calling validate
only once,
after all the components have been added.
comp
- the component to be addedindex
- the position at which to insert the component,
or -1
to append the component to the end
comp
addImpl(java.awt.Component, java.lang.Object, int)
,
remove(int)
,
validate()
,
JComponent.revalidate()
void setZOrder(Component comp, int index)
public void add(Component comp, Object constraints)
addImpl(java.awt.Component, java.lang.Object, int)
.
Note: If a component has been added to a container that
has been displayed, validate
must be
called on that container to display the new component.
If multiple components are being added, you can improve
efficiency by calling validate
only once,
after all the components have been added.
comp
- the component to be addedconstraints
- an object expressing
layout contraints for this componentaddImpl(java.awt.Component, java.lang.Object, int)
,
validate()
,
JComponent.revalidate()
,
LayoutManager
public void add(Component comp, Object constraints, int index)
addImpl(java.awt.Component, java.lang.Object, int)
.
Note: If a component has been added to a container that
has been displayed, validate
must be
called on that container to display the new component.
If multiple components are being added, you can improve
efficiency by calling validate
only once,
after all the components have been added.
comp
- the component to be addedconstraints
- an object expressing layout contraints for thisindex
- the position in the container's list at which to insert
the component; -1
means insert at the end
componentaddImpl(java.awt.Component, java.lang.Object, int)
,
validate()
,
JComponent.revalidate()
,
remove(int)
,
LayoutManager
protected void addImpl(Component comp, Object constraints, int index)
addLayoutComponent
method. The constraints are
defined by the particular layout manager being used. For
example, the BorderLayout
class defines five
constraints: BorderLayout.NORTH
,
BorderLayout.SOUTH
, BorderLayout.EAST
,
BorderLayout.WEST
, and BorderLayout.CENTER
.
Note that if the component already exists in this container or a child of this container, it is removed from that container before being added to this container.
This is the method to override if a program needs to track every add request to a container as all other add methods defer to this one. An overriding method should usually include a call to the superclass's version of the method:
super.addImpl(comp, constraints, index)
comp
- the component to be addedconstraints
- an object expressing layout constraints
for this componentindex
- the position in the container's list at which to
insert the component, where -1
means append to the end
IllegalArgumentException
- if index
is invalid
IllegalArgumentException
- if adding the container's parent
to itself
IllegalArgumentException
- if adding a window to a containeradd(Component)
,
add(Component, int)
,
add(Component, java.lang.Object)
,
LayoutManager
,
LayoutManager2
void checkGD(String stringID)
checkGD
in class Component
public void remove(int index)
index
,
from this container.
index
- the index of the component to be removed.add(java.awt.Component)
public void remove(Component comp)
comp
- the component to be removedadd(java.awt.Component)
public void removeAll()
add(java.awt.Component)
,
remove(int)
int numListening(long mask)
numListening
in class Component
void adjustListeningChildren(long mask, int num)
void adjustDescendants(int num)
void adjustDecendantsOnParent(int num)
int countHierarchyMembers()
countHierarchyMembers
in class Component
int createHierarchyEvents(int id, Component changed, Container changedParent, long changeFlags, boolean enabledOnToolkit)
createHierarchyEvents
in class Component
void createChildHierarchyEvents(int id, long changeFlags, boolean enabledOnToolkit)
createChildHierarchyEvents
in class Component
public LayoutManager getLayout()
doLayout()
,
setLayout(java.awt.LayoutManager)
public void setLayout(LayoutManager mgr)
mgr
- the specified layout managerdoLayout()
,
getLayout()
public void doLayout()
validate
method instead.
doLayout
in class Component
LayoutManager.layoutContainer(java.awt.Container)
,
setLayout(java.awt.LayoutManager)
,
validate()
public void layout()
doLayout()
.
layout
in class Component
public void invalidate()
invalidate
in class Component
validate()
,
layout()
,
LayoutManager
public void validate()
The validate
method is used to cause a container
to lay out its subcomponents again. It should be invoked when
this container's subcomponents are modified (added to or
removed from the container, or layout-related information
changed) after the container has been displayed.
validate
in class Component
add(java.awt.Component)
,
Component.invalidate()
,
JComponent.revalidate()
protected void validateTree()
validate
.
void invalidateTree()
public void setFont(Font f)
setFont
in class Component
f
- The font to become this container's font.Component.getFont()
public Dimension getPreferredSize()
getPreferredSize
in class Component
Dimension
that represents
the preferred size of this container.getMinimumSize()
,
getLayout()
,
LayoutManager.preferredLayoutSize(Container)
,
Component.getPreferredSize()
public Dimension preferredSize()
getPreferredSize()
.
preferredSize
in class Component
public Dimension getMinimumSize()
getMinimumSize
in class Component
Dimension
that represents
the minimum size of this container.getPreferredSize()
,
getLayout()
,
LayoutManager.minimumLayoutSize(Container)
,
Component.getMinimumSize()
public Dimension minimumSize()
getMinimumSize()
.
minimumSize
in class Component
public Dimension getMaximumSize()
getMaximumSize
in class Component
getPreferredSize()
public float getAlignmentX()
getAlignmentX
in class Component
public float getAlignmentY()
getAlignmentY
in class Component
public void paint(Graphics g)
paint
in class Component
g
- the specified Graphics windowComponent.update(Graphics)
public void update(Graphics g)
update
in class Component
g
- the specified Graphics windowComponent.update(Graphics)
public void print(Graphics g)
print
in class Component
g
- the specified Graphics windowComponent.update(Graphics)
public void paintComponents(Graphics g)
g
- the graphics context.Component.paint(java.awt.Graphics)
,
Component.paintAll(java.awt.Graphics)
void lightweightPaint(Graphics g)
lightweightPaint
in class Component
g
- the graphics context to use for printing.Component.printAll(java.awt.Graphics)
,
printComponents(java.awt.Graphics)
void paintHeavyweightComponents(Graphics g)
paintHeavyweightComponents
in class Component
public void printComponents(Graphics g)
g
- the graphics context.Component.print(java.awt.Graphics)
,
Component.printAll(java.awt.Graphics)
void lightweightPrint(Graphics g)
lightweightPrint
in class Component
g
- the graphics context to use for printing.Component.printAll(java.awt.Graphics)
,
printComponents(java.awt.Graphics)
void printHeavyweightComponents(Graphics g)
printHeavyweightComponents
in class Component
public void addContainerListener(ContainerListener l)
l
- the container listenerremoveContainerListener(java.awt.event.ContainerListener)
,
getContainerListeners()
public void removeContainerListener(ContainerListener l)
l
- the container listeneraddContainerListener(java.awt.event.ContainerListener)
,
getContainerListeners()
public ContainerListener[] getContainerListeners()
ContainerListener
s
or an empty array if no container
listeners are currently registeredaddContainerListener(java.awt.event.ContainerListener)
,
removeContainerListener(java.awt.event.ContainerListener)
public EventListener[] getListeners(Class listenerType)
FooListener
s
upon this Container
.
FooListener
s are registered using the
addFooListener
method.
You can specify the listenerType
argument
with a class literal, such as
FooListener.class
.
For example, you can query a
Container
c
for its container listeners with the following code:
ContainerListener[] cls = (ContainerListener[])(c.getListeners(ContainerListener.class));If no such listeners exist, this method returns an empty array.
getListeners
in class Component
listenerType
- the type of listeners requested; this parameter
should specify an interface that descends from
java.util.EventListener
FooListener
s on this container,
or an empty array if no such listeners have been added
ClassCastException
- if listenerType
doesn't specify a class or interface that implements
java.util.EventListener
getContainerListeners()
boolean eventEnabled(AWTEvent e)
eventEnabled
in class Component
protected void processEvent(AWTEvent e)
ContainerEvent
, it invokes the
processContainerEvent
method, else it invokes
its superclass's processEvent
.
Note that if the event parameter is null
the behavior is unspecified and may result in an
exception.
processEvent
in class Component
e
- the eventComponent.processComponentEvent(java.awt.event.ComponentEvent)
,
Component.processFocusEvent(java.awt.event.FocusEvent)
,
Component.processKeyEvent(java.awt.event.KeyEvent)
,
Component.processMouseEvent(java.awt.event.MouseEvent)
,
Component.processMouseMotionEvent(java.awt.event.MouseEvent)
,
Component.processInputMethodEvent(java.awt.event.InputMethodEvent)
,
Component.processHierarchyEvent(java.awt.event.HierarchyEvent)
,
Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)
protected void processContainerEvent(ContainerEvent e)
addContainerListener
enableEvents
Note that if the event parameter is null
the behavior is unspecified and may result in an
exception.
e
- the container eventComponent.enableEvents(long)
void dispatchEventImpl(AWTEvent e)
dispatchEventImpl
in class Component
void dispatchEventToSelf(AWTEvent e)
Component getMouseEventTarget(int x, int y, boolean includeSelf)
Component getDropTargetEventTarget(int x, int y, boolean includeSelf)
private Component getMouseEventTarget(int x, int y, boolean includeSelf, Container.EventTargetFilter filter, boolean searchHeavyweights)
false
.
filter
- EventTargetFilter instance to determine whether the
given component is a valid target for this event.searchHeavyweights
- if false, the method
will bypass heavyweight components during the search.
private Component getMouseEventTargetImpl(int x, int y, boolean includeSelf, Container.EventTargetFilter filter, boolean searchHeavyweightChildren, boolean searchHeavyweightDescendants)
false
.
filter
- EventTargetFilter instance to determine whether the
selected component is a valid target for this event.searchHeavyweightChildren
- if true, the method
will bypass immediate lightweight children during the search.
If false
, the methods will bypass immediate
heavyweight children during the search.searchHeavyweightDescendants
- if false, the method
will bypass heavyweight descendants which are not immediate
children during the search. If true
, the method
will traverse both lightweight and heavyweight descendants during
the search.
void proxyEnableEvents(long events)
public void deliverEvent(Event e)
dispatchEvent(AWTEvent e)
deliverEvent
in class Component
public Component getComponentAt(int x, int y)
getComponentAt
in class Component
x
- the x coordinatey
- the y coordinate
Component.contains(int, int)
public Component locate(int x, int y)
getComponentAt(int, int)
.
locate
in class Component
public Component getComponentAt(Point p)
getComponentAt
in class Component
p
- the point.
null
if the component does
not contain the point.Component.contains(int, int)
public Component findComponentAt(int x, int y)
The findComponentAt method is different from getComponentAt in that getComponentAt only searches the Container's immediate children; if the containing component is a Container, findComponentAt will search that child to find a nested component.
x
- the x coordinatey
- the y coordinate
Component.contains(int, int)
,
getComponentAt(int, int)
final Component findComponentAt(int x, int y, boolean ignoreEnabled)
public Component findComponentAt(Point p)
The findComponentAt method is different from getComponentAt in that getComponentAt only searches the Container's immediate children; if the containing component is a Container, findComponentAt will search that child to find a nested component.
p
- the point.
Component.contains(int, int)
,
getComponentAt(int, int)
public void addNotify()
addNotify
in class Component
Component.isDisplayable()
,
removeNotify()
public void removeNotify()
removeNotify
in class Component
Component.isDisplayable()
,
addNotify()
public boolean isAncestorOf(Component c)
c
- the component
true
if it is an ancestor;
false
otherwise.protected String paramString()
Container
.
This method is intended to be used only for debugging purposes, and the
content and format of the returned string may vary between
implementations. The returned string may be empty but may not be
null
.
paramString
in class Component
public void list(PrintStream out, int indent)
list
in class Component
out
- a print stream.indent
- the number of spaces to indent.Component.list(java.io.PrintStream, int)
public void list(PrintWriter out, int indent)
list
in class Component
out
- the print writer to print toindent
- the number of spaces to indentPrintStream.println(java.lang.Object)
public void setFocusTraversalKeys(int id, Set keystrokes)
The default values for a Container's focus traversal keys are implementation-dependent. Sun recommends that all implementations for a particular native platform use the same default values. The recommendations for Windows and Unix are listed below. These recommendations are used in the Sun AWT implementations.
Identifier | Meaning | Default | |
---|---|---|---|
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS | Normal forward keyboard traversal | TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED | |
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS | Normal reverse keyboard traversal | SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED | |
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS | Go up one focus traversal cycle | none | |
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS | Go down one focus traversal cycle | none |
Using the AWTKeyStroke API, client code can specify on which of two specific KeyEvents, KEY_PRESSED or KEY_RELEASED, the focus traversal operation will occur. Regardless of which KeyEvent is specified, however, all KeyEvents related to the focus traversal key, including the associated KEY_TYPED event, will be consumed, and will not be dispatched to any Container. It is a runtime error to specify a KEY_TYPED event as mapping to a focus traversal operation, or to map the same event to multiple default focus traversal operations.
If a value of null is specified for the Set, this Container inherits the Set from its parent. If all ancestors of this Container have null specified for the Set, then the current KeyboardFocusManager's default Set is used.
setFocusTraversalKeys
in class Component
id
- one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSkeystrokes
- the Set of AWTKeyStroke for the specified operation
IllegalArgumentException
- if id is not one of
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS, or if keystrokes
contains null, or if any Object in keystrokes is not an
AWTKeyStroke, or if any keystroke represents a KEY_TYPED event,
or if any keystroke already maps to another focus traversal
operation for this ContainergetFocusTraversalKeys(int)
,
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
,
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
,
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
,
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
public Set getFocusTraversalKeys(int id)
setFocusTraversalKeys
for a full description of each key.)
If a Set of traversal keys has not been explicitly defined for this Container, then this Container's parent's Set is returned. If no Set has been explicitly defined for any of this Container's ancestors, then the current KeyboardFocusManager's default Set is returned.
getFocusTraversalKeys
in class Component
id
- one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
IllegalArgumentException
- if id is not one of
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSsetFocusTraversalKeys(int, java.util.Set)
,
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
,
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
,
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
,
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
public boolean areFocusTraversalKeysSet(int id)
false
, this Container is inheriting the
Set from an ancestor, or from the current KeyboardFocusManager.
areFocusTraversalKeysSet
in class Component
id
- one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
true
if the the Set of focus traversal keys for the
given focus traversal operation has been explicitly defined for
this Component; false
otherwise.
IllegalArgumentException
- if id is not one of
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSpublic boolean isFocusCycleRoot(Container container)
true
for both such
Containers in this case.
isFocusCycleRoot
in class Component
container
- the Container to be tested
true
if the specified Container is a focus-cycle-
root of this Container; false
otherwiseisFocusCycleRoot()
private Container findTraversalRoot()
final boolean containsFocus()
containsFocus
in class Component
boolean isParentOf(Component comp)
comp
- a component in test, must not be nullvoid clearMostRecentFocusOwnerOnHide()
clearMostRecentFocusOwnerOnHide
in class Component
void clearCurrentFocusCycleRootOnHide()
clearCurrentFocusCycleRootOnHide
in class Component
boolean nextFocusHelper()
nextFocusHelper
in class Component
public void transferFocusBackward()
Component
transferFocusBackward
in class Component
Component.requestFocus()
public void setFocusTraversalPolicy(FocusTraversalPolicy policy)
If this Container is not a focus cycle root, the policy will be remembered, but will not be used or inherited by this or any other Containers until this Container is made a focus cycle root.
policy
- the new focus traversal policy for this ContainergetFocusTraversalPolicy()
,
setFocusCycleRoot(boolean)
,
isFocusCycleRoot(java.awt.Container)
public FocusTraversalPolicy getFocusTraversalPolicy()
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
,
setFocusCycleRoot(boolean)
,
isFocusCycleRoot(java.awt.Container)
public boolean isFocusTraversalPolicySet()
false
, this
Container will inherit its focus traversal policy from an ancestor.
true
if the focus traversal policy has been
explicitly set for this Container; false
otherwise.public void setFocusCycleRoot(boolean focusCycleRoot)
focusCycleRoot
- indicates whether this Container is the root of a
focus traversal cycleisFocusCycleRoot()
,
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
,
getFocusTraversalPolicy()
,
ContainerOrderFocusTraversalPolicy
public boolean isFocusCycleRoot()
setFocusCycleRoot(boolean)
,
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
,
getFocusTraversalPolicy()
,
ContainerOrderFocusTraversalPolicy
public void transferFocusDownCycle()
Component.requestFocus()
,
isFocusCycleRoot(java.awt.Container)
,
setFocusCycleRoot(boolean)
void preProcessKeyEvent(KeyEvent e)
void postProcessKeyEvent(KeyEvent e)
boolean postsOldMouseEvents()
postsOldMouseEvents
in class Component
public void applyComponentOrientation(ComponentOrientation o)
ComponentOrientation
property of this container
and all components contained within it.
applyComponentOrientation
in class Component
o
- the new component orientation of this container and
the components contained within it.
NullPointerException
- if orientation
is null.Component.setComponentOrientation(java.awt.ComponentOrientation)
,
Component.getComponentOrientation()
public void addPropertyChangeListener(java.beans.PropertyChangeListener listener)
If listener is null, no exception is thrown and no action is performed.
addPropertyChangeListener
in class Component
listener
- the PropertyChangeListener to be addedComponent.removePropertyChangeListener(java.beans.PropertyChangeListener)
,
addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
public void addPropertyChangeListener(String propertyName, java.beans.PropertyChangeListener listener)
If listener is null, no exception is thrown and no action is performed.
addPropertyChangeListener
in class Component
propertyName
- one of the property names listed abovelistener
- the PropertyChangeListener to be addedaddPropertyChangeListener(java.beans.PropertyChangeListener)
,
Component.removePropertyChangeListener(java.beans.PropertyChangeListener)
private void writeObject(ObjectOutputStream s) throws IOException
Container
to the specified
ObjectOutputStream
.
null
is written.
s
- the ObjectOutputStream
to write
IOException
AWTEventMulticaster.save(java.io.ObjectOutputStream, java.lang.String, java.util.EventListener)
,
Component.containerListenerK
,
readObject(ObjectInputStream)
private void readObject(ObjectInputStream s) throws ClassNotFoundException, IOException
Container
from the specified
ObjectInputStream
.
s
- the ObjectInputStream
to read
ClassNotFoundException
IOException
addContainerListener(java.awt.event.ContainerListener)
,
writeObject(ObjectOutputStream)
javax.accessibility.Accessible getAccessibleAt(Point p)
Accessible
child contained at the local
coordinate Point
, if one exists. Otherwise
returns null
.
p
- the point defining the top-left corner of the
Accessible
, given in the coordinate space
of the object's parent
Accessible
at the specified location,
if it exists; otherwise null
int getAccessibleChildrenCount()
Accessible
,
then this method should return the number of children of this object.
javax.accessibility.Accessible getAccessibleChild(int i)
Accessible
child of the object.
i
- zero-based index of child
Accessible
child of the object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |