| |
Modifier and Type |
Method and Description |
 |
addActionListener   |
void addActionListener(ActionListener l)
Adds the specified action listener to receive action events
from this menu item.
|
 |
addItemListener |
void addItemListener(ItemListener l)
Adds the specified item listener to receive item events from
this check box menu item.
|
 |
addNotify |
void addNotify()
Creates the peer of the checkbox item.
|
|
deleteShortcut |
void deleteShortcut()
Delete any MenuShortcut object associated
with this menu item.
public void deleteShortcut()
-
Delete any MenuShortcut object associated
with this menu item.
- Since:
- JDK1.1
|
|
disable |
void disable()
Deprecated. As of JDK version 1.1,
replaced by setEnabled(boolean).
@Deprecated
public void disable()
Deprecated. As of JDK version 1.1,
replaced by setEnabled(boolean).
|
|
disableEvents |
protected void disableEvents(long eventsToDisable)
Disables event delivery to this menu item for events
defined by the specified event mask parameter.
|
|
dispatchEvent |
void dispatchEvent(AWTEvent e)
Delivers an event to this component or one of its sub components.
public final void dispatchEvent( AWTEvent e)
-
Delivers an event to this component or one of its sub components.
- Parameters:
e - the event
|
|
enable |
void enable()
Deprecated. As of JDK version 1.1,
replaced by setEnabled(boolean).
@Deprecated
public void enable()
Deprecated. As of JDK version 1.1,
replaced by setEnabled(boolean).
|
|
enable |
void enable(boolean b)
Deprecated. As of JDK version 1.1,
replaced by setEnabled(boolean).
@Deprecated
public void enable(boolean b)
Deprecated. As of JDK version 1.1,
replaced by setEnabled(boolean).
|
|
enableEvents |
protected void enableEvents(long eventsToEnable)
Enables event delivery to this menu item for events
to be defined by the specified event mask parameter
protected final void enableEvents(long eventsToEnable)
-
Enables event delivery to this menu item for events
to be defined by the specified event mask parameter
Since event types are automatically enabled when a listener for
that type is added to the menu item, this method only needs
to be invoked by subclasses of MenuItem which desire to
have the specified event types delivered to processEvent
regardless of whether a listener is registered. - Parameters:
eventsToEnable - the event mask defining the event types- Since:
- JDK1.1
- See Also:
MenuItem.processEvent(java.awt.AWTEvent),
MenuItem.disableEvents(long),
Component.enableEvents(long)
|
|
getAccessibleContext |
javax.accessibility.AccessibleContext getAccessibleContext()
Gets the AccessibleContext associated with this CheckboxMenuItem.
public javax.accessibility.AccessibleContext getAccessibleContext()
-
Gets the AccessibleContext associated with this CheckboxMenuItem.
For checkbox menu items, the AccessibleContext takes the
form of an AccessibleAWTCheckboxMenuItem.
A new AccessibleAWTCheckboxMenuItem is created if necessary.
- Specified by:
getAccessibleContext in interface javax.accessibility.Accessible- Overrides:
getAccessibleContext in class MenuItem- Returns:
- an AccessibleAWTCheckboxMenuItem that serves as the
AccessibleContext of this CheckboxMenuItem
- Since:
- 1.3
|
|
getActionCommand |
java.lang.String getActionCommand()
Gets the command name of the action event that is fired
by this menu item.
|
|
getActionListeners |
Returns an array of all the action listeners
registered on this menu item.
|
|
getFont |
Gets the font used for this menu component.
|
|
getItemListeners |
Returns an array of all the item listeners
registered on this checkbox menuitem.
|
|
getLabel |
java.lang.String getLabel()
Gets the label for this menu item.
public java.lang.String getLabel()
-
Gets the label for this menu item.
- Returns:
- the label of this menu item, or
null
if this menu item has no label. - Since:
- JDK1.0
- See Also:
MenuItem.setLabel(java.lang.String)
|
|
getListeners |
<T extends java.util.EventListener> T[] getListeners(java.lang.Class<T> listenerType)
Returns an array of all the objects currently registered
as FooListeners
upon this CheckboxMenuItem.
public <T extends java.util.EventListener> T[] getListeners(java.lang.Class<T> listenerType)
-
Returns an array of all the objects currently registered
as FooListeners
upon this CheckboxMenuItem.
FooListeners 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
CheckboxMenuItem c
for its item listeners with the following code:
ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
If no such listeners exist, this method returns an empty array.
- Overrides:
getListeners in class MenuItem- Parameters:
listenerType - the type of listeners requested; this parameter
should specify an interface that descends from
java.util.EventListener- Returns:
- an array of all objects registered as
FooListeners on this checkbox menuitem,
or an empty array if no such
listeners have been added
- Throws:
java.lang.ClassCastException - if listenerType
doesn't specify a class or interface that implements
java.util.EventListener- Since:
- 1.3
- See Also:
getItemListeners()
|
|
getName |
java.lang.String getName()
Gets the name of the menu component.
|
|
getParent |
Returns the parent container for this menu component.
-
Returns the parent container for this menu component.
- Returns:
- the menu component containing this menu component,
or
null if this menu component
is the outermost component, the menu bar itself
|
|
getPeer |
java.awt.peer.MenuComponentPeer getPeer()
Deprecated. As of JDK version 1.1,
programs should not directly manipulate peers.
@Deprecated
public java.awt.peer.MenuComponentPeer getPeer()
Deprecated. As of JDK version 1.1,
programs should not directly manipulate peers.
|
|
getSelectedObjects |
java.lang.Object[] getSelectedObjects()
Returns the an array (length 1) containing the checkbox menu item
label or null if the checkbox is not selected.
public java.lang.Object[] getSelectedObjects()
-
Returns the an array (length 1) containing the checkbox menu item
label or null if the checkbox is not selected.
- Specified by:
getSelectedObjects in interface ItemSelectable- See Also:
ItemSelectable
|
|
getShortcut |
Get the MenuShortcut object associated with this
menu item,
-
Get the MenuShortcut object associated with this
menu item,
- Returns:
- the menu shortcut associated with this menu item,
or
null if none has been specified. - Since:
- JDK1.1
- See Also:
MenuItem.setShortcut(java.awt.MenuShortcut)
|
|
getState |
boolean getState()
Determines whether the state of this check box menu item
is "on" or "off."
public boolean getState()
-
Determines whether the state of this check box menu item
is "on" or "off."
- Returns:
- the state of this check box menu item, where
true indicates "on" and
false indicates "off" - See Also:
setState(boolean)
|
|
getTreeLock |
protected java.lang.Object getTreeLock()
Gets this component's locking object (the object that owns the thread
sychronization monitor) for AWT component-tree and layout
operations.
protected final java.lang.Object getTreeLock()
-
Gets this component's locking object (the object that owns the thread
sychronization monitor) for AWT component-tree and layout
operations.
- Returns:
- this component's locking object
|
|
isEnabled |
boolean isEnabled()
Checks whether this menu item is enabled.
|
|
paramString |
java.lang.String paramString()
Returns a string representing the state of this
CheckBoxMenuItem.
public java.lang.String paramString()
-
Returns a string representing the state of this
CheckBoxMenuItem. 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.
- Overrides:
paramString in class MenuItem- Returns:
- the parameter string of this check box menu item
|
|
postEvent |
boolean postEvent(Event evt)
@Deprecated
public boolean postEvent( Event evt)
Deprecated. As of JDK version 1.1, replaced by dispatchEvent.
-
Posts the specified event to the menu.
This method is part of the Java 1.0 event system
and it is maintained only for backwards compatibility.
Its use is discouraged, and it may not be supported
in the future.
- Parameters:
evt - the event which is to take place
|
|
processActionEvent |
protected void processActionEvent(ActionEvent e)
Processes action events occurring on this menu item,
by dispatching them to any registered
ActionListener objects.
-
Processes action events occurring on this menu item,
by dispatching them to any registered
ActionListener objects.
This method is not called unless action events are
enabled for this component. Action events are enabled
when one of the following occurs:
- An
ActionListener object is registered
via addActionListener.
- Action 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 action event- Since:
- JDK1.1
- See Also:
ActionEvent,
ActionListener,
MenuItem.enableEvents(long)
|
|
processEvent |
protected void processEvent(AWTEvent e)
Processes events on this check box menu item.
-
Processes events on this check box menu item.
If the event is an instance of ItemEvent,
this method invokes the processItemEvent method.
If the event is not an item event,
it invokes processEvent on the superclass.
Check box menu items currently support only item events.
Note that if the event parameter is null
the behavior is unspecified and may result in an
exception.
- Overrides:
processEvent in class MenuItem- Parameters:
e - the event- Since:
- JDK1.1
- See Also:
ItemEvent,
processItemEvent(java.awt.event.ItemEvent)
|
|
processItemEvent |
protected void processItemEvent(ItemEvent e)
Processes item events occurring on this check box menu item by
dispatching them to any registered ItemListener objects.
-
Processes item events occurring on this check box menu item by
dispatching them to any registered ItemListener objects.
This method is not called unless item events are
enabled for this menu item. Item events are enabled
when one of the following occurs:
- An
ItemListener object is registered
via addItemListener.
- Item 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 item event- Since:
- JDK1.1
- See Also:
ItemEvent,
ItemListener,
addItemListener(java.awt.event.ItemListener),
MenuItem.enableEvents(long)
|
|
removeActionListener |
void removeActionListener(ActionListener l)
Removes the specified action listener so it no longer receives
action events from this menu item.
|
|
removeItemListener |
void removeItemListener(ItemListener l)
Removes the specified item listener so that it no longer receives
item events from this check box menu item.
|
|
removeNotify |
void removeNotify()
Removes the menu component's peer.
public void removeNotify()
-
Removes the menu component's peer. The peer allows us to modify the
appearance of the menu component without changing the functionality of
the menu component.
|
|
setActionCommand |
void setActionCommand(java.lang.String command)
Sets the command name of the action event that is fired
by this menu item.
public void setActionCommand(java.lang.String command)
-
Sets the command name of the action event that is fired
by this menu item.
By default, the action command is set to the label of
the menu item. - Parameters:
command - the action command to be set
for this menu item.- Since:
- JDK1.1
- See Also:
MenuItem.getActionCommand()
|
|
setEnabled |
void setEnabled(boolean b)
Sets whether or not this menu item can be chosen.
public void setEnabled(boolean b)
-
Sets whether or not this menu item can be chosen.
- Parameters:
b - if true, enables this menu item;
if false, disables it.- Since:
- JDK1.1
- See Also:
MenuItem.isEnabled()
|
|
setFont |
void setFont(Font f)
Sets the font to be used for this menu component to the specified
font.
public void setFont( Font f)
-
Sets the font to be used for this menu component to the specified
font. This font is also used by all subcomponents of this menu
component, unless those subcomponents specify a different font.
Some platforms may not support setting of all font attributes
of a menu component; in such cases, calling setFont
will have no effect on the unsupported font attributes of this
menu component. Unless subcomponents of this menu component
specify a different font, this font will be used by those
subcomponents if supported by the underlying platform. - Parameters:
f - the font to be set- See Also:
MenuComponent.getFont(),
Font.getAttributes(),
TextAttribute
|
|
setLabel |
void setLabel(java.lang.String label)
Sets the label for this menu item to the specified label.
public void setLabel(java.lang.String label)
-
Sets the label for this menu item to the specified label.
- Parameters:
label - the new label, or null for no label.- Since:
- JDK1.0
- See Also:
MenuItem.getLabel()
|
|
setName |
void setName(java.lang.String name)
Sets the name of the component to the specified string.
public void setName(java.lang.String name)
-
Sets the name of the component to the specified string.
- Parameters:
name - the name of the menu component- Since:
- JDK1.1
- See Also:
MenuComponent.getName()
|
|
setShortcut |
void setShortcut(MenuShortcut s)
Set the MenuShortcut object associated with this
menu item.
-
Set the MenuShortcut object associated with this
menu item. If a menu shortcut is already associated with
this menu item, it is replaced.
- Parameters:
s - the menu shortcut to associate
with this menu item.- Since:
- JDK1.1
- See Also:
MenuItem.getShortcut()
|
|
setState |
void setState(boolean b)
Sets this check box menu item to the specifed state.
public void setState(boolean b)
-
Sets this check box menu item to the specifed state.
The boolean value true indicates "on" while
false indicates "off."
Note that this method should be primarily used to
initialize the state of the check box menu item.
Programmatically setting the state of the check box
menu item will not trigger
an ItemEvent. The only way to trigger an
ItemEvent is by user interaction. - Parameters:
b - true if the check box
menu item is on, otherwise false- See Also:
getState()
|
|
toString |
java.lang.String toString()
Returns a representation of this menu component as a string.
public java.lang.String toString()
-
Returns a representation of this menu component as a string.
- Overrides:
toString in class java.lang.Object- Returns:
- a string representation of this menu component
|
