Serializable
, AccessibleComponent
, AccessibleSelection
MenuBar.AccessibleAWTMenuBar
, MenuItem.AccessibleAWTMenuItem
MenuComponent
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 | Description |
---|---|---|
protected |
Although the class is abstract, this should be called by all sub-classes. |
Modifier and Type | Method | Description |
---|---|---|
void |
addAccessibleSelection |
Adds the specified Accessible child of the object to the object's selection. |
void |
addFocusListener |
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 |
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 |
Returns the Accessible child, if one exists, contained at the local coordinate Point . |
Accessible |
getAccessibleChild |
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 |
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 |
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 |
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 |
Removes the specified child of the object from the object's selection. |
void |
removeFocusListener |
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 |
Sets the background color of this object. |
void |
setBounds |
Sets the bounds of this object in the form of a Rectangle object. |
void |
setCursor |
Sets the Cursor of this object. |
void |
setEnabled |
Sets the enabled state of the object. |
void |
setFont |
Sets the Font of this object. |
void |
setForeground |
Sets the foreground color of this object. |
void |
setLocation |
Sets the location of the object relative to the parent. |
void |
setSize |
Resizes this object. |
void |
setVisible |
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
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 namepublic String getAccessibleDescription()
getAccessibleDescription
in class AccessibleContext
null
if this object does not have a descriptionpublic AccessibleRole getAccessibleRole()
getAccessibleRole
in class AccessibleContext
AccessibleRole
describing the role of the objectpublic AccessibleStateSet getAccessibleStateSet()
getAccessibleStateSet
in class AccessibleContext
AccessibleStateSet
containing the current state set of the objectpublic 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
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 childpublic Locale getLocale()
getLocale
in class AccessibleContext
public AccessibleComponent getAccessibleComponent()
AccessibleComponent
associated with this object if one exists. Otherwise return null
.getAccessibleComponent
in class AccessibleContext
public Color getBackground()
getBackground
in interface AccessibleComponent
null
public void setBackground(Color c)
isOpaque
.)setBackground
in interface AccessibleComponent
c
- the new Color
for the backgroundpublic Color getForeground()
getForeground
in interface AccessibleComponent
null
public void setForeground(Color c)
setForeground
in interface AccessibleComponent
c
- the new Color
for the foregroundpublic Cursor getCursor()
Cursor
of this object.getCursor
in interface AccessibleComponent
Cursor
, if supported, of the object; otherwise, null
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 objectpublic Font getFont()
Font
of this object.getFont
in interface AccessibleComponent
Font
, if supported, for the object; otherwise, null
public void setFont(Font f)
Font
of this object.setFont
in interface AccessibleComponent
f
- the new Font
for the objectpublic FontMetrics getFontMetrics(Font f)
FontMetrics
of this object.getFontMetrics
in interface AccessibleComponent
f
- the Font
null
public boolean isEnabled()
isEnabled
in interface AccessibleComponent
public void setEnabled(boolean b)
setEnabled
in interface AccessibleComponent
b
- if true, enables this object; otherwise, disables itpublic boolean isVisible()
isShowing
.isVisible
in interface AccessibleComponent
public void setVisible(boolean b)
setVisible
in interface AccessibleComponent
b
- if true, shows this object; otherwise, hides itpublic 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 falsepublic Point getLocationOnScreen()
getLocationOnScreen
in interface AccessibleComponent
null
if this object is not on the screenpublic 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 screenpublic void setLocation(Point p)
setLocation
in interface AccessibleComponent
p
- the new position for the top-left cornerpublic 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 screenpublic 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 boundspublic 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 screenpublic void setSize(Dimension d)
setSize
in interface AccessibleComponent
d
- the Dimension
specifying the new size of the objectpublic 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
public void requestFocus()
requestFocus
in interface AccessibleComponent
public void addFocusListener(FocusListener l)
addFocusListener
in interface AccessibleComponent
l
- the focus listenerpublic void removeFocusListener(FocusListener l)
removeFocusListener
in interface AccessibleComponent
l
- the focus listenerpublic 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 childrenpublic boolean isAccessibleChildSelected(int i)
isAccessibleChildSelected
in interface AccessibleSelection
i
- the zero-based index of the child in this Accessible
objectpublic 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 childpublic void removeAccessibleSelection(int i)
removeAccessibleSelection
in interface AccessibleSelection
i
- the zero-based index of the childpublic void clearAccessibleSelection()
clearAccessibleSelection
in interface AccessibleSelection
public void selectAllAccessibleSelection()
selectAllAccessibleSelection
in interface AccessibleSelection
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/MenuComponent.AccessibleAWTMenuComponent.html