javax.swing
クラス JMenu

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

すべての実装インタフェース:

Accessible, ImageObserver, ItemSelectable, MenuContainer, MenuElement, Serializable, SwingConstants

public class JMenu

extends JMenuItem

implements Accessible, MenuElement

メニューの実装であり、ユーザが JMenuBar で項目を選択すると表示される JMenuItem を保持するポップアップウィンドウです。JMenuItem のほかに、JMenu には JSeparator も含めることができます。

メニューというのは実質的には JPopupMenu が割り当てられたボタンのことです。「ボタン」が押されると JPopupMenu が表示されます。「ボタン」が JMenuBar 上にあれば、そのメニューはトップレベルウィンドウです。「ボタン」が別のメニュー項目であれば JPopupMenu は「プルライト」メニューです。

メニューの使用に関する詳細と例については、「The Java Tutorial」の「How to Use Menus」を参照してください。標準の Look & Feel (L&F) 表現でこのコンポーネントが使うキーボードのキーについては、「JMenu のキー割り当て」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 では、すべての JavaBeans^TM の長期間の運用に対するサポートが java.beans パッケージに追加されました。XMLEncoder を参照してください。

関連項目:

JMenuItem, JSeparator, JMenuBar, JPopupMenu

入れ子クラスの概要

protected class	JMenu.AccessibleJMenu このクラスは JMenu クラス用のユーザ補助機能のサポートを実装しています。
protected class	JMenu.WinListener ポップアップウィンドウが閉じられるのを監視するリスナークラスです。

クラス javax.swing.JMenuItem から継承した入れ子クラス

クラス javax.swing.AbstractButton から継承した入れ子クラス

AbstractButton.ButtonChangeListener

クラス javax.swing.JComponent から継承した入れ子クラス

クラス java.awt.Container から継承した入れ子クラス

クラス java.awt.Component から継承した入れ子クラス

Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

protected JMenu.WinListener

popupListener ポップアップ用の、ウィンドウを閉じるためのリスナーです。

クラス 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

インタフェース javax.swing.SwingConstants から継承したフィールド

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

インタフェース java.awt.image.ImageObserver から継承したフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタの概要

JMenu()
テキストのない新しい JMenu を作成します。

JMenu(Action a)
指定された Action からプロパティを取得するメニューを作成します。

JMenu(String s)
指定された文字列をテキストとして持つ新しい JMenu を作成します。

JMenu(String s, boolean b)
指定された文字列をテキストとして持ち、ティアオフメニューかどうかを指定された、新しい JMenu を作成します。

メソッドの概要

