Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the component listener
Since: JDK1.1
See Also: ComponentEvent, ComponentListener, Component.removeComponentListener(java.awt.event.ComponentListener), Component.getComponentListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the focus listener
Since: JDK1.1
See Also: FocusEvent, FocusListener, Component.removeFocusListener(java.awt.event.FocusListener), Component.getFocusListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the hierarchy bounds listener
Since: 1.3
See Also: HierarchyEvent, HierarchyBoundsListener, Component.removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), Component.getHierarchyBoundsListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the hierarchy listener
Since: 1.3
See Also: HierarchyEvent, HierarchyListener, Component.removeHierarchyListener(java.awt.event.HierarchyListener), Component.getHierarchyListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the input method listener
Since: 1.2
See Also: InputMethodEvent, InputMethodListener, Component.removeInputMethodListener(java.awt.event.InputMethodListener), Component.getInputMethodListeners(), Component.getInputMethodRequests(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the key listener.
Since: JDK1.1
See Also: KeyEvent, KeyListener, Component.removeKeyListener(java.awt.event.KeyListener), Component.getKeyListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the mouse listener
Since: JDK1.1
See Also: MouseEvent, MouseListener, Component.removeMouseListener(java.awt.event.MouseListener), Component.getMouseListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the mouse motion listener
Since: JDK1.1
See Also: MouseEvent, MouseMotionListener, Component.removeMouseMotionListener(java.awt.event.MouseMotionListener), Component.getMouseMotionListeners(),

For information on how mouse wheel events are dispatched, see the class description for MouseWheelEvent.

If l is null, no exception is thrown and no action is performed.

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the mouse wheel listener
Since: 1.4
See Also: MouseWheelEvent, MouseWheelListener, Component.removeMouseWheelListener(java.awt.event.MouseWheelListener), Component.getMouseWheelListeners(),

• this Component's font ("font")
• this Component's background color ("background")
• this Component's foreground color ("foreground")
• this Component's focusability ("focusable")
• this Component's focus traversal keys enabled state ("focusTraversalKeysEnabled")
• this Component's Set of FORWARD_TRAVERSAL_KEYS ("forwardFocusTraversalKeys")
• this Component's Set of BACKWARD_TRAVERSAL_KEYS ("backwardFocusTraversalKeys")
• this Component's Set of UP_CYCLE_TRAVERSAL_KEYS ("upCycleFocusTraversalKeys")
• this Component's preferred size ("preferredSize")
• this Component's minimum size ("minimumSize")
• this Component's maximum size ("maximumSize")
• this Component's name ("name")

If listener is null, no exception is thrown and no action is performed.
Parameters:
- listener - the property change listener to be added
See Also: Component.removePropertyChangeListener(java.beans.PropertyChangeListener), Component.getPropertyChangeListeners(), Component.addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener),

• this Component's font ("font")
• this Component's background color ("background")
• this Component's foreground color ("foreground")
• this Component's focusability ("focusable")
• this Component's focus traversal keys enabled state ("focusTraversalKeysEnabled")
• this Component's Set of FORWARD_TRAVERSAL_KEYS ("forwardFocusTraversalKeys")
• this Component's Set of BACKWARD_TRAVERSAL_KEYS ("backwardFocusTraversalKeys")
• this Component's Set of UP_CYCLE_TRAVERSAL_KEYS ("upCycleFocusTraversalKeys")

If propertyName or listener is null, no exception is thrown and no action is taken.
Parameters:
- propertyName - one of the property names listed above
- listener - the property change listener to be added
See Also: Component.removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), Component.getPropertyChangeListeners(java.lang.String), Component.addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener),

This method does not cause the image to begin loading. An application must use the prepareImage method to force the loading of an image.

Information on the flags returned by this method can be found with the discussion of the ImageObserver interface.
Returns: the bitwise inclusive OR of ImageObserver flags indicating what information about the image is currently available
Parameters:
- image - the Image object whose status is being checked
- observer - the ImageObserver object to be notified as the image is being prepared
Since: JDK1.0
See Also: Component.prepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserver,

This method does not cause the image to begin loading. An application must use the prepareImage method to force the loading of an image.

The checkImage method of Component calls its peer's checkImage method to calculate the flags. If this component does not yet have a peer, the component's toolkit's checkImage method is called instead.

