Spec-Zone.ru › OpenJDK 25

Класс JPopupMenu

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JPopupMenu
Все реализуемые интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, MenuElement
Прямые известные подклассы:
BasicComboPopup
@JavaBean(defaultProperty="UI", description="A small window that pops up and displays a series of choices.") public class JPopupMenu extends JComponent implements Accessible, MenuElement
Реализация всплывающего меню — небольшого окна, которое появляется и отображает набор вариантов. JPopupMenu используется для меню, которое появляется, когда пользователь выбирает пункт в строке меню. Оно также используется для меню с подменю, которое появляется, когда пользователь выбирает пункт меню, открывающий его. Наконец, JPopupMenu можно использовать и в любом другом месте, где требуется отобразить меню. Например, когда пользователь щёлкает правой кнопкой мыши в указанной области.

Сведения и примеры использования всплывающих меню см. в разделе Использование меню в учебнике по Java.

Предупреждение: Swing не является потокобезопасной библиотекой. Дополнительную информацию см. в разделе Политика Swing в отношении потоков.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, в пакет java.beans добавлена поддержка долгосрочного хранения всех JavaBeans. См. XMLEncoder.

Начиная с версии:
1.2

Краткое описание вложенных классов

Модификатор и тип Класс Описание
protected class  JPopupMenu.AccessibleJPopupMenu
Этот класс реализует поддержку специальных возможностей для класса JPopupMenu.
static class  JPopupMenu.Separator
Разделитель, предназначенный для всплывающих меню.

Вложенные классы и интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent

Вложенные классы и интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer

Вложенные классы и интерфейсы, объявленные в классе Component

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

Краткое описание полей

Поля, объявленные в классе JComponent

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

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе ImageObserver

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

Краткое описание конструкторов

Конструктор Описание
JPopupMenu()
Создаёт JPopupMenu без «инициатора».
JPopupMenu(String label)
Создаёт JPopupMenu с указанным заголовком.

Краткое описание методов

Модификатор и тип Метод Описание
JMenuItem add(String s)
Создаёт новый пункт меню с указанным текстом и добавляет его в конец этого меню.
JMenuItem add(Action a)
Добавляет новый пункт меню в конец меню; при его выборе отправляется указанный объект Action.
JMenuItem add(JMenuItem menuItem)
Добавляет указанный пункт меню в конец этого меню.
void addMenuKeyListener(MenuKeyListener l)
Добавляет MenuKeyListener во всплывающее меню.
void addPopupMenuListener(PopupMenuListener l)
Добавляет слушателя PopupMenu.
void addSeparator()
Добавляет новый разделитель в конец меню.
protected PropertyChangeListener createActionChangeListener(JMenuItem b)
Возвращает правильно настроенный PropertyChangeListener, который обновляет элемент управления при изменении Action.
protected JMenuItem createActionComponent(Action a)
Фабричный метод, создающий JMenuItem для Actions, добавленного в JPopupMenu.
protected void firePopupMenuCanceled()
Уведомляет PopupMenuListeners об отмене этого всплывающего меню.
protected void firePopupMenuWillBecomeInvisible()
Уведомляет слушателей PopupMenuListener о том, что это всплывающее меню станет невидимым.
protected void firePopupMenuWillBecomeVisible()
Уведомляет слушателей PopupMenuListener о том, что это всплывающее меню станет видимым.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JPopupMenu.
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()
Возвращает массив всех слушателей MenuKeyListener, добавленных в этот JPopupMenu с помощью addMenuKeyListener().
PopupMenuListener[] getPopupMenuListeners()
Возвращает массив всех слушателей PopupMenuListener, добавленных в этот JMenuItem с помощью addPopupMenuListener().
SingleSelectionModel getSelectionModel()
Возвращает объект модели, обрабатывающий одиночный выбор.
MenuElement[] getSubElements()
Возвращает массив объектов MenuElement, содержащих подменю для этого компонента меню.
PopupMenuUI getUI()
Возвращает объект оформления (L&F), отображающий этот компонент.
String getUIClassID()
Возвращает имя класса L&F, отображающего этот компонент.
void insert(Component component, int index)
Вставляет указанный компонент в меню в заданную позицию.
void insert(Action a, int index)
Вставляет пункт меню для указанного объекта Action в заданную позицию.
boolean isBorderPainted()
Проверяет, нужно ли отрисовывать границу.
boolean isLightWeightPopupEnabled()
Возвращает свойство lightWeightPopupEnabled.
boolean isPopupTrigger(MouseEvent e)
Возвращает true, если MouseEvent считается инициатором всплывающего меню текущим пользовательским интерфейсом JPopupMenu.
boolean isVisible()
Возвращает true, если всплывающее меню видимо (в данный момент отображается).
void menuSelectionChanged(boolean isIncluded)
Вызывается при изменении выбора в строке меню для активации или деактивации этого меню.
void pack()
Выполняет компоновку контейнера, используя минимальное пространство, необходимое для отображения его содержимого.
protected void paintBorder(Graphics g)
Отрисовывает границу всплывающего меню, если свойство borderPainted имеет значение true.
protected String paramString()
Возвращает строковое представление этого JPopupMenu.
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(int width, int height)
Задаёт размер всплывающего окна, указывая ширину и высоту.
void setPopupSize(Dimension d)
Задаёт размер всплывающего окна с помощью объекта Dimension.
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 до значения из текущего оформления.