JMenuItem	add(Action a) 指定された Action オブジェクトに属する新しいメニュー項目を作成し、それをこのメニューの末尾に追加します。
Component	add(Component c) このメニューの最後にコンポーネントを追加します。
Component	add(Component c, int index) 指定されたコンポーネントをこのコンテナの指定された位置に追加します。
JMenuItem	add(JMenuItem menuItem) このメニューの最後にメニュー項目を追加します。
JMenuItem	add(String s) 指定されたテキストを持つ新しいメニュー項目を作成して、このメニューの末尾に追加します。
void	addMenuListener(MenuListener l) メニューイベントのリスナーを追加します。
void	addSeparator() メニューの最後に新しいセパレータを追加します。
void	applyComponentOrientation(ComponentOrientation o) このメニューおよびこのメニューに含まれるすべてのコンポーネントの ComponentOrientation プロパティを設定します。
protected void	configurePropertiesFromAction(Action a) Action インスタンスの値に従って ActionEvent ソースのプロパティを設定するファクトリメソッドです。
protected PropertyChangeListener	createActionChangeListener(JMenuItem b) Action に対する変更が発生した場合にコントロールを更新する、適切に設定された PropertyChangeListener を返します。
protected JMenuItem	createActionComponent(Action a) JMenu に追加される Action の JMenuItem を作成するファクトリメソッドです。
protected JMenu.WinListener	createWinListener(JPopupMenu p) ポップアップのウィンドウを閉じるリスナーを作成します。
void	doClick(int pressTime) 「クリック」をプログラム上で実行します。
protected void	fireMenuCanceled() 通知の配信対象を、指定されたイベントタイプで登録したすべてのリスナーに通知します。
protected void	fireMenuDeselected() 通知の配信対象を、指定されたイベントタイプで登録したすべてのリスナーに通知します。
protected void	fireMenuSelected() 通知の配信対象を、指定されたイベントタイプで登録したすべてのリスナーに通知します。
AccessibleContext	getAccessibleContext() この JMenu に関連した AccessibleContext を返します。
Component	getComponent() この MenuElement をペイントするのに使われる java.awt.Component を返します。
int	getDelay() サブメニューを表示または非表示にするまでの、推奨される遅延時間をミリ秒単位で返します。
JMenuItem	getItem(int pos) 指定された位置の JMenuItem を返します。
int	getItemCount() セパレータを含めたメニュー項目数を返します。
Component	getMenuComponent(int n) n の位置にあるコンポーネントを返します。
int	getMenuComponentCount() メニューのコンポーネント数を返します。
Component[]	getMenuComponents() メニューのサブコンポーネントの Component の配列を返します。
MenuListener[]	getMenuListeners() この JMenu に addMenuListener() で追加されたすべての MenuListener の配列を返します。
JPopupMenu	getPopupMenu() このメニューに関連したポップアップメニューを返します。
protected Point	getPopupMenuOrigin() JMenu のポップアップメニューの原点を計算します。
MenuElement[]	getSubElements() このメニューコンポーネントのサブメニューを格納する MenuElement の配列を返します。
String	getUIClassID() このコンポーネントを描画する L&F クラスの名前を返します。
JMenuItem	insert(Action a, int pos) 指定された Action オブジェクトに属する新しいメニュー項目を、指定された位置に挿入します。
JMenuItem	insert(JMenuItem mi, int pos) 指定された JMenuItem を指定された位置に挿入します。
void	insert(String s, int pos) 指定されたテキストを持つ新しいメニュー項目を、指定された位置に挿入します。
void	insertSeparator(int index) 指定された位置にセパレータを挿入します。
boolean	isMenuComponent(Component c) 指定されたコンポーネントがサブメニュー階層内にある場合に true を返します。
boolean	isPopupMenuVisible() メニューのポップアップウィンドウが可視の場合に true を返します。
boolean	isSelected() メニューが現在選択されている (強調表示されている) 場合に true を返します。
boolean	isTearOff() メニューがティアオフ可能な場合に true を返します。
boolean	isTopLevelMenu() メニューが「トップレベルメニュー」の場合に true を返します。
void	menuSelectionChanged(boolean isIncluded) このメニューをアクティブにするか、アクティブではなくするためにメニューバーの選択が変更されたときに、メッセージを送ります。
protected String	paramString() この JMenu の文字列表現を返します。
protected void	processKeyEvent(KeyEvent evt) ニーモニックやアクセラレータなどの、キーストロークイベントを処理します。
void	remove(Component c) このメニューからコンポーネント c を削除します。
void	remove(int pos) このメニューから、指定されたインデックスにあるメニュー項目を削除します。
void	remove(JMenuItem item) 指定されたメニューをこのメニューから削除します。
void	removeAll() このメニューからメニュー項目をすべて削除します。
void	removeMenuListener(MenuListener l) メニューイベントのリスナーを削除します。
void	setAccelerator(KeyStroke keyStroke) setAccelerator は JMenu には定義されていません。
void	setComponentOrientation(ComponentOrientation o) このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を設定します。
void	setDelay(int d) メニューの PopupMenu を表示または非表示にするまでの、推奨される遅延時間をミリ秒単位で返します。
void	setMenuLocation(int x, int y) ポップアップコンポーネントの位置を設定します。
void	setModel(ButtonModel newModel) 「メニューボタン」のデータモデルを設定します。
void	setPopupMenuVisible(boolean b) メニューのポップアップの可視性を設定します。
void	setSelected(boolean b) メニューの選択状態を設定します。
void	updateUI() 現在の Look & Feel からの値を持つ UI プロパティをリセットします。

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

