javax.swing
類別 JPopupMenu

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPopupMenu

所有已實作的介面：

ImageObserver, MenuContainer, Serializable, Accessible, MenuElement

直接已知子類別：

BasicComboPopup

public class JPopupMenu
extends JComponent
implements Accessible, MenuElement

彈出選單的實作，彈出選單是一個可彈出並顯示一系列選項的小視窗。JPopupMenu 用於使用者在選單欄上選擇項時顯示的選單。它還用於當使用者選擇選單項並啟動它時顯示的“右拉式 (pull-right)”選單。最後，JPopupMenu 還可以在想讓選單顯示的任何其他位置使用。例如，當使用者在指定區域中右擊時。

有關使用彈出選單的範例和資訊，請參閱 The Java Tutorial 中的 How to Use Menus。

警告：Swing 不是執行緒安全的。有關更多資訊，請參閱 Swing's Threading Policy。

警告：此類別的序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲，或適用於在運行相同 Swing 版本的應用程序之間進行 RMI（Remote Method Invocation，遠端方法調用）。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

巢狀類別摘要

protected class	JPopupMenu.AccessibleJPopupMenu 此類別實作 JPopupMenu 類別的可存取性支持。
static class	JPopupMenu.Separator 彈出與選單有關的分隔符。

從類別 javax.swing.JComponent 繼承的巢狀類別/介面

JComponent.AccessibleJComponent

從類別 java.awt.Container 繼承的巢狀類別/介面

Container.AccessibleAWTContainer

從類別 java.awt.Component 繼承的巢狀類別/介面

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

欄位摘要

從類別 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

從介面 java.awt.image.ImageObserver 繼承的欄位

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

建構子摘要

JPopupMenu()
建構一個不帶“調用者”的 JPopupMenu。

JPopupMenu(String label)
建構一個具有指定標題的 JPopupMenu。

方法摘要