Information on the flags returned by this method can be found with the discussion of the ImageObserver interface.
Returns: the bitwise inclusive OR of ImageObserver flags indicating what information about the image is currently available
Parameters:
- image - the Image object whose status is being checked
- width - the width of the scaled version whose status is to be checked
- height - the height of the scaled version whose status is to be checked
- observer - the ImageObserver object to be notified as the image is being prepared
Since: JDK1.0
See Also: Component.prepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserver,

This implementation of coalesceEvents coalesces two event types: mouse move (and drag) events, and paint (and update) events. For mouse move events the last event is always returned, causing intermediate moves to be discarded. For paint events, the new event is coalesced into a complex RepaintArea in the peer. The new AWTEvent is always returned.
Returns: a coalesced event, or null indicating that no coalescing was done
Parameters:
- existingEvent - the event already on the EventQueue
- newEvent - the event being posted to the EventQueue

Each time this method is called, the existing buffer strategy for this component is discarded.
Parameters:
- numBuffers - number of buffers to create, including the front buffer
Throws:
- IllegalArgumentException - if numBuffers is less than 1.
- IllegalStateException - if the component is not displayable
Since: 1.4
See Also: Component.isDisplayable(), Component.getBufferStrategy(),

Each time this method is called, dispose will be invoked on the existing BufferStrategy.
Parameters:
- numBuffers - number of buffers to create
- caps - the required capabilities for creating the buffer strategy; cannot be null
Throws:
- AWTException - if the capabilities supplied could not be supported or met; this may happen, for example, if there is not enough accelerated memory currently available, or if page flipping is specified but not possible.
- IllegalArgumentException - if numBuffers is less than 1, or if caps is null
Since: 1.4
See Also: Component.getBufferStrategy(),

Event types are automatically enabled when a listener for that event type is added to the component.

This method only needs to be invoked by subclasses of Component which desire to have the specified event types delivered to processEvent regardless of whether or not a listener is registered.
Parameters:
- eventsToEnable - the event mask defining the event types
Since: JDK1.1
See Also: Component.processEvent(java.awt.AWTEvent), Component.disableEvents(long), AWTEvent,

The default implementation returns -1. Subclasses that support baseline should override appropriately. If a value >= 0 is returned, then the component has a valid baseline for any size >= the minimum size and getBaselineResizeBehavior can be used to determine how the baseline changes with size.
Returns: the baseline or < 0 indicating there is no reasonable baseline
Parameters:
- width - the width to get the baseline for
- height - the height to get the baseline for
Throws:
- IllegalArgumentException - if width or height is < 0
Since: 1.6
See Also: Component.getBaselineResizeBehavior(), FontMetrics,

The default implementation returns BaselineResizeBehavior.OTHER. Subclasses that have a baseline should override appropriately. Subclasses should never return null; if the baseline can not be calculated return BaselineResizeBehavior.OTHER. Callers should first ask for the baseline using getBaseline and if a value >= 0 is returned use this method. It is acceptable for this method to return a value other than BaselineResizeBehavior.OTHER even if getBaseline returns a value less than 0.
Returns: an enum indicating how the baseline changes as the component size changes
Since: 1.6
See Also: Component.getBaseline(int, int),

The locate method of Component simply returns the component itself if the (x, y) coordinate location is inside its bounding box, and null otherwise.
Returns: the component or subcomponent that contains the (x, y) location; null if the location is outside this component
Parameters:
- x - the x coordinate
- y - the y coordinate
Since: JDK1.0
See Also: Component.contains(int, int),

If a Set of traversal keys has not been explicitly defined for this Component, then this Component's parent's Set is returned. If no Set has been explicitly defined for any of this Component's ancestors, then the current KeyboardFocusManager's default Set is returned.
Returns: the Set of AWTKeyStrokes for the specified operation. The Set will be unmodifiable, and may be empty. null will never be returned.
Parameters:
- id - one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, or KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
Throws:
- IllegalArgumentException - if id is not one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, or KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
Since: 1.4
See Also: Component.setFocusTraversalKeys(int, java.util.Set), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS,

You can specify the listenerType argument with a class literal, such as FooListener.class. For example, you can query a Component c for its mouse listeners with the following code:

MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));