addMenuDragMouseListener, addMenuKeyListener, createActionPropertyChangeListener, fireMenuDragMouseDragged, fireMenuDragMouseEntered, fireMenuDragMouseExited, fireMenuDragMouseReleased, fireMenuKeyPressed, fireMenuKeyReleased, fireMenuKeyTyped, getAccelerator, getMenuDragMouseListeners, getMenuKeyListeners, init, isArmed, processKeyEvent, processMenuDragMouseEvent, processMenuKeyEvent, processMouseEvent, removeMenuDragMouseListener, removeMenuKeyListener, setArmed, setEnabled, setUI

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

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

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

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

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

add, add, add, addContainerListener, addImpl, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

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

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

インタフェース javax.swing.MenuElement から継承したメソッド

processKeyEvent, processMouseEvent

フィールドの詳細

popupListener

protected JMenu.WinListener popupListener

ポップアップ用の、ウィンドウを閉じるためのリスナーです。

関連項目:

JMenu.WinListener

コンストラクタの詳細

JMenu

public JMenu()

テキストのない新しい JMenu を作成します。

JMenu

public JMenu(String s)

指定された文字列をテキストとして持つ新しい JMenu を作成します。

パラメータ:

s - メニューラベルのテキスト

JMenu

public JMenu(Action a)

指定された Action からプロパティを取得するメニューを作成します。

パラメータ:

a - Action

導入されたバージョン:

1.3

JMenu

public JMenu(String s,
             boolean b)

指定された文字列をテキストとして持ち、ティアオフメニューかどうかを指定された、新しい JMenu を作成します。

パラメータ:

s - メニューラベルのテキスト

b - メニューがティアオフできるかどうか (まだ実装されていない)

メソッドの詳細

updateUI

public void updateUI()

現在の Look & Feel からの値を持つ UI プロパティをリセットします。

オーバーライド:

クラス JMenuItem 内の updateUI

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

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

オーバーライド:

クラス JMenuItem 内の getUIClassID

戻り値:

文字列「MenuUI」

関連項目:

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

setModel

public void setModel(ButtonModel newModel)

「メニューボタン」のデータモデルを設定します。これは、ユーザがクリックしてメニューを開いたり閉じたりするラベルです。

オーバーライド:

クラス AbstractButton 内の setModel

パラメータ:

newModel - ButtonModel

関連項目:

AbstractButton.getModel()

isSelected

public boolean isSelected()

メニューが現在選択されている (強調表示されている) 場合に true を返します。

オーバーライド:

クラス AbstractButton 内の isSelected

戻り値:

メニューが選択されている場合は true、そうでない場合は false

setSelected

public void setSelected(boolean b)

メニューの選択状態を設定します。

オーバーライド:

クラス AbstractButton 内の setSelected

パラメータ:

b - メニューを選択する (強調表示する) 場合は true、メニューを選択解除する場合は false

isPopupMenuVisible

public boolean isPopupMenuVisible()

メニューのポップアップウィンドウが可視の場合に true を返します。

戻り値:

メニューが可視の場合は true、そうでない場合は false

setPopupMenuVisible

public void setPopupMenuVisible(boolean b)

メニューのポップアップの可視性を設定します。メニューが使用可能でない場合は、このメソッドは無効です。

パラメータ:

b - boolean 値。メニューを可視にする場合は true、隠す場合は false

getPopupMenuOrigin

protected Point getPopupMenuOrigin()

