Класс 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, поддержка длительного хранения всех JavaBeans™ добавлена в пакет java.beans. Пожалуйста, ознакомьтесь со статьей XMLEncoder.

С момента:
1.2
См. также:
Сериализованная форма

Вложенные классы

Модификатор и тип Класс Описание
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

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

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

accessibleContext, 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​(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 рассматривается как триггер всплывающего меню установленной в данный момент UI.
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)

Обрабатывает события нажатия клавиш, такие как мнемоники и акселератoры.
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 до значения из текущего визуального представления.

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

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

Методы, объявленные в классе java.lang.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 темы и внешнего вида
См. также:
UIDefaults.getUI(javax.swing.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(javax.swing.JComponent)

processKeyEvent

protected void processKeyEvent(KeyEvent evt)

Обрабатывает события нажатия клавиш, такие как мнемоники и акселераторы.

Переопределяет:
processKeyEvent в классе JComponent
Параметры:
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

@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(java.awt.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) всплывающего окна. Облегчённые всплывающие окна более эффективны, чем тяжёлые (родной peer) окна, но лёгкие и тяжёлые компоненты плохо сочетаются в графическом интерфейсе. Если ваше приложение смешивает лёгкие и тяжёлые компоненты, вы должны отключить облегчённые всплывающие окна. Некоторые темы и внешние виды могут всегда использовать тяжёлые всплывающие окна, независимо от значения этого свойства.

Параметры:
aFlag - false для отключения облегчённых всплывающих окон
См. также:
isLightWeightPopupEnabled()

isLightWeightPopupEnabled

public boolean isLightWeightPopupEnabled()

Возвращает свойство lightWeightPopupEnabled.

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

getLabel

public String getLabel()

Возвращает метку всплывающего меню.

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

setLabel

@BeanProperty(description="The label for the popup menu.")
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

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

Возвращает массив всех обработчиков событий клавиш, добавленных к этому JPopupMenu с помощью addMenuKeyListener().

Возвращает:
все добавленные обработчики событий или пустой массив, если обработчики не были добавлены
С момента:
1.5

firePopupMenuWillBecomeVisible

protected void firePopupMenuWillBecomeVisible()

Уведомляет слушателей, что всплывающее меню станет видимым.

firePopupMenuWillBecomeInvisible

protected void firePopupMenuWillBecomeInvisible()

Уведомляет слушателей, что всплывающее меню станет невидимым.

firePopupMenuCanceled

protected void firePopupMenuCanceled()

Уведомляет слушателей, что всплывающее меню отменено.

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

Возвращает компонент, который является 'вызывающим' элементом для этого всплывающего меню.

Возвращает:
компонент, в котором отображается всплывающее меню

setInvoker

@BeanProperty(bound=false,
              expert=true,
              description="The invoking component for the popup menu")
public void setInvoker(Component invoker)

Устанавливает вызывающий компонент этого всплывающего меню — компонент, в котором должно отображаться всплывающее меню.

Параметры:
invoker - компонент, в котором отображается всплывающее меню

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 — первый
Возвращает:
компонент по этому индексу

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 - компонент для выбора

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(java.awt.Graphics), JComponent.setBorder(javax.swing.border.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. Для JPopupMenus AccessibleContext принимает вид AccessibleJPopupMenu. Новый экземпляр AccessibleJPopupMenu создается при необходимости.

Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
AccessibleJPopupMenu, который служит AccessibleContext этого JPopupMenu

processMouseEvent

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

Этот метод необходим для соответствия интерфейсу MenuElement, но он не реализован.

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

processKeyEvent

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

Обрабатывает событие нажатия клавиши, переданное от MenuSelectionManager, и изменяет выбор меню, если необходимо, используя API MenuSelectionManager.

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

Определено в:
processKeyEvent в интерфейсе MenuElement
Параметры:
e - событие нажатия клавиши
path - массив пути элементов меню
manager - менеджер выбора меню
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, если MouseEvent считается триггером всплывающего меню текущим установленным UI JPopupMenu.

Параметры:
e - событие MouseEvent
Возвращает:
true, если событие мыши является триггером всплывающего меню
С:
1.3

© 1993, 2020, 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/11/docs/api/java.desktop/javax/swing/JPopupMenu.html

Spec-Zone .ru
спецификации, руководства, описания, API