Due to the asynchronous nature of native event handling, this method can return outdated values (for instance, after several calls of setLocation() in rapid succession). For this reason, the recommended method of obtaining a component's position is within java.awt.event.ComponentListener.componentMoved(), which is called after the operating system has finished moving the component.

For Containers it returns a non-null value if the mouse is above the Container itself or above any of its descendants. Use Container.getMousePosition(boolean) if you need to exclude children.

Sometimes the exact mouse coordinates are not important, and the only thing that matters is whether a specific Component is under the mouse pointer. If the return value of this method is null, mouse pointer is not directly above the Component.
Returns: mouse coordinates relative to this Component, or null
Throws:
- HeadlessException - if GraphicsEnvironment.isHeadless() returns true
Since: 1.5
See Also: Component.isShowing(), Container.getMousePosition(boolean),

The imageUpdate method of Component incrementally draws an image on the component as more of the bits of the image are available.

If the system property awt.image.incrementaldraw is missing or has the value true, the image is incrementally drawn. If the system property has any other value, then the image is not drawn until it has been completely loaded.

Also, if incremental drawing is in effect, the value of the system property awt.image.redrawrate is interpreted as an integer to give the maximum redraw rate, in milliseconds. If the system property is missing or cannot be interpreted as an integer, the redraw rate is once every 100ms.

The interpretation of the x, y, width, and height arguments depends on the value of the infoflags argument.
Returns: false if the infoflags indicate that the image is completely loaded; true otherwise.
Parameters:
- img - the image being observed
- infoflags - see imageUpdate for more information
- x - the x coordinate
- y - the y coordinate
- w - the width
- h - the height
Since: JDK1.0
See Also: ImageObserver, Graphics.drawImage(Image, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, java.awt.image.ImageObserver), ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int),

A component is made displayable either when it is added to a displayable containment hierarchy or when its containment hierarchy is made displayable. A containment hierarchy is made displayable when its ancestor window is either packed or made visible.

A component is made undisplayable either when it is removed from a displayable containment hierarchy or when its containment hierarchy is made undisplayable. A containment hierarchy is made undisplayable when its ancestor window is disposed.
Returns: true if the component is displayable, false otherwise
Since: 1.2
See Also: Container.add(Component), Window.pack(), Window.show(), Container.remove(Component), Window.dispose(),

This method will always return false if this component is not displayable because it is impossible to determine the weight of an undisplayable component.
Returns: true if this component has a lightweight peer; false if it has a native peer or no peer
Since: 1.2
See Also: Component.isDisplayable(),

An opaque component paints every pixel within its rectangular region. A non-opaque component paints only some of its pixels, allowing the pixels underneath it to "show through". A component that does not fully paint its pixels therefore provides a degree of transparency. Only lightweight components can be transparent.

Subclasses that guarantee to always completely paint their contents should override this method and return true. All of the "heavyweight" AWT components are opaque.
Returns: true if this component is completely opaque
Since: 1.2
See Also: Component.isLightweight(),

Note: sometimes there is no way to detect whether the Component is actually visible to the user. This can happen when:

• the component has been added to a visible ScrollPane but the Component is not currently in the scroll pane's view port.
• the Component is obscured by another Component or Container.

This method is called when the contents of the component should be painted; such as when the component is first being shown or is damaged and in need of repair. The clip rectangle in the Graphics parameter is set to the area which needs to be painted. Subclasses of Component that override this method need not call super.paint(g).

For performance reasons, Components with zero width or height aren't considered to need painting when they are first shown, and also aren't considered to need repair.

Note: For more information on the paint mechanisms utilitized by AWT and Swing, including information on how to write the most efficient painting code, see Painting in AWT and Swing.
Parameters:
- g - the graphics context to use for painting
Since: JDK1.0
See Also: Component.update(java.awt.Graphics),

The origin of the graphics context, its (0, 0) coordinate point, is the top-left corner of this component. The clipping region of the graphics context is the bounding rectangle of this component.
Parameters:
- g - the graphics context to use for painting
Since: JDK1.0
See Also: Component.paint(java.awt.Graphics),

The image data is downloaded asynchronously in another thread, and an appropriately scaled screen representation of the image is generated.
Returns: true if the image has already been fully prepared; false otherwise
Parameters:
- image - the instance of Image for which to prepare a screen representation
- width - the width of the desired screen representation
- height - the height of the desired screen representation
- observer - the ImageObserver object to be notified as the image is being prepared
Since: JDK1.0
See Also: ImageObserver,