Методы, объявленные в классе JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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

Методы, объявленные в классе 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, transferFocusDownCycle, validate, validateTree

Методы, объявленные в классе 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, 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, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, 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, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе Object

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

Подробное описание конструкторов

JPopupMenu

public JPopupMenu()
Создает JPopupMenu без «вызывающего» компонента.

JPopupMenu

public JPopupMenu(String label)
Создает JPopupMenu с указанным заголовком.
Параметры:
label — строка, которую пользовательский интерфейс может использовать в качестве заголовка всплывающего меню.

Подробное описание методов

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), который отображает этот компонент.
Переопределяет:
getUI в классе JComponent
Возвращает:
объект PopupMenuUI, который отображает этот компонент

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(PopupMenuUI ui)
Задает объект внешнего вида (L&F), который отображает этот компонент.
Параметры:
ui — новый объект внешнего вида (L&F) PopupMenuUI
См. также:
  • UIDefaults.getUI(JComponent)

updateUI

public void updateUI()
Сбрасывает свойство UI в значение из текущего внешнего вида.
Переопределяет:
updateUI в классе JComponent
См. также:
  • JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает имя класса внешнего вида (L&F), который отображает этот компонент.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "PopupMenuUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(JComponent)

processKeyEvent

protected void processKeyEvent(KeyEvent evt)
Обрабатывает события нажатия клавиш, такие как мнемоники и клавиши быстрого вызова.
Переопределяет:
processKeyEvent в классе JComponent
Параметры:
evt — обрабатываемое событие клавиатуры
См. также:
  • KeyEvent
  • KeyListener
  • KeyboardFocusManager
  • DefaultKeyboardFocusManager
  • Component.processEvent(AWTEvent)
  • Component.dispatchEvent(AWTEvent)
  • Component.addKeyListener(KeyListener)
  • Component.enableEvents(long)
  • Component.isShowing()

getSelectionModel

public SingleSelectionModel getSelectionModel()
Возвращает объект модели, обрабатывающий одиночный выбор.
Возвращает:
свойство selectionModel
См. также:
  • SingleSelectionModel

setSelectionModel

@BeanProperty(bound=false, expert=true, description="The selection model for the popup menu") public void setSelectionModel(SingleSelectionModel model)
Задает объект модели для обработки одиночного выбора.
Параметры:
model — новая SingleSelectionModel
См. также:
  • SingleSelectionModel

add

public JMenuItem add(JMenuItem menuItem)
Добавляет указанный элемент меню в конец этого меню.
Параметры:
menuItem — добавляемый JMenuItem
Возвращает:
добавленный JMenuItem

add

public JMenuItem add(String s)
Создает новый элемент меню с указанным текстом и добавляет его в конец этого меню.
Параметры:
s — строка для добавляемого элемента меню
Возвращает:
новый JMenuItem, созданный с помощью s

add

public JMenuItem add(Action a)
Добавляет новый элемент в конец меню; при его выборе отправляется указанный объект Action.
Параметры:
a — добавляемый в меню Action
Возвращает:
новый элемент меню
См. также:
  • Action

createActionComponent

protected JMenuItem createActionComponent(Action a)
Фабричный метод, создающий JMenuItem для Actions, добавленного в JPopupMenu.
Параметры:
a — Action для добавляемого элемента меню
Возвращает:
новый элемент меню
Начиная с версии:
1.3
См. также:
  • Action

createActionChangeListener

protected PropertyChangeListener createActionChangeListener(JMenuItem b)
Возвращает правильно настроенный PropertyChangeListener, который обновляет элемент управления при изменении Action.
Параметры:
b — элемент меню, для которого создается слушатель
Возвращает:
правильно настроенный PropertyChangeListener

remove

public void remove(int pos)
Удаляет компонент с указанным индексом из этого всплывающего меню.
Переопределяет:
remove в классе Container
Параметры:
pos — позиция удаляемого элемента
Вызывает исключение:
IllegalArgumentException — если значение pos меньше 0 или значение pos больше числа элементов
См. также:
  • Container.add(Component)
  • Container.invalidate()
  • Container.validate()
  • Container.getComponentCount()

setLightWeightPopupEnabled

@BeanProperty(bound=false, expert=true, description="Determines whether lightweight popups are used when possible") public void setLightWeightPopupEnabled(boolean aFlag)
Задает значение свойства lightWeightPopupEnabled, значение которого по умолчанию — true. По умолчанию, отображая всплывающее окно, внешний вид может выбрать легковесное всплывающее окно (полностью на Java). Легковесные всплывающие окна эффективнее тяжеловесных окон (с нативным аналогом), но легковесные и тяжеловесные компоненты плохо сочетаются в графическом интерфейсе. Если приложение использует и легковесные, и тяжеловесные компоненты, следует отключить легковесные всплывающие окна. Некоторые варианты внешнего вида могут всегда использовать тяжеловесные всплывающие окна независимо от значения этого свойства.
Параметры:
aFlag — false для отключения легковесных всплывающих окон
См. также:
  • isLightWeightPopupEnabled()

isLightWeightPopupEnabled

public boolean isLightWeightPopupEnabled()
Возвращает свойство lightWeightPopupEnabled.
Возвращает:
значение свойства lightWeightPopupEnabled
См. также:
  • setLightWeightPopupEnabled(boolean)

getLabel

public String getLabel()
Возвращает метку всплывающего меню
Возвращает:
строку, содержащую метку всплывающего меню
См. также:
  • setLabel(String)

setLabel

@BeanProperty(description="The label for the popup menu.") public void setLabel(String label)
Задает метку всплывающего меню. Разные варианты внешнего вида могут отображать ее или не отображать.
Параметры:
label — строка, задающая метку всплывающего меню
См. также:
  • getLabel()

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

@BeanProperty(bound=false) public PopupMenuListener[] getPopupMenuListeners()
Возвращает массив всех PopupMenuListenerов, добавленных в этот JMenuItem с помощью addPopupMenuListener().
Возвращает:
все добавленные 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

@BeanProperty(bound=false) public MenuKeyListener[] getMenuKeyListeners()
Возвращает массив всех MenuKeyListenerов, добавленных в этот JPopupMenu с помощью addMenuKeyListener().
Возвращает:
все добавленные MenuKeyListenerы или пустой массив, если слушатели не добавлялись
Начиная с версии:
1.5

firePopupMenuWillBecomeVisible

protected void firePopupMenuWillBecomeVisible()
Уведомляет PopupMenuListenerов о том, что это всплывающее меню станет видимым.

firePopupMenuWillBecomeInvisible

protected void firePopupMenuWillBecomeInvisible()
Уведомляет PopupMenuListenerов о том, что это всплывающее меню станет невидимым.

firePopupMenuCanceled

protected void firePopupMenuCanceled()
Уведомляет PopupMenuListeners о том, что это всплывающее меню отменено.

pack

public void pack()
Располагает компоненты контейнера так, чтобы для отображения его содержимого использовалось минимально необходимое пространство.

setVisible

@BeanProperty(description="Makes the popup visible") public void setVisible(boolean b)
Задает видимость всплывающего меню.
Переопределяет:
setVisible в классе JComponent
Параметры:
b — true, чтобы показать всплывающее меню, или false, чтобы скрыть его
См. также:
  • Component.isVisible()
  • Component.invalidate()

isVisible

public boolean isVisible()
Возвращает true, если всплывающее меню видимо (в данный момент отображается).
Переопределяет:
isVisible в классе Component
Возвращает:
true, если компонент видим, иначе false
См. также:
  • Component.setVisible(boolean)

setLocation

@BeanProperty(description="The location of the popup menu.") public void setLocation(int x, int y)
Задает положение верхнего левого угла всплывающего меню с помощью координат x и y.

Этот метод изменяет данные, связанные с геометрией. Поэтому оконная система может игнорировать такие запросы или изменять заданные данные, чтобы объект JPopupMenu размещался и имел размер, наиболее соответствующие настройкам рабочего стола.

Переопределяет:
setLocation в классе Component
Параметры:
x — координата x нового положения всплывающего окна в системе координат экрана
y — координата y нового положения всплывающего окна в системе координат экрана
См. также:
  • Component.getLocation()
  • Component.setBounds(int, int, int, int)
  • Component.invalidate()

getInvoker

public Component getInvoker()
Возвращает компонент, который является «вызывающим» для этого всплывающего меню.
Возвращает:
Component, в котором отображается всплывающее меню

setInvoker

@BeanProperty(bound=false, expert=true, description="The invoking component for the popup menu") 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

@BeanProperty(description="The size of the popup menu") public void setPopupSize(Dimension d)
Задает размер всплывающего окна с помощью объекта Dimension. Это эквивалентно setPreferredSize(d).
Параметры:
d — объект Dimension, задающий новый размер этого компонента.

