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

Предупреждение: 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` с указанным заголовком.

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

Modifier and Type	Method	Description
`JMenuItem`	`add(String s)`	Создаёт новую запись меню с указанным текстом и добавляет её в конец этого меню.
`JMenuItem`	`add(Action a)`	Добавляет новую запись меню в конец меню, которая обрабатывает указанный объект `Action`.
`JMenuItem`	`add(JMenuItem menuItem)`	Добавляет указанную запись меню в конец этого меню.
`void`	`addMenuKeyListener(MenuKeyListener l)`	Добавляет `MenuKeyListener` в всплывающее меню.
`void`	`addPopupMenuListener(PopupMenuListener l)`	Добавляет слушателя `PopupMenu`.
`void`	`addSeparator()`	Добавляет новый разделитель в конец меню.
`protected PropertyChangeListener`	`createActionChangeListener(JMenuItem b)`	Возвращает правильно настроенный объект `PropertyChangeListener`, который обновляет элемент управления при изменении данных в `Action`.
`protected JMenuItem`	`createActionComponent(Action a)`	Метод-фабрика, который создаёт `JMenuItem` для `Actions`, добавленного в `JPopupMenu`.
`protected void`	`firePopupMenuCanceled()`	Уведомляет `PopupMenuListeners`, что всплывающее меню отменено.
`protected void`	`firePopupMenuWillBecomeInvisible()`	Уведомляет объекты `PopupMenuListener`, что это всплывающее меню станет невидимым.
`protected void`	`firePopupMenuWillBecomeVisible()`	Уведомляет объекты `PopupMenuListener`, что это всплывающее меню станет видимым.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим JPopupMenu.
`Component`	`getComponent()`	Возвращает этот компонент `JPopupMenu`.
`Component`	`getComponentAtIndex(int i)`	Устарело. заменено на `Container.getComponent(int)`
`int`	`getComponentIndex(Component c)`	Возвращает индекс указанного компонента.
`static boolean`	`getDefaultLightWeightPopupEnabled()`	Возвращает свойство `defaultLightWeightPopupEnabled`, которое по умолчанию равно `true`.
`Component`	`getInvoker()`	Возвращает компонент, который является 'вызывающим' этого всплывающего меню.
`String`	`getLabel()`	Возвращает метку всплывающего меню.
`Insets`	`getMargin()`	Возвращает отступ, в пикселях, между границей всплывающего меню и его контейнерами.
`MenuKeyListener[]`	`getMenuKeyListeners()`	Возвращает массив всех слушателей `MenuKeyListener`, добавленных к этому JPopupMenu с помощью addMenuKeyListener().
`PopupMenuListener[]`	`getPopupMenuListeners()`	Возвращает массив всех слушателей `PopupMenuListener`, добавленных к этому JMenuItem с помощью addPopupMenuListener().
`SingleSelectionModel`	`getSelectionModel()`	Возвращает объект модели, обрабатывающий одиночные выделения.
`MenuElement[]`	`getSubElements()`	Возвращает массив `MenuElement`, содержащих подменю для этого компонента меню.
`PopupMenuUI`	`getUI()`	Возвращает объект внешнего вида (L&F), который отображает этот компонент.
`String`	`getUIClassID()`	Возвращает имя класса L&F, который отображает этот компонент.
`void`	`insert(Component component, int index)`	Вставляет указанный компонент в меню в заданную позицию.
`void`	`insert(Action a, int index)`	Вставляет запись меню для указанного объекта `Action` в заданную позицию.
`boolean`	`isBorderPainted()`	Проверяет, должна ли быть нарисована граница.
`boolean`	`isLightWeightPopupEnabled()`	Получает свойство `lightWeightPopupEnabled`.
`boolean`	`isPopupTrigger(MouseEvent e)`	Возвращает true, если `MouseEvent` считается триггером всплывающего меню установленным в данный момент интерфейсом `JPopupMenu`.
`boolean`	`isVisible()`	Возвращает true, если всплывающее меню отображается (в данный момент отображается).
`void`	`menuSelectionChanged(boolean isIncluded)`	Вызывается, когда изменяется выделенный элемент меню, для активации или деактивации этого меню.
`void`	`pack()`	Выполняет компоновку контейнера так, чтобы он использовал минимальное пространство, необходимое для отображения содержимого.
`protected void`	`paintBorder(Graphics g)`	Рисует границу всплывающего меню, если свойство `borderPainted` имеет значение `true`.
`protected String`	`paramString()`	Возвращает строковое представление этого объекта `JPopupMenu`.
`protected void`	`processKeyEvent(KeyEvent evt)`	Обрабатывает события нажатия клавиш, такие как мнемоники и ускорители.
`void`	`processKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager)`	Обрабатывает событие нажатия клавиши, переданное от `MenuSelectionManager`, и изменяет выделение меню, если необходимо, используя API `MenuSelectionManager`.
`void`	`processMouseEvent(MouseEvent event, MenuElement[] path, MenuSelectionManager manager)`	Этот метод необходим для соответствия интерфейсу `MenuElement`, но он не реализован.
`void`	`remove(int pos)`	Удаляет компонент в указанном индексе из этого всплывающего меню.
`void`	`removeMenuKeyListener(MenuKeyListener l)`	Удаляет `MenuKeyListener` из всплывающего меню.
`void`	`removePopupMenuListener(PopupMenuListener l)`	Удаляет слушателя `PopupMenu`.
`void`	`setBorderPainted(boolean b)`	Устанавливает, должна ли быть нарисована граница.
`static void`	`setDefaultLightWeightPopupEnabled(boolean aFlag)`	Устанавливает значение по умолчанию свойства `lightWeightPopupEnabled`.
`void`	`setInvoker(Component invoker)`	Устанавливает вызывающий элемент этого всплывающего меню — компонент, в котором должно отображаться всплывающее меню.
`void`	`setLabel(String label)`	Устанавливает метку всплывающего меню.
`void`	`setLightWeightPopupEnabled(boolean aFlag)`	Устанавливает значение свойства `lightWeightPopupEnabled`, которое по умолчанию равно `true`.
`void`	`setLocation(int x, int y)`	Устанавливает положение верхнего левого угла всплывающего меню с помощью координат x, y.
`void`	`setPopupSize(int width, int height)`	Устанавливает размер окна всплывающего окна в указанную ширину и высоту.
`void`	`setPopupSize(Dimension d)`	Устанавливает размер окна всплывающего окна с помощью объекта `Dimension`.
`void`	`setSelected(Component sel)`	Устанавливает текущий выделенный компонент. Это приведёт к изменению модели выделения.
`void`	`setSelectionModel(SingleSelectionModel model)`	Устанавливает объект модели для обработки одиночных выделений.
`void`	`setUI(PopupMenuUI ui)`	Устанавливает объект внешнего вида (L&F), который отображает этот компонент.
`void`	`setVisible(boolean b)`	Устанавливает видимость всплывающего меню.
`void`	`show(Component invoker, int x, int y)`	Отображает всплывающее меню в позиции x,y в пространстве координат вызывающего компонента.
`void`	`updateUI()`	Сбрасывает свойство UI до значения из текущего внешнего вида.

Methods declared in class 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

Methods declared in class 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

Methods declared in class 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 - новый объект L&F PopupMenuUI

См. также:

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 - значение для отключения облегчённых всплывающих окон

См. также:

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 - компонент Component для вставки; index - указывает позицию, в которую нужно вставить компонент, где 0 - это первая
Исключения:: IllegalArgumentException - если index < 0

addPopupMenuListener

public void addPopupMenuListener(PopupMenuListener l)

Добавляет прослушиватель PopupMenu.

Параметры:: l - добавляемый PopupMenuListener

removePopupMenuListener

public void removePopupMenuListener(PopupMenuListener l)

Удаляет прослушиватель PopupMenu.

Параметры:: l - удаляемый PopupMenuListener

getPopupMenuListeners

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

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

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

addMenuKeyListener

public void addMenuKeyListener(MenuKeyListener l)

Добавляет MenuKeyListener во всплывающее меню.

Параметры:: l - добавляемый MenuKeyListener
С версии:: 1.5

removeMenuKeyListener

public void removeMenuKeyListener(MenuKeyListener l)

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

Параметры:: l - удаляемый MenuKeyListener
С версии:: 1.5

getMenuKeyListeners

@BeanProperty(bound=false) public MenuKeyListener[] getMenuKeyListeners()

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

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

firePopupMenuWillBecomeVisible

protected void firePopupMenuWillBecomeVisible()

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

firePopupMenuWillBecomeInvisible

protected void firePopupMenuWillBecomeInvisible()

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

firePopupMenuCanceled

protected void firePopupMenuCanceled()

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

pack

public void pack()

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

setVisible

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

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

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

setVisible в классе JComponent

Параметры:

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

См. также:

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)

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

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

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

setLocation в классе Component

Параметры:

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

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

См. также:

getInvoker

public Component getInvoker()

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

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

setInvoker

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

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

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

show

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

Отображает всплывающее меню в позиции x,y в пространстве координат компонента-вызывающего.

Параметры:: invoker - компонент, в пространстве которого должно появиться всплывающее меню; x - координата x в пространстве координат вызывающего, в которой должно отображаться всплывающее меню; y - координата y в пространстве координат вызывающего, в которой должно отображаться всплывающее меню

getComponentAtIndex

@Deprecated public Component getComponentAtIndex(int i)

Устарело.

заменено на Container.getComponent(int)

Возвращает компонент с указанным индексом.

Параметры:: i - индекс компонента, где 0 - это первый
Возвращает:: Component с этим индексом

getComponentIndex

public int getComponentIndex(Component c)

Возвращает индекс указанного компонента.

Параметры:: c - Component для поиска
Возвращает:: индекс компонента, где 0 - это первый; или -1, если компонент не найден

Установить размер всплывающего окна

@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 для выбора

Отображать границу

public boolean isBorderPainted()

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

Возвращает:

true, если граница отображается, false в противном случае

См. также:

Установить рисование границы

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

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

Параметры:

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

См. также:

Отобразить границу

protected void paintBorder(Graphics g)

Рисует границу всплывающего меню, если свойство borderPainted имеет значение true.

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

paintBorder в классе JComponent

Параметры:

g - объект Graphics

См. также:

Получить отступ

@BeanProperty(bound=false) public Insets getMargin()

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

Возвращает:: объект Insets, содержащий значения отступа.

paramString

protected String paramString()

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

Переопределяет:: paramString в классе JComponent
Возвращает:: строковое представление этого JPopupMenu.

Получить контекст доступности

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим JPopupMenu. Для JPopupMenus AccessibleContext принимает вид AccessibleJPopupMenu. Новый экземпляр AccessibleJPopupMenu создается при необходимости.

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

Обработать событие мыши

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

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

Задано в:

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

Параметры:

event - обрабатываемое событие MouseEvent

path - путь получающего элемента в иерархии меню

manager - MenuSelectionManager для иерархии меню

См. также:

Обработать событие клавиши

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

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

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

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

Изменился выбор меню

public void menuSelectionChanged(boolean isIncluded)

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

Задано в:

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

Параметры:

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

См. также:

Получить дочерние элементы

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

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

Задано в:

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

Возвращает:

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

См. также:

Получить компонент

public Component getComponent()

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

Задано в:

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

Возвращает:

объект JPopupMenu

См. также:

Является триггером всплывающего меню

public boolean isPopupTrigger(MouseEvent e)

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

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

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