The default implementation of this method calls the paint method.

The origin of the graphics context, its (0, 0) coordinate point, is the top-left corner of this component. The clipping region of the graphics context is the bounding rectangle of this component.
Parameters:
- g - the graphics context to use for printing
Since: JDK1.0
See Also: Component.paint(Graphics),

The origin of the graphics context, its (0, 0) coordinate point, is the top-left corner of this component. The clipping region of the graphics context is the bounding rectangle of this component.
Parameters:
- g - the graphics context to use for printing
Since: JDK1.0
See Also: Component.print(Graphics),

This method is not called unless component events are enabled for this component. Component events are enabled when one of the following occurs:

• A ComponentListener object is registered via addComponentListener.
• Component events are enabled via enableEvents.

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the component event
Since: JDK1.1
See Also: ComponentEvent, ComponentListener, Component.addComponentListener(java.awt.event.ComponentListener), Component.enableEvents(long),

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the event
Since: JDK1.1
See Also: Component.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),

This method is not called unless focus events are enabled for this component. Focus events are enabled when one of the following occurs:

• A FocusListener object is registered via addFocusListener.
• Focus events are enabled via enableEvents.

If focus events are enabled for a Component, the current KeyboardFocusManager determines whether or not a focus event should be dispatched to registered FocusListener objects. If the events are to be dispatched, the KeyboardFocusManager calls the Component's dispatchEvent method, which results in a call to the Component's processFocusEvent method.

If focus events are enabled for a Component, calling the Component's dispatchEvent method with a FocusEvent as the argument will result in a call to the Component's processFocusEvent method regardless of the current KeyboardFocusManager.

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the focus event
Since: JDK1.1
See Also: FocusEvent, FocusListener, KeyboardFocusManager, Component.addFocusListener(java.awt.event.FocusListener), Component.enableEvents(long), Component.dispatchEvent(java.awt.AWTEvent),

This method is not called unless hierarchy bounds events are enabled for this component. Hierarchy bounds events are enabled when one of the following occurs:

• An HierarchyBoundsListener object is registered via addHierarchyBoundsListener.
• Hierarchy bounds events are enabled via enableEvents.

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the hierarchy event
Since: 1.3
See Also: HierarchyEvent, HierarchyBoundsListener, Component.addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), Component.enableEvents(long),

This method is not called unless hierarchy events are enabled for this component. Hierarchy events are enabled when one of the following occurs:

• An HierarchyListener object is registered via addHierarchyListener.
• Hierarchy events are enabled via enableEvents.

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the hierarchy event
Since: 1.3
See Also: HierarchyEvent, HierarchyListener, Component.addHierarchyListener(java.awt.event.HierarchyListener), Component.enableEvents(long),

This method is not called unless input method events are enabled for this component. Input method events are enabled when one of the following occurs:

• An InputMethodListener object is registered via addInputMethodListener.
• Input method events are enabled via enableEvents.

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the input method event
Since: 1.2
See Also: InputMethodEvent, InputMethodListener, Component.addInputMethodListener(java.awt.event.InputMethodListener), Component.enableEvents(long),

This method is not called unless key events are enabled for this component. Key events are enabled when one of the following occurs:

• A KeyListener object is registered via addKeyListener.
• Key events are enabled via enableEvents.

If key events are enabled for a Component, the current KeyboardFocusManager determines whether or not a key event should be dispatched to registered KeyListener objects. The DefaultKeyboardFocusManager will not dispatch key events to a Component that is not the focus owner or is not showing.

As of J2SE 1.4, KeyEvents are redirected to the focus owner. Please see the Focus Specification for further information.

Calling a Component's dispatchEvent method with a KeyEvent as the argument will result in a call to the Component's processKeyEvent method regardless of the current KeyboardFocusManager as long as the component is showing, focused, and enabled, and key events are enabled on it.

If the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the key event
Since: JDK1.1
See Also: KeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, Component.processEvent(java.awt.AWTEvent), Component.dispatchEvent(java.awt.AWTEvent), Component.addKeyListener(java.awt.event.KeyListener), Component.enableEvents(long), Component.isShowing(),

This method is not called unless mouse events are enabled for this component. Mouse events are enabled when one of the following occurs:

• A MouseListener object is registered via addMouseListener.
• Mouse events are enabled via enableEvents.

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the mouse event
Since: JDK1.1
See Also: MouseEvent, MouseListener, Component.addMouseListener(java.awt.event.MouseListener), Component.enableEvents(long),

This method is not called unless mouse motion events are enabled for this component. Mouse motion events are enabled when one of the following occurs:

• A MouseMotionListener object is registered via addMouseMotionListener.
• Mouse motion events are enabled via enableEvents.

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the mouse motion event
Since: JDK1.1
See Also: MouseEvent, MouseMotionListener, Component.addMouseMotionListener(java.awt.event.MouseMotionListener), Component.enableEvents(long),

This method is not called unless mouse wheel events are enabled for this component. Mouse wheel events are enabled when one of the following occurs:

• A MouseWheelListener object is registered via addMouseWheelListener.
• Mouse wheel events are enabled via enableEvents.

For information on how mouse wheel events are dispatched, see the class description for MouseWheelEvent.

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the mouse wheel event
Since: 1.4
See Also: MouseWheelEvent, MouseWheelListener, Component.addMouseWheelListener(java.awt.event.MouseWheelListener), Component.enableEvents(long),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the component listener
Since: JDK1.1
See Also: ComponentEvent, ComponentListener, Component.addComponentListener(java.awt.event.ComponentListener), Component.getComponentListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the focus listener
Since: JDK1.1
See Also: FocusEvent, FocusListener, Component.addFocusListener(java.awt.event.FocusListener), Component.getFocusListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the hierarchy bounds listener
Since: 1.3
See Also: HierarchyEvent, HierarchyBoundsListener, Component.addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), Component.getHierarchyBoundsListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the hierarchy listener
Since: 1.3
See Also: HierarchyEvent, HierarchyListener, Component.addHierarchyListener(java.awt.event.HierarchyListener), Component.getHierarchyListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the input method listener
Since: 1.2
See Also: InputMethodEvent, InputMethodListener, Component.addInputMethodListener(java.awt.event.InputMethodListener), Component.getInputMethodListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the key listener
Since: JDK1.1
See Also: KeyEvent, KeyListener, Component.addKeyListener(java.awt.event.KeyListener), Component.getKeyListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the mouse listener
Since: JDK1.1
See Also: MouseEvent, MouseListener, Component.addMouseListener(java.awt.event.MouseListener), Component.getMouseListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the mouse motion listener
Since: JDK1.1
See Also: MouseEvent, MouseMotionListener, Component.addMouseMotionListener(java.awt.event.MouseMotionListener), Component.getMouseMotionListeners(),

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the mouse wheel listener.
Since: 1.4
See Also: MouseWheelEvent, MouseWheelListener, Component.addMouseWheelListener(java.awt.event.MouseWheelListener), Component.getMouseWheelListeners(),

This method is called by the toolkit internally and should not be called directly by programs. Code overriding this method should call super.removeNotify as the first line of the overriding method.
Since: JDK1.0
See Also: Component.isDisplayable(), Component.addNotify(),

If listener is null, no exception is thrown and no action is performed.
Parameters:
- listener - the PropertyChangeListener to be removed
See Also: Component.addPropertyChangeListener(java.beans.PropertyChangeListener), Component.getPropertyChangeListeners(), Component.removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener),

If propertyName or listener is null, no exception is thrown and no action is taken.
Parameters:
- propertyName - a valid property name
- listener - the PropertyChangeListener to be removed
See Also: Component.addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), Component.getPropertyChangeListeners(java.lang.String), Component.removePropertyChangeListener(java.beans.PropertyChangeListener),

If this component is a lightweight component, this method causes a call to this component's paint method as soon as possible. Otherwise, this method causes a call to this component's update method as soon as possible.

Note: For more information on the paint mechanisms utilitized by AWT and Swing, including information on how to write the most efficient painting code, see Painting in AWT and Swing.
Since: JDK1.0
See Also: Component.update(Graphics),

If this component is a lightweight component, this method causes a call to this component's paint method as soon as possible. Otherwise, this method causes a call to this component's update method as soon as possible.

Note: For more information on the paint mechanisms utilitized by AWT and Swing, including information on how to write the most efficient painting code, see Painting in AWT and Swing.
Parameters:
- x - the x coordinate
- y - the y coordinate
- width - the width
- height - the height
Since: JDK1.0
See Also: Component.update(Graphics),