JMenuItem	add(Action a) 將指派指定 Action 物件的新選單項添加到選單的末尾。
JMenuItem	add(JMenuItem menuItem) 將指定選單項添加到此選單的末尾。
JMenuItem	add(String s) 創建具有指定文本的選單項，並將其添加到此選單的末尾。
void	addMenuKeyListener(MenuKeyListener l) 將 MenuKeyListener 添加到彈出選單。
void	addPopupMenuListener(PopupMenuListener l) 添加 PopupMenu 偵聽器。
void	addSeparator() 將新分隔符添加到選單的末尾。
protected PropertyChangeListener	createActionChangeListener(JMenuItem b) 返回一個正確配置的 PropertyChangeListener，它在 Action 發生更改時更新控制元件。
protected JMenuItem	createActionComponent(Action a) 該處理器方法為添加到 JPopupMenu 的 Action 創建對應的 JMenuItem。
protected void	firePopupMenuCanceled() 通知 PopupMenuListener 此彈出選單將被取消。
protected void	firePopupMenuWillBecomeInvisible() 通知 PopupMenuListener 此彈出選單將變得不可見。
protected void	firePopupMenuWillBecomeVisible() 通知 PopupMenuListener 此彈出選單將變得可見。
AccessibleContext	getAccessibleContext() 獲取與此 JPopupMenu 關聯的 AccessibleContext。
Component	getComponent() 返回此 JPopupMenu 元件。
Component	getComponentAtIndex(int i) 已過時。 由 Container.getComponent(int) 取代
int	getComponentIndex(Component c) 返回指定元件的索引。
static boolean	getDefaultLightWeightPopupEnabled() 獲取 defaultLightWeightPopupEnabled 屬性，預設情況下，該屬性為 true。
Component	getInvoker() 返回作為此彈出選單的“調用者”的元件。
String	getLabel() 返回彈出選單的標籤。
Insets	getMargin() 返回彈出選單的邊框與其包含內容之間的空白（以像素表示）。
MenuKeyListener[]	getMenuKeyListeners() 返回利用 addMenuKeyListener() 添加到此 JPopupMenu 的所有 MenuKeyListener 組成的陣列。
PopupMenuListener[]	getPopupMenuListeners() 返回利用 addPopupMenuListener() 添加到此 JMenuItem 的所有 PopupMenuListener 組成的陣列。
SingleSelectionModel	getSelectionModel() 返回處理單個選擇的模型物件。
MenuElement[]	getSubElements() 返回 MenuElement 組成的陣列，包含此選單元件的子選單。
PopupMenuUI	getUI() 返回用於呈現此元件的外觀 (L&F) 物件。
String	getUIClassID() 返回用於呈現此元件的 L&F 類別名。
void	insert(Action a, int index) 在給定位置插入指定 Action 物件的選單項。
void	insert(Component component, int index) 將指定元件插入到選單的給定位置。
boolean	isBorderPainted() 檢查是否應該繪製邊框。
boolean	isLightWeightPopupEnabled() 獲取 lightWeightPopupEnabled 屬性。
boolean	isPopupTrigger(MouseEvent e) 如果 JPopupMenu 的當前安裝 UI 將 MouseEvent 視為彈出選單觸發器，則返回 true。
boolean	isVisible() 如果彈出選單可見（當前顯示的），則返回 true。
void	menuSelectionChanged(boolean isIncluded) 當選單欄選擇發生更改以啟動或取消啟動此選單時傳遞訊息。
void	pack() 佈置容器，讓它使用顯示其內容所需的最小空間。
protected void	paintBorder(Graphics g) 如果 borderPainted 屬性為 true，則繪製彈出選單的邊框。
protected String	paramString() 返回此 JPopupMenu 的字元串表示形式。
protected void	processFocusEvent(FocusEvent evt) 處理元件上發生的焦點事件，方法是將其指派到任意已註冊的 FocusListener 物件。
protected void	processKeyEvent(KeyEvent evt) 處理快捷鍵事件，如助記符和加速器。
void	processKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager) 如有必要，通過使用 MenuSelectionManager 的 API 處理從 MenuSelectionManager 轉發的鍵事件並更改選單選擇。
void	processMouseEvent(MouseEvent event, MenuElement[] path, MenuSelectionManager manager) 要求此方法遵守 MenuElement 介面，但它沒有被實作。
void	remove(int pos) 從此彈出選單移除指定索引處的元件。
void	removeMenuKeyListener(MenuKeyListener l) 從彈出選單移除 MenuKeyListener。
void	removePopupMenuListener(PopupMenuListener l) 移除 PopupMenu 偵聽器。
void	setBorderPainted(boolean b) 設置是否應該繪製邊框。
static void	setDefaultLightWeightPopupEnabled(boolean aFlag) 設置 lightWeightPopupEnabled 屬性的預設值。
void	setInvoker(Component invoker) 設置此彈出選單的調用者，即彈出選單在其中顯示的元件。
void	setLabel(String label) 設置彈出選單的標籤。
void	setLightWeightPopupEnabled(boolean aFlag) 設置 lightWeightPopupEnabled 屬性的值，預設情況下該值為 true。
void	setLocation(int x, int y) 使用 X、Y 坐標設置彈出選單的左上角的位置。
void	setPopupSize(Dimension d) 使用 Dimension 物件設置彈出視窗的大小。
void	setPopupSize(int width, int height) 將彈出視窗的大小設置為指定的寬度和高度。
void	setSelected(Component sel) 設置當前選擇的元件，此方法將更改選擇模型。
void	setSelectionModel(SingleSelectionModel model) 設置處理單個選擇的模型物件。
void	setUI(PopupMenuUI ui) 設置呈現此元件的 L&F 物件。
void	setVisible(boolean b) 設置彈出選單的可見性。
void	show(Component invoker, int x, int y) 在元件調用者的坐標空間中的位置 X、Y 顯示彈出選單。
void	updateUI() 將 UI 屬性重置為一個來自當前外觀的值。

