Класс 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

public static boolean getDefaultLightWeightPopupEnabled()

Возвращает свойство defaultLightWeightPopupEnabled, которое по умолчанию равно true.

Возвращает:

значение свойства defaultLightWeightPopupEnabled

См. также:

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 - новый объект отображения PopupMenuUI L&F

См. также:

updateUI

public void updateUI()

Сбрасывает свойство UI до значения из текущего стиля отображения.

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

updateUI в классе JComponent

См. также:

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

См. также:

setSelectionModel

@BeanProperty(bound=false, expert=true, description="The selection model for the popup menu") public void setSelectionModel(SingleSelectionModel model)

Устанавливает объект модели для обработки одиночных выделений.

Параметры:

model - новое свойство 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

Возвращает:

новый элемент меню

См. также:

createActionComponent

protected JMenuItem createActionComponent(Action a)

Метод-фабрика, который создаёт JMenuItem для Actions, добавленного в JPopupMenu.

Параметры:

a - Action для добавляемого элемента меню

Возвращает:

новый элемент меню

Since:

1.3

См. также:

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

public boolean isLightWeightPopupEnabled()

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

Возвращает:

значение свойства lightWeightPopupEnabled

См. также:

getLabel

public String getLabel()

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

Возвращает:

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

См. также:

setLabel

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

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

Параметры:

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

См. также:

addSeparator

public void addSeparator()

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

insert

public void insert(Action a, int index)

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

Параметры:

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

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

Исключения:

IllegalArgumentException - если index < 0

См. также:

insert

public void insert(Component component, int index)

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

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

addPopupMenuListener

public void addPopupMenuListener(PopupMenuListener l)

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

Параметры:: l - слушатель событий всплывающего меню для добавления

removePopupMenuListener

public void removePopupMenuListener(PopupMenuListener l)

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

Параметры:: l - слушатель событий всплывающего меню для удаления

getPopupMenuListeners

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

Возвращает массив всех слушателей событий всплывающего меню, добавленных к этому элементу меню с помощью 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()

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

pack

public void pack()

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

setVisible

@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 в противном случае

См. также:

setLocation

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

Устанавливает координаты верхнего левого угла всплывающего меню.

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

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

setLocation в классе Component

Параметры:

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

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

См. также:

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 - компонент для поиска
Возвращает:: индекс компонента, где 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

@BeanProperty(bound=false, description="Is the border of the popup menu painted") public void setBorderPainted(boolean b)

Устанавливает, нужно ли рисовать границу.

Параметры:

b - если true, граница рисуется.

См. также:

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 для иерархии меню

См. также:

processKeyEvent

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

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

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

Указано в:: processKeyEvent в интерфейсе MenuElement
Параметры:: e - событие нажатия клавиши KeyEvent; path - массив путей к элементам меню; manager - MenuSelectionManager

menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)

Получает сообщение при изменении выбора в меню, чтобы активировать или деактивировать это меню. Реализует интерфейс javax.swing.MenuElement. Переопределяет MenuElement.menuSelectionChanged.

Указано в:

menuSelectionChanged в интерфейсе MenuElement

Параметры:

isIncluded - true, если это меню активно, false в противном случае

См. также:

getSubElements

@BeanProperty(bound=false) public MenuElement[] getSubElements()

Возвращает массив MenuElement содержащих подменю для этого компонента меню. Он вернет только элементы, соответствующие интерфейсу JMenuElement. Если всплывающее меню null возвращает пустой массив. Этот метод требуется для соответствия интерфейсу MenuElement.

Указано в:

getSubElements в интерфейсе MenuElement

Возвращает:

массив объектов MenuElement

См. также:

getComponent

public Component getComponent()

Возвращает компонент JPopupMenu.

Указано в:

getComponent в интерфейсе MenuElement

Возвращает:

объект JPopupMenu

См. также:

isPopupTrigger

public boolean isPopupTrigger(MouseEvent e)

Возвращает true, если MouseEvent считается триггером всплывающего меню текущим UI JPopupMenu.

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

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