JMenu のポップアップメニューの原点を計算します。このメソッドは、ポップアップの正確な位置を調整するため、Menu.menuPopupOffsetX、Menu.menuPopupOffsetY、Menu.submenuPopupOffsetX、および Menu.submenuPopupOffsetY という名前の Look & Feel プロパティを使用します。

戻り値:

JMenu のポップアップメニューの原点として使う、メニューの座標空間にある Point

導入されたバージョン:

1.3

getDelay

public int getDelay()

サブメニューを表示または非表示にするまでの、推奨される遅延時間をミリ秒単位で返します。各 Look & Feel (L&F) は、delay プロパティを監視するための独自のポリシーを決定できます。ほとんどの場合、トップレベルメニューの遅延、あるいはドラッグ中の遅延は監視されません。delay のデフォルトは 0 です。このメソッドは Look & Feel コードのプロパティであり、さまざまな UI 実装の特質の管理に使われます。

戻り値:

delay プロパティ

setDelay

public void setDelay(int d)

メニューの PopupMenu を表示または非表示にするまでの、推奨される遅延時間をミリ秒単位で返します。各 Look & Feel (L&F) は、遅延プロパティを監視するための独自のポリシーを決定できます。ほとんどの場合、トップレベルメニューの遅延、あるいはドラッグ中の遅延は監視されません。このメソッドは Look & Feel コードのプロパティであり、さまざまな UI 実装の特質を管理するのに使われます。

パラメータ:

d - 遅延のミリ秒数

例外:

IllegalArgumentException - d が 0 未満の場合

setMenuLocation

public void setMenuLocation(int x,
                            int y)

ポップアップコンポーネントの位置を設定します。

パラメータ:

x - ポップアップメニューの新しい位置の x 座標

y - ポップアップメニューの新しい位置の y 座標

add

public JMenuItem add(JMenuItem menuItem)

このメニューの最後にメニュー項目を追加します。追加されたメニュー項目を返します。

パラメータ:

menuItem - 追加する JMenuItem

戻り値:

追加された JMenuItem

add

public Component add(Component c)

このメニューの最後にコンポーネントを追加します。追加されたコンポーネントを返します。

オーバーライド:

クラス Container 内の add

パラメータ:

c - 追加する Component

戻り値:

追加された Component

関連項目:

Container.addImpl(java.awt.Component, java.lang.Object, int)

add

public Component add(Component c,
                     int index)

指定されたコンポーネントをこのコンテナの指定された位置に追加します。index が -1 の場合、コンポーネントは末尾に追加されます。

オーバーライド:

クラス Container 内の add

パラメータ:

c - 追加する Component

index - コンポーネントを挿入する位置

戻り値:

追加された Component

関連項目:

remove(javax.swing.JMenuItem), Container.add(Component, int)

add

public JMenuItem add(String s)

指定されたテキストを持つ新しいメニュー項目を作成して、このメニューの末尾に追加します。

パラメータ:

s - 追加されるメニュー項目の文字列

add

public JMenuItem add(Action a)

指定された Action オブジェクトに属する新しいメニュー項目を作成し、それをこのメニューの末尾に追加します。1.3 以降は、これはコンテナに Action を追加するメソッドとしてはお勧めしません。代わりに、setAction を使ってアクションを持つコントロールを設定し、そのコントロールを直接 Container に追加することをお勧めします。

パラメータ:

a - 追加されるメニュー項目の Action

関連項目:

Action

createActionComponent

protected JMenuItem createActionComponent(Action a)

JMenu に追加される Action の JMenuItem を作成するファクトリメソッドです。1.3 以降は、このメソッドはお勧めしません。代わりに、setAction を使ってアクションを持つコントロールを設定し、そのコントロールを直接 Container に追加することをお勧めします。

パラメータ:

a - 追加されるメニュー項目の Action

戻り値:

新しいメニュー項目

導入されたバージョン:

1.3

関連項目:

Action

createActionChangeListener

protected PropertyChangeListener createActionChangeListener(JMenuItem b)

