protected abstract class MenuComponent.AccessibleAWTMenuComponent extends AccessibleContext implements Serializable, AccessibleComponent, AccessibleSelection
MenuComponent
used to provide
default support for accessibility. This class is not meant
to be used directly by application developers, but is instead
meant only to be subclassed by menu component developers.
The class used to obtain the accessible role for this object.
ACCESSIBLE_ACTION_PROPERTY, ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY, ACCESSIBLE_CARET_PROPERTY, ACCESSIBLE_CHILD_PROPERTY, ACCESSIBLE_COMPONENT_BOUNDS_CHANGED, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_HYPERTEXT_OFFSET, ACCESSIBLE_INVALIDATE_CHILDREN, ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_TABLE_CAPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED, ACCESSIBLE_TABLE_MODEL_CHANGED, ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_ROW_HEADER_CHANGED, ACCESSIBLE_TABLE_SUMMARY_CHANGED, ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY, accessibleDescription, accessibleName, accessibleParent
Modifier | Constructor and Description |
---|---|
protected |
AccessibleAWTMenuComponent()
Although the class is abstract, this should be called by
all sub-classes.
|
Modifier and Type | Method and Description |
---|---|
void |
addAccessibleSelection(int i)
Adds the specified
Accessible child of the object
to the object's selection. |
void |
addFocusListener(FocusListener l)
Adds the specified focus listener to receive focus events from this
component.
|
void |
clearAccessibleSelection()
Clears the selection in the object, so that no children in the
object are selected.
|
boolean |
contains(Point p)
Checks whether the specified point is within this object's bounds,
where the point's x and y coordinates are defined to be relative to
the coordinate system of the object.
|
Accessible |
getAccessibleAt(Point p)
Returns the
Accessible child, if one exists,
contained at the local coordinate Point . |
Accessible |
getAccessibleChild(int i)
Returns the nth
Accessible child of the object. |
int |
getAccessibleChildrenCount()
Returns the number of accessible children in the object.
|
AccessibleComponent |
getAccessibleComponent()
Gets the
AccessibleComponent associated with
this object if one exists. |
String |
getAccessibleDescription()
Gets the accessible description of this object.
|
int |
getAccessibleIndexInParent()
Gets the index of this object in its accessible parent.
|
String |
getAccessibleName()
Gets the accessible name of this object.
|
Accessible |
getAccessibleParent()
Gets the
Accessible parent of this object. |
AccessibleRole |
getAccessibleRole()
Gets the role of this object.
|
AccessibleSelection |
getAccessibleSelection()
Gets the
AccessibleSelection associated with this
object which allows its Accessible children to be selected. |
Accessible |
getAccessibleSelection(int i)
Returns an
Accessible representing the specified
selected child in the object. |
int |
getAccessibleSelectionCount()
Returns the number of
Accessible children currently selected. |
AccessibleStateSet |
getAccessibleStateSet()
Gets the state of this object.
|
Color |
getBackground()
Gets the background color of this object.
|
Rectangle |
getBounds()
Gets the bounds of this object in the form of a
Rectangle object. |
Cursor |
getCursor()
Gets the
Cursor of this object. |
Font |
getFont()
Gets the
Font of this object. |
FontMetrics |
getFontMetrics(Font f)
Gets the
FontMetrics of this object. |
Color |
getForeground()
Gets the foreground color of this object.
|
Locale |
getLocale()
Returns the locale of this object.
|
Point |
getLocation()
Gets the location of the object relative to the parent in the form
of a point specifying the object's top-left corner in the screen's
coordinate space.
|
Point |
getLocationOnScreen()
Returns the location of the object on the screen.
|
Dimension |
getSize()
Returns the size of this object in the form of a
Dimension object. |
boolean |
isAccessibleChildSelected(int i)
Determines if the current child of this object is selected.
|
boolean |
isEnabled()
Determines if the object is enabled.
|
boolean |
isFocusTraversable()
Returns whether this object can accept focus or not.
|
boolean |
isShowing()
Determines if the object is showing.
|
boolean |
isVisible()
Determines if the object is visible.
|
void |
removeAccessibleSelection(int i)
Removes the specified child of the object from the object's
selection.
|
void |
removeFocusListener(FocusListener l)
Removes the specified focus listener so it no longer receives focus
events from this component.
|
void |
requestFocus()
Requests focus for this object.
|
void |
selectAllAccessibleSelection()
Causes every child of the object to be selected
if the object supports multiple selections.
|
void |
setBackground(Color c)
Sets the background color of this object.
|
void |
setBounds(Rectangle r)
Sets the bounds of this object in the form of a
Rectangle object. |
void |
setCursor(Cursor cursor)
Sets the
Cursor of this object. |
void |
setEnabled(boolean b)
Sets the enabled state of the object.
|
void |
setFont(Font f)
Sets the
Font of this object. |
void |
setForeground(Color c)
Sets the foreground color of this object.
|
void |
setLocation(Point p)
Sets the location of the object relative to the parent.
|
void |
setSize(Dimension d)
Resizes this object.
|
void |
setVisible(boolean b)
Sets the visible state of the object.
|
addPropertyChangeListener, firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleTable, getAccessibleText, getAccessibleValue, removePropertyChangeListener, setAccessibleDescription, setAccessibleName, setAccessibleParent
protected AccessibleAWTMenuComponent()
public AccessibleSelection getAccessibleSelection()
AccessibleSelection
associated with this
object which allows its Accessible
children to be selected.getAccessibleSelection
in class AccessibleContext
AccessibleSelection
if supported by object;
else return null
AccessibleSelection
public String getAccessibleName()
java.awt.MenuComponent.getName
, as that
generally isn't a localized name, and doesn't have meaning for the
user. If the object is fundamentally a text object (e.g. a menu item), the
accessible name should be the text of the object (e.g. "save").
If the object has a tooltip, the tooltip text may also be an
appropriate String to return.getAccessibleName
in class AccessibleContext
null
if this object does not have a nameAccessibleContext.setAccessibleName(java.lang.String)
public String getAccessibleDescription()
getAccessibleDescription
in class AccessibleContext
null
if this object does not have a descriptionAccessibleContext.setAccessibleDescription(java.lang.String)
public AccessibleRole getAccessibleRole()
getAccessibleRole
in class AccessibleContext
AccessibleRole
describing the role of the objectAccessibleRole
public AccessibleStateSet getAccessibleStateSet()
getAccessibleStateSet
in class AccessibleContext
AccessibleStateSet
containing the current state set of the objectAccessibleState
public Accessible getAccessibleParent()
Accessible
parent of this object.
If the parent of this object implements Accessible
,
this method should simply return getParent
.getAccessibleParent
in class AccessibleContext
Accessible
parent of this object -- can
be null
if this object does not have an
Accessible
parentpublic int getAccessibleIndexInParent()
getAccessibleIndexInParent
in class AccessibleContext
getAccessibleParent()
public int getAccessibleChildrenCount()
Accessible
,
then this method should return the number of children of this object.getAccessibleChildrenCount
in class AccessibleContext
public Accessible getAccessibleChild(int i)
Accessible
child of the object.getAccessibleChild
in class AccessibleContext
i
- zero-based index of childAccessibleContext.getAccessibleChildrenCount()
public Locale getLocale()
getLocale
in class AccessibleContext
public AccessibleComponent getAccessibleComponent()
AccessibleComponent
associated with
this object if one exists. Otherwise return null
.getAccessibleComponent
in class AccessibleContext
AccessibleComponent
public Color getBackground()
getBackground
in interface AccessibleComponent
null
AccessibleComponent.setBackground(java.awt.Color)
public void setBackground(Color c)
isOpaque
.)setBackground
in interface AccessibleComponent
c
- the new Color
for the backgroundComponent.isOpaque()
public Color getForeground()
getForeground
in interface AccessibleComponent
null
AccessibleComponent.setForeground(java.awt.Color)
public void setForeground(Color c)
setForeground
in interface AccessibleComponent
c
- the new Color
for the foregroundAccessibleComponent.getForeground()
public Cursor getCursor()
Cursor
of this object.getCursor
in interface AccessibleComponent
Cursor
, if supported, of the object;
otherwise, null
AccessibleComponent.setCursor(java.awt.Cursor)
public void setCursor(Cursor cursor)
Cursor
of this object.
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.
setCursor
in interface AccessibleComponent
cursor
- the new Cursor
for the objectAccessibleComponent.getCursor()
public Font getFont()
Font
of this object.getFont
in interface AccessibleComponent
Font
,if supported, for the object;
otherwise, null
AccessibleComponent.setFont(java.awt.Font)
public void setFont(Font f)
Font
of this object.setFont
in interface AccessibleComponent
f
- the new Font
for the objectAccessibleComponent.getFont()
public FontMetrics getFontMetrics(Font f)
FontMetrics
of this object.getFontMetrics
in interface AccessibleComponent
f
- the Font
null
getFont()
public boolean isEnabled()
isEnabled
in interface AccessibleComponent
AccessibleComponent.setEnabled(boolean)
,
AccessibleContext.getAccessibleStateSet()
,
AccessibleState.ENABLED
,
AccessibleStateSet
public void setEnabled(boolean b)
setEnabled
in interface AccessibleComponent
b
- if true, enables this object; otherwise, disables itAccessibleComponent.isEnabled()
public boolean isVisible()
isShowing
.isVisible
in interface AccessibleComponent
AccessibleComponent.setVisible(boolean)
,
AccessibleContext.getAccessibleStateSet()
,
AccessibleState.VISIBLE
,
AccessibleStateSet
public void setVisible(boolean b)
setVisible
in interface AccessibleComponent
b
- if true, shows this object; otherwise, hides itAccessibleComponent.isVisible()
public boolean isShowing()
isShowing
in interface AccessibleComponent
public boolean contains(Point p)
contains
in interface AccessibleComponent
p
- the Point
relative to the coordinate
system of the objectPoint
; otherwise falseAccessibleComponent.getBounds()
public Point getLocationOnScreen()
getLocationOnScreen
in interface AccessibleComponent
null
if this object is not on the screenAccessibleComponent.getBounds()
,
AccessibleComponent.getLocation()
public Point getLocation()
getLocation
in interface AccessibleComponent
Point
representing the
top-left corner of the object's bounds in the coordinate
space of the screen; null
if
this object or its parent are not on the screenAccessibleComponent.getBounds()
,
AccessibleComponent.getLocationOnScreen()
public void setLocation(Point p)
setLocation
in interface AccessibleComponent
p
- the new position for the top-left cornerAccessibleComponent.getLocation()
public Rectangle getBounds()
Rectangle
object.
The bounds specify this object's width, height, and location
relative to its parent.getBounds
in interface AccessibleComponent
null
if this object is not on the screenAccessibleComponent.contains(java.awt.Point)
public void setBounds(Rectangle r)
Rectangle
object.
The bounds specify this object's width, height, and location
relative to its parent.setBounds
in interface AccessibleComponent
r
- a rectangle indicating this component's boundsAccessibleComponent.getBounds()
public Dimension getSize()
Dimension
object. The height field of
the Dimension
object contains this object's
height, and the width field of the Dimension
object contains this object's width.getSize
in interface AccessibleComponent
Dimension
object that indicates the
size of this component; null
if this object is not on the screenAccessibleComponent.setSize(java.awt.Dimension)
public void setSize(Dimension d)
setSize
in interface AccessibleComponent
d
- - the Dimension
specifying the
new size of the objectAccessibleComponent.getSize()
public Accessible getAccessibleAt(Point p)
Accessible
child, if one exists,
contained at the local coordinate Point
.
If there is no Accessible
child, null
is returned.getAccessibleAt
in interface AccessibleComponent
p
- the point defining the top-left corner of the
Accessible
, given in the coordinate space
of the object's parentAccessible
, if it exists,
at the specified location; else null
public boolean isFocusTraversable()
isFocusTraversable
in interface AccessibleComponent
AccessibleContext.getAccessibleStateSet()
,
AccessibleState.FOCUSABLE
,
AccessibleState.FOCUSED
,
AccessibleStateSet
public void requestFocus()
requestFocus
in interface AccessibleComponent
AccessibleComponent.isFocusTraversable()
public void addFocusListener(FocusListener l)
addFocusListener
in interface AccessibleComponent
l
- the focus listenerAccessibleComponent.removeFocusListener(java.awt.event.FocusListener)
public void removeFocusListener(FocusListener l)
removeFocusListener
in interface AccessibleComponent
l
- the focus listenerAccessibleComponent.addFocusListener(java.awt.event.FocusListener)
public int getAccessibleSelectionCount()
Accessible
children currently selected.
If no children are selected, the return value will be 0.getAccessibleSelectionCount
in interface AccessibleSelection
public Accessible getAccessibleSelection(int i)
Accessible
representing the specified
selected child in the object. If there isn't a selection, or there are
fewer children selected than the integer passed in, the return
value will be null
.
Note that the index represents the i-th selected child, which is different from the i-th child.
getAccessibleSelection
in interface AccessibleSelection
i
- the zero-based index of selected childrengetAccessibleSelectionCount()
public boolean isAccessibleChildSelected(int i)
isAccessibleChildSelected
in interface AccessibleSelection
i
- the zero-based index of the child in this
Accessible
objectAccessibleContext.getAccessibleChild(int)
public void addAccessibleSelection(int i)
Accessible
child of the object
to the object's selection. If the object supports multiple selections,
the specified child is added to any existing selection, otherwise
it replaces any existing selection in the object. If the
specified child is already selected, this method has no effect.addAccessibleSelection
in interface AccessibleSelection
i
- the zero-based index of the childAccessibleContext.getAccessibleChild(int)
public void removeAccessibleSelection(int i)
removeAccessibleSelection
in interface AccessibleSelection
i
- the zero-based index of the childAccessibleContext.getAccessibleChild(int)
public void clearAccessibleSelection()
clearAccessibleSelection
in interface AccessibleSelection
public void selectAllAccessibleSelection()
selectAllAccessibleSelection
in interface AccessibleSelection
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, 2024, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.