JavaTM 2 Platform
Std. Ed. v1.3

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 に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:
JMenuItem, JSeparator, JMenuBar, JPopupMenu, 直列化された形式

内部クラスの概要
protected  class JMenu.AccessibleJMenu
          このクラスは JMenu クラス用のユーザ補助機能のサポートを実装しています。
protected  class JMenu.WinListener
          ポップアップウィンドウが閉じられるのを監視するリスナークラスです。
 
クラス javax.swing.JMenuItem から継承した内部クラス
JMenuItem.AccessibleJMenuItem
 
クラス javax.swing.AbstractButton から継承した内部クラス
AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener
 
クラス javax.swing.JComponent から継承した内部クラス
JComponent.AccessibleJComponent
 
クラス java.awt.Container から継承した内部クラス
Container.AccessibleAWTContainer
 
クラス java.awt.Component から継承した内部クラス
Component.AccessibleAWTComponent
 
フィールドの概要
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, NORTH, NORTH_EAST, NORTH_WEST, 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()
          メニューの最後に新しいセパレータを追加します。
protected  PropertyChangeListener createActionChangeListener(JMenuItem b)
          Action に対する変更が発生した場合にコントロールを更新する、適切に設定された PropertyChangeListener を返します。
protected  JMenuItem createActionComponent(Action a)
          JMenu に追加される ActionJMenuItem を作成するファクトリメソッドです。
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 の配列を返します。
 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 e)
          ニーモニックやアクセラレータなどの、このメニューのキーストロークイベントを処理します。
 void remove(Component c)
          このメニューからコンポーネント c を削除します。
 void remove(int pos)
          このメニューから、指定されたインデックスにあるメニュー項目を削除します。
 void remove(JMenuItem item)
          指定されたメニューをこのメニューから削除します。
 void removeAll()
          このメニューからメニュー項目をすべて削除します。
 void removeMenuListener(MenuListener l)
          メニューイベントのリスナーを削除します。
 void setAccelerator(KeyStroke keyStroke)
          setAcceleratorJMenu には定義されていません。
 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()
          L&F が変更されたことを示す UIFactory からの通知です。
 
クラス javax.swing.JMenuItem から継承したメソッド
addMenuDragMouseListener, addMenuKeyListener, configurePropertiesFromAction, createActionPropertyChangeListener, fireMenuDragMouseDragged, fireMenuDragMouseEntered, fireMenuDragMouseExited, fireMenuDragMouseReleased, fireMenuKeyPressed, fireMenuKeyReleased, fireMenuKeyTyped, getAccelerator, 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, getDisabledIcon, getDisabledSelectedIcon, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getLabel, getMargin, getMnemonic, getModel, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getSelectedObjects, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, isBorderPainted, isContentAreaFilled, isFocusPainted, isFocusTraversable, isRolloverEnabled, paintBorder, removeActionListener, removeChangeListener, removeItemListener, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setFocusPainted, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setLabel, setMargin, setMnemonic, setMnemonic, 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, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
クラス java.awt.Container から継承したメソッド
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, printComponents, processContainerEvent, processEvent, removeContainerListener, setLayout, validate, validateTree
 
クラス java.awt.Component から継承したメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, 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, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, 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
 
インタフェース 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()
L&F が変更されたことを示す UIFactory からの通知です。UI を UIFactory からの最新バージョンに置き換えるために呼び出されます。
オーバーライド:
クラス 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 のポップアップメニューの原点を計算します。
戻り値:
JMenu のポップアップメニューの原点として使う、メニューの座標空間にある Point

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

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 オブジェクトに属する新しいメニュー項目を作成し、それをこのメニューの末尾に追加します。JDK 1.3 以降は、これはコンテナに Action を追加するメソッドとしてはお勧めしません。代わりに、setAction を使ってアクションを持つコントロールを設定し、そのコントロールを直接 Container に追加することをお勧めします。
パラメータ:
a - 追加するメニュー項目の Action
関連項目:
Action

createActionComponent

protected JMenuItem createActionComponent(Action a)
JMenu に追加される ActionJMenuItem を作成するファクトリメソッドです。JDK 1.3 以降は、このメソッドはお勧めしません。代わりに、setAction を使ってアクションを持つコントロールを設定し、そのコントロールを直接 Container に追加することをお勧めします。
パラメータ:
a - 追加するメニュー項目の Action
戻り値:
新しいメニュー項目
関連項目:
Action

createActionChangeListener

protected PropertyChangeListener createActionChangeListener(JMenuItem b)
Action に対する変更が発生した場合にコントロールを更新する、適切に設定された PropertyChangeListener を返します。JDK 1.3 以降は、これは ContainerActions を追加するメソッドとしてはお勧めしません。代わりに、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 がメニュー項目の数より大きい場合

remove

public void remove(Component c)
このメニューからコンポーネント c を削除します。
オーバーライド:
クラス Container 内の remove
パラメータ:
c - 削除するコンポーネント

removeAll

public void removeAll()
このメニューからメニュー項目をすべて削除します。
オーバーライド:
クラス Container 内の removeAll
クラス java.awt.Container からコピーされたタグ:
関連項目:
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 - 削除するリスナー

fireMenuSelected

protected void fireMenuSelected()
このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。fire メソッドに渡されたパラメータを使用して、イベントのインスタンスはゆっくりと生成されます。
例外:
Error - null リスナーが存在する場合
関連項目:
EventListenerList

fireMenuDeselected

protected void fireMenuDeselected()
このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。fire メソッドに渡されたパラメータを使用して、イベントのインスタンスはゆっくりと生成されます。
例外:
Error - null リスナーが存在する場合
関連項目:
EventListenerList

fireMenuCanceled

protected void fireMenuCanceled()
このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。fire メソッドに渡されたパラメータを使用して、イベントのインスタンスはゆっくりと生成されます。
例外:
Error - null リスナーが存在する場合
関連項目:
EventListenerList

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

getSubElements

public MenuElement[] getSubElements()
このメニューコンポーネントのサブメニューを格納する MenuElement の配列を返します。ポップアップメニューが null の場合は空の配列を返します。このメソッドは、MenuElement インタフェースに適合するために必要です。JSeparatorMenuElement インタフェースに適合しないので、この配列には JMenuItem だけが含まれます。
定義:
インタフェース MenuElement 内の getSubElements
オーバーライド:
クラス JMenuItem 内の getSubElements
戻り値:
MenuElement オブジェクトの配列

getComponent

public Component getComponent()
この MenuElement をペイントするのに使われる java.awt.Component を返します。返されたコンポーネントは、イベントを変換し、イベントが発生した場所がメニューコンポーネント内であるかどうかを検出するために使われます。
定義:
インタフェース MenuElement 内の getComponent
オーバーライド:
クラス JMenuItem 内の getComponent
インタフェース javax.swing.MenuElement からコピーされたタグ:
戻り値:
Component 値

setAccelerator

public void setAccelerator(KeyStroke keyStroke)
setAcceleratorJMenu には定義されていません。代わりに setMnemonic を使用してください。
オーバーライド:
クラス JMenuItem 内の setAccelerator
パラメータ:
keyStroke - メニュー階層を移動することなく JMenuItem のアクションリスナーを呼び出すキーストロークの組み合わせ
例外:
Error - 呼び出された場合。このメソッドは JMenu には定義されていない。代わりに setMnemonic を使用

processKeyEvent

protected void processKeyEvent(KeyEvent e)
ニーモニックやアクセラレータなどの、このメニューのキーストロークイベントを処理します。
オーバーライド:
クラス JComponent 内の processKeyEvent
パラメータ:
e - 処理されるキーイベント

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

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.