Класс JPopupMenu

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

Реализация всплывающего меню — маленького окна, которое появляется и отображает ряд вариантов. Всплывающее меню используется для меню, которое появляется, когда пользователь выбирает элемент в строке меню. Оно также используется для меню "справа", которое появляется, когда пользователь выбирает пункт меню, вызывающий его. Наконец, всплывающее меню можно использовать в любом другом месте, где требуется меню. Например, когда пользователь щелкает правой кнопкой мыши в определённой области.

Дополнительную информацию и примеры использования всплывающих меню см. в Руководстве по использованию меню в Java Tutorial.

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

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

C момента:: 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 `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)`	Устанавливает размер окна Popup с заданной шириной и высотой.
`void`	`setPopupSize(Dimension d)`	Устанавливает размер окна Popup с помощью объекта `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, 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

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

См. также:

processKeyEvent

protected void processKeyEvent(KeyEvent evt)

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

Переопределяет:

processKeyEvent в классе JComponent

Параметры:

evt - событие нажатия клавиши, подлежащее обработке

См. также:

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

Возвращает:

новый пункт меню

Since:

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 больше, чем количество элементов

См. также:

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(java.lang.String)

END_OF_DOCUMENT_MARKER

Установить метку

@BeanProperty(description="The label for the popup menu.") public void setLabel(String label)

Устанавливает метку всплывающего меню. Различные визуальные стили могут выбрать отображение или не отображение этой метки.

Параметры:

label - строка, определяющая метку для всплывающего меню

См. также:

setLabel(java.lang.String)

Добавить разделитель

public void addSeparator()

Добавляет новый разделитель в конец меню.

вставить

public void insert(Action a, int index)

Вставляет элемент меню для указанного объекта Action в заданную позицию.

Параметры:

a - объект Action для вставки

index - задаёт позицию вставки объекта Action, где 0 — это первый

Исключения:

IllegalArgumentException - если index < 0

См. также:

Action

вставить

public void insert(Component component, int index)

Вставляет указанный компонент в меню в заданную позицию.

Параметры:: component - компонент Component для вставки; index - задаёт позицию вставки компонента, где 0 — это первый
Исключения:: IllegalArgumentException - если index < 0

addPopupMenuListener

public void addPopupMenuListener(PopupMenuListener l)

Добавляет слушателя событий всплывающего меню.

Параметры:: l - слушатель PopupMenuListener для добавления

removePopupMenuListener

public void removePopupMenuListener(PopupMenuListener l)

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

Параметры:: l - слушатель PopupMenuListener для удаления

getPopupMenuListeners

@BeanProperty(bound=false) public PopupMenuListener[] getPopupMenuListeners()

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

Возвращает:: все добавленные слушатели событий всплывающего меню или пустой массив, если слушатели не добавлены
С:: 1.4

addMenuKeyListener

public void addMenuKeyListener(MenuKeyListener l)

Добавляет слушатель нажатий клавиш для всплывающего меню.

Параметры:: l - слушатель нажатий клавиш для добавления
С:: 1.5

removeMenuKeyListener

public void removeMenuKeyListener(MenuKeyListener l)

Удаляет слушателя нажатий клавиш из всплывающего меню.

Параметры:: l - слушатель нажатий клавиш для удаления
С:: 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()

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

упаковать

public void pack()

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

установитьВидимость

@BeanProperty(description="Makes the popup visible") public void setVisible(boolean b)

Устанавливает видимость всплывающего меню.

Переопределяет:

setVisible в классе JComponent

Параметры:

b - true для отображения всплывающего меню, или false для его скрытия

См. также:

isVisible

public boolean isVisible()

Возвращает true, если всплывающее меню видимое (в данный момент отображается).

Переопределяет:

isVisible в классе Component

Возвращает:

true если компонент видим, false в противном случае

См. также:

Component.setVisible(boolean)

установитьПозицию

@BeanProperty(description="The location of the popup menu.") public void setLocation(int x, int y)

Устанавливает положение верхнего левого угла всплывающего меню, используя координаты x, y.

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

Переопределяет:

setLocation в классе Component

Параметры:

x - координата x нового положения всплывающего меню в пространстве координат экрана

y - координата y нового положения всплывающего меню в пространстве координат экрана

См. также:

получитьВызывающийКомпонент

public Component getInvoker()

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

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

установитьВызывающийКомпонент

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

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

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

показать

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

установитьРазмерВсплывающегоОкна

@BeanProperty(description="The size of the popup menu") public void setPopupSize(Dimension d)

Устанавливает размер окна всплывающего меню, используя объект Dimension. Это эквивалентно setPreferredSize(d).

Параметры:: d - Dimension , задающий новый размер этого компонента.

установитьРазмерВсплывающегоОкна

@BeanProperty(description="The size of the popup menu") public void setPopupSize(int width, int height)

Устанавливает размер окна всплывающего меню заданной шириной и высотой. Это эквивалентно setPreferredSize(new Dimension(width, height)).

Параметры:: width - новая ширина всплывающего меню в пикселях; height - новая высота всплывающего меню в пикселях

установитьВыбранным

@BeanProperty(expert=true, hidden=true, description="The selected component on the popup menu") public void setSelected(Component sel)

Устанавливает текущий выбранный компонент. Это приведёт к изменению модели выбора.

Параметры:: sel - Component для выбора

isBorderPainted

public boolean isBorderPainted()

Проверяет, должен ли быть нарисован border.

Возвращает:

true, если border нарисован, false в противном случае

См. также:

setBorderPainted(boolean)

END_OF_DOCUMENT_MARKER

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

См. также:

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 - обрабатываемое событие 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, если MouseEvent считается триггером всплывающего меню установленным UI JPopupMenu.

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

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