javax.swing
クラス JMenuItem

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.AbstractButton
                          |
                          +--javax.swing.JMenuItem

直接の既知のサブクラス:

JCheckBoxMenuItem, JMenu, JRadioButtonMenuItem

public class JMenuItem

extends AbstractButton

implements Accessible, MenuElement

MenuItem の実装です。メニュー項目は実質的にはリストに置かれているボタンです。ユーザが「ボタン」を選択するとメニュー項目に対応するアクションが実行されます。機能は JPopupMenu が保持する JMenuItem で正確に実行されます。

標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JMenuItem のキーの割り当てを参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:

JPopupMenu, JMenu, JCheckBoxMenuItem, JRadioButtonMenuItem, 直列化された形式

内部クラスの概要

protected class

JMenuItem.AccessibleJMenuItem このオブジェクトのユーザ補助機能を取得するために使用されるクラスです。

クラス javax.swing.AbstractButton から継承した内部クラス

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

クラス javax.swing.JComponent から継承した内部クラス

JComponent.AccessibleJComponent

クラス javax.swing.AbstractButton から継承したフィールド

actionListener, BORDER_PAINTED_CHANGED_PROPERTY, changeEvent, changeListener, CONTENT_AREA_FILLED_CHANGED_PROPERTY, DISABLED_ICON_CHANGED_PROPERTY, DISABLED_SELECTED_ICON_CHANGED_PROPERTY, FOCUS_PAINTED_CHANGED_PROPERTY, HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY, HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY, ICON_CHANGED_PROPERTY, itemListener, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, model, MODEL_CHANGED_PROPERTY, PRESSED_ICON_CHANGED_PROPERTY, ROLLOVER_ENABLED_CHANGED_PROPERTY, ROLLOVER_ICON_CHANGED_PROPERTY, ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY, SELECTED_ICON_CHANGED_PROPERTY, TEXT_CHANGED_PROPERTY, VERTICAL_ALIGNMENT_CHANGED_PROPERTY, VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

クラス javax.swing.JComponent から継承したフィールド

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

クラス java.awt.Component から継承したフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

コンストラクタの概要

JMenuItem()
テキストまたはアイコンのない menuItem を作成します。

JMenuItem(Icon icon)
アイコンのある menuItem を作成します。

JMenuItem(String text)
テキストのある menuItem を作成します。

JMenuItem(String text, Icon icon)
指定されたテキストおよびアイコンで menuItem を作成します。

JMenuItem(String text, int mnemonic)
指定されたテキストおよびキーボードニーモニックで menuItem を作成します。

メソッドの概要

void	addMenuDragMouseListener(MenuDragMouseListener l) メニュー項目に MenuDragMouseListener を追加します。
void	addMenuKeyListener(MenuKeyListener l) メニュー項目に MenuKeyListener を追加します。
protected void	fireMenuDragMouseDragged(MenuDragMouseEvent event)
protected void	fireMenuDragMouseEntered(MenuDragMouseEvent event)
protected void	fireMenuDragMouseExited(MenuDragMouseEvent event)
protected void	fireMenuDragMouseReleased(MenuDragMouseEvent event)
protected void	fireMenuKeyPressed(MenuKeyEvent event)
protected void	fireMenuKeyReleased(MenuKeyEvent event)
protected void	fireMenuKeyTyped(MenuKeyEvent event)
KeyStroke	getAccelerator() メニュー項目のアクセラレータとして機能する KeyStroke を返します。
AccessibleContext	getAccessibleContext() この JComponent に関連付けられた AccessibleContext を取得します。
Component	getComponent() 該当のオブジェクトを描画するための java.awt.Component を返します。
MenuElement[]	getSubElements() 該当のメニューコンポーネントのサブメニューコンポーネントを保持する配列を返します。
String	getUIClassID() このコンポーネントを描画する L&F クラスの名前を返します。
protected void	init(String text, Icon icon) メニュー項目を指定されたテキストおよびアイコンで初期化します。
boolean	isArmed() メニュー項目の「作動準備が整っている」かどうかを返します。
void	menuSelectionChanged(boolean isIncluded) MenuElement が選択されるか選択を解除されると MenuSelectionManager から呼び出されます。
protected String	paramString() この JMenuItem の文字列表現を返します。
void	processKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager) MenuSelectionManager から転送されるキーイベントを処理します。
void	processMenuDragMouseEvent(MenuDragMouseEvent e) メニューでのマウスドラッグを処理します。
void	processMenuKeyEvent(MenuKeyEvent e) メニューでのキーストロークを処理します。
void	processMouseEvent(MouseEvent e, MenuElement[] path, MenuSelectionManager manager) MenuSelectionManager から転送されるマウスイベントを処理します。
void	removeMenuDragMouseListener(MenuDragMouseListener l) メニュー項目から MenuDragMouseListener を削除します。
void	removeMenuKeyListener(MenuKeyListener l) メニュー項目から MenuKeyListener を削除します。
void	setAccelerator(KeyStroke keyStroke) メニュー階層を移動することなくメニュー項目のアクションリスナーを呼び出すキーの組み合わせを設定します。
void	setArmed(boolean b) メニュー項目を「作動準備が整っている」ものとして設定します。
void	setEnabled(boolean b) メニュー項目を使用可能または使用不可にします。
void	setUI(MenuItemUI ui) このコンポーネントを描画する L&F オブジェクトを設定します。
void	updateUI() L&F が変更されたことを示す UIFactory からの通知です。