Note: For more information on the paint mechanisms utilitized by AWT and Swing, including information on how to write the most efficient painting code, see Painting in AWT and Swing.
Parameters:
- tm - maximum time in milliseconds before update
Since: JDK1.0
See Also: Component.paint(java.awt.Graphics), Component.update(Graphics),

If this component is a lightweight component, this method causes a call to this component's paint method. Otherwise, this method causes a call to this component's update method.

Note: For more information on the paint mechanisms utilitized by AWT and Swing, including information on how to write the most efficient painting code, see Painting in AWT and Swing.
Parameters:
- tm - maximum time in milliseconds before update
- x - the x coordinate
- y - the y coordinate
- width - the width
- height - the height
Since: JDK1.0
See Also: Component.update(Graphics),

This method cannot be used to set the focus owner to no Component at all. Use KeyboardFocusManager.clearGlobalFocusOwner() instead.

Because the focus behavior of this method is platform-dependent, developers are strongly encouraged to use requestFocusInWindow when possible.

Note: Not all focus transfers result from invoking this method. As such, a component may receive focus without this or any of the other requestFocus methods of Component being invoked.
Since: JDK1.0
See Also: Component.requestFocusInWindow(), FocusEvent, Component.addFocusListener(java.awt.event.FocusListener), Component.isFocusable(), Component.isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner(),

This method returns a boolean value. If false is returned, the request is guaranteed to fail. If true is returned, the request will succeed unless it is vetoed, or an extraordinary event, such as disposal of the component's peer, occurs before the request can be granted by the native windowing system. Again, while a return value of true indicates that the request is likely to succeed, developers must never assume that this component is the focus owner until this component receives a FOCUS_GAINED event.

This method cannot be used to set the focus owner to no component at all. Use KeyboardFocusManager.clearGlobalFocusOwner instead.

Because the focus behavior of this method is platform-dependent, developers are strongly encouraged to use requestFocusInWindow when possible.

Every effort will be made to ensure that FocusEvents generated as a result of this request will have the specified temporary value. However, because specifying an arbitrary temporary state may not be implementable on all native windowing systems, correct behavior for this method can be guaranteed only for lightweight Components. This method is not intended for general use, but exists instead as a hook for lightweight component libraries, such as Swing.

Note: Not all focus transfers result from invoking this method. As such, a component may receive focus without this or any of the other requestFocus methods of Component being invoked.
Returns: false if the focus change request is guaranteed to fail; true if it is likely to succeed
Parameters:
- temporary - true if the focus change is temporary, such as when the window loses the focus; for more information on temporary focus changes see the Focus Specification
Since: 1.4
See Also: FocusEvent, Component.addFocusListener(java.awt.event.FocusListener), Component.isFocusable(), Component.isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner(),

This method returns a boolean value. If false is returned, the request is guaranteed to fail. If true is returned, the request will succeed unless it is vetoed, or an extraordinary event, such as disposal of the Component's peer, occurs before the request can be granted by the native windowing system. Again, while a return value of true indicates that the request is likely to succeed, developers must never assume that this Component is the focus owner until this Component receives a FOCUS_GAINED event.

This method cannot be used to set the focus owner to no Component at all. Use KeyboardFocusManager.clearGlobalFocusOwner() instead.

The focus behavior of this method can be implemented uniformly across platforms, and thus developers are strongly encouraged to use this method over requestFocus when possible. Code which relies on requestFocus may exhibit different focus behavior on different platforms.

Note: Not all focus transfers result from invoking this method. As such, a component may receive focus without this or any of the other requestFocus methods of Component being invoked.
Returns: false if the focus change request is guaranteed to fail; true if it is likely to succeed
Since: 1.4
See Also: Component.requestFocus(), FocusEvent, Component.addFocusListener(java.awt.event.FocusListener), Component.isFocusable(), Component.isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner(),

This method returns a boolean value. If false is returned, the request is guaranteed to fail. If true is returned, the request will succeed unless it is vetoed, or an extraordinary event, such as disposal of the component's peer, occurs before the request can be granted by the native windowing system. Again, while a return value of true indicates that the request is likely to succeed, developers must never assume that this component is the focus owner until this component receives a FOCUS_GAINED event.

This method cannot be used to set the focus owner to no component at all. Use KeyboardFocusManager.clearGlobalFocusOwner instead.

The focus behavior of this method can be implemented uniformly across platforms, and thus developers are strongly encouraged to use this method over requestFocus when possible. Code which relies on requestFocus may exhibit different focus behavior on different platforms.

Every effort will be made to ensure that FocusEvents generated as a result of this request will have the specified temporary value. However, because specifying an arbitrary temporary state may not be implementable on all native windowing systems, correct behavior for this method can be guaranteed only for lightweight components. This method is not intended for general use, but exists instead as a hook for lightweight component libraries, such as Swing.

Note: Not all focus transfers result from invoking this method. As such, a component may receive focus without this or any of the other requestFocus methods of Component being invoked.
Returns: false if the focus change request is guaranteed to fail; true if it is likely to succeed
Parameters:
- temporary - true if the focus change is temporary, such as when the window loses the focus; for more information on temporary focus changes see the Focus Specification
Since: 1.4
See Also: Component.requestFocus(), FocusEvent, Component.addFocusListener(java.awt.event.FocusListener), Component.isFocusable(), Component.isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner(),

The background color affects each component differently and the parts of the component that are affected by the background color may differ between operating systems.
Parameters:
- c - the color to become this component's color; if this parameter is null, then this component will inherit the background color of its parent
Since: JDK1.0
See Also: Component.getBackground(),

At construction time, a component's orientation is set to ComponentOrientation.UNKNOWN, indicating that it has not been specified explicitly. The UNKNOWN orientation behaves the same as ComponentOrientation.LEFT_TO_RIGHT.

To set the orientation of a single component, use this method. To set the orientation of an entire component hierarchy, use applyComponentOrientation.
See Also: ComponentOrientation,

The method may have no visual effect if the Java platform implementation and/or the native system do not support changing the mouse cursor shape.
Parameters:
- cursor - One of the constants defined by the Cursor class; if this parameter is null then this component will inherit the cursor of its parent
Since: JDK1.1
See Also: Component.isEnabled(), Component.isShowing(), Component.getCursor(), Component.contains(int, int), Toolkit.createCustomCursor(java.awt.Image, java.awt.Point, java.lang.String), Cursor,

Note: Disabling a lightweight component does not prevent it from receiving MouseEvents.

Note: Disabling a heavyweight container prevents all components in this container from receiving any input events. But disabling a lightweight container affects only this container.
Parameters:
- b - If true, this component is enabled; otherwise this component is disabled
Since: JDK1.1
See Also: Component.isEnabled(), Component.isLightweight(),

The default values for a Component'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

To disable a traversal key, use an empty Set; Collections.EMPTY_SET is recommended.

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 Component. 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 Component inherits the Set from its parent. If all ancestors of this Component have null specified for the Set, then the current KeyboardFocusManager's default Set is used.
Parameters:
- id - one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, or KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
- keystrokes - the Set of AWTKeyStroke for the specified operation
Throws:
- IllegalArgumentException - if id is not one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, or KeyboardFocusManager.UP_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 Component
Since: 1.4
See Also: Component.getFocusTraversalKeys(int), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS,

This is useful, for example, if running under full-screen mode and better performance is desired, or if page-flipping is used as the buffer strategy.
Since: 1.4
See Also: Component.getIgnoreRepaint(), Canvas.createBufferStrategy(int), Window.createBufferStrategy(int), BufferStrategy, GraphicsDevice.setFullScreenWindow(java.awt.Window),

If this component is not a lightweight component, the AWT calls the update method in response to a call to repaint. You can assume that the background is not cleared.

The update method of Component calls this component's paint method to redraw this component. This method is commonly overridden by subclasses which need to do additional work in response to a call to repaint. Subclasses of Component that override this method should either call super.update(g), or call paint(g) directly from their update method.

The origin of the graphics context, its (0, 0) coordinate point, is the top-left corner of this component. The clipping region of the graphics context is the bounding rectangle of this component.

Note: For more information on the paint mechanisms utilitized by AWT and Swing, including information on how to write the most efficient painting code, see Painting in AWT and Swing.
Parameters:
- g - the specified context to use for updating
Since: JDK1.0
See Also: Component.paint(java.awt.Graphics), Component.repaint(),