Action に対する変更が発生した場合にコントロールを更新する、適切に設定された PropertyChangeListener を返します。1.3 以降は、これは Container に Actions を追加するメソッドとしてはお勧めしません。代わりに、setAction を使ってアクションを持つコントロールを設定し、そのコントロールを直接 Container に追加することをお勧めします。

addSeparator

public void addSeparator()

メニューの最後に新しいセパレータを追加します。

insert

public void insert(String s,
                   int pos)

指定されたテキストを持つ新しいメニュー項目を、指定された位置に挿入します。

パラメータ:

s - 追加するメニュー項目のテキスト

pos - 新しいメニュー項目を追加する位置を指定する整数

例外:

IllegalArgumentException - pos の値が 0 より小さい場合

insert

public JMenuItem insert(JMenuItem mi,
                        int pos)

指定された JMenuItem を指定された位置に挿入します。

パラメータ:

mi - 追加する JMenuItem

pos - 新しい JMenuItem を追加する位置を指定する整数

戻り値:

新しいメニュー項目

例外:

IllegalArgumentException - pos の値が 0 より小さい場合

insert

public JMenuItem insert(Action a,
                        int pos)

指定された Action オブジェクトに属する新しいメニュー項目を、指定された位置に挿入します。

パラメータ:

a - 追加するメニュー項目の Action オブジェクト

pos - 新しいメニュー項目を追加する位置を指定する整数

例外:

IllegalArgumentException - pos の値が 0 より小さい場合

insertSeparator

public void insertSeparator(int index)

指定された位置にセパレータを挿入します。

パラメータ:

index - メニューセパレータを挿入する位置を指定する整数

例外:

IllegalArgumentException - index の値が 0 より小さい場合

getItem

public JMenuItem getItem(int pos)

指定された位置の JMenuItem を返します。pos のコンポーネントがメニュー項目でない場合は、null が返されます。このメソッドは AWT の互換性のために用意されています。

パラメータ:

pos - 位置を指定する整数

戻り値:

指定された位置のメニュー項目。指定された位置の項目がメニュー項目でない場合は null

例外:

IllegalArgumentException - pos の値が 0 より小さい場合

getItemCount

public int getItemCount()

セパレータを含めたメニュー項目数を返します。このメソッドは AWT の互換性のために用意されています。

戻り値:

メニューの項目数を表す整数

関連項目:

getMenuComponentCount()

isTearOff

public boolean isTearOff()

メニューがティアオフ可能な場合に true を返します。このメソッドはまだ実装されていません。

戻り値:

メニューがティアオフ可能な場合は true、そうでない場合は false

例外:

Error - 呼び出された場合。このメソッドはまだ実装されていない

remove

public void remove(JMenuItem item)

指定されたメニューをこのメニューから削除します。ポップアップメニューがない場合は、このメソッドは無効です。

パラメータ:

item - メニューから削除する JMenuItem

remove

public void remove(int pos)

このメニューから、指定されたインデックスにあるメニュー項目を削除します。

オーバーライド:

クラス Container 内の remove

パラメータ:

pos - 削除される項目の位置

例外:

IllegalArgumentException - pos の値が 0 より小さいか、pos がメニュー項目の数より大きい場合

関連項目:

Container.add(java.awt.Component)

remove

public void remove(Component c)

このメニューからコンポーネント c を削除します。

オーバーライド:

クラス Container 内の remove

パラメータ:

c - 削除されるコンポーネント

関連項目:

Container.add(java.awt.Component)

removeAll

public void removeAll()

このメニューからメニュー項目をすべて削除します。

オーバーライド:

クラス Container 内の removeAll

関連項目:

Container.add(java.awt.Component), Container.remove(int)

getMenuComponentCount

public int getMenuComponentCount()

メニューのコンポーネント数を返します。

戻り値:

メニューのコンポーネント数を表す整数

getMenuComponent

public Component getMenuComponent(int n)

n の位置にあるコンポーネントを返します。

パラメータ:

n - 返されるコンポーネントの位置

戻り値:

要求されたコンポーネント。ポップアップメニューがない場合は null

getMenuComponents

public Component[] getMenuComponents()

メニューのサブコンポーネントの Component の配列を返します。セパレータを含め、ポップアップメニューにあるすべての Component を返します。

戻り値:

Component の配列。ポップアップメニューがない場合は空の配列

isTopLevelMenu

public boolean isTopLevelMenu()

メニューが「トップレベルメニュー」の場合に true を返します。トップレベルとはメニューがメニューバーの直接の子の場合を示します。

戻り値:

メニューがメニューバーからアクティブにされる場合は true、別のメニューのメニュー項目からアクティブにされる場合は false

isMenuComponent

public boolean isMenuComponent(Component c)

指定されたコンポーネントがサブメニュー階層内にある場合に true を返します。

パラメータ:

c - 判定対象の Component

戻り値:

Component が存在する場合は true、そうでない場合は false

getPopupMenu

public JPopupMenu getPopupMenu()

このメニューに関連したポップアップメニューを返します。ポップアップメニューがない場合は、ポップアップメニューを作成します。

addMenuListener

public void addMenuListener(MenuListener l)

メニューイベントのリスナーを追加します。

パラメータ:

l - 追加されるリスナー

removeMenuListener

public void removeMenuListener(MenuListener l)

メニューイベントのリスナーを削除します。

パラメータ:

l - 削除されるリスナー

getMenuListeners

public MenuListener[] getMenuListeners()

この JMenu に addMenuListener() で追加されたすべての MenuListener の配列を返します。

戻り値:

追加されたすべての MenuListener。追加されたリスナーがない場合は空の配列

導入されたバージョン:

1.4

fireMenuSelected

protected void fireMenuSelected()

通知の配信対象を、指定されたイベントタイプで登録したすべてのリスナーに通知します。イベントのインスタンスはあとで生成されます。

例外:

Error - null リスナーが存在する場合

関連項目:

EventListenerList

fireMenuDeselected

protected void fireMenuDeselected()

通知の配信対象を、指定されたイベントタイプで登録したすべてのリスナーに通知します。イベントのインスタンスはあとで生成されます。

例外:

Error - null リスナーが存在する場合

関連項目:

EventListenerList

fireMenuCanceled

protected void fireMenuCanceled()

通知の配信対象を、指定されたイベントタイプで登録したすべてのリスナーに通知します。イベントのインスタンスはあとで生成されます。

例外:

Error - null リスナーが存在する場合

関連項目:

EventListenerList

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

Action インスタンスの値に従って ActionEvent ソースのプロパティを設定するファクトリメソッドです。設定されるプロパティはサブクラスによって異なります。デフォルトでは、設定されるプロパティは Text、Icon、Enabled、ToolTipText、ActionCommand、および Mnemonic です。

オーバーライド:

クラス JMenuItem 内の configurePropertiesFromAction

パラメータ:

a - プロパティを取得する Action、または null

導入されたバージョン:

1.4

関連項目:

Action, AbstractButton.setAction(javax.swing.Action)

createWinListener

protected JMenu.WinListener createWinListener(JPopupMenu p)

ポップアップのウィンドウを閉じるリスナーを作成します。

パラメータ:

p - JPopupMenu

戻り値:

ウィンドウを閉じる新しいリスナー

関連項目:

JMenu.WinListener

menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)

このメニューをアクティブにするか、アクティブではなくするためにメニューバーの選択が変更されたときに、メッセージを送ります。JMenuItem.menuSelectionChanged をオーバーライドします。

定義:

インタフェース MenuElement 内の menuSelectionChanged

オーバーライド:

クラス JMenuItem 内の menuSelectionChanged

パラメータ:

isIncluded - このメニューがアクティブな場合は true、そうでない場合は false

関連項目:

MenuSelectionManager.setSelectedPath(MenuElement[])

getSubElements

public MenuElement[] getSubElements()

このメニューコンポーネントのサブメニューを格納する MenuElement の配列を返します。ポップアップメニューが null の場合は空の配列を返します。このメソッドは、MenuElement インタフェースに適合するために必要です。JSeparator は MenuElement インタフェースに適合しないので、この配列には JMenuItem だけが含まれます。

定義:

インタフェース MenuElement 内の getSubElements

オーバーライド:

クラス JMenuItem 内の getSubElements

戻り値:

MenuElement オブジェクトの配列

getComponent

public Component getComponent()

この MenuElement をペイントするのに使われる java.awt.Component を返します。返されたコンポーネントは、イベントを変換し、イベントが発生した場所がメニューコンポーネント内であるかどうかを検出するために使われます。

定義:

インタフェース MenuElement 内の getComponent

オーバーライド:

クラス JMenuItem 内の getComponent

戻り値:

Component 値

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation o)

このメニューおよびこのメニューに含まれるすべてのコンポーネントの ComponentOrientation プロパティを設定します。これには getMenuComponents によって返されたすべてのコンポーネントが含まれます。

オーバーライド:

クラス Container 内の applyComponentOrientation

例外:

NullPointerException - orientation が null の場合

導入されたバージョン:

1.4

関連項目:

Component.setComponentOrientation(java.awt.ComponentOrientation), Component.getComponentOrientation()

setComponentOrientation

public void setComponentOrientation(ComponentOrientation o)

クラス Component の記述:

このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を設定します。言語に依存する LayoutManager サブクラスおよび Component サブクラスはこのプロパティを使用してコンポーネントの配置方法および描画方法を決めます。

構築時には、コンポーネントの方向は、明示的に指定されていないことを示す ComponentOrientation.UNKNOWN に設定されます。UNKNOWN の方向の動作は ComponentOrientation.LEFT_TO_RIGHT と同じです。

コンポーネントの方向決定を単独で行う場合はこのメソッドを使用します。コンポーネント階層全体の方向を決定する場合は、applyComponentOrientation を使用します。

オーバーライド:

クラス Component 内の setComponentOrientation

関連項目:

ComponentOrientation

setAccelerator

public void setAccelerator(KeyStroke keyStroke)

setAccelerator は JMenu には定義されていません。代わりに setMnemonic を使用してください。

オーバーライド:

クラス JMenuItem 内の setAccelerator

パラメータ:

keyStroke - メニュー階層を移動することなく JMenuItem のアクションリスナーを呼び出すキーストロークの組み合わせ

例外:

Error - 呼び出された場合。このメソッドは JMenu には定義されていない。代わりに setMnemonic を使用

processKeyEvent

protected void processKeyEvent(KeyEvent evt)

ニーモニックやアクセラレータなどの、キーストロークイベントを処理します。

オーバーライド:

クラス JComponent 内の processKeyEvent

パラメータ:

evt - 処理されるキーイベント

関連項目:

KeyEvent, KeyListener, Component.addKeyListener(java.awt.event.KeyListener), Component.enableEvents(long), Component.isShowing()

doClick

public void doClick(int pressTime)

「クリック」をプログラム上で実行します。このメソッドはメニューを表示するために AbstractButton.doClick メソッドをオーバーライドします。

オーバーライド:

クラス AbstractButton 内の doClick

パラメータ:

pressTime - ボタンが押されたミリ秒数

paramString

protected String paramString()

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

オーバーライド:

クラス JMenuItem 内の paramString

戻り値:

この JMenu の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JMenu に関連した AccessibleContext を返します。JMenu の場合、AccessibleContext は AccessibleJMenu の形式を取ります。必要に応じて新規の AccessibleJMenu インスタンスが作成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス JMenuItem 内の getAccessibleContext

戻り値:

この JMenu の AccessibleContext として機能する AccessibleJMenu