Класс JComponent

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable

Непосредственные известные подклассы:: AbstractButton, BasicInternalFrameTitlePane, Box, Box.Filler, JColorChooser, JComboBox, JFileChooser, JInternalFrame, JInternalFrame.JDesktopIcon, JLabel, JLayer, JLayeredPane, JList, JMenuBar, JOptionPane, JPanel, JPopupMenu, JProgressBar, JRootPane, JScrollBar, JScrollPane, JSeparator, JSlider, JSpinner, JSplitPane, JTabbedPane, JTable, JTableHeader, JTextComponent, JToolBar, JToolTip, JTree, JViewport

@JavaBean(defaultProperty="UIClassID") public abstract class JComponent extends Container implements Serializable

Базовый класс для всех компонентов Swing, кроме контейнеров верхнего уровня. Чтобы использовать компонент, наследующий от JComponent, вы должны разместить компонент в иерархии вложений, корнем которой является контейнер Swing верхнего уровня. Контейнеры Swing верхнего уровня — такие как JFrame, JDialog, и JApplet — это специализированные компоненты, предоставляющие место для отрисовки других компонентов Swing. Для объяснения иерархии вложений см. Компоненты Swing и иерархия вложений, раздел учебника The Java Tutorial.

Класс JComponent предоставляет:

Базовый класс для стандартных и пользовательских компонентов, использующих архитектуру Swing.
«Подключаемый вид и ощущения» (L&F), который может быть задан программистом или (по желанию) выбран пользователем во время выполнения. Вид и ощущения каждого компонента предоставляются делегатом UI — объектом, унаследованным от ComponentUI. Дополнительную информацию см. в Как настроить вид и ощущения в учебнике The Java Tutorial.
Полноценную обработку нажатий клавиш. Дополнительную информацию см. в документе Как использовать привязки к клавишам, статье в учебнике The Java Tutorial.
Поддержку всплывающих подсказок — кратких описаний, которые появляются при наведении курсора на компонент. Дополнительную информацию см. в Как использовать всплывающие подсказки в учебнике The Java Tutorial.
Поддержку доступности. JComponent содержит все методы интерфейса Accessible, но фактически не реализует интерфейс. Это обязанность отдельных классов, расширяющих JComponent.
Поддержку свойств, специфичных для компонентов. С помощью методов putClientProperty(java.lang.Object, java.lang.Object) и getClientProperty(java.lang.Object) вы можете связать пары имя-объект с любым объектом, унаследованным от JComponent.
Инфраструктуру отрисовки, которая включает двойную буферизацию и поддержку границ. Дополнительную информацию см. в Отрисовка и Как использовать границы, оба этих раздела содержатся в учебнике The Java Tutorial.

Для получения дополнительной информации по этим темам см. Swing package description и раздел учебника The Java Tutorial Класс JComponent.

JComponent и его подклассы документируют значения по умолчанию для определенных свойств. Например, JTable документирует высоту строки по умолчанию как 16. Каждый подкласс JComponent с ComponentUI создаст ComponentUI в качестве части своего конструктора. Для обеспечения определенного вида и ощущений каждый ComponentUI может устанавливать свойства обратно на JComponent , который его создал. Например, настраиваемому виду и ощущениям может потребоваться, чтобы у JTable была высота строки 24. Документированные значения по умолчанию — это значение свойства ДО установки ComponentUI. Если вам нужно определенное значение для конкретного свойства, вы должны явно его установить.

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

В релизе 1.4 была перестроена система фокуса. Дополнительную информацию см. в Как использовать систему фокуса, разделе учебника The Java Tutorial.

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

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

С:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`class`	`JComponent.AccessibleJComponent`	Внутренний класс JComponent, используемый для обеспечения поддержки доступности по умолчанию.

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип	Поле	Описание
`protected EventListenerList`	`listenerList`	Список обработчиков событий для этого компонента.
`static final String`	`TOOL_TIP_TEXT_KEY`	Комментарий для отображения при наведении курсора на компонент, также известный как «подсказка», «помощь при наведении» или «метка при наведении».
`protected ComponentUI`	`ui`	Делегат вида и ощущений для этого компонента.
`static final int`	`UNDEFINED_CONDITION`	Константа, используемая некоторыми API для обозначения того, что никакое условие не определено.
`static final int`	`WHEN_ANCESTOR_OF_FOCUSED_COMPONENT`	Константа, используемая для `registerKeyboardAction`, означающая, что команда должна вызываться, когда принимающий компонент является предком фокусированного компонента или сам является фокусированным компонентом.
`static final int`	`WHEN_FOCUSED`	Константа, используемая для `registerKeyboardAction`, означающая, что команда должна вызываться, когда компонент имеет фокус.
`static final int`	`WHEN_IN_FOCUSED_WINDOW`	Константа, используемая для `registerKeyboardAction`, означающая, что команда должна вызываться, когда принимающий компонент находится в окне, имеющем фокус, или сам является фокусированным компонентом.

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

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

Конструктор	Описание
`JComponent()`	Конструктор по умолчанию `JComponent`.

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

Модификатор и тип	Метод	Описание
`void`	`addAncestorListener(AncestorListener listener)`	Регистрирует `listener` таким образом, чтобы он получал `AncestorEvents` при перемещении его или любого из его предков, а также при изменении видимости.
`void`	`addNotify()`	Уведомляет этот компонент о том, что у него теперь есть родительский компонент.
`void`	`addVetoableChangeListener(VetoableChangeListener listener)`	Добавляет `VetoableChangeListener` в список слушателей.
`void`	`computeVisibleRect(Rectangle visibleRect)`	Возвращает "прямоугольник видимой области" `Component` - пересечение видимых прямоугольников для данного компонента и всех его предков.
`boolean`	`contains(int x, int y)`	Предоставляет делегату UI возможность определить точную форму этого компонента для обработки нажатий мыши.
`JToolTip`	`createToolTip()`	Возвращает экземпляр `JToolTip`, который должен использоваться для отображения всплывающей подсказки.
`void`	`disable()`	Устарело. Начиная с версии JDK 1.1, заменено на `java.awt.Component.setEnabled(boolean)`.
`void`	`enable()`	Устарело. Начиная с версии JDK 1.1, заменено на `java.awt.Component.setEnabled(boolean)`.
`void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)`	Поддержка отслеживания изменений связанных свойств для булевых свойств.
`void`	`firePropertyChange(String propertyName, int oldValue, int newValue)`	Поддержка отслеживания изменений связанных свойств для целочисленных свойств.
`protected void`	`fireVetoableChange(String propertyName, Object oldValue, Object newValue)`	Поддержка отслеживания ограниченных изменений свойств.
`ActionListener`	`getActionForKeyStroke(KeyStroke aKeyStroke)`	Возвращает объект, который выполнит действие, зарегистрированное для заданного нажатия клавиши.
`final ActionMap`	`getActionMap()`	Возвращает `ActionMap`, используемый для определения, какое `Action` будет срабатывать для определенной привязки `KeyStroke`.
`float`	`getAlignmentX()`	Переопределяет `Container.getAlignmentX` для возвращения горизонтального выравнивания.
`float`	`getAlignmentY()`	Переопределяет `Container.getAlignmentY` для возвращения вертикального выравнивания.
`AncestorListener[]`	`getAncestorListeners()`	Возвращает массив всех слушателей предков, зарегистрированных в этом компоненте.
`boolean`	`getAutoscrolls()`	Получает свойство `autoscrolls`.
`int`	`getBaseline(int width, int height)`	Возвращает базу.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior()`	Возвращает перечисление, указывающее, как смещение базы компонента изменяется при изменении размера.
`Border`	`getBorder()`	Возвращает границу этого компонента или `null`, если граница не установлена.
`Rectangle`	`getBounds(Rectangle rv)`	Сохраняет границы этого компонента в "результате" `rv` и возвращает `rv`.
`final Object`	`getClientProperty(Object key)`	Возвращает значение свойства со значением ключа.
`protected Graphics`	`getComponentGraphics(Graphics g)`	Возвращает объект графики, используемый для рисования этого компонента.
`JPopupMenu`	`getComponentPopupMenu()`	Возвращает `JPopupMenu`, назначенное для данного компонента.
`int`	`getConditionForKeyStroke(KeyStroke aKeyStroke)`	Возвращает условие, определяющее, произойдет ли зарегистрированное действие в ответ на заданное нажатие клавиши.
`int`	`getDebugGraphicsOptions()`	Возвращает состояние отладки графики.
`static Locale`	`getDefaultLocale()`	Возвращает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при его создании.
`FontMetrics`	`getFontMetrics(Font font)`	Получает `FontMetrics` для указанного `Font`.
`Graphics`	`getGraphics()`	Возвращает контекст графики данного компонента, который позволяет рисовать на компоненте.
`int`	`getHeight()`	Возвращает текущую высоту данного компонента.
`boolean`	`getInheritsPopupMenu()`	Возвращает true, если JPopupMenu должен наследоваться от родителя.
`final InputMap`	`getInputMap()`	Возвращает `InputMap`, используемый, когда компонент получает фокус.
`final InputMap`	`getInputMap(int condition)`	Возвращает `InputMap`, используемый во время `condition`.
`InputVerifier`	`getInputVerifier()`	Возвращает валидатор ввода для этого компонента.
`Insets`	`getInsets()`	Если для этого компонента установлена граница, возвращает отступы границы; в противном случае вызывает `super.getInsets`.
`Insets`	`getInsets(Insets insets)`	Возвращает объект `Insets`, содержащий значения отступов данного компонента.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, текущих зарегистрированных в качестве `FooListener` на этом `JComponent`.
`Point`	`getLocation(Point rv)`	Сохраняет координату начала (x,y) этого компонента в "результате" `rv` и возвращает `rv`.
`Dimension`	`getMaximumSize()`	Если максимальный размер установлен на ненулевое значение, просто возвращает его.
`Dimension`	`getMinimumSize()`	Если минимальный размер установлен на ненулевое значение, просто возвращает его.
`Component`	`getNextFocusableComponent()`	Устарело. Начиная с версии 1.4, заменено на `FocusTraversalPolicy`.
`Point`	`getPopupLocation(MouseEvent event)`	Возвращает предпочтительное расположение для отображения всплывающего меню в системе координат этого компонента.
`Dimension`	`getPreferredSize()`	Если `preferredSize` установлен на ненулевое значение, просто возвращает его.
`KeyStroke[]`	`getRegisteredKeyStrokes()`	Возвращает `KeyStrokes`, который инициирует зарегистрированные действия.
`JRootPane`	`getRootPane()`	Возвращает предка `JRootPane` этого компонента.
`Dimension`	`getSize(Dimension rv)`	Сохраняет ширину/высоту данного компонента в "результате" `rv` и возвращает `rv`.
`Point`	`getToolTipLocation(MouseEvent event)`	Возвращает расположение всплывающей подсказки в системе координат этого компонента.
`String`	`getToolTipText()`	Возвращает строку всплывающей подсказки, которая была установлена с помощью `setToolTipText`.
`String`	`getToolTipText(MouseEvent event)`	Возвращает строку, используемую в качестве всплывающей подсказки для события.
`Container`	`getTopLevelAncestor()`	Возвращает предка верхнего уровня этого компонента (содержимый `Window` или `Applet`), или `null` если этот компонент не добавлен ни в один контейнер.
`TransferHandler`	`getTransferHandler()`	Получает свойство `transferHandler`.
`ComponentUI`	`getUI()`	Возвращает делегата внешнего вида, который отрисовывает этот компонент.
`String`	`getUIClassID()`	Возвращает ключ `UIDefaults` для поиска имени класса `swing.plaf.ComponentUI` , который определяет внешний вид для этого компонента.
`boolean`	`getVerifyInputWhenFocusTarget()`	Возвращает значение, указывающее, будет ли вызываться валидатор ввода для текущего владельца фокуса до того, как этот компонент запросит фокус.

`VetoableChangeListener[]`	`getVetoableChangeListeners()`	Возвращает массив всех регистрируемых слушателей изменений на данном компоненте.
`Rectangle`	`getVisibleRect()`	Возвращает "видимый прямоугольник" `Component` - пересечение видимого прямоугольника этого компонента, `new Rectangle(0, 0, getWidth(), getHeight())`, и всех видимых прямоугольников его предков.
`int`	`getWidth()`	Возвращает текущую ширину этого компонента.
`int`	`getX()`	Возвращает текущую координату x начала координат компонента.
`int`	`getY()`	Возвращает текущую координату y начала координат компонента.
`void`	`grabFocus()`	Запрашивает, чтобы этот компонент получил фокус ввода, и чтобы его непосредственный предок стал фокусированным окном.
`void`	`hide()`	Устарело.
`boolean`	`isDoubleBuffered()`	Возвращает, следует ли этому компоненту использовать буфер для рисования.
`static boolean`	`isLightweightComponent(Component c)`	Возвращает true, если компонент является легким, то есть если у него нет родного объекта для системы окон.
`boolean`	`isManagingFocus()`	Устарело. С версии 1.4 заменено на `Component.setFocusTraversalKeys(int, Set)` и `Container.setFocusCycleRoot(boolean)`.
`boolean`	`isOpaque()`	Возвращает true, если этот компонент полностью непрозрачен.
`boolean`	`isOptimizedDrawingEnabled()`	Возвращает true, если этот компонент выкладывает своих потомков — то есть, если он может гарантировать, что потомки не перекрываются.
`final boolean`	`isPaintingForPrint()`	Возвращает `true`, если текущая операция рисования на этом компоненте является частью операции `print`.
`protected boolean`	`isPaintingOrigin()`	Возвращает `true`, если рисование, инициированное на дочернем компоненте, должно быть инициировано этим компонентом или одним из его предков.
`boolean`	`isPaintingTile()`	Возвращает true, если компонент в данный момент рисует плитку.
`boolean`	`isRequestFocusEnabled()`	Возвращает `true`, если этому `JComponent` должен быть предоставлен фокус; в противном случае возвращает `false`.
`boolean`	`isValidateRoot()`	Если этот метод возвращает true, вызовы `revalidate` потомками этого компонента приведут к валидации всего дерева, начиная с этого корня.
`void`	`paint(Graphics g)`	Вызывается Swing для отрисовки компонентов.
`protected void`	`paintBorder(Graphics g)`	Отрисовывает границу компонента.
`protected void`	`paintChildren(Graphics g)`	Отрисовывает потомков этого компонента.
`protected void`	`paintComponent(Graphics g)`	Вызывает метод paint делегата пользовательского интерфейса, если делегат пользовательского интерфейса не `null`.
`void`	`paintImmediately(int x, int y, int w, int h)`	Отрисовывает указанную область в этом компоненте и всех его потомках, которые перекрывают область, немедленно.
`void`	`paintImmediately(Rectangle r)`	Отрисовывает указанную область сейчас.
`protected String`	`paramString()`	Возвращает строковое представление этого `JComponent`.
`void`	`print(Graphics g)`	Вызовите этот метод для печати компонента в указанный `Graphics`.
`void`	`printAll(Graphics g)`	Вызовите этот метод для печати компонента.
`protected void`	`printBorder(Graphics g)`	Печатает границу компонента.
`protected void`	`printChildren(Graphics g)`	Печатает потомков этого компонента.
`protected void`	`printComponent(Graphics g)`	Вызывается во время операции печати.
`protected void`	`processComponentKeyEvent(KeyEvent e)`	Обрабатывает любые события нажатия клавиш, которые распознает сам компонент.
`protected boolean`	`processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)`	Вызывается для обработки привязок клавиш для `ks` в результате `KeyEvent` `e`.
`protected void`	`processKeyEvent(KeyEvent e)`	Переопределяет `processKeyEvent` для обработки событий.
`protected void`	`processMouseEvent(MouseEvent e)`	Обрабатывает события мыши, происходящие на этом компоненте, направляя их зарегистрированным объектам `MouseListener`, см. `Component.processMouseEvent(MouseEvent)` для полного описания этого метода.
`protected void`	`processMouseMotionEvent(MouseEvent e)`	Обрабатывает события перемещения мыши, такие как MouseEvent.MOUSE_DRAGGED.
`final void`	`putClientProperty(Object key, Object value)`	Добавляет произвольное свойство "свойство клиента" ключ/значение в этот компонент.
`void`	`registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)`	Этот метод устарел. Пожалуйста, используйте комбинацию `getActionMap()` и `getInputMap()` для аналогичного поведения.
`void`	`registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)`	Этот метод устарел. Пожалуйста, используйте комбинацию `getActionMap()` и `getInputMap()` для аналогичного поведения.
`void`	`removeAncestorListener(AncestorListener listener)`	Отменяет регистрацию `listener`, чтобы он больше не получал `AncestorEvents`.
`void`	`removeNotify()`	Сообщает этому компоненту, что у него больше нет родительского компонента.
`void`	`removeVetoableChangeListener(VetoableChangeListener listener)`	Удаляет `VetoableChangeListener` из списка слушателей.
`void`	`repaint(long tm, int x, int y, int width, int height)`	Добавляет указанную область в список грязных областей, если компонент отображается.
`void`	`repaint(Rectangle r)`	Добавляет указанную область в список грязных областей, если компонент отображается.
`boolean`	`requestDefaultFocus()`	Устарело. С версии 1.4 заменено на `FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()`
`void`	`requestFocus()`	Запрашивает, чтобы этот `Component` получил фокус ввода.
`boolean`	`requestFocus(boolean temporary)`	Запрашивает, чтобы этот `Component` получил фокус ввода.
`boolean`	`requestFocusInWindow()`	Запрашивает, чтобы этот `Component` получил фокус ввода.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Запрашивает, чтобы этот `Component` получил фокус ввода.
`void`	`resetKeyboardActions()`	Отменяет регистрацию всех привязок в первом уровне `InputMaps` и `ActionMap`.
`void`	`reshape(int x, int y, int w, int h)`	Устарело. С версии JDK 5 заменено на `Component.setBounds(int, int, int, int)`.
`void`	`revalidate()`	Поддерживает отложенную автоматическую компоновку.
`void`	`scrollRectToVisible(Rectangle aRect)`	Пересылает сообщение `scrollRectToVisible()` родителю `JComponent`.
`final void`	`setActionMap(ActionMap am)`	Устанавливает `ActionMap` в `am`.
`void`	`setAlignmentX(float alignmentX)`	Устанавливает горизонтальное выравнивание.
`void`	`setAlignmentY(float alignmentY)`	Устанавливает вертикальное выравнивание.
`void`	`setAutoscrolls(boolean autoscrolls)`	Устанавливает свойство `autoscrolls`.
`void`	`setBackground(Color bg)`	Устанавливает цвет фона этого компонента.
`void`	`setBorder(Border border)`	Устанавливает границу этого компонента.

END_OF_DOCUMENT_MARKER

`void`	`setComponentPopupMenu(JPopupMenu popup)`	Устанавливает `JPopupMenu` для данного `JComponent`.
`void`	`setDebugGraphicsOptions(int debugOptions)`	Включает или отключает диагностическую информацию о каждой графической операции, выполненной внутри компонента или одного из его дочерних элементов.
`static void`	`setDefaultLocale(Locale l)`	Устанавливает локаль по умолчанию, используемую для инициализации свойства locale каждого компонента JComponent при создании.
`void`	`setDoubleBuffered(boolean aFlag)`	Устанавливает, должен ли этот компонент использовать буфер для рисования.
`void`	`setEnabled(boolean enabled)`	Устанавливает, активен ли этот компонент.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Устанавливает клавиши перемещения фокуса для заданной операции перемещения для данного компонента Component.
`void`	`setFont(Font font)`	Устанавливает шрифт для этого компонента.
`void`	`setForeground(Color fg)`	Устанавливает цвет переднего плана этого компонента.
`void`	`setInheritsPopupMenu(boolean value)`	Устанавливает, должен ли `getComponentPopupMenu` делегировать родительскому элементу, если этому компоненту не назначен `JPopupMenu`.
`final void`	`setInputMap(int condition, InputMap map)`	Устанавливает `InputMap` для использования при условии `condition` в `map`.
`void`	`setInputVerifier(InputVerifier inputVerifier)`	Устанавливает верификатор ввода для этого компонента.
`void`	`setMaximumSize(Dimension maximumSize)`	Устанавливает максимальный размер этого компонента в константу.
`void`	`setMinimumSize(Dimension minimumSize)`	Устанавливает минимальный размер этого компонента в константу.
`void`	`setNextFocusableComponent(Component aComponent)`	Устаревший. С версии 1.4, заменён на `FocusTraversalPolicy`
`void`	`setOpaque(boolean isOpaque)`	Если true, компонент рисует каждый пиксель в пределах своих границ.
`void`	`setPreferredSize(Dimension preferredSize)`	Устанавливает предпочтительный размер этого компонента.
`void`	`setRequestFocusEnabled(boolean requestFocusEnabled)`	Даёт подсказку, должен ли этот `JComponent` получить фокус.
`void`	`setTransferHandler(TransferHandler newHandler)`	Регистрирует текст для отображения в подсказке.
`void`	`TransferHandler`	Устанавливает `TransferHandler`, который обеспечивает поддержку передачи данных в этот компонент и из него с помощью вырезания/копирования/вставки и перетаскивания.
`protected void`	`setUI(ComponentUI newUI)`	Устанавливает делегата для настройки внешнего вида этого компонента.
`void`	`setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)`	Устанавливает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед запросом фокуса этим компонентом.
`void`	`setVisible(boolean aFlag)`	Делает компонент видимым или невидимым.
`void`	`unregisterKeyboardAction(KeyStroke aKeyStroke)`	Этот метод теперь устарел.
`void`	`update(Graphics g)`	Вызывает `paint`.
`void`	`updateUI()`	Этот метод вызывается для обновления свойства пользовательского интерфейса значением из текущей темы оформления.

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

Подробное описание полей

ui

protected transient ComponentUI ui

Делегат внешнего вида и ощущений для этого компонента.

listenerList

protected EventListenerList listenerList

Список обработчиков событий для этого компонента.

WHEN_FOCUSED

public static final int WHEN_FOCUSED

Константа, используемая для registerKeyboardAction, что означает, что команда должна быть вызвана, когда компонент имеет фокус.

См. также:

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

public static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

Константа, используемая для registerKeyboardAction, что означает, что команда должна быть вызвана, когда принимающий компонент является предком фокусированного компонента или является самим фокусированным компонентом.

См. также:

WHEN_IN_FOCUSED_WINDOW

public static final int WHEN_IN_FOCUSED_WINDOW

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

См. также:

UNDEFINED_CONDITION

public static final int UNDEFINED_CONDITION

Константа, используемая некоторыми API для обозначения того, что ни одно условие не определено.

См. также:

TOOL_TIP_TEXT_KEY

public static final String TOOL_TIP_TEXT_KEY

Комментарий для отображения при наведении курсора на компонент, также известный как "подсказка", "помощь при наведении" или "метка при наведении".

См. также:

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

JComponent

public JComponent()

Конструктор по умолчанию. Этот конструктор выполняет очень небольшую инициализацию, помимо вызова конструктора Container. Например, начальный менеджер компоновки — null. Однако он устанавливает свойство locale компонента в значение, возвращаемое JComponent.getDefaultLocale.

См. также:

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

setInheritsPopupMenu

@BeanProperty(description="Whether or not the JPopupMenu is inherited") public void setInheritsPopupMenu(boolean value)

Устанавливает, должен ли getComponentPopupMenu делегировать родительскому элементу, если у этого компонента нет назначенного JPopupMenu.

Значение по умолчанию — false, но некоторые подклассы JComponent, реализованные как множество JComponents, могут установить его в значение true.

Это свойство привязки.

Параметры:

value - должно ли JPopupMenu наследовать

С момента:

1.5

См. также:

getInheritsPopupMenu

public boolean getInheritsPopupMenu()

Возвращает true, если JPopupMenu должен наследовать от родителя.

Возвращает:

true, если JPopupMenu должен наследовать от родителя

С момента:

1.5

См. также:

setComponentPopupMenu

@BeanProperty(preferred=true, description="Popup to show") public void setComponentPopupMenu(JPopupMenu popup)

Устанавливает JPopupMenu для этого JComponent. UI отвечает за регистрацию привязок и добавление необходимых обработчиков, чтобы JPopupMenu отображался в нужное время. Время отображения JPopupMenu зависит от внешнего вида: некоторые могут отображать его при событии мыши, некоторые могут активировать привязку клавиш.

Если popup равно null, и getInheritsPopupMenu возвращает true, то getComponentPopupMenu будет делегировано родителю. Это предоставляет способ сделать все дочерние компоненты унаследовавшими JPopupMenu родителя.

Это свойство привязки.

Параметры:

popup - всплывающее меню, которое будет назначено этому компоненту, может быть null

С момента:

1.5

См. также:

getComponentPopupMenu

public JPopupMenu getComponentPopupMenu()

Возвращает JPopupMenu, назначенный для этого компонента. Если этому компоненту не назначено JPopupMenu и getInheritsPopupMenu равно true, это вернет getParent().getComponentPopupMenu() (предполагается, что родитель валиден).

Возвращает:

JPopupMenu назначенный для этого компонента или null если всплывающее меню не назначено

С момента:

1.5

См. также:

updateUI

public void updateUI()

Этот метод вызывается для обновления свойства UI до значения из текущего внешнего вида. JComponent подклассы должны переопределять этот метод следующим образом:

   public void updateUI() {
      setUI((SliderUI)UIManager.getUI(this);
   }

Требования к реализации:

Метод по умолчанию ничего не делает.

См. также:

getUI

public ComponentUI getUI()

Возвращает делегата внешнего вида, который отображает этот компонент.

Возвращает:: объект ComponentUI, который отображает этот компонент
С момента:: 9

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The component\'s look and feel delegate.") protected void setUI(ComponentUI newUI)

Устанавливает делегата внешнего вида для этого компонента. JComponent подклассы обычно переопределяют этот метод, чтобы сузить тип аргумента. Например, в JSlider:

 public void setUI(SliderUI newUI) {
     super.setUI(newUI);
 }

Кроме того, JComponent подклассы должны предоставить метод getUI, который возвращает правильный тип. Например:

 public SliderUI getUI() {
     return (SliderUI)ui;
 }

Параметры:

newUI - новый делегат UI

См. также:

getUIClassID

@BeanProperty(bound=false, expert=true, description="UIClassID") public String getUIClassID()

Возвращает UIDefaults ключ, используемый для поиска имени swing.plaf.ComponentUI класса, который определяет внешний вид для этого компонента. Большинству приложений не нужно вызывать этот метод. Подклассы JComponent, которые поддерживают подключаемый внешний вид, должны переопределять этот метод, чтобы вернуть UIDefaults ключ, который сопоставляется с подклассом ComponentUI внешнего вида.

Возвращает:

ключ UIDefaults для подкласса ComponentUI

См. также:

getComponentGraphics

protected Graphics getComponentGraphics(Graphics g)

Возвращает объект Graphics, используемый для рисования этого компонента. Если DebugGraphics включен, мы создаем новый объект DebugGraphics при необходимости. В противном случае мы просто настраиваем передний план и шрифт указанного объекта Graphics.

Параметры:: g - исходный объект Graphics
Возвращает:: объект Graphics настроенный для этого компонента

paintComponent

protected void paintComponent(Graphics g)

Вызывает метод рисования делегата пользовательского интерфейса, если делегат пользовательского интерфейса не null. Мы передаём делегату копию объекта Graphics, чтобы защитить остальную часть кода рисования от необратимых изменений (например, Graphics.translate).

Если вы переопределяете этот метод в подклассе, не вносите постоянных изменений в переданный объект Graphics. Например, не изменяйте область вырезания Rectangle или преобразовывание. Если вам нужно выполнить эти операции, вам может быть проще создать новый объект Graphics из переданного объекта Graphics и манипулировать им. Кроме того, если вы не вызываете реализацию родительского класса, вы должны соблюдать свойство непрозрачности; то есть, если этот компонент непрозрачен, вы должны полностью заполнить фон непрозрачным цветом. Если вы не соблюдаете свойство непрозрачности, вы, вероятно, увидите визуальные артефакты.

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

Parameters:

g - объект Graphics для защиты

See Also:

paintChildren

protected void paintChildren(Graphics g)

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

Parameters:

g - контекст Graphics для рисования

See Also:

paintBorder

protected void paintBorder(Graphics g)

Рисует границу компонента.

Parameters:

g - контекст Graphics для рисования

See Also:

update

public void update(Graphics g)

Вызывает paint. Не очищает фон, но см. ComponentUI.update, который вызывается paintComponent.

Overrides:

update в классе Container

Parameters:

g - контекст Graphics для рисования

See Also:

paint

public void paint(Graphics g)

Вызывается Swing для рисования компонентов. Приложения не должны вызывать paint напрямую, но вместо этого должны использовать метод repaint для планирования перерисовки компонента.

Этот метод фактически делегирует работу рисования трём защищённым методам: paintComponent, paintBorder и paintChildren. Они вызываются в указанном порядке, чтобы гарантировать, что дети появляются поверх самого компонента. Как правило, компонент и его дети не должны рисовать в области отступов, выделенной для рамки. Подклассы могут просто переопределить этот метод, как всегда. Подкласс, который просто хочет специализировать делегата пользовательского интерфейса (внешний вид и ощущения) метода paint, должен просто переопределить paintComponent.

Overrides:

paint в классе Container

Parameters:

g - контекст Graphics для рисования

See Also:

printAll

public void printAll(Graphics g)

Вызовите этот метод для печати компонента. Этот метод вызывает метод print на компоненте.

Overrides:

printAll в классе Component

Parameters:

g - контекст Graphics для рисования

See Also:

print

public void print(Graphics g)

Вызовите этот метод для печати компонента в указанный Graphics. Этот метод приведет к вызовам printComponent, printBorder и printChildren. Рекомендуется переопределить один из упомянутых методов, а не этот, если вы намерены настроить способ отображения печати. Однако, может быть полезно переопределить этот метод, если вы хотите подготовить состояние перед вызовом поведения родительского класса. Например, если вы хотите изменить цвет фона компонента перед печатью, вы можете сделать следующее:

     public void print(Graphics g) {
         Color orig = getBackground();
         setBackground(Color.WHITE);

         // wrap in try/finally so that we always restore the state
         try {
             super.print(g);
         } finally {
             setBackground(orig);
         }
     }

В качестве альтернативы, или для компонентов, которые делегируют рисование другим объектам, вы можете запросить во время рисования, находится ли компонент в процессе печати. Метод isPaintingForPrint предоставляет эту возможность, и его возвращаемое значение будет изменено этим методом: на true непосредственно перед рендерингом и на false непосредственно после. С каждым изменением на этом компоненте генерируется событие изменения свойства с именем "paintingForPrint".

Этот метод устанавливает состояние компонента таким образом, что двойной буфер не будет использоваться: рисование будет выполняться непосредственно на переданном Graphics.

Overrides:

print в классе Container

Parameters:

g - контекст Graphics для рисования

See Also:

printComponent

protected void printComponent(Graphics g)

Вызывается во время печати. Это реализовано для вызова paintComponent на компоненте. Переопределите этот метод, если вы хотите добавить специальное поведение рисования при печати.

Parameters:

g - контекст Graphics для рисования

Since:

1.3

See Also:

printChildren

protected void printChildren(Graphics g)

Печатает дочерние компоненты этого компонента. Это реализовано для вызова paintChildren на компоненте. Переопределите этот метод, если вы хотите печатать дочерние элементы по-другому, чем при рисовании.

Parameters:

g - контекст Graphics для рисования

Since:

1.3

See Also:

printBorder

protected void printBorder(Graphics g)

Печатает границу компонента. Это реализовано для вызова paintBorder на компоненте. Переопределите этот метод, если вы хотите печатать границу иначе, чем при рисовании.

Parameters:

g - контекст Graphics для рисования

Since:

1.3

See Also:

isPaintingTile

@BeanProperty(bound=false) public boolean isPaintingTile()

Возвращает true, если компонент в настоящее время рисует плитку. Если этот метод возвращает true, paint будет вызван снова для другой плитки. Этот метод возвращает false, если вы не рисуете плитку или если последняя плитка нарисована. Используйте этот метод для сохранения некоторого состояния, которое вам может потребоваться между плитками.

Returns:: true, если компонент в настоящее время рисует плитку, иначе false

isPaintingForPrint

@BeanProperty(bound=false) public final boolean isPaintingForPrint()

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

Вы можете обнаруживать изменения в значении этого свойства, прослушивая события изменения свойств на этом компоненте с именем "paintingForPrint".

Примечание: Этот метод предоставляет дополнительную функциональность, аналогичную той, что предоставляют другие API для печати Swing высокого уровня. Однако он строго обрабатывает рисование и не должен рассматриваться как предоставление информации о процессах печати более высокого уровня. Например, операция JTable.print() не обязательно приводит к непрерывному отображению всего компонента, и возвращаемое значение этого метода может изменяться несколько раз во время этой операции. Даже возможно, что компонент будет нарисован на экране, в то время как процесс печати продолжается. В таком случае возвращаемое значение этого метода равно true только и только тогда, когда таблица рисуется в рамках процесса печати.

Возвращает:

true, если текущая операция рисования на этом компоненте является частью операции печати

С:

1.6

См. также:

isManagingFocus

@Deprecated @BeanProperty(bound=false) public boolean isManagingFocus()

Устарело.

С версии 1.4 заменено на Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean).

В релизе 1.4 подсистема фокуса была перестроена. Дополнительную информацию см. в разделе Как использовать подсистему фокуса в Java Tutorial.

Изменяет клавиши перехода фокуса этого JComponent на CTRL+TAB и CTRL+SHIFT+TAB. Также предотвращает SortingFocusTraversalPolicy от учета потомков этого JComponent при вычислении цикла перехода фокуса.

Возвращает:

false

См. также:

setNextFocusableComponent

@Deprecated public void setNextFocusableComponent(Component aComponent)

Устарело.

С версии 1.4 заменено на FocusTraversalPolicy

Переопределяет по умолчанию FocusTraversalPolicy для цикла перехода фокуса этого JComponent, безусловно устанавливая указанный Component в качестве следующего Component в цикле и этот JComponent в качестве предыдущего Component указанного Component в цикле.

Параметры:

aComponent - компонент Component, который должен следовать за этим JComponent в цикле перехода фокуса

См. также:

getNextFocusableComponent

@Deprecated public Component getNextFocusableComponent()

Устарело.

С версии 1.4 заменено на FocusTraversalPolicy.

Возвращает Component , установленный предыдущим вызовом setNextFocusableComponent(Component) на этом JComponent.

Возвращает:

Component , который последует за этим JComponent в цикле перехода фокуса, или null , если явно не был указан

См. также:

setRequestFocusEnabled

public void setRequestFocusEnabled(boolean requestFocusEnabled)

Предоставляет подсказку о том, должен ли этот JComponent получить фокус. Это только подсказка, и потребители, запрашивающие фокус, должны учитывать это свойство. Обычно это учитывается для операций с мышкой, но не для операций с клавиатурой. Например, внешние вид и ощущения могли бы проверить это свойство на истинность перед запросом фокуса во время операции с мышкой. Это часто используется, если вы не хотите, чтобы нажатие мыши на JComponent отнимало фокус, но хотели, чтобы JComponent был доступен для перехода с помощью клавиатуры. Если вы вообще не хотите, чтобы этот JComponent был доступен для фокуса, используйте метод setFocusable вместо этого.

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

Параметры:

requestFocusEnabled - указывает, хотите ли вы, чтобы этот JComponent был доступен для фокуса

См. также:

isRequestFocusEnabled

public boolean isRequestFocusEnabled()

Возвращает true , если этот JComponent должен получить фокус; в противном случае возвращает false.

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

Возвращает:

true , если этот компонент должен получить фокус, в противном случае возвращает false

См. также:

requestFocus

public void requestFocus()

Запрашивает, чтобы этот Component получил фокус ввода. Обратитесь к Component.requestFocus() для полного описания этого метода.

Обратите внимание, что использование этого метода не рекомендуется, так как его поведение зависит от платформы. Вместо этого рекомендуется использовать requestFocusInWindow(). Для получения дополнительной информации о фокусе, см. Как использовать подсистему фокуса в Java Tutorial.

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

requestFocus в классе Component

С:

1.4

См. также:

requestFocus

public boolean requestFocus(boolean temporary)

Запрашивает, чтобы этот Component получил фокус ввода. Обратитесь к Component.requestFocus(boolean) для полного описания этого метода.

Обратите внимание, что использование этого метода не рекомендуется, так как его поведение зависит от платформы. Вместо этого рекомендуется использовать requestFocusInWindow(boolean). Для получения дополнительной информации о фокусе, см. Как использовать подсистему фокуса в Java Tutorial.

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

requestFocus в классе Component

Параметры:

temporary - boolean, указывающий, является ли изменение фокуса временным

Возвращает:

false , если запрос на изменение фокуса гарантированно завершится неудачей; true , если он, вероятно, завершится успешно

С:

1.4

См. также:

requestFocusInWindow

public boolean requestFocusInWindow()

Запрашивает, чтобы этот Component получил фокус ввода. Обратитесь к Component.requestFocusInWindow() для полного описания этого метода.

Для получения дополнительной информации о фокусе, см. Как использовать подсистему фокуса в Java Tutorial.

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

requestFocusInWindow в классе Component

Возвращает:

С:

1.4

См. также:

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

Запрашивает, чтобы этот Component получил фокус ввода. Обратитесь к Component.requestFocusInWindow(boolean) для полного описания этого метода.

Если вам нужна дополнительная информация о фокусе, см. Как использовать подсистему фокуса, раздел учебника Java.

Overrides:

requestFocusInWindow в классе Component

Parameters:

temporary - логическое значение, указывающее, является ли изменение фокуса временным

Returns:

false если запрос на изменение фокуса гарантированно потерпит неудачу; true если он, скорее всего, будет успешным

Since:

1.4

See Also:

grabFocus

public void grabFocus()

Запрашивает, чтобы этот компонент Component получил фокус ввода, и чтобы его родительское окно-предок стало фокусированным окном. Этот компонент должен быть отображаемым, видимым и доступным для фокуса, чтобы запрос был удовлетворён.

Этот метод предназначен для использования реализациями фокуса. Клиентский код не должен использовать этот метод; вместо этого он должен использовать requestFocusInWindow().

See Also:

setVerifyInputWhenFocusTarget

@BeanProperty(description="Whether the Component verifies input before accepting focus.") public void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)

Устанавливает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед запросом фокуса этим компонентом. По умолчанию значение true. Устанавливается в false для компонентов, таких как кнопка Отмена или полоса прокрутки, которые должны активироваться, даже если ввод в текущем владельце фокуса не «прошёл» верификатор ввода для этого компонента.

Parameters:

verifyInputWhenFocusTarget - значение для свойства verifyInputWhenFocusTarget

Since:

1.3

See Also:

getVerifyInputWhenFocusTarget

public boolean getVerifyInputWhenFocusTarget()

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

Returns:

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

Since:

1.3

See Also:

getFontMetrics

public FontMetrics getFontMetrics(Font font)

Получает FontMetrics для указанного Font.

Overrides:

getFontMetrics в классе Component

Parameters:

font - шрифт, для которого требуется получить метрики шрифта

Returns:

метрики шрифта для font

Throws:

NullPointerException - если font имеет значение null

Since:

1.5

See Also:

setPreferredSize

@BeanProperty(preferred=true, description="The preferred size of the component.") public void setPreferredSize(Dimension preferredSize)

Устанавливает предпочтительный размер этого компонента. Если preferredSize имеет значение null, UI запросит предпочтительный размер.

Overrides:

setPreferredSize в классе Component

Parameters:

preferredSize - новый предпочтительный размер или null

See Also:

getPreferredSize

public Dimension getPreferredSize()

Если предпочтительный размер был установлен в ненулевое значение, просто возвращает его. Если метод getPreferredSize делегата UI возвращает ненулевое значение, то возвращает это значение; в противном случае обращается к менеджеру компоновки компонента.

Overrides:

getPreferredSize в классе Container

Returns:

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

See Also:

setMaximumSize

@BeanProperty(description="The maximum size of the component.") public void setMaximumSize(Dimension maximumSize)

Устанавливает максимальный размер этого компонента в постоянное значение. Последующие вызовы getMaximumSize всегда будут возвращать это значение; UI компонента не будет запрошен для его вычисления. Установка максимального размера в null восстанавливает поведение по умолчанию.

Overrides:

setMaximumSize в классе Component

Parameters:

maximumSize - Dimension, содержащий желаемый максимальный размер

See Also:

getMaximumSize

public Dimension getMaximumSize()

Если максимальный размер был установлен в ненулевое значение, просто возвращает его. Если метод getMaximumSize делегата UI возвращает ненулевое значение, возвращает его; в противном случае обращается к менеджеру компоновки компонента.

Overrides:

getMaximumSize в классе Container

Returns:

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

See Also:

setMinimumSize

@BeanProperty(description="The minimum size of the component.") public void setMinimumSize(Dimension minimumSize)

Устанавливает минимальный размер этого компонента в постоянное значение. Последующие вызовы getMinimumSize всегда будут возвращать это значение; UI компонента не будет запрошен для его вычисления. Установка минимального размера в null восстанавливает поведение по умолчанию.

Overrides:

setMinimumSize в классе Component

Parameters:

minimumSize - новый минимальный размер этого компонента

See Also:

getMinimumSize

public Dimension getMinimumSize()

Если минимальный размер был установлен в ненулевое значение, просто возвращает его. Если метод getMinimumSize делегата UI возвращает ненулевое значение, возвращает его; в противном случае обращается к менеджеру компоновки компонента.

Overrides:

getMinimumSize в классе Container

Returns:

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

See Also:

contains

public boolean contains(int x, int y)

Предоставляет делегату UI возможность определить точную форму этого компонента для обработки мыши.

Overrides:

contains в классе Component

Parameters:

x - координата x точки

y - координата y точки

Returns:

true, если этот компонент логически содержит x,y

See Also:

setBorder

@BeanProperty(preferred=true, visualUpdate=true, description="The component\'s border.") public void setBorder(Border border)

Устанавливает границу этого компонента. Объект Border отвечает за определение отступов для компонента (переопределяя любые отступы, установленные непосредственно на компоненте) и за необязательную отрисовку любых декоративных элементов границы в пределах этих отступов. Границы должны использоваться (вместо отступов) для создания как декоративных, так и не декоративных (например, отступов и отступов) областей для компонента Swing. Составные границы могут использоваться для вложенности нескольких границ внутри одного компонента.

Хотя технически вы можете установить границу на любой объект, унаследованный от JComponent, реализация внешнего вида и ощущения многих стандартных компонентов Swing не работает хорошо с пользовательскими границами. В общем случае, когда вы хотите установить границу на стандартном компоненте Swing, отличном от JPanel или JLabel, рекомендуется поместить компонент в JPanel и установить границу на JPanel.

Это свойство привязано.

Параметры:

border - граница, которая должна быть отрисована для этого компонента

См. также:

getBorder

public Border getBorder()

Возвращает границу этого компонента или null, если граница в данный момент не установлена.

Возвращает:

объект границы для этого компонента

См. также:

getInsets

@BeanProperty(expert=true) public Insets getInsets()

Если для этого компонента установлена граница, возвращает отступы границы; в противном случае вызывает super.getInsets.

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

getInsets в классе Container

Возвращает:

значение свойства отступов

См. также:

getInsets

public Insets getInsets(Insets insets)

Возвращает объект Insets, содержащий значения отступов этого компонента. Переданный объект Insets будет повторно использован, если это возможно. Однако вызывающие методы не могут предполагать, что будет возвращен тот же объект. Все существующие значения в этом объекте перезаписываются. Если insets равно null, будет выделен новый.

Параметры:

insets - объект Insets, который может быть повторно использован

Возвращает:

объект Insets

См. также:

getAlignmentY

public float getAlignmentY()

Переопределяет Container.getAlignmentY для возвращения вертикального выравнивания.

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

getAlignmentY в классе Container

Возвращает:

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

См. также:

setAlignmentY

@BeanProperty(description="The preferred vertical alignment of the component.") public void setAlignmentY(float alignmentY)

Устанавливает вертикальное выравнивание.

Параметры:

alignmentY - новое вертикальное выравнивание

См. также:

getAlignmentX

public float getAlignmentX()

Переопределяет Container.getAlignmentX для возвращения горизонтального выравнивания.

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

getAlignmentX в классе Container

Возвращает:

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

См. также:

setAlignmentX

@BeanProperty(description="The preferred horizontal alignment of the component.") public void setAlignmentX(float alignmentX)

Устанавливает горизонтальное выравнивание.

Параметры:

alignmentX - новое горизонтальное выравнивание

См. также:

setInputVerifier

@BeanProperty(description="The component\'s input verifier.") public void setInputVerifier(InputVerifier inputVerifier)

Устанавливает проверяющий ввод для этого компонента.

Параметры:

inputVerifier - новый проверяющий ввод

С тех пор как:

1.3

См. также:

getInputVerifier

public InputVerifier getInputVerifier()

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

Возвращает:

свойство inputVerifier

С тех пор как:

1.3

См. также:

getGraphics

@BeanProperty(bound=false) public Graphics getGraphics()

Возвращает контекст графики этого компонента, который позволяет рисовать на компоненте. Используйте этот метод для получения объекта Graphics и затем вызывайте операции на этом объекте для рисования на компоненте.

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

getGraphics в классе Component

Возвращает:

контекст графики этого компонента

См. также:

setDebugGraphicsOptions

@BeanProperty(bound=false, preferred=true, enumerationValues={"DebugGraphics.NONE_OPTION","DebugGraphics.LOG_OPTION","DebugGraphics.FLASH_OPTION","DebugGraphics.BUFFERED_OPTION"}, description="Diagnostic options for graphics operations.") public void setDebugGraphicsOptions(int debugOptions)

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

Параметры:

debugOptions - определяет, как компонент должен отображать информацию; один из следующих вариантов:

DebugGraphics.LOG_OPTION - вызывает печать текстового сообщения.
DebugGraphics.FLASH_OPTION - вызывает несколько вспышек рисования.
DebugGraphics.BUFFERED_OPTION - создает ExternalWindow, отображающий операции, выполняемые на отложенном буфере представления.
DebugGraphics.NONE_OPTION отключает отладку.
Значение 0 не меняет параметры отладки.

debugOptions выполняет побитовое ИЛИ с текущим значением

getDebugGraphicsOptions

public int getDebugGraphicsOptions()

Возвращает состояние отладки графики.

Возвращает:

побитовое ИЛИ флаг нуля или более из следующих параметров:

DebugGraphics.LOG_OPTION - вызывает печать текстового сообщения.
DebugGraphics.FLASH_OPTION - вызывает несколько вспышек рисования.
DebugGraphics.BUFFERED_OPTION - создает ExternalWindow, отображающий операции, выполняемые на отложенном буфере представления.
DebugGraphics.NONE_OPTION отключает отладку.
Значение 0 не меняет параметры отладки.

См. также:

registerKeyboardAction

public void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)

Этот метод устарел, пожалуйста, используйте комбинацию getActionMap() и getInputMap() для аналогичного поведения. Например, для привязки KeyStroke aKeyStroke к Action anAction используйте сейчас:

   component.getInputMap().put(aKeyStroke, aCommand);
   component.getActionMap().put(aCommmand, anAction);

Выше предполагается, что привязка должна быть применима для WHEN_FOCUSED. Для регистрации привязок для других состояний фокуса используйте метод getInputMap, который принимает целое число.

Регистрирует новое действие по нажатию клавиши. anAction будет вызван, если произойдёт событие нажатия клавиши, соответствующее aKeyStroke и aCondition подтвердится. Объект KeyStroke определяет конкретную комбинацию клавиши и одного или нескольких модификаторов (alt, shift, ctrl, meta).

Объект aCommand будет установлен в доставленном событии, если это указано.

aCondition может быть одним из следующих:

WHEN_FOCUSED

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

WHEN_IN_FOCUSED_WINDOW

Действие будет вызвано, когда нажатие клавиши происходит, когда у компонента есть фокус или если компонент находится в окне, имеющем фокус. Обратите внимание, что компонент не обязательно должен быть непосредственным потомком окна – он может находиться где угодно в иерархии контейнеров окна. Другими словами, когда любой компонент в окне имеет фокус, вызывается действие, зарегистрированное с этим компонентом.

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

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

Комбинация нажатий клавиш и условий позволяет определять события действий высокого уровня (семантические) для заданной комбинации нажатия клавиши + модификатор (используя класс KeyStroke) и направлять их к родителю или потомку компонента, имеющего фокус, или к самому компоненту. Другими словами, в любой иерархической структуре компонентов произвольная комбинация клавиш может быть немедленно направлена к соответствующему компоненту в иерархии и вызвать выполнение определенного метода (обычно через адаптерные объекты).

Если для контейнера-получателя уже зарегистрировано действие с тем же кодом символа и теми же модификаторами, anAction заменит это действие.

Parameters:

anAction - регистрируемое Action

aCommand - команда, которая будет установлена в доставленном событии

aKeyStroke - KeyStroke для привязки к действию

aCondition - условие, которое должно быть выполнено, см. выше

See Also:

registerKeyboardAction

public void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)

Этот метод устарел, пожалуйста, используйте комбинацию getActionMap() и getInputMap() для аналогичного поведения.

Parameters:

anAction - действие, которое будет зарегистрировано для данной комбинации клавиш и условия

aKeyStroke - KeyStroke

aCondition - условие, которое должно быть ассоциировано с заданной комбинацией клавиш и действием

See Also:

unregisterKeyboardAction

public void unregisterKeyboardAction(KeyStroke aKeyStroke)

Этот метод устарел. Для отмены существующей привязки можно либо удалить привязку из ActionMap/InputMap, либо поместить дублирующую привязку в InputMap. Удаление привязки из InputMap позволяет привязки в родительских InputMap оставаться активными, в то время как размещение дублирующей привязки в InputMap эффективно отключает привязку.

Parameters:: aKeyStroke - комбинация клавиш, для которой необходимо отменить действие по нажатию клавиш

getRegisteredKeyStrokes

@BeanProperty(bound=false) public KeyStroke[] getRegisteredKeyStrokes()

Возвращает KeyStrokes , которые инициируют зарегистрированные действия.

Returns:

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

See Also:

getConditionForKeyStroke

public int getConditionForKeyStroke(KeyStroke aKeyStroke)

Возвращает условие, определяющее, произойдёт ли зарегистрированное действие в ответ на указанную комбинацию клавиш.

Для платформы Java 2 v1.3, KeyStroke может быть ассоциирован с несколькими условиями. Например, 'a' может быть привязан для двух условий: WHEN_FOCUSED и WHEN_IN_FOCUSED_WINDOW.

Parameters:: aKeyStroke - комбинация клавиш, для которой запрашивается условие действия-комбинации клавиш
Returns:: условие действия-комбинации клавиш

getActionForKeyStroke

public ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)

Возвращает объект, который выполнит действие, зарегистрированное для заданной комбинации клавиш.

Parameters:: aKeyStroke - комбинация клавиш, для которой требуется вернуть обработчик
Returns:: объект ActionListener , вызываемый при нажатии комбинации клавиш

resetKeyboardActions

public void resetKeyboardActions()

Отменяет все привязки в первом уровне InputMaps и ActionMap. Это приводит к удалению всех локальных привязок и сохранению привязок, определенных в родительских InputMap/ActionMaps (интерфейс обычно определяется во втором уровне).

setInputMap

public final void setInputMap(int condition, InputMap map)

Устанавливает InputMap для использования при условии condition в map. Значение null означает, что вы не хотите использовать какие-либо привязки, даже из интерфейса. Это не переустановит интерфейсный InputMap (если он был). condition принимает одно из следующих значений:

WHEN_IN_FOCUSED_WINDOW
WHEN_FOCUSED
WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

Если condition равно WHEN_IN_FOCUSED_WINDOW и map не является ComponentInputMap, будет брошено исключение IllegalArgumentException. Аналогично, если condition не имеет одного из перечисленных значений, будет брошено исключение IllegalArgumentException.

Parameters:: condition - одно из перечисленных значений выше; map - InputMap для использования в заданном условии
Throws:: IllegalArgumentException - если condition равно WHEN_IN_FOCUSED_WINDOW и map не является экземпляром ComponentInputMap; или если condition не имеет одного из допустимых значений, указанных выше
Since:: 1.3

getInputMap

public final InputMap getInputMap(int condition)

Возвращает InputMap , используемый во время condition.

Parameters:: condition - одно из значений WHEN_IN_FOCUSED_WINDOW, WHEN_FOCUSED, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Returns:: InputMap для указанного condition
Since:: 1.3

getInputMap

public final InputMap getInputMap()

Возвращает InputMap , используемый, когда у компонента есть фокус. Это удобный метод для getInputMap(WHEN_FOCUSED).

Returns:: InputMap , используемый, когда у компонента есть фокус
Since:: 1.3

setActionMap

public final void setActionMap(ActionMap am)

Устанавливает ActionMap в am. Это не устанавливает родителя am в ActionMap из интерфейса (если он был), это задача вызывающего кода.

Parameters:: am - новый ActionMap
Since:: 1.3

getActionMap

public final ActionMap getActionMap()

Возвращает ActionMap , используемый для определения, какое Action следует вызвать для конкретной KeyStroke привязки. Возвращенный ActionMap, если не указано иное, будет иметь ActionMap из интерфейса в качестве родителя.

Returns:: ActionMap , содержащий привязки ключ/действие
Since:: 1.3

getBaseline

public int getBaseline(int width, int height)

Возвращает базовую линию. Базовая линия измеряется от верхней части компонента. Этот метод предназначен в первую очередь для LayoutManager для выравнивания компонентов вдоль их базовой линии. Возвращаемое значение меньше 0 указывает, что у этого компонента нет разумной базовой линии, и что LayoutManager не следует выравнивать этот компонент по его базовой линии.

Этот метод обращается к методу ComponentUI с таким же именем. Если у этого компонента нет ComponentUI, возвращается -1. Если возвращается значение >= 0, то компонент имеет допустимую базовую линию для любого размера >= минимального размера, и getBaselineResizeBehavior можно использовать для определения того, как изменяется базовая линия при изменении размера.

Overrides:

getBaseline в классе Component

Параметры:

width - ширина для получения базовой линии

height - высота для получения базовой линии

Возвращает:

базовую линию или < 0, если нет разумной базовой линии

Выбрасывает:

IllegalArgumentException - если ширина или высота меньше 0

С:

1.6

См. также:

getBaselineResizeBehavior

@BeanProperty(bound=false) public Component.BaselineResizeBehavior getBaselineResizeBehavior()

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

Этот метод обращается к методу ComponentUI с таким же именем. Если у этого компонента нет ComponentUI BaselineResizeBehavior.OTHER будет возвращено. Подклассы никогда не должны возвращать null; если базовая линия не может быть вычислена, возвращается BaselineResizeBehavior.OTHER. Вызывающие методы должны сначала запросить базовую линию с помощью getBaseline и, если возвращено значение >= 0, использовать этот метод. Приемлемо, чтобы этот метод возвращал значение отличное от BaselineResizeBehavior.OTHER даже если getBaseline возвращает значение меньше 0.

Overrides:

getBaselineResizeBehavior в классе Component

Возвращает:

перечисление, указывающее, как изменяется базовая линия при изменении размера компонента

С:

1.6

См. также:

requestDefaultFocus

@Deprecated public boolean requestDefaultFocus()

Устарело.

С версии 1.4 заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()

В релизе 1.4 подсистема фокуса была перепроектирована. Для получения дополнительной информации см. Как использовать подсистему фокуса, раздел в Java Tutorial.

Запрашивает фокус на этом JComponent's FocusTraversalPolicy's Component. Если этот JComponent является корнем цикла фокуса, используется его FocusTraversalPolicy. В противном случае используется FocusTraversalPolicy предка этого JComponent в цикле фокуса.

Возвращает:

true, если этот компонент может запросить получение фокуса ввода, false в противном случае

См. также:

setVisible

@BeanProperty(hidden=true, visualUpdate=true) public void setVisible(boolean aFlag)

Делает компонент видимым или невидимым. Переопределяет Component.setVisible.

Overrides:

setVisible в классе Component

Параметры:

aFlag - true для отображения компонента; false для скрытия

См. также:

setEnabled

@BeanProperty(expert=true, preferred=true, visualUpdate=true, description="The enabled state of the component.") public void setEnabled(boolean enabled)

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

Примечание: отключение компонента не отключает его дочерние элементы.

Примечание: отключение легкого компонента не препятствует получению им событий MouseEvents.

Overrides:

setEnabled в классе Component

Параметры:

enabled - true, если этот компонент должен быть активирован, false в противном случае

См. также:

setForeground

@BeanProperty(preferred=true, visualUpdate=true, description="The foreground color of the component.") public void setForeground(Color fg)

Устанавливает цвет переднего плана этого компонента. Визуальное представление может игнорировать этот параметр.

Overrides:

setForeground в классе Component

Параметры:

fg - желаемый цвет переднего плана

См. также:

setBackground

@BeanProperty(preferred=true, visualUpdate=true, description="The background color of the component.") public void setBackground(Color bg)

Устанавливает цвет фона этого компонента. Цвет фона используется только если компонент непрозрачен, и только подклассами JComponent или ComponentUI. Прямые подклассы JComponent должны переопределить paintComponent для учета этого свойства.

Визуальное представление может игнорировать этот параметр.

Overrides:

setBackground в классе Component

Параметры:

bg - желаемый цвет фона

См. также:

setFont

@BeanProperty(preferred=true, visualUpdate=true, description="The font for the component.") public void setFont(Font font)

Устанавливает шрифт для этого компонента.

Overrides:

setFont в классе Container

Параметры:

font - желаемый шрифт для этого компонента

См. также:

getDefaultLocale

public static Locale getDefaultLocale()

Возвращает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании. Локаль по умолчанию имеет область "AppContext", чтобы апплеты (и потенциально несколько легких приложений, работающих в одной виртуальной машине) могли иметь собственное значение. Аплет может безопасно изменить локаль по умолчанию, поскольку это не повлияет на другие апплеты (или браузер).

Возвращает:

локаль по умолчанию.

С:

1.4

См. также:

setDefaultLocale

public static void setDefaultLocale(Locale l)

Устанавливает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании. Начальное значение — локаль по умолчанию виртуальной машины. Локаль по умолчанию имеет область "AppContext", чтобы апплеты (и потенциально несколько легких приложений, работающих в одной виртуальной машине) могли иметь собственное значение. Аплет может безопасно изменить локаль по умолчанию, поскольку это не повлияет на другие апплеты (или браузер). Передача null сбросит текущую локаль обратно к локале по умолчанию виртуальной машины.

Параметры:

l - желаемая локаль по умолчанию для новых компонентов.

С:

1.4

См. также:

processComponentKeyEvent

protected void processComponentKeyEvent(KeyEvent e)

Обрабатывает любые события клавиш, которые распознает сам компонент. Этот метод вызывается после того, как менеджер фокуса и любые заинтересованные слушатели получили возможность перехватить событие. Этот метод вызывается только в том случае, если событие еще не обработано. Этот метод вызывается до логики пользовательского интерфейса клавиатуры.

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

Параметры:: e - событие для обработки

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

protected void processKeyEvent(KeyEvent e)

Переопределяет processKeyEvent для обработки событий.

Overrides:

processKeyEvent в классе Component

Параметры:

e - событие нажатия клавиши

См. также:

Обработка привязки к клавише

protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)

Вызывается для обработки привязок к клавишам для ks в результате KeyEvent e. Получает соответствующую InputMap, привязку, действие из ActionMap, а затем (если действие найдено и компонент активен), вызывает notifyAction для уведомления об этом действии.

Параметры:

ks - запрос к KeyStroke

e - событие KeyEvent

condition - одно из следующих значений:

JComponent.WHEN_FOCUSED
JComponent.WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
JComponent.WHEN_IN_FOCUSED_WINDOW

pressed - true, если клавиша нажата

Возвращает:

true, если была привязка к действию, и действие было включено

С тех пор:

1.3

Установить подсказку

@BeanProperty(bound=false, preferred=true, description="The text to display in a tool tip.") public void setToolTipText(String text)

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

См. Использование всплывающих подсказок в Java Tutorial для дополнительной документации.

Параметры:

text - строка для отображения; если текст null, всплывающая подсказка отключается для данного компонента

См. также:

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

public String getToolTipText()

Возвращает строку всплывающей подсказки, которая была установлена с помощью setToolTipText.

Возвращает:

текст всплывающей подсказки

См. также:

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

public String getToolTipText(MouseEvent event)

Возвращает строку, используемую в качестве всплывающей подсказки для event. По умолчанию это возвращает любую строку, установленную с помощью setToolTipText. Если компонент предоставляет более расширенный API для поддержки различных всплывающих подсказок в разных местах, этот метод должен быть переопределён.

Параметры:: event - событие мыши, которое инициировало отображение ToolTip подсказки
Возвращает:: строка, содержащая всплывающую подсказку

Получить расположение всплывающей подсказки

public Point getToolTipLocation(MouseEvent event)

Возвращает расположение всплывающей подсказки в системе координат этого компонента. Если null возвращается, Swing выберет расположение. По умолчанию возвращается null.

Параметры:: event - событие мыши, вызвавшее отображение всплывающей подсказки
Возвращает:: всегда возвращает null

Получить расположение всплывающего меню

public Point getPopupLocation(MouseEvent event)

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

Параметры:: event - событие мыши, которое вызвало отображение всплывающего меню, или null если всплывающее меню не отображается в результате события мыши
Возвращает:: местоположение для отображения JPopupMenu, или null
С тех пор:: 1.5

Создать всплывающую подсказку

public JToolTip createToolTip()

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

Возвращает:: экземпляр JToolTip для отображения этой всплывающей подсказки

Прокрутить прямоугольник в видимую область

public void scrollRectToVisible(Rectangle aRect)

Пересылает сообщение scrollRectToVisible() родительскому элементу JComponent. Компоненты, которые могут обработать этот запрос, такие как JViewport, переопределяют этот метод и выполняют прокрутку.

Параметры:

aRect - видимый Rectangle прямоугольник

См. также:

Установить автоматическую прокрутку

@BeanProperty(bound=false, expert=true, description="Determines if this component automatically scrolls its contents when dragged.") public void setAutoscrolls(boolean autoscrolls)

Устанавливает свойство autoscrolls. Если true, при перетаскивании мыши вне границ компонента и приостановке движения мыши (при сохранении нажатия кнопки), будут генерироваться синтетические события перетаскивания. Синтетические события имитируют возобновление жеста перетаскивания в направлении, установленном при пересечении границы компонента. Компоненты, поддерживающие автоматическую прокрутку, должны обрабатывать события перетаскивания мыши, вызывая scrollRectToVisible с прямоугольником, содержащим расположение события мыши. Все компоненты Swing, которые поддерживают выбор элементов и обычно отображаются в области прокрутки (JTable, JList, JTree, JTextArea, и JEditorPane) уже обрабатывают события перетаскивания мыши таким образом. Чтобы включить автоматическую прокрутку в любой другой компонент, добавьте обработчик перемещения мыши, который вызовет scrollRectToVisible. Например, для JPanel, myPanel:

 MouseMotionListener doScrollRectToVisible = new MouseMotionAdapter() {
     public void mouseDragged(MouseEvent e) {
        Rectangle r = new Rectangle(e.getX(), e.getY(), 1, 1);
        ((JPanel)e.getSource()).scrollRectToVisible(r);
    }
 };
 myPanel.addMouseMotionListener(doScrollRectToVisible);

По умолчанию свойство autoScrolls имеет значение false.

Параметры:

autoscrolls - если true, генерируются синтетические события перетаскивания мыши при перетаскивании мыши за пределы границ компонента и удерживании кнопки мыши; иначе false

См. также:

Получить автоматическую прокрутку

public boolean getAutoscrolls()

Получает свойство autoscrolls.

Возвращает:

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

См. также:

Установить обработчик передачи

@BeanProperty(hidden=true, description="Mechanism for transfer of data to and from the component") public void setTransferHandler(TransferHandler newHandler)

Устанавливает TransferHandler, который обеспечивает поддержку передачи данных в и из этого компонента через вырезку/копирование/вставку и перетаскивание. Может быть null если компонент не поддерживает операции передачи данных.

Если новый TransferHandler не null, этот метод также устанавливает новый DropTarget на компоненте для активации обработки падения через TransferHandler и активации любой встроенной поддержки (такой как вычисление и отображение потенциальных мест падения). Если вы не хотите, чтобы этот компонент реагировал на падения, вы можете полностью отключить поддержку падения, удалив целевой объект падения (setDropTarget(null)) или деактивировав его (getDropTaget().setActive(false)).

Если новый TransferHandler равен null, этот метод удаляет целевой объект падения.

В двух случаях этот метод не изменяет целевой объект падения: во-первых, если существующий целевой объект падения на этом компоненте был явно установлен разработчиком в значение non-null . Во-вторых, если системная переменная suppressSwingDropSupport имеет значение true. По умолчанию значение системной переменной false.

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

Параметры:

newHandler - новый TransferHandler обработчик передачи

С тех пор:

1.4

См. также:

getTransferHandler

public TransferHandler getTransferHandler()

Получает свойство transferHandler.

Возвращает:

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

С момента:

1.4

См. также:

processMouseEvent

protected void processMouseEvent(MouseEvent e)

Обрабатывает события мыши, происходящие на этом компоненте, направляя их зарегистрированным объектам MouseListener, см. Component.processMouseEvent(MouseEvent) для полного описания этого метода.

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

processMouseEvent в классе Component

Параметры:

e - событие мыши

С момента:

1.5

См. также:

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

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

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

processMouseMotionEvent в классе Component

Параметры:

e - событие MouseEvent

См. также:

enable

@Deprecated public void enable()

Устарело.

С версии JDK 1.1 заменено на java.awt.Component.setEnabled(boolean).

Переопределяет:: enable в классе Component

disable

@Deprecated public void disable()

Устарело.

С версии JDK 1.1 заменено на java.awt.Component.setEnabled(boolean).

Переопределяет:: disable в классе Component

getClientProperty

public final Object getClientProperty(Object key)

Возвращает значение свойства с указанным ключом. Только свойства, добавленные с помощью putClientProperty , вернут значение, отличное от null.

Параметры:

key - запрашиваемый ключ

Возвращает:

значение этого свойства или null

См. также:

putClientProperty

public final void putClientProperty(Object key, Object value)

Добавляет произвольное свойство "свойство клиента" с ключом/значением к этому компоненту.

Методы get/putClientProperty предоставляют доступ к небольшой хеш-таблице на экземпляр. Вызывающие стороны могут использовать get/putClientProperty для аннотации компонентов, созданных другим модулем. Например, менеджер макета может хранить ограничения для каждого дочернего элемента таким образом. Например:

 componentA.putClientProperty("to the left of", componentB);

Если значение равно null, этот метод удалит свойство. Изменения в свойствах клиента сообщаются с помощью событий PropertyChange . Название свойства (для событий PropertyChange) равно key.toString().

Словарь clientProperty не предназначен для поддержки крупных расширений JComponent и не должен рассматриваться как альтернатива наследованию при разработке нового компонента.

Параметры:

key - новый ключ свойства клиента

value - новое значение свойства клиента; если null этот метод удалит свойство

См. также:

setFocusTraversalKeys

public void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)

Устанавливает клавиши перемещения фокуса для заданной операции перемещения для этого компонента. См. Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>) для полного описания этого метода.

Этот метод может выбросить ClassCastException , если какой-либо Object в keystrokes не является AWTKeyStroke.

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

setFocusTraversalKeys в классе Container

Параметры:

id - одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

keystrokes - набор AWTKeyStroke для указанной операции

Исключения:

IllegalArgumentException - если id не совпадает ни с одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или если keystrokes содержит null, или если какой-либо keystroke представляет событие KEY_TYPED, или если какой-либо keystroke уже сопоставлен с другой операцией перемещения фокуса для этого компонента

С момента:

1.5

См. также:

isLightweightComponent

public static boolean isLightweightComponent(Component c)

Возвращает true, если этот компонент является лёгким, то есть у него нет родного виджета системы окон.

Параметры:: c - проверяемый компонент
Возвращает:: true, если компонент лёгкий

reshape

@Deprecated public void reshape(int x, int y, int w, int h)

Устарело.

С версии JDK 5, заменено на Component.setBounds(int, int, int, int).

Перемещает и изменяет размер этого компонента.

Описание, скопированное из класса: Component

Изменяет границы этого компонента.

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

reshape в классе Component

Параметры:

x - новое горизонтальное положение

y - новое вертикальное положение

w - новая ширина

h - новая высота

См. также:

getBounds

public Rectangle getBounds(Rectangle rv)

Сохраняет границы этого компонента в "значении возврата" rv и возвращает rv. Если rv равно null, выделяется новый Rectangle. Эта версия getBounds полезна, если вызывающая сторона хочет избежать выделения нового объекта Rectangle в куче.

Переопределяет:: getBounds в классе Component
Параметры:: rv - значение возврата, изменённое на границы компонента
Возвращает:: rv; если rv равно null, возвращает новый Rectangle с границами этого компонента

getSize

public Dimension getSize(Dimension rv)

Сохраняет ширину/высоту этого компонента в "значении возврата" rv и возвращает rv. Если rv равно null, выделяется новый объект Dimension . Эта версия getSize полезна, если вызывающая сторона хочет избежать выделения нового объекта Dimension в куче.

Переопределяет:: getSize в классе Component
Параметры:: rv - значение возврата, изменённое на размер компонента
Возвращает:: rv

getLocation

public Point getLocation(Point rv)

Сохраняет координаты x, y начала этого компонента в "значении возврата" rv и возвращает rv. Если rv равно null, выделяется новый Point . Эта версия getLocation полезна, если вызывающая сторона хочет избежать выделения нового объекта Point в куче.

Переопределяет:: getLocation в классе Component
Параметры:: rv - значение возврата, изменённое на расположение компонента
Возвращает:: rv

getX

@BeanProperty(bound=false) public int getX()

Возвращает текущую координату x начала компонента. Этот метод предпочтительнее, чем component.getBounds().x, или component.getLocation().x, так как не приводит к выделению памяти.

Переопределяет:: getX в классе Component
Возвращает:: текущую координату x начала компонента

getY

@BeanProperty(bound=false) public int getY()

Возвращает текущую координату y начала компоненты. Этот метод предпочтительнее, чем написание component.getBounds().y, или component.getLocation().y, потому что он не вызывает выделения памяти.

Overrides:: getY в классе Component
Возвращает:: текущую координату y начала компоненты

getWidth

@BeanProperty(bound=false) public int getWidth()

Возвращает текущую ширину этой компоненты. Этот метод предпочтительнее, чем написание component.getBounds().width, или component.getSize().width, потому что он не вызывает выделения памяти.

Overrides:: getWidth в классе Component
Возвращает:: текущую ширину этой компоненты

getHeight

@BeanProperty(bound=false) public int getHeight()

Возвращает текущую высоту этой компоненты. Этот метод предпочтительнее, чем написание component.getBounds().height, или component.getSize().height, потому что он не вызывает выделения памяти.

Overrides:: getHeight в классе Component
Возвращает:: текущую высоту этой компоненты

isOpaque

public boolean isOpaque()

Возвращает true, если эта компонента полностью непрозрачная.

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

Подклассы, которые гарантируют всегда полное рисование своего содержимого, должны переопределить этот метод и вернуть true.

Overrides:

isOpaque в классе Component

Возвращает:

true, если эта компонента полностью непрозрачная

См. также:

setOpaque

@BeanProperty(expert=true, description="The component\'s opacity") public void setOpaque(boolean isOpaque)

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

Значение по умолчанию этого свойства равно false для JComponent. Однако, значение по умолчанию этого свойства для большинства стандартных подклассов JComponent (таких как JButton и JTree) зависит от темы.

Параметры:

isOpaque - true, если эта компонента должна быть непрозрачной

См. также:

computeVisibleRect

public void computeVisibleRect(Rectangle visibleRect)

Возвращает "прямоугольник видимой области" компоненты - пересечение видимых прямоугольников для этой компоненты и всех её предков. Значение возврата сохраняется в visibleRect.

Параметры:

visibleRect - прямоугольник, вычисленный как пересечение всех видимых прямоугольников для этой компоненты и всех её предков -- это значение возврата для этого метода

См. также:

getVisibleRect

@BeanProperty(bound=false) public Rectangle getVisibleRect()

Возвращает "прямоугольник видимой области" компоненты - пересечение видимого прямоугольника этой компоненты, new Rectangle(0, 0, getWidth(), getHeight()), и видимых прямоугольников всех её предков.

Возвращает:: видимый прямоугольник

firePropertyChange

public void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)

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

Overrides:: firePropertyChange в классе Component
Параметры:: propertyName - свойство, значение которого изменилось; oldValue - предыдущее значение свойства; newValue - новое значение свойства

firePropertyChange

public void firePropertyChange(String propertyName, int oldValue, int newValue)

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

Overrides:: firePropertyChange в классе Component
Параметры:: propertyName - свойство, значение которого изменилось; oldValue - предыдущее значение свойства; newValue - новое значение свойства

fireVetoableChange

protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue) throws PropertyVetoException

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

Параметры:: propertyName - имя свойства, за которым ведётся наблюдение; oldValue - старое значение свойства; newValue - новое значение свойства
Исключения:: PropertyVetoException - когда попытка установить свойство отменена компонентой

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)

Добавляет VetoableChangeListener в список слушателей. Слушатель регистрируется для всех свойств.

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

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

Удаляет VetoableChangeListener из списка слушателей. Это удаляет VetoableChangeListener , который был зарегистрирован для всех свойств.

Параметры:: listener - удаляемый VetoableChangeListener

getVetoableChangeListeners

@BeanProperty(bound=false) public VetoableChangeListener[] getVetoableChangeListeners()

Возвращает массив всех слушателей изменений vetoable, зарегистрированных в этой компоненте.

Возвращает:

все слушатели изменений vetoable компоненты или пустой массив, если слушателей vetoable изменений нет.

Since:

1.4

См. также:

getTopLevelAncestor

@BeanProperty(bound=false) public Container getTopLevelAncestor()

Возвращает верхнего предка этой компоненты (либо содержащий её Window или Applet), или null, если эта компонента не добавлена ни в какой контейнер.

Возвращает:: верхний Container контейнер, в котором находится эта компонента, или null, если компонента не находится ни в каком контейнере.

addAncestorListener

public void addAncestorListener(AncestorListener listener)

Регистрирует listener таким образом, что он будет получать AncestorEvents при перемещении его или любого из его предков, или когда они становятся видимыми или невидимыми. События также отправляются при добавлении или удалении компоненты или её предков из иерархии вложения.

Параметры:

listener - регистрируемый AncestorListener

См. также:

removeAncestorListener

public void removeAncestorListener(AncestorListener listener)

Отменяет регистрацию listener, чтобы он больше не получал AncestorEvents.

Параметры:

listener - удаляемый AncestorListener

См. также:

getAncestorListeners

@BeanProperty(bound=false) public AncestorListener[] getAncestorListeners()

Возвращает массив всех слушателей предков, зарегистрированных в этой компоненте.

Возвращает:

все слушатели предков компоненты или пустой массив, если слушателей предков нет.

Since:

1.4

См. также:

END_OF_DOCUMENT_MARKER

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Возвращает массив всех объектов, в настоящее время зарегистрированных в качестве FooListener на этом JComponent. FooListener регистрируются с помощью метода addFooListener.

Вы можете указать аргумент listenerType с использованием литерала класса, например FooListener.class. Например, вы можете запросить JComponent c для его обработчиков событий мыши с помощью следующего кода:

MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));

Если такие обработчики не существуют, этот метод возвращает пустой массив.

Overrides:

getListeners в классе Container

Type Parameters:

T - тип обработчиков

Parameters:

listenerType - тип запрашиваемых обработчиков; этот параметр должен указать интерфейс, который наследуется от java.util.EventListener

Returns:

массив всех объектов, зарегистрированных в качестве FooListener на этом компоненте, или пустой массив, если такие обработчики не были добавлены

Throws:

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

Since:

1.3

See Also:

addNotify

public void addNotify()

Уведомляет этот компонент о том, что у него теперь есть родительский компонент. Когда вызывается этот метод, цепочка родительских компонентов устанавливается с KeyboardAction обработчиками событий. Этот метод вызывается средой исполнения внутри и не должен вызываться программами напрямую.

Overrides:

addNotify в классе Container

See Also:

removeNotify

public void removeNotify()

Уведомляет этот компонент о том, что у него больше нет родительского компонента. Когда вызывается этот метод, все KeyboardAction установленные в цепочке родительских компонентов удаляются. Этот метод вызывается средой исполнения внутри и не должен вызываться программами напрямую.

Overrides:

removeNotify в классе Container

See Also:

repaint

public void repaint(long tm, int x, int y, int width, int height)

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

Overrides:

repaint в классе Component

Parameters:

tm - этот параметр не используется

x - значение x грязной области

y - значение y грязной области

width - ширина грязной области

height - высота грязной области

See Also:

repaint

public void repaint(Rectangle r)

Parameters:

r - a Rectangle содержащий грязную область

See Also:

revalidate

public void revalidate()

Поддерживает отложенную автоматическую компоновку.

Вызывает invalidate и затем добавляет компонент к списку компонентов, которые необходимо валидировать. Валидация произойдёт после обработки всех текущих ожидающих событий. Другими словами, после вызова этого метода, первый validateRoot (если таковой имеется), найденный при обходе иерархии контейнеров этого компонента, будет проверен. По умолчанию JRootPane, JScrollPane, и JTextField возвращают true из isValidateRoot.

Этот метод автоматически вызывается на этом компоненте, когда значение свойства изменяется таким образом, что размер, расположение или внутренняя компоновка этого компонента изменяются. Это автоматическое обновление отличается от AWT, так как программы обычно больше не нуждаются в вызове validate для обновления содержимого графического интерфейса.

Overrides:

revalidate в классе Component

See Also:

isValidateRoot

public boolean isValidateRoot()

Если этот метод возвращает true, вызовы revalidate потомками этого компонента приведут к валидации всего дерева, начиная с этого корня. По умолчанию возвращает false. JScrollPane переопределяет этот метод и возвращает true.

Overrides:

isValidateRoot в классе Container

Returns:

всегда возвращает false

See Also:

isOptimizedDrawingEnabled

@BeanProperty(bound=false) public boolean isOptimizedDrawingEnabled()

Возвращает true, если этот компонент чередует своих потомков — то есть, если он может гарантировать, что потомки не будут перекрываться. Система перерисовки значительно эффективнее в этом распространённом случае. JComponent подклассы, которые не могут сделать это гарантию, такие как JLayeredPane, должны переопределить этот метод, чтобы вернуть false.

Returns:: всегда возвращает true

isPaintingOrigin

protected boolean isPaintingOrigin()

Возвращает true , если перерисовка, вызванная на дочернем компоненте, должна начать перерисовку с этого компонента или одного из его предков.

Вызов repaint(long, int, int, int, int) или paintImmediately(int, int, int, int) на компоненте Swing приведет к вызову метода paintImmediately(int, int, int, int) первого предка, который isPaintingOrigin() возвращает true, если таковой имеется.

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

Returns:

всегда возвращает false

See Also:

paintImmediately

public void paintImmediately(int x, int y, int w, int h)

Немедленно перерисовывает указанную область в этом компоненте и всех его потомках, которые перекрывают область.

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

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

Parameters:

x - значение x области для перерисовки

y - значение y области для перерисовки

w - ширина области для перерисовки

h - высота области для перерисовки

See Also:

paintImmediately

public void paintImmediately(Rectangle r)

Перерисовывает указанную область прямо сейчас.

Parameters:: r - a Rectangle содержащий область для перерисовки

setDoubleBuffered

public void setDoubleBuffered(boolean aFlag)

Устанавливает, должен ли этот компонент использовать буфер для перерисовки. Если установлено значение true, все отрисовки от этого компонента будут выполняться в буфере отложенной отрисовки. Буфер отложенной отрисовки будет скопирован на экран. Если компонент буферизован, а один из его предков тоже буферизован, будет использоваться буфер предка.

Parameters:: aFlag - если true, установить этот компонент для буферизации с двумя буферами

isDoubleBuffered

public boolean isDoubleBuffered()

Возвращает, использует ли этот компонент буфер для отрисовки.

Overrides:: isDoubleBuffered в классе Component
Возвращает:: true, если этот компонент использует двойной буферизацию, иначе false

getRootPane

@BeanProperty(bound=false) public JRootPane getRootPane()

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

Возвращает:: родительский контейнер, содержащий этот компонент, или null, если родительский контейнер не найден

paramString

protected String paramString()

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

Overrides:: paramString в классе Container
Возвращает:: строковое представление этого объекта

hide

@Deprecated public void hide()

Устарело.

Overrides:: hide в классе Component

© 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/JComponent.html