JavaTM 2 Platform
Standard Ed. 5.0

javax.swing
クラス JMenu

java.lang.Object
  上位を拡張 java.awt.Component
      上位を拡張 java.awt.Container
          上位を拡張 javax.swing.JComponent
              上位を拡張 javax.swing.AbstractButton
                  上位を拡張 javax.swing.JMenuItem
                      上位を拡張 javax.swing.JMenu
すべての実装されたインタフェース:
ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, MenuElement, 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」を参照してください。

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

関連項目:
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, 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 に追加される 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 の配列を返します。
 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)
          setAcceleratorJMenu には定義されていません。
 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, addImpl, 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, setLayout, setMargin, setMnemonic, setMnemonic, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition
 
クラス javax.swing.JComponent から継承されたメソッド
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
クラス java.awt.Container から継承されたメソッド
add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, 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, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, 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, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, 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.menuPopupOffsetXMenu.menuPopupOffsetYMenu.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), Container.validate(), JComponent.revalidate()

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

パラメータ:
a - 追加されるメニュー項目の Action
戻り値:
新しいメニュー項目
導入されたバージョン:
1.3
関連項目:
Action

createActionChangeListener

protected PropertyChangeListener createActionChangeListener(JMenuItem b)
Action に対する変更が発生した場合にコントロールを更新する、適切に設定された PropertyChangeListener を返します。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 がメニュー項目の数より大きい場合
関連項目:
Container.add(java.awt.Component)

remove

public void remove(Component c)
このメニューからコンポーネント c を削除します。

オーバーライド:
クラス Container 内の remove
パラメータ:
c - 削除されるコンポーネント
関連項目:
Container.add(java.awt.Component), Container.remove(int)

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 ソースのプロパティを設定するファクトリメソッドです。設定されるプロパティはサブクラスによって異なります。デフォルトでは、設定されるプロパティは TextIconEnabledToolTipTextActionCommand、および 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 インタフェースに適合するために必要です。JSeparatorMenuElement インタフェースに適合しないので、この配列には 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
パラメータ:
o - このメニューおよびこのメニューに含まれるコンポーネントの新しいコンポーネント方向
例外:
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)
setAcceleratorJMenu には定義されていません。代わりに setMnemonic を使用してください。

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

processKeyEvent

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

オーバーライド:
クラス JComponent 内の processKeyEvent
パラメータ:
evt - 処理されるキーイベント
関連項目:
KeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, Component.processEvent(java.awt.AWTEvent), Component.dispatchEvent(java.awt.AWTEvent), 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

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。