クラス javax.swing.AbstractButton から継承したメソッド

addActionListener, addChangeListener, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getActionCommand, getDisabledIcon, getDisabledSelectedIcon, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getLabel, getMargin, getMnemonic, getModel, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getSelectedObjects, getText, getUI, getVerticalAlignment, getVerticalTextPosition, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setFocusPainted, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setLabel, setMargin, setMnemonic, setMnemonic, setModel, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

クラス javax.swing.JComponent から継承したメソッド

addAncestorListener, addNotify, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInsets, getInsets, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, processComponentKeyEvent, processFocusEvent, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setFont, setForeground, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVisible, unregisterKeyboardAction, update

クラス java.awt.Container から継承したメソッド

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hide, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

JMenuItem

public JMenuItem()

テキストまたはアイコンのない menuItem を作成します。

JMenuItem

public JMenuItem(Icon icon)

アイコンのある menuItem を作成します。

パラメータ:

icon - MenuItem のアイコン

JMenuItem

public JMenuItem(String text)

テキストのある menuItem を作成します。

パラメータ:

text - MenuItem のテキスト

JMenuItem

public JMenuItem(String text,
                 Icon icon)

指定されたテキストおよびアイコンで menuItem を作成します。

パラメータ:

text - MenuItem のテキスト

icon - MenuItem のアイコン

JMenuItem

public JMenuItem(String text,
                 int mnemonic)

指定されたテキストおよびキーボードニーモニックで menuItem を作成します。

パラメータ:

text - MenuItem のテキスト

mnemonic - MenuItem のキーボードニーモニック

メソッドの詳細

init

protected void init(String text,
                    Icon icon)

メニュー項目を指定されたテキストおよびアイコンで初期化します。

パラメータ:

text - MenuItem のテキスト

icon - MenuItem のアイコン

オーバーライド:

クラス AbstractButton 内の init

setUI

public void setUI(MenuItemUI ui)

このコンポーネントを描画する L&F オブジェクトを設定します。

パラメータ:

ui - MenuItemUI L&F オブジェクト

関連項目:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

L&F が変更されたことを示す UIFactory からの通知です。UI を UIFactory からの最新バージョンに置き換えるために呼び出されます。

オーバーライド:

クラス AbstractButton 内の updateUI

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

このコンポーネントを描画する L&F クラスの名前を返します。

戻り値:

"MenuItemUI"

オーバーライド:

クラス JComponent 内の getUIClassID

関連項目:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setArmed

public void setArmed(boolean b)

メニュー項目を「作動準備が整っている」ものとして設定します。この項目上でマウスボタンが離されると、メニューのアクションイベントがトリガーされます。それ以外の場所でマウスボタンが離されると、イベントはトリガーされずメニュー項目の作動準備は解除されます。

パラメータ:

b - メニュー項目の作動準備を整え、選択可能にする場合は true

isArmed

public boolean isArmed()

メニュー項目の「作動準備が整っている」かどうかを返します。

戻り値:

メニュー項目の作動準備が整っていて選択可能な場合は true

関連項目:

setArmed(boolean)

setEnabled

public void setEnabled(boolean b)

メニュー項目を使用可能または使用不可にします。

パラメータ:

b - 項目を使用可能にする場合は true

オーバーライド:

クラス AbstractButton 内の setEnabled

setAccelerator

public void setAccelerator(KeyStroke keyStroke)

メニュー階層を移動することなくメニュー項目のアクションリスナーを呼び出すキーの組み合わせを設定します。

パラメータ:

keyStroke - アクセラレータとして機能する KeyStroke

getAccelerator

public KeyStroke getAccelerator()

メニュー項目のアクセラレータとして機能する KeyStroke を返します。