從類別 javax.swing.JComponent 繼承的方法

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, 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, isPaintingForPrint, 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, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, unregisterKeyboardAction, update

從類別 java.awt.Container 繼承的方法

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, 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, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, 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, 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, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

JPopupMenu

public JPopupMenu()

建構一個不帶“調用者”的 JPopupMenu。

JPopupMenu

public JPopupMenu(String label)

建構一個具有指定標題的 JPopupMenu。

參數：

label - 可以被 UI 用作彈出選單的標題顯示的字元串。

方法詳細資訊

setDefaultLightWeightPopupEnabled

public static void setDefaultLightWeightPopupEnabled(boolean aFlag)

設置 lightWeightPopupEnabled 屬性的預設值。

參數：

aFlag - 如果彈出選單為輕量級，則為 true；否則為 false

另請參見：

getDefaultLightWeightPopupEnabled(), setLightWeightPopupEnabled(boolean)

getDefaultLightWeightPopupEnabled

public static boolean getDefaultLightWeightPopupEnabled()

獲取 defaultLightWeightPopupEnabled 屬性，預設情況下，該屬性為 true。

返回：

defaultLightWeightPopupEnabled 屬性的值

另請參見：

setDefaultLightWeightPopupEnabled(boolean)

getUI

public PopupMenuUI getUI()

返回用於呈現此元件的外觀 (L&F) 物件。

返回：

呈現此元件的 PopupMenuUI 物件

setUI

public void setUI(PopupMenuUI ui)

設置呈現此元件的 L&F 物件。

參數：

ui - 新 PopupMenuUI L&F 物件

另請參見：

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

將 UI 屬性重置為一個來自當前外觀的值。

覆寫：

類別 JComponent 中的 updateUI

另請參見：

JComponent.updateUI()

getUIClassID

public String getUIClassID()

返回用於呈現此元件的 L&F 類別名。

覆寫：

類別 JComponent 中的 getUIClassID

返回：

字元串 "PopupMenuUI"

另請參見：

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

processFocusEvent

protected void processFocusEvent(FocusEvent evt)

從類別 Component 複製的描述

處理元件上發生的焦點事件，方法是將其指派到任意已註冊的 FocusListener 物件。

如果元件上沒有啟用焦點事件，則不調用此方法。發生下列之一時啟用焦點事件：

• 通過 addFocusListener 註冊了一個 FocusListener 物件。
• 通過 enableEvents 啟用了焦點事件。

如果為某個 Component 啟用了焦點事件，則當前的 KeyboardFocusManager 確定是否應該將焦點事件指派到已註冊的 FocusListener 物件。如果未指派事件，則 KeyboardFocusManager 調用 Component 的 dispatchEvent 方法，此方法又調用 Component 的 processFocusEvent 方法。

如果為 Component 啟用了焦點事件，則用 FocusEvent 作為參數來調用 Component 的 dispatchEvent 方法將導致調用 Component 的 processFocusEvent 方法，而不管當前的 KeyboardFocusManager 如何。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

覆寫：

類別 Component 中的 processFocusEvent

參數：

evt - 焦點事件

另請參見：

FocusEvent, FocusListener, KeyboardFocusManager, Component.addFocusListener(java.awt.event.FocusListener), Component.enableEvents(long), Component.dispatchEvent(java.awt.AWTEvent)

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()

getSelectionModel

public SingleSelectionModel getSelectionModel()

返回處理單個選擇的模型物件。

返回：

selectionModel 屬性

另請參見：

SingleSelectionModel

setSelectionModel

public void setSelectionModel(SingleSelectionModel model)

設置處理單個選擇的模型物件。

參數：

model - 新 SingleSelectionModel

另請參見：

SingleSelectionModel

add

public JMenuItem add(JMenuItem menuItem)

將指定選單項添加到此選單的末尾。

參數：

menuItem - 要添加的 JMenuItem

返回：

已添加的 JMenuItem

add

public JMenuItem add(String s)

創建具有指定文本的選單項，並將其添加到此選單的末尾。

參數：

s - 要添加的選單項的字元串

add

public JMenuItem add(Action a)

將指派指定 Action 物件的新選單項添加到選單的末尾。

參數：

a - 要添加到選單的 Action

返回：

新選單項

另請參見：

Action

createActionComponent

protected JMenuItem createActionComponent(Action a)

該處理器方法為添加到 JPopupMenu 的 Action 創建對應的 JMenuItem。

參數：

a - 要添加的選單項的 Action

返回：

新選單項

從以下版本開始：

1.3

另請參見：

Action

createActionChangeListener

protected PropertyChangeListener createActionChangeListener(JMenuItem b)

返回一個正確配置的 PropertyChangeListener，它在 Action 發生更改時更新控制元件。

remove

public void remove(int pos)

從此彈出選單移除指定索引處的元件。

覆寫：

類別 Container 中的 remove

參數：

pos - 要移除的項的位置

拋出：

IllegalArgumentException - 如果 pos 的值 < 0 或者 pos 的值大於項數

另請參見：

Container.add(java.awt.Component), Container.validate(), Container.getComponentCount()

setLightWeightPopupEnabled

public void setLightWeightPopupEnabled(boolean aFlag)

設置 lightWeightPopupEnabled 屬性的值，預設情況下該值為 true。預設情況下，當外觀顯示彈出選單時，它選擇使用輕量級（純 Java 的）彈出選單。輕量級彈出視窗比重量級（本機同位體）視窗效果更好，但是輕量級和重量級元件在 GUI 中不能很好地混合使用。如果應用程序混合使用輕量級和重量級元件，則應該禁用輕量級彈出視窗。某些外觀可能始終使用重量級彈出選單，不管此屬性的值如何。

參數：

aFlag - 為 false 表示禁用輕量級彈出選單

另請參見：

isLightWeightPopupEnabled()

isLightWeightPopupEnabled

public boolean isLightWeightPopupEnabled()

獲取 lightWeightPopupEnabled 屬性。

返回：

lightWeightPopupEnabled 屬性的值

另請參見：

setLightWeightPopupEnabled(boolean)

getLabel

public String getLabel()

返回彈出選單的標籤。

返回：

包含彈出選單標籤的字元串

另請參見：

setLabel(java.lang.String)

setLabel

public void setLabel(String label)

設置彈出選單的標籤。不同的外觀可以選擇顯示，也可以選擇不顯示這一項。

參數：

label - 指定彈出選單標籤的字元串

另請參見：

setLabel(java.lang.String)

addSeparator

public void addSeparator()

將新分隔符添加到選單的末尾。

insert

public void insert(Action a,
                   int index)

在給定位置插入指定 Action 物件的選單項。

參數：

a - 要插入的 Action 物件

index - 指定插入 Action 的位置，其中 0 為第一個

拋出：

IllegalArgumentException - 如果 index < 0

另請參見：

Action

insert

public void insert(Component component,
                   int index)

將指定元件插入到選單的給定位置。

參數：

component - 要插入的 Component

index - 指定插入元件的位置，其中 0 為第一個

拋出：

IllegalArgumentException - 如果 index < 0

addPopupMenuListener

public void addPopupMenuListener(PopupMenuListener l)

添加 PopupMenu 偵聽器。

參數：

l - 要添加的 PopupMenuListener

removePopupMenuListener

public void removePopupMenuListener(PopupMenuListener l)

移除 PopupMenu 偵聽器。

參數：

l - 要移除的 PopupMenuListener

getPopupMenuListeners

public PopupMenuListener[] getPopupMenuListeners()

返回利用 addPopupMenuListener() 添加到此 JMenuItem 的所有 PopupMenuListener 組成的陣列。

返回：

所有添加的 PopupMenuListener，如果沒有添加偵聽器，則返回一個空陣列

從以下版本開始：

1.4

addMenuKeyListener

public void addMenuKeyListener(MenuKeyListener l)

將 MenuKeyListener 添加到彈出選單。

參數：

l - 要添加的 MenuKeyListener

從以下版本開始：

1.5

removeMenuKeyListener

public void removeMenuKeyListener(MenuKeyListener l)

從彈出選單移除 MenuKeyListener。

參數：

l - 要移除的 MenuKeyListener

從以下版本開始：

1.5

getMenuKeyListeners

public MenuKeyListener[] getMenuKeyListeners()

返回利用 addMenuKeyListener() 添加到此 JPopupMenu 的所有 MenuKeyListener 組成的陣列。

返回：

添加的所有 MenuKeyListener，如果沒有添加偵聽器，則返回一個空陣列

從以下版本開始：

1.5

firePopupMenuWillBecomeVisible

protected void firePopupMenuWillBecomeVisible()

通知 PopupMenuListener 此彈出選單將變得可見。

firePopupMenuWillBecomeInvisible

protected void firePopupMenuWillBecomeInvisible()

通知 PopupMenuListener 此彈出選單將變得不可見。

firePopupMenuCanceled

protected void firePopupMenuCanceled()

通知 PopupMenuListener 此彈出選單將被取消。

pack

public void pack()

佈置容器，讓它使用顯示其內容所需的最小空間。

setVisible

public void setVisible(boolean b)

設置彈出選單的可見性。

覆寫：

類別 JComponent 中的 setVisible

參數：

b - 為 true 表示使彈出選單可見，為 false 表示隱藏它

另請參見：

Component.isVisible()

isVisible

public boolean isVisible()

如果彈出選單可見（當前顯示的），則返回 true。

覆寫：

類別 Component 中的 isVisible

返回：

如果元件是可見的，則返回 true；否則返回 false

另請參見：

Component.setVisible(boolean)

setLocation

public void setLocation(int x,
                        int y)

使用 X、Y 坐標設置彈出選單的左上角的位置。

覆寫：

類別 Component 中的 setLocation

參數：

x - 螢幕坐標空間中彈出選單的新位置的 X 坐標

y - 螢幕坐標空間中彈出選單的新位置的 Y 坐標

另請參見：

Component.getLocation(), Component.setBounds(int, int, int, int)

getInvoker

public Component getInvoker()

返回作為此彈出選單的“調用者”的元件。

返回：

彈出選單在其中顯示的 Component

setInvoker

public void setInvoker(Component invoker)

設置此彈出選單的調用者，即彈出選單在其中顯示的元件。

參數：

invoker - 彈出選單在其中顯示的 Component

show

public void show(Component invoker,
                 int x,
                 int y)

在元件調用者的坐標空間中的位置 X、Y 顯示彈出選單。

參數：

invoker - 彈出選單在其空間中顯示的元件

x - 用於顯示彈出選單的調用者的坐標空間中的 X 坐標

y - 用於顯示彈出選單的調用者的坐標空間中的 Y 坐標

getComponentAtIndex

@Deprecated
public Component getComponentAtIndex(int i)

已過時。 由 Container.getComponent(int) 取代

返回指定索引處的元件。

參數：

i - 元件的索引，其中 0 為第一個

返回：

該索引處的 Component

getComponentIndex

public int getComponentIndex(Component c)

返回指定元件的索引。

參數：

c - 要尋找的 Component

返回：

元件的索引，其中 0 為第一個；如果未找到該元件，則返回 -1

setPopupSize

public void setPopupSize(Dimension d)

使用 Dimension 物件設置彈出視窗的大小。此操作等效於 setPreferredSize(d)。

參數：

d - 指定此元件新的大小的 Dimension。

setPopupSize

public void setPopupSize(int width,
                         int height)

將彈出視窗的大小設置為指定的寬度和高度。此操作等效於 setPreferredSize(new Dimension(width, height))。

參數：

width - 彈出視窗的新寬度（以像素為單位）

height - 彈出視窗的新高度（以像素為單位）

setSelected

public void setSelected(Component sel)

設置當前選擇的元件，此方法將更改選擇模型。

參數：

sel - 要選擇的 Component

isBorderPainted

public boolean isBorderPainted()

檢查是否應該繪製邊框。

返回：

如果繪製邊框，則返回 true；否則返回 false

另請參見：

setBorderPainted(boolean)

setBorderPainted

public void setBorderPainted(boolean b)

設置是否應該繪製邊框。

參數：

b - 如果為 true，則繪製邊框。

另請參見：

isBorderPainted()

paintBorder

protected void paintBorder(Graphics g)

如果 borderPainted 屬性為 true，則繪製彈出選單的邊框。

覆寫：

類別 JComponent 中的 paintBorder

參數：

g - Graphics 物件

另請參見：

JComponent.paint(java.awt.Graphics), JComponent.setBorder(javax.swing.border.Border)

getMargin

public Insets getMargin()

返回彈出選單的邊框與其包含內容之間的空白（以像素表示）。

返回：

包含空白值的 Insets 物件。

paramString

protected String paramString()

返回此 JPopupMenu 的字元串表示形式。此方法僅在進行除錯的時候使用，對於各個實作，所返回字元串的內容和格式可能有所不同。返回的字元串可能為空，但不可能為 null。

覆寫：

類別 JComponent 中的 paramString

返回：

此 JPopupMenu 的字元串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲取與此 JPopupMenu 關聯的 AccessibleContext。對於 JPopupMenus，AccessibleContext 採用 AccessibleJPopupMenu 的形式。必要時創建一個新的 AccessibleJPopupMenu 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 JComponent 中的 getAccessibleContext

返回：

一個 AccessibleJPopupMenu，它充當此 JPopupMenu 的 AccessibleContext

processMouseEvent

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

要求此方法遵守 MenuElement 介面，但它沒有被實作。

指定者：

介面 MenuElement 中的 processMouseEvent

另請參見：

MenuElement.processMouseEvent(MouseEvent, MenuElement[], MenuSelectionManager)

processKeyEvent

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

如有必要，通過使用 MenuSelectionManager 的 API 處理從 MenuSelectionManager 轉發的鍵事件並更改選單選擇。

註：不必將事件轉發到子元件。此操作可以通過 MenuSelectionManager 自動完成。

指定者：

介面 MenuElement 中的 processKeyEvent

參數：

e - KeyEvent

path - MenuElement 路徑陣列

manager - MenuSelectionManager

menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)

當選單欄選擇發生更改以啟動或取消啟動此選單時傳遞訊息。此操作實作 javax.swing.MenuElement 介面。覆寫 MenuElement.menuSelectionChanged。

指定者：

介面 MenuElement 中的 menuSelectionChanged

參數：

isIncluded - 如果此選單處於啟動狀態，則為 true；如果不是，則為 false

另請參見：

MenuElement.menuSelectionChanged(boolean)

getSubElements

public MenuElement[] getSubElements()

返回 MenuElement 組成的陣列，包含此選單元件的子選單。它將只返回遵守 JMenuElement 介面的項。如果彈出選單為 null，則返回空陣列。要求此方法遵守 MenuElement 介面。

指定者：

介面 MenuElement 中的 getSubElements

返回：

MenuElement 物件的陣列

另請參見：

MenuElement.getSubElements()

getComponent

public Component getComponent()

返回此 JPopupMenu 元件。

指定者：

介面 MenuElement 中的 getComponent

返回：

此 JPopupMenu 物件

另請參見：

MenuElement.getComponent()

isPopupTrigger

public boolean isPopupTrigger(MouseEvent e)

如果 JPopupMenu 的當前安裝 UI 將 MouseEvent 視為彈出選單觸發器，則返回 true。

返回：

如果鼠標事件為彈出選單觸發器，則返回 true

從以下版本開始：

1.3