setPopupSize

@BeanProperty(description="The size of the popup menu") public void setPopupSize(int width, int height)
Задает ширину и высоту всплывающего окна. Это эквивалентно setPreferredSize(new Dimension(width, height)).
Параметры:
width — новая ширина всплывающего окна в пикселях
height — новая высота всплывающего окна в пикселях

setSelected

@BeanProperty(expert=true, hidden=true, description="The selected component on the popup menu") public void setSelected(Component sel)
Задает текущий выбранный компонент. Это приведет к изменению модели выбора.
Параметры:
sel — выбираемый Component

isBorderPainted

public boolean isBorderPainted()
Проверяет, следует ли рисовать границу.
Возвращает:
true, если граница рисуется, иначе false
См. также:
  • setBorderPainted(boolean)

setBorderPainted

@BeanProperty(bound=false, description="Is the border of the popup menu painted") public void setBorderPainted(boolean b)
Задает, следует ли рисовать границу.
Параметры:
b — если true, граница рисуется.
См. также:
  • isBorderPainted()

paintBorder

protected void paintBorder(Graphics g)
Рисует границу всплывающего меню, если свойство borderPainted имеет значение true.
Переопределяет:
paintBorder в классе JComponent
Параметры:
g — объект Graphics
См. также:
  • JComponent.paint(Graphics)
  • JComponent.setBorder(Border)

getMargin

@BeanProperty(bound=false) public Insets getMargin()
Возвращает отступ в пикселях между границей всплывающего меню и его контейнерами.
Возвращает:
объект Insets, содержащий значения отступов.

paramString

protected String paramString()
Возвращает строковое представление этого JPopupMenu. Этот метод предназначен только для отладки, а содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.
Переопределяет:
paramString в классе JComponent
Возвращает:
строковое представление этого JPopupMenu.

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JPopupMenu. Для JPopupMenu объект AccessibleContext имеет тип AccessibleJPopupMenu. При необходимости создается новый экземпляр AccessibleJPopupMenu.
Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
AccessibleJPopupMenu, выполняющий роль AccessibleContext этого JPopupMenu

processMouseEvent

public void processMouseEvent(MouseEvent event, MenuElement[] path, MenuSelectionManager manager)
Этот метод необходим для соответствия интерфейсу MenuElement, но не реализован.
Определено в:
processMouseEvent в интерфейсе MenuElement
Параметры:
event — обрабатываемое событие MouseEvent
path — путь принимающего элемента в иерархии меню
manager — MenuSelectionManager для иерархии меню
См. также:
  • MenuElement.processMouseEvent(MouseEvent, MenuElement[], MenuSelectionManager)

processKeyEvent

public void processKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager)
Обрабатывает событие клавиатуры, переданное из MenuSelectionManager, и при необходимости изменяет выбор в меню с помощью API объекта MenuSelectionManager.

Примечание: не нужно передавать событие дочерним компонентам. Это автоматически делает MenuSelectionManager.

Определено в:
processKeyEvent в интерфейсе MenuElement
Параметры:
e — событие KeyEvent
path — массив путей MenuElement
manager — MenuSelectionManager

menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)
Вызывается при изменении выбранного пункта строки меню, чтобы активировать или деактивировать это меню. Реализует интерфейс javax.swing.MenuElement. Переопределяет MenuElement.menuSelectionChanged.
Определено в:
menuSelectionChanged в интерфейсе MenuElement
Параметры:
isIncluded — true, если это меню активно, false в противном случае
См. также:
  • MenuElement.menuSelectionChanged(boolean)

getSubElements

@BeanProperty(bound=false) public MenuElement[] getSubElements()
Возвращает массив MenuElementов, содержащих подменю для этого компонента меню. В массив включаются только элементы, реализующие интерфейс JMenuElement. Если всплывающее меню null, возвращается пустой массив. Этот метод необходим для соответствия интерфейсу MenuElement.
Определено в:
getSubElements в интерфейсе MenuElement
Возвращает:
массив объектов MenuElement
См. также:
  • MenuElement.getSubElements()

getComponent

public Component getComponent()
Возвращает этот компонент JPopupMenu.
Определено в:
getComponent в интерфейсе MenuElement
Возвращает:
этот объект JPopupMenu
См. также:
  • MenuElement.getComponent()

isPopupTrigger

public boolean isPopupTrigger(MouseEvent e)
Возвращает true, если установленный в данный момент пользовательский интерфейс JPopupMenu считает MouseEvent триггером всплывающего меню.
Параметры:
e — объект MouseEvent
Возвращает:
true, если событие мыши является триггером всплывающего меню
Начиная с:
1.3

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JPopupMenu.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API