戻り値:

アクセラレータキーを識別する KeyStroke オブジェクト

processMouseEvent

public void processMouseEvent(MouseEvent e,
                              MenuElement[] path,
                              MenuSelectionManager manager)

MenuSelectionManager から転送されるマウスイベントを処理します。

定義:

インタフェース MenuElement 内の processMouseEvent

パラメータ:

e - MouseEvent と、受信側コンポーネントであるソース

path - 受信側コンポーネントに対する MenuElement のパス配列

manager - メニュー階層の MenuSelectionManager

このメソッドは、MouseEvent を処理し、必要に応じて MenuSelectionManager の API を使用して、メニュー選択を変更しなければなりません。

注: イベントをサブコンポーネントに転送する必要はありません。MenuSelectionManager が自動的に実行します。

processKeyEvent

public void processKeyEvent(KeyEvent e,
                            MenuElement[] path,
                            MenuSelectionManager manager)

MenuSelectionManager から転送されるキーイベントを処理します。

定義:

インタフェース MenuElement 内の processKeyEvent

パラメータ:

e - KeyEvent と、受信側コンポーネントであるソース

path - 受信側コンポーネントに対する MenuElement のパス配列

manager - メニュー階層の MenuSelectionManager

このメソッドは、KeyEvent を処理し、必要に応じて MenuSelectionManager の API を使用して、メニュー選択を変更しなければなりません。

注: イベントをサブコンポーネントに転送する必要はありません。MenuSelectionManager が自動的に実行します。

processMenuDragMouseEvent

public void processMenuDragMouseEvent(MenuDragMouseEvent e)

メニューでのマウスドラッグを処理します。

パラメータ:

e - MenuDragMouseEvent オブジェクト

processMenuKeyEvent

public void processMenuKeyEvent(MenuKeyEvent e)

メニューでのキーストロークを処理します。

パラメータ:

e - MenuKeyEvent オブジェクト

fireMenuDragMouseEntered

protected void fireMenuDragMouseEntered(MenuDragMouseEvent event)

fireMenuDragMouseExited

protected void fireMenuDragMouseExited(MenuDragMouseEvent event)

fireMenuDragMouseDragged

protected void fireMenuDragMouseDragged(MenuDragMouseEvent event)

fireMenuDragMouseReleased

protected void fireMenuDragMouseReleased(MenuDragMouseEvent event)

fireMenuKeyPressed

protected void fireMenuKeyPressed(MenuKeyEvent event)

fireMenuKeyReleased

protected void fireMenuKeyReleased(MenuKeyEvent event)

fireMenuKeyTyped

protected void fireMenuKeyTyped(MenuKeyEvent event)

menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)

MenuElement が選択されるか選択を解除されると MenuSelectionManager から呼び出されます。

定義:

インタフェース MenuElement 内の menuSelectionChanged

パラメータ:

isIncluded - このメニュー項目が変更されたメニューパスの一部の上にある場合は true、このメニューが変更されたメニューパスの一部で内容が変更されていない場合は false

関連項目:

MenuSelectionManager.setSelectedPath(MenuElement[])

getSubElements

public MenuElement[] getSubElements()

該当のメニューコンポーネントのサブメニューコンポーネントを保持する配列を返します。

定義:

インタフェース MenuElement 内の getSubElements

戻り値:

MenuElement の配列

getComponent

public Component getComponent()

該当のオブジェクトを描画するための java.awt.Component を返します。返されるコンポーネントを使用して、イベントの変換およびイベントがメニューコンポーネント内にあるかどうかの判定を行います。

定義:

インタフェース MenuElement 内の getComponent

戻り値:

このメニュー項目を描画する Component

addMenuDragMouseListener

public void addMenuDragMouseListener(MenuDragMouseListener l)

メニュー項目に MenuDragMouseListener を追加します。

removeMenuDragMouseListener

public void removeMenuDragMouseListener(MenuDragMouseListener l)

メニュー項目から MenuDragMouseListener を削除します。

addMenuKeyListener

public void addMenuKeyListener(MenuKeyListener l)

メニュー項目に MenuKeyListener を追加します。

removeMenuKeyListener

public void removeMenuKeyListener(MenuKeyListener l)

メニュー項目から MenuKeyListener を削除します。

paramString

protected String paramString()

この JMenuItem の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。

戻り値:

この JMenuItem の文字列表現

オーバーライド:

クラス AbstractButton 内の paramString

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JComponent に関連付けられた AccessibleContext を取得します。

定義:

インタフェース Accessible 内の getAccessibleContext

戻り値:

この JComponent の AccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext