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

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 Swing package description и раздел The Java Tutorial Класс JComponent.

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

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

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

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

См. также:: KeyStroke, Action, setBorder(javax.swing.border.Border), registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int), JOptionPane, setDebugGraphicsOptions(int), setToolTipText(java.lang.String), setAutoscrolls(boolean)

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

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

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

Container.AccessibleAWTContainer

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

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

Поля

Модификатор и тип	Поле и описание
`protected EventListenerList`	`listenerList` Список слушателей событий для этого компонента.
`static String`	`TOOL_TIP_TEXT_KEY` Комментарий для отображения при наведении курсора на компонент, также известный как "подсказка значения", "помощь при наведении" или "метка при наведении".
`protected ComponentUI`	`ui` Делегат вида и ощущений для этого компонента.
`static int`	`UNDEFINED_CONDITION` Константа, используемая некоторыми API для обозначения того, что никакое условие не определено.
`static int`	`WHEN_ANCESTOR_OF_FOCUSED_COMPONENT` Константа для `registerKeyboardAction`, которая означает, что команда должна быть вызвана, когда принимающий компонент является предком фокусированного компонента или сам является фокусированным компонентом.
`static int`	`WHEN_FOCUSED` Константа для `registerKeyboardAction`, которая означает, что команда должна быть вызвана, когда компонент имеет фокус.
`static 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)` Предоставляет делегату пользовательского интерфейса возможность определить точную форму этого компонента для обработки событий мыши.
`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, char oldValue, char newValue)` Сообщает о изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, int oldValue, int newValue)` Поддержка отчёта о изменениях связанных свойств для целочисленных свойств.
`protected void`	`fireVetoableChange(String propertyName, Object oldValue, Object newValue)` Поддерживает отчёт о изменениях ограниченных свойств.
`ActionListener`	`getActionForKeyStroke(KeyStroke aKeyStroke)` Возвращает объект, который выполнит действие, зарегистрированное для заданной комбинации клавиш.
`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`.
`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 должен наследоваться от родителя.
`InputMap`	`getInputMap()` Возвращает `InputMap`, который используется, когда компонент имеет фокус.
`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`.
`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()` Возвращает, должен ли этот компонент использовать буфер для рисования.

END_OF_DOCUMENT_MARKER

`static boolean`	`isLightweightComponent(Component c)` Возвращает true, если этот компонент является лёгким, то есть если у него нет родного объекта системы окон.
`boolean`	`isManagingFocus()` Устарело. Начиная с версии 1.4, заменено на `Component.setFocusTraversalKeys(int, Set)` и `Container.setFocusCycleRoot(boolean)`.
`boolean`	`isOpaque()` Возвращает true, если этот компонент полностью непрозрачен.
`boolean`	`isOptimizedDrawingEnabled()` Возвращает true, если этот компонент выкладывает свои дочерние элементы плиткой — то есть, если он может гарантировать, что дочерние элементы не будут перекрываться.
`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.
`void`	`putClientProperty(Object key, Object value)` Добавляет произвольную пару "свойство клиента" ключ/значение к этому компоненту.
`void`	`registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)` Этот метод устарел, используйте комбинацию `getActionMap()` и `getInputMap()` для аналогичного поведения.
`void`	`registerKeyboardAction(ActionListener anAction, String aCommand, 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`.
`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)` Устанавливает границу этого компонента.
`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)` Устанавливает клавиши перехода для данной операции перехода для этого компонента.
`void`	`setFont(Font font)` Устанавливает шрифт для этого компонента.
`void`	`setForeground(Color fg)` Устанавливает цвет переднего плана этого компонента.
`void`	`setInheritsPopupMenu(boolean value)` Устанавливает, должен ли `getComponentPopupMenu` делегировать родителю, если у этого компонента нет назначенного `JPopupMenu`.
`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`	`setToolTipText(String text)` Регистрирует текст для отображения в подсказке.
`void`	`setTransferHandler(TransferHandler newHandler)` Устанавливает `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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, 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()

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

См. также:: getDefaultLocale()

Методы

setInheritsPopupMenu

public void setInheritsPopupMenu(boolean value)

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

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

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

Параметры:: value — наследовать ли JPopupMenu
С:: 1.5
См. также:: setComponentPopupMenu(javax.swing.JPopupMenu)

getInheritsPopupMenu

public boolean getInheritsPopupMenu()

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

С:: 1.5
См. также:: setComponentPopupMenu(javax.swing.JPopupMenu)

setComponentPopupMenu

public void setComponentPopupMenu(JPopupMenu popup)

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

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

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

Параметры:: popup — назначенный для этого компонента всплывающее меню, может быть null
С:: 1.5
См. также:: getComponentPopupMenu()

getComponentPopupMenu

public JPopupMenu getComponentPopupMenu()

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

Возвращает:: JPopupMenu для этого компонента или null при отсутствии назначенного popup меню
С:: 1.5
См. также:: setComponentPopupMenu(javax.swing.JPopupMenu)

updateUI

public void updateUI()

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

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

См. также:: setUI(javax.swing.plaf.ComponentUI), UIManager.getLookAndFeel(), UIManager.getUI(javax.swing.JComponent)

setUI

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
См. также:: updateUI(), UIManager.getLookAndFeel(), UIManager.getUI(javax.swing.JComponent)

getUIClassID

public String getUIClassID()

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

Возвращает:: ключ UIDefaults для ComponentUI подкласса
См. также:: UIDefaults.getUI(javax.swing.JComponent)

getComponentGraphics

protected Graphics getComponentGraphics(Graphics g)

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

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

paintComponent

protected void paintComponent(Graphics g)

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

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

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

Параметры:: g — объект Graphics для защиты
См. также:: paint(java.awt.Graphics), ComponentUI

paintChildren

protected void paintChildren(Graphics g)

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

Параметры:: g — контекст Graphics для рисования
См. также:: paint(java.awt.Graphics), Container.paint(java.awt.Graphics)

paintBorder

protected void paintBorder(Graphics g)

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

Параметры:: g — контекст Graphics для рисования
См. также:: paint(java.awt.Graphics), setBorder(javax.swing.border.Border)

update

public void update(Graphics g)

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

Overrides:: update в классе Container
Параметры:: g - контекст Graphics для отрисовки
См. также:: paint(java.awt.Graphics), paintComponent(java.awt.Graphics), ComponentUI

paint

public void paint(Graphics g)

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

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

Overrides:: paint в классе Container
Параметры:: g - контекст Graphics для отрисовки
См. также:: paintComponent(java.awt.Graphics), paintBorder(java.awt.Graphics), paintChildren(java.awt.Graphics), getComponentGraphics(java.awt.Graphics), repaint(long, int, int, int, int)

printAll

public void printAll(Graphics g)

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

Overrides:: printAll в классе Component
Параметры:: g - контекст Graphics для отрисовки
См. также:: print(java.awt.Graphics), printComponent(java.awt.Graphics), printBorder(java.awt.Graphics), printChildren(java.awt.Graphics)

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
Параметры:: g - контекст Graphics для отрисовки
См. также:: printComponent(java.awt.Graphics), printBorder(java.awt.Graphics), printChildren(java.awt.Graphics), isPaintingForPrint()

printComponent

protected void printComponent(Graphics g)

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

Параметры:: g - контекст Graphics для отрисовки
Since:: 1.3
См. также:: print(java.awt.Graphics)

printChildren

protected void printChildren(Graphics g)

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

Параметры:: g - контекст Graphics для отрисовки
Since:: 1.3
См. также:: print(java.awt.Graphics)

printBorder

protected void printBorder(Graphics g)

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

Параметры:: g - контекст Graphics для отрисовки
Since:: 1.3
См. также:: print(java.awt.Graphics)

isPaintingTile

public boolean isPaintingTile()

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

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

isPaintingForPrint

public final boolean isPaintingForPrint()

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

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

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

Возвращает:: true, если текущая операция отрисовки на этом компоненте является частью операции печати
Since:: 1.6
См. также:: print(java.awt.Graphics)

isManagingFocus

@Deprecated
public boolean isManagingFocus()

Устарело. Начиная с 1.4, заменено на Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean).

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

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

См. также:: Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), SortingFocusTraversalPolicy

setNextFocusableComponent

@Deprecated
public void setNextFocusableComponent(Component aComponent)

Устарело. Начиная с 1.4, заменено на FocusTraversalPolicy.

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

Параметры:: aComponent - Component, который должен следовать за этим JComponent в цикле перемещения фокуса
См. также:: getNextFocusableComponent(), FocusTraversalPolicy

getNextFocusableComponent

@Deprecated
public Component getNextFocusableComponent()

Устарело. Начиная с 1.4, заменено на FocusTraversalPolicy.

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

Возвращает:: Component , который будет следовать за этим JComponent в цикле перемещения фокуса, или null , если явно не был задан
См. также:: setNextFocusableComponent(java.awt.Component)

setRequestFocusEnabled

public void setRequestFocusEnabled(boolean requestFocusEnabled)

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

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

Параметры:: requestFocusEnabled - указывает, хотите ли вы, чтобы данному JComponent было доступно получение фокуса
См. также:: Спецификация фокуса, Component.setFocusable(boolean)

isRequestFocusEnabled

public boolean isRequestFocusEnabled()

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

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

Возвращает:: true , если данному компоненту должен быть предоставлен фокус, в противном случае возвращает false
См. также:: setRequestFocusEnabled(boolean), Спецификация фокуса, Component.isFocusable()

requestFocus

public void requestFocus()

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

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

Переопределяет:: requestFocus в классе Component
С:: 1.4
См. также:: Component.requestFocusInWindow(), Component.requestFocusInWindow(boolean)

requestFocus

public boolean requestFocus(boolean temporary)

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

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

Переопределяет:: requestFocus в классе Component
Параметры:: temporary - boolean, указывающий, является ли изменение фокуса временным
Возвращает:: false , если запрос на изменение фокуса гарантированно завершится неудачей; true , если он, вероятно, завершится успешно
С:: 1.4
См. также:: Component.requestFocusInWindow(), Component.requestFocusInWindow(boolean)

requestFocusInWindow

public boolean requestFocusInWindow()

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

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

Переопределяет:: requestFocusInWindow в классе Component
Возвращает:: false , если запрос на изменение фокуса гарантированно завершится неудачей; true , если он, вероятно, завершится успешно
С:: 1.4
См. также:: Component.requestFocusInWindow(), Component.requestFocusInWindow(boolean)

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

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

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

Переопределяет:: requestFocusInWindow в классе Component
Параметры:: temporary - boolean, указывающий, является ли изменение фокуса временным
Возвращает:: false , если запрос на изменение фокуса гарантированно завершится неудачей; true , если он, вероятно, завершится успешно
С:: 1.4
См. также:: Component.requestFocusInWindow(), Component.requestFocusInWindow(boolean)

grabFocus

public void grabFocus()

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

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

См. также:: requestFocusInWindow()

setVerifyInputWhenFocusTarget

public void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)

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

Параметры:: verifyInputWhenFocusTarget - значение для свойства verifyInputWhenFocusTarget
С:: 1.3
См. также:: InputVerifier, setInputVerifier(javax.swing.InputVerifier), getInputVerifier(), getVerifyInputWhenFocusTarget()

getVerifyInputWhenFocusTarget

public boolean getVerifyInputWhenFocusTarget()

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

Возвращает:: значение свойства verifyInputWhenFocusTarget
С:: 1.3
См. также:: InputVerifier, setInputVerifier(javax.swing.InputVerifier), getInputVerifier(), setVerifyInputWhenFocusTarget(boolean)

getFontMetrics

public FontMetrics getFontMetrics(Font font)

Возвращает FontMetrics для указанного Font.

Переопределяет:: getFontMetrics в классе Component
Параметры:: font - шрифт, для которого требуется получить метрики
Возвращает:: метрики font
Исключения:: NullPointerException - если font равно null
С:: 1.5
См. также:: Component.getFont(), Component.getPeer(), ComponentPeer.getFontMetrics(Font), Toolkit.getFontMetrics(Font)

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

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

Переопределяет:: setPreferredSize в классе Component
Параметры:: preferredSize - Новый предпочтительный размер, или null
См. также:: Component.getPreferredSize(), Component.isPreferredSizeSet()

getPreferredSize

public Dimension getPreferredSize()

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

Переопределяет:: getPreferredSize в классе Container
Возвращает:: значение свойства preferredSize
См. также:: setPreferredSize(java.awt.Dimension), ComponentUI

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

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

Переопределяет:: setMaximumSize в классе Component
Параметры:: maximumSize - Dimension , содержащий желаемый максимальный разрешенный размер
См. также:: getMaximumSize()

getMaximumSize

public Dimension getMaximumSize()

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

Overrides:: getMaximumSize в классе Container
Возвращает:: значение свойства maximumSize
См. также:: setMaximumSize(java.awt.Dimension), ComponentUI

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

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

Overrides:: setMinimumSize в классе Component
Параметры:: minimumSize - новый минимальный размер этого компонента
См. также:: getMinimumSize()

getMinimumSize

public Dimension getMinimumSize()

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

Overrides:: getMinimumSize в классе Container
Возвращает:: значение свойства minimumSize
См. также:: setMinimumSize(java.awt.Dimension), ComponentUI

contains

public boolean contains(int x,
                        int y)

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

Overrides:: contains в классе Component
Параметры:: x - координата x точки; y - координата y точки
Возвращает:: true, если этот компонент логически содержит x,y
См. также:: Component.contains(int, int), ComponentUI

setBorder

public void setBorder(Border border)

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

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

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

Параметры:: border - граница, которая должна отображаться для этого компонента
См. также:: Border, CompoundBorder

getBorder

public Border getBorder()

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

Возвращает:: объект границы для этого компонента
См. также:: setBorder(javax.swing.border.Border)

getInsets

public Insets getInsets()

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

Overrides:: getInsets в классе Container
Возвращает:: значение свойства отступов
См. также:: setBorder(javax.swing.border.Border)

getInsets

public Insets getInsets(Insets insets)

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

Параметры:: insets - объект Insets, который может быть повторно использован
Возвращает:: объект Insets
См. также:: getInsets()

getAlignmentY

public float getAlignmentY()

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

Overrides:: getAlignmentY в классе Container
Возвращает:: значение свойства alignmentY
См. также:: setAlignmentY(float), Component.getAlignmentY()

setAlignmentY

public void setAlignmentY(float alignmentY)

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

Параметры:: alignmentY - новое горизонтальное выравнивание
См. также:: getAlignmentY()

getAlignmentX

public float getAlignmentX()

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

Overrides:: getAlignmentX в классе Container
Возвращает:: значение свойства alignmentX
См. также:: setAlignmentX(float), Component.getAlignmentX()

setAlignmentX

public void setAlignmentX(float alignmentX)

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

Параметры:: alignmentX - новое вертикальное выравнивание
См. также:: getAlignmentX()

setInputVerifier

public void setInputVerifier(InputVerifier inputVerifier)

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

Параметры:: inputVerifier - новый верификатор ввода
Since:: 1.3
См. также:: InputVerifier

getInputVerifier

public InputVerifier getInputVerifier()

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

Возвращает:: свойство inputVerifier
Since:: 1.3
См. также:: InputVerifier

getGraphics

public Graphics getGraphics()

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

Overrides:: getGraphics в классе Component
Возвращает:: контекст графики этого компонента
См. также:: Component.paint(java.awt.Graphics)

setDebugGraphicsOptions

public void setDebugGraphicsOptions(int debugOptions)

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

Параметры:

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

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

debugOptions побитово ИЛИ'd к текущему значению

getDebugGraphicsOptions

public int getDebugGraphicsOptions()

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

Возвращает:

побитовое ИЛИ'd значение нуля или более из следующих опций:

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

См. также:

setDebugGraphicsOptions(int)

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 заменит это действие.

Параметры:: anAction - регистрируемое Action; aCommand - команда, которая будет установлена в доставленном событии; aKeyStroke - KeyStroke для привязки к действию; aCondition - условие, которое необходимо выполнить, см. выше
См. также:: KeyStroke

registerKeyboardAction

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

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

unregisterKeyboardAction

public void unregisterKeyboardAction(KeyStroke aKeyStroke)

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

Отменяет действие нажатия клавиши. Это удалит привязку из ActionMap (если она существует), а также из InputMaps.

getRegisteredKeyStrokes

public KeyStroke[] getRegisteredKeyStrokes()

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

Возвращает:: массив объектов KeyStroke
См. также:: registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

getConditionForKeyStroke

public int getConditionForKeyStroke(KeyStroke aKeyStroke)

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

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

Возвращает:: условие действия-нажатия клавиш

getActionForKeyStroke

public ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)

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

Возвращает:: объект 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.

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

getInputMap

public final InputMap getInputMap(int condition)

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

Параметры:: condition - одно из значений WHEN_IN_FOCUSED_WINDOW, WHEN_FOCUSED, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Возвращает:: InputMap для указанного condition
С тех пор:: 1.3

getInputMap

public final InputMap getInputMap()

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

Возвращает:: InputMap, используемый, когда компонент имеет фокус
С тех пор:: 1.3

setActionMap

public final void setActionMap(ActionMap am)

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

Параметры:: am - новый ActionMap
С тех пор:: 1.3

getActionMap

public final ActionMap getActionMap()

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

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

getBaseline

public int getBaseline(int width,
                       int height)

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

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

Переопределяет:: getBaseline в классе Component
Параметры:: width - ширина для получения базовой строки; height - высота для получения базовой строки
Возвращает:: базовая строка или < 0, указывающее, что нет разумной базовой строки
Исключения:: IllegalArgumentException - если ширина или высота < 0
С тех пор:: 1.6
См. также:: getBaselineResizeBehavior(), FontMetrics

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior()

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

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

Переопределяет:: getBaselineResizeBehavior в классе Component
Возвращает:: перечисление, указывающее, как базовая строка меняется при изменении размера компонента
С тех пор:: 1.6
См. также:: getBaseline(int, int)

requestDefaultFocus

@Deprecated
public boolean requestDefaultFocus()

Устарело. Начиная с версии 1.4, заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()

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

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

См. также:: FocusTraversalPolicy.getDefaultComponent(java.awt.Container)

setVisible

public void setVisible(boolean aFlag)

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

Переопределяет:: setVisible в классе Component
Параметры:: aFlag - true, чтобы сделать компонент видимым; false, чтобы сделать его невидимым
См. также:: Component.isVisible(), Component.invalidate()

setEnabled

public void setEnabled(boolean enabled)

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

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

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

Переопределяет:: setEnabled в классе Component
Параметры:: enabled - true, если этот компонент должен быть активен, false в противном случае
См. также:: Component.isEnabled(), Component.isLightweight()

setForeground

public void setForeground(Color fg)

Устанавливает цвет переднего плана этого компонента. Вид и ощущение должны учитывать эту собственность, некоторые могут её игнорировать.

Переопределяет:: setForeground в классе Component
Параметры:: fg - желаемый цвет переднего плана Color
См. также:: Component.getForeground()

setBackground

public void setBackground(Color bg)

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

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

Переопределяет:: setBackground в классе Component
Параметры:: bg - желаемый цвет фона Color
См. также:: Component.getBackground(), setOpaque(boolean)

setFont

public void setFont(Font font)

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

Переопределяет:: setFont в классе Container
Параметры:: font - желаемый Font для этого компонента
См. также:: Component.getFont()

getDefaultLocale

public static Locale getDefaultLocale()

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

Возвращает:: локалью по умолчанию Locale.
С:: 1.4
См. также:: setDefaultLocale(java.util.Locale), Component.getLocale(), Component.setLocale(java.util.Locale)

setDefaultLocale

public static void setDefaultLocale(Locale l)

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

Параметры:: l - желаемая локаль по умолчанию Locale для новых компонентов.
С:: 1.4
См. также:: getDefaultLocale(), Component.getLocale(), Component.setLocale(java.util.Locale)

processComponentKeyEvent

protected void processComponentKeyEvent(KeyEvent e)

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

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

processKeyEvent

protected void processKeyEvent(KeyEvent e)

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

Переопределяет:: processKeyEvent в классе Component
Параметры:: e - событие нажатия клавиши
См. также:: KeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, Component.processEvent(java.awt.AWTEvent), Component.dispatchEvent(java.awt.AWTEvent), Component.addKeyListener(java.awt.event.KeyListener), Component.enableEvents(long), Component.isShowing()

processKeyBinding

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

setToolTipText

public void setToolTipText(String text)

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

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

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

getToolTipText

public String getToolTipText()

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

Возвращает:: текст подсказки
См. также:: TOOL_TIP_TEXT_KEY

getToolTipText

public String getToolTipText(MouseEvent event)

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

getToolTipLocation

public Point getToolTipLocation(MouseEvent event)

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

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

getPopupLocation

public Point getPopupLocation(MouseEvent event)

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

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

createToolTip

public JToolTip createToolTip()

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

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

scrollRectToVisible

public void scrollRectToVisible(Rectangle aRect)

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

Параметры:: aRect - видимая Rectangle
См. также:: JViewport

setAutoscrolls

public void setAutoscrolls(boolean autoscrolls)

Устанавливает свойство autoscrolls. Если true генерируются синтетические события перетаскивания мышью, когда мышь перетаскивается за пределы границ компонента, а движение мыши приостановлено (при нажатой кнопке). Синтетические события имитируют возобновление жеста перетаскивания в направлении, установленным при пересечении границы компонента. Компоненты, поддерживающие автоматическую прокрутку, должны обрабатывать события mouseDragged вызывая scrollRectToVisible с прямоугольником, содержащим местоположение события мыши. Все компоненты Swing, поддерживающие выбор элементов и обычно отображаемые в JScrollPane (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
См. также:: getAutoscrolls(), JViewport, JScrollPane

getAutoscrolls

public boolean getAutoscrolls()

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

Возвращает:: значение свойства autoscrolls
См. также:: JViewport, setAutoscrolls(boolean)

setTransferHandler

public void setTransferHandler(TransferHandler newHandler)

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

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

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

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

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

Параметры:: newHandler - новый TransferHandler
С:: 1.4
См. также:: TransferHandler, getTransferHandler()

getTransferHandler

public TransferHandler getTransferHandler()

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

Возвращает:: значение свойства transferHandler
С:: 1.4
См. также:: TransferHandler, setTransferHandler(javax.swing.TransferHandler)

processMouseEvent

protected void processMouseEvent(MouseEvent e)

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

Переопределяет:: processMouseEvent в классе Component
Параметры:: e - событие мыши
С:: 1.5
См. также:: Component.processMouseEvent(java.awt.event.MouseEvent)

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

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

Переопределяет:: processMouseMotionEvent в классе Component
Параметры:: e - событие MouseEvent
См. также:: 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(java.lang.Object, java.lang.Object)

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, этот метод удалит свойство
См. также:: getClientProperty(java.lang.Object), Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

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
См. также:: KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

isLightweightComponent

public static boolean isLightweightComponent(Component c)

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

Возвращает:: true, если этот компонент облегчённый

reshape

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

Устарело. Начиная с JDK 5, заменено на Component.setBounds(int, int, int, int).

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

Переопределяет:: reshape в классе Component
Параметры:: x - новая горизонтальная позиция; y - новая вертикальная позиция; w - новая ширина; h - новая высота
См. также:: Component.setBounds(int, int, int, int)

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

public int getX()

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

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

getY

public int getY()

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

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

getWidth

public int getWidth()

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

Переопределяет:: getWidth в классе Component
Возвращает:: текущую ширину этого компонента

getHeight

public int getHeight()

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

Переопределяет:: getHeight в классе Component
Возвращает:: текущую высоту этого компонента

isOpaque

public boolean isOpaque()

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

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

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

Переопределяет:: isOpaque в классе Component
Возвращает:: true, если этот компонент полностью непрозрачный
См. также:: setOpaque(boolean)

setOpaque

public void setOpaque(boolean isOpaque)

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

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

Параметры:: isOpaque - true, если этот компонент должен быть непрозрачным
См. также:: isOpaque()

computeVisibleRect

public void computeVisibleRect(Rectangle visibleRect)

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

Параметры:: visibleRect - Rectangle вычисленное как пересечение всех видимых прямоугольников этого компонента и всех его предков — это значение возврата для этого метода
См. также:: getVisibleRect()

getVisibleRect

public Rectangle getVisibleRect()

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

Сообщает об изменении связанного свойства.

Переопределяет:: firePropertyChange в классе Component
Параметры:: propertyName - программное имя свойства, которое было изменено; oldValue - старое значение свойства (как символ); newValue - новое значение свойства (как символ)
См. также:: Component.firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

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

public VetoableChangeListener[] getVetoableChangeListeners()

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

Возвращает:: все слушатели изменения вето компонента или пустой массив, если в данный момент нет зарегистрированных слушателей изменения вето
С:: 1.4
См. также:: addVetoableChangeListener(java.beans.VetoableChangeListener), removeVetoableChangeListener(java.beans.VetoableChangeListener)

getTopLevelAncestor

public Container getTopLevelAncestor()

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

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

addAncestorListener

public void addAncestorListener(AncestorListener listener)

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

Параметры:: listener - регистрируемый AncestorListener
См. также:: AncestorEvent

removeAncestorListener

public void removeAncestorListener(AncestorListener listener)

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

Параметры:: listener - удаляемый AncestorListener
См. также:: addAncestorListener(javax.swing.event.AncestorListener)

getAncestorListeners

public AncestorListener[] getAncestorListeners()

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

Возвращает:: все слушатели компонента AncestorListener или пустой массив, если слушатели предков не зарегистрированы
С:: 1.4
См. также:: addAncestorListener(javax.swing.event.AncestorListener), removeAncestorListener(javax.swing.event.AncestorListener)

getListeners

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

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

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

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

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

Переопределяет:: getListeners в классе Container
Параметры:: listenerType - тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, который наследуется от java.util.EventListener
Возвращает:: массив всех объектов, зарегистрированных в качестве FooListener для этого компонента, или пустой массив, если такие слушатели не были добавлены
Исключения:: ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener
С:: 1.3
См. также:: getVetoableChangeListeners(), getAncestorListeners()

addNotify

public void addNotify()

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

Переопределяет:: addNotify в классе Container
См. также:: registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

removeNotify

public void removeNotify()

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

Переопределяет:: removeNotify в классе Container
См. также:: registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

repaint

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

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

Переопределяет:: repaint в классе Component
Параметры:: tm - этот параметр не используется; x - значение x грязной области; y - значение y грязной области; width - ширина грязной области; height - высота грязной области
См. также:: isPaintingOrigin(), Component.isShowing(), RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)

repaint

public void repaint(Rectangle r)

Параметры:: r - прямоугольник, содержащий грязную область
См. также:: isPaintingOrigin(), Component.isShowing(), RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)

revalidate

public void revalidate()

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

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

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

Переопределяет:: revalidate в классе Component
См. также:: Component.invalidate(), Container.validate(), isValidateRoot(), RepaintManager.addInvalidComponent(javax.swing.JComponent)

isValidateRoot

public boolean isValidateRoot()

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

Переопределяет:: isValidateRoot в классе Container
Возвращает:: всегда возвращает false
См. также:: revalidate(), Component.invalidate(), Container.validate(), Container.isValidateRoot()

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()

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

Возвращает:: всегда возвращает 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.

Возвращает:: всегда возвращает false
См. также:: paintImmediately(int, int, int, int)

paintImmediately

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

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

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

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

Параметры:: x - значение x области, подлежащей отрисовке; y - значение y области, подлежащей отрисовке; w - ширина области, подлежащей отрисовке; h - высота области, подлежащей отрисовке
См. также:: repaint(long, int, int, int, int), isPaintingOrigin()

paintImmediately

public void paintImmediately(Rectangle r)

Отрисовывает указанную область сразу.

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

setDoubleBuffered

public void setDoubleBuffered(boolean aFlag)

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

Параметры:: aFlag - если true, установить этот компонент в буферизованный режим

isDoubleBuffered

public boolean isDoubleBuffered()

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

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

getRootPane

public JRootPane getRootPane()

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

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

paramString

protected String paramString()

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

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

hide

@Deprecated
public void hide()

Устарело.

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.