Класс JComponent

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

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

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

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

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

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

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

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

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

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

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

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

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

С момента:

1.2

См. также:

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

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

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

Container.AccessibleAWTContainer

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

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

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

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

Поля, объявленные в классе java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

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

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

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

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

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

`void`	`setComponentPopupMenu(JPopupMenu popup)`	Устанавливает `JPopupMenu` для этого `JComponent`.
`void`	`setDebugGraphicsOptions(int debugOptions)`	Включает или отключает диагностическую информацию обо всех графических операциях, выполняемых в компоненте или в одном из его дочерних элементов.
`static void`	`setDefaultLocale(Locale l)`	Устанавливает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
`void`	`setDoubleBuffered(boolean aFlag)`	Устанавливает, следует ли этому компоненту использовать буфер для отрисовки.
`void`	`setEnabled(boolean enabled)`	Устанавливает, включён ли этот компонент.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Устанавливает клавиши перемещения фокуса для данной операции перемещения для данного Component.
`void`	`setFont(Font font)`	Устанавливает шрифт для этого компонента.
`void`	`setForeground(Color fg)`	Устанавливает цвет переднего плана этого компонента.
`void`	`setInheritsPopupMenu(boolean value)`	Устанавливает, следует ли этому компоненту делегировать обработку родительскому элементу, если этому компоненту не назначен `JPopupMenu`.
`final void`	`setInputMap(int condition, InputMap map)`	Устанавливает `InputMap` для использования при условии `condition` до `map`.
`void`	`setInputVerifier(InputVerifier inputVerifier)`	Устанавливает верификатор входных данных для этого компонента.
`void`	`setMaximumSize(Dimension maximumSize)`	Устанавливает максимальный размер этого компонента до постоянного значения.
`void`	`setMinimumSize(Dimension minimumSize)`	Устанавливает минимальный размер этого компонента до постоянного значения.
`void`	`setNextFocusableComponent(Component aComponent)`	Устарело. С версии 1.4, заменено на `FocusTraversalPolicy`
`void`	`setOpaque(boolean isOpaque)`	Если true, компонент отрисовывает каждый пиксель в пределах своих границ.
`void`	`setPreferredSize(Dimension preferredSize)`	Устанавливает предпочтительный размер этого компонента.
`void`	`setRequestFocusEnabled(boolean requestFocusEnabled)`	Предлагает подсказку о том, получит ли фокус этот `JComponent`.
`void`	`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()`	Этот метод вызывается для обновления свойства UI значением из текущего визуального оформления.

Методы, объявленные в классе java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Методы, объявленные в классе java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

ui

protected transient ComponentUI ui

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

listenerList

protected EventListenerList listenerList

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

WHEN_FOCUSED

public static final int WHEN_FOCUSED

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

См. также:

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

public static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

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

См. также:

WHEN_IN_FOCUSED_WINDOW

public static final int WHEN_IN_FOCUSED_WINDOW

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

См. также:

UNDEFINED_CONDITION

public static final int UNDEFINED_CONDITION

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

См. также:

TOOL_TIP_TEXT_KEY

public static final String TOOL_TIP_TEXT_KEY

Комментарий, отображаемый при наведении курсора на компонент, также известный как «подсказка», «справочная информация при наведении» или «метка при наведении».

См. также:

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

JComponent

public JComponent()

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

См. также:

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

setInheritsPopupMenu

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

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

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

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

Параметры:

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

С:

1.5

См. также:

getInheritsPopupMenu

public boolean getInheritsPopupMenu()

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

Возвращает:

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

С:

1.5

См. также:

setComponentPopupMenu

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

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

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

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

Параметры:

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

С:

1.5

См. также:

getComponentPopupMenu

public JPopupMenu getComponentPopupMenu()

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

Возвращает:

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

С:

1.5

См. также:

updateUI

public void updateUI()

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

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

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

По умолчанию этот метод ничего не делает.

См. также:

getUI

public ComponentUI getUI()

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

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

setUI

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

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

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

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

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

Параметры:

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

См. также:

getUIClassID

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

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

Возвращает:

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

См. также:

getComponentGraphics

protected Graphics getComponentGraphics(Graphics g)

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

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

paintComponent

protected void paintComponent(Graphics g)

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

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

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

Параметры:

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

См. также:

paintChildren

protected void paintChildren(Graphics g)

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

Параметры:

g - контекст Graphics, в котором выполняется отрисовка

См. также:

paintBorder

protected void paintBorder(Graphics g)

Отрисовывает границу компонента.

Параметры:

g - контекст Graphics, в котором выполняется отрисовка

См. также:

update

public void update(Graphics g)

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

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

update в классе Container

Параметры:

g - контекст Graphics, в котором выполняется отрисовка

См. также:

paint

public void paint(Graphics g)

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

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

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

paint в классе Container

Параметры:

g - контекст Graphics, в котором выполняется отрисовка

См. также:

printAll

public void printAll(Graphics g)

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

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

printAll в классе Component

Параметры:

g - контекст 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.

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

print в классе Container

Параметры:

g - контекст Graphics, в котором выполняется отрисовка

См. также:

printComponent

protected void printComponent(Graphics g)

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

Параметры:

g - контекст Graphics, в котором выполняется отрисовка

С версии:

1.3

См. также:

printChildren

protected void printChildren(Graphics g)

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

Параметры:

g - контекст Graphics, в котором выполняется отрисовка

С версии:

1.3

См. также:

printBorder

protected void printBorder(Graphics g)

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

Параметры:

g - контекст Graphics, в котором выполняется отрисовка

С версии:

1.3

См. также:

isPaintingTile

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

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

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

isPaintingForPrint

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

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

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

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

Returns:

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

Since:

1.6

See Also:

isManagingFocus

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

Устарело.

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

В релизе 1.4 система фокусировки была перестроена. Более подробную информацию см. в Руководстве по работе с системой фокусировки, разделе учебника Java.

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

Returns:

false

See Also:

setNextFocusableComponent

@Deprecated public void setNextFocusableComponent(Component aComponent)

Устарело.

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

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

Parameters:

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

See Also:

getNextFocusableComponent

@Deprecated public Component getNextFocusableComponent()

Устарело.

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

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

Returns:

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

See Also:

setRequestFocusEnabled

public void setRequestFocusEnabled(boolean requestFocusEnabled)

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

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

Parameters:

requestFocusEnabled - указывает, хотите ли вы, чтобы этот JComponent был фокусируемым

See Also:

isRequestFocusEnabled

public boolean isRequestFocusEnabled()

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

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

Returns:

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

See Also:

requestFocus

public void requestFocus()

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

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

Overrides:

requestFocus в классе Component

Since:

1.4

See Also:

requestFocus

public boolean requestFocus(boolean temporary)

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

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

Overrides:

requestFocus в классе Component

Parameters:

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

Returns:

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

Since:

1.4

See Also:

requestFocusInWindow

public boolean requestFocusInWindow()

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

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

Overrides:

requestFocusInWindow в классе Component

Returns:

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

Since:

1.4

See Also:

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

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

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

Overrides:

requestFocusInWindow в классе Component

Parameters:

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

Returns:

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

Since:

1.4

See Also:

grabFocus

public void grabFocus()

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

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

See Also:

setVerifyInputWhenFocusTarget

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

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

Parameters:

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

Since:

1.3

See Also:

getVerifyInputWhenFocusTarget

public boolean getVerifyInputWhenFocusTarget()

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

Returns:

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

Since:

1.3

See Also:

getFontMetrics

public FontMetrics getFontMetrics(Font font)

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

Overrides:

getFontMetrics в классе Component

Parameters:

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

Returns:

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

Throws:

NullPointerException - если font равно null

Since:

1.5

See Also:

setPreferredSize

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

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

Overrides:

setPreferredSize в классе Component

Parameters:

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

See Also:

getPreferredSize

public Dimension getPreferredSize()

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

Overrides:

getPreferredSize в классе Container

Returns:

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

See Also:

setMaximumSize

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

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

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

Overrides:

setMaximumSize в классе Component

Parameters:

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

See Also:

getMaximumSize

public Dimension getMaximumSize()

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

Overrides:

getMaximumSize в классе Container

Returns:

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

See Also:

setMinimumSize

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

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

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

Overrides:

setMinimumSize в классе Component

Parameters:

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

See Also:

getMinimumSize

public Dimension getMinimumSize()

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

Overrides:

getMinimumSize в классе Container

Returns:

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

See Also:

contains

public boolean contains(int x, int y)

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

Overrides:

contains в классе Component

Parameters:

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

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

Returns:

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

See Also:

setBorder

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

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

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

Это свойство, связанное с границами.

Параметры:

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

См. также:

getBorder

public Border getBorder()

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

Возвращает:

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

См. также:

getInsets

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

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

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

getInsets в классе Container

Возвращает:

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

См. также:

getInsets

public Insets getInsets(Insets insets)

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

Параметры:

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

Возвращает:

объект Insets

См. также:

getAlignmentY

public float getAlignmentY()

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

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

getAlignmentY в классе Container

Возвращает:

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

См. также:

setAlignmentY

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

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

Параметры:

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

См. также:

getAlignmentX

public float getAlignmentX()

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

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

getAlignmentX в классе Container

Возвращает:

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

См. также:

setAlignmentX

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

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

Параметры:

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

См. также:

setInputVerifier

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

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

Параметры:

inputVerifier - новый проверщик входных данных

С:

1.3

См. также:

getInputVerifier

public InputVerifier getInputVerifier()

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

Возвращает:

свойство inputVerifier

С:

1.3

См. также:

getGraphics

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

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

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

getGraphics в классе Component

Возвращает:

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

См. также:

setDebugGraphicsOptions

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

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

Параметры:

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

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

debugOptions побитово объединяется с текущим значением

getDebugGraphicsOptions

public int getDebugGraphicsOptions()

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

Возвращает:

побитовое или флаг нуля или более из следующих опций:

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

См. также:

registerKeyboardAction

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

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

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

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

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

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

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

WHEN_FOCUSED

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

WHEN_IN_FOCUSED_WINDOW

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

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

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

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

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

Параметры:

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

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

aKeyStroke - KeyStroke, привязанное к действию

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

См. также:

registerKeyboardAction

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

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

Параметры:

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

aKeyStroke - KeyStroke

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

См. также:

unregisterKeyboardAction

public void unregisterKeyboardAction(KeyStroke aKeyStroke)

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

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

Параметры:: aKeyStroke - нажатие клавиш, для которого необходимо отменить действие клавиатуры

getRegisteredKeyStrokes

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

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

Возвращает:

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

См. также:

getConditionForKeyStroke

public int getConditionForKeyStroke(KeyStroke aKeyStroke)

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

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

Параметры:: aKeyStroke - нажатие клавиш, для которого требуется условие действия-нажатия клавиш
Возвращает:: условие действия-нажатия клавиш

getActionForKeyStroke

public ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)

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

Параметры:: 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 с тем же именем. Если у этого компонента нет ComponentUI, будет возвращено значение -1. Если возвращается значение >= 0, то компонент имеет допустимую базовую линию для любого размера >= минимального размера, и getBaselineResizeBehavior можно использовать для определения того, как базовая линия изменяется с изменением размера.

Overrides:

getBaseline в классе Component

Параметры:

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

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

Возвращает:

базовую линию или < 0, указывая, что нет разумной базовой линии

Исключение:

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

С:

1.6

См. также:

getBaselineResizeBehavior

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

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

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

Overrides:

getBaselineResizeBehavior в классе Component

Возвращает:

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

С:

1.6

См. также:

requestDefaultFocus

@Deprecated public boolean requestDefaultFocus()

Устарело.

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

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

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

Возвращает:

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

См. также:

setVisible

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

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

Overrides:

setVisible в классе Component

Параметры:

aFlag - true, чтобы сделать компонент видимым; false, чтобы сделать его невидимым

См. также:

setEnabled

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

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

Примечание: Отключение компонента не отключает его потомков.

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

Overrides:

setEnabled в классе Component

Параметры:

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

См. также:

setForeground

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

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

Overrides:

setForeground в классе Component

Параметры:

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

См. также:

setBackground

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

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

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

Overrides:

setBackground в классе Component

Параметры:

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

См. также:

setFont

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

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

Overrides:

setFont в классе Container

Параметры:

font - желаемый Font для этого компонента

См. также:

getDefaultLocale

public static Locale getDefaultLocale()

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

Возвращает:

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

С:

1.4

См. также:

setDefaultLocale

public static void setDefaultLocale(Locale l)

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

Параметры:

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

С:

1.4

См. также:

processComponentKeyEvent

protected void processComponentKeyEvent(KeyEvent e)

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

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

Параметры:: e - обрабатываемое событие

обработкаНажатияКлавиши

protected void processKeyEvent(KeyEvent e)

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

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

processKeyEvent в классе Component

Параметры:

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

См. также:

обработкаСвязиКлавиш

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

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

Параметры:

ks - запрошенная KeyStroke

e - событие KeyEvent

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

JComponent.WHEN_FOCUSED
JComponent.WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
JComponent.WHEN_IN_FOCUSED_WINDOW

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

Возвращает:

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

См. также:

1.3

установитьПодсказкуИнструмента

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

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

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

Параметры:

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

См. также:

получитьТекстПодсказкиИнструмента

public String getToolTipText()

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

Возвращает:

текст подсказки инструмента

См. также:

получитьТекстПодсказкиИнструмента

public String getToolTipText(MouseEvent event)

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

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

получитьРасположениеПодсказкиИнструмента

public Point getToolTipLocation(MouseEvent event)

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

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

получитьРасположениеПоп-меню

public Point getPopupLocation(MouseEvent event)

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

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

создатьПодсказкуИнструмента

public JToolTip createToolTip()

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

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

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

public void scrollRectToVisible(Rectangle aRect)

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

Параметры:

aRect - видимый Rectangle

См. также:

установитьАвтоПрокрутку

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

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

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

Значение свойства autoScrolls по умолчанию равно false.

Параметры:

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

См. также:

получитьАвтоПрокрутку

public boolean getAutoscrolls()

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

Возвращает:

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

См. также:

setTransferHandler

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

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

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

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

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

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

Parameters:

newHandler - новый TransferHandler

Since:

1.4

See Also:

getTransferHandler

public TransferHandler getTransferHandler()

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

Returns:

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

Since:

1.4

See Also:

processMouseEvent

protected void processMouseEvent(MouseEvent e)

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

Overrides:

processMouseEvent в классе Component

Parameters:

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

Since:

1.5

See Also:

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

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

Overrides:

processMouseMotionEvent в классе Component

Parameters:

e - событие перемещения MouseEvent

See Also:

enable

@Deprecated public void enable()

Deprecated.

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

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

disable

@Deprecated public void disable()

Deprecated.

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

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

getClientProperty

public final Object getClientProperty(Object key)

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

Parameters:

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

Returns:

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

See Also:

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 и не должен рассматриваться как альтернатива наследованию при проектировании нового компонента.

Parameters:

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

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

See Also:

setFocusTraversalKeys

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

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

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

Overrides:

setFocusTraversalKeys в классе Container

Parameters:

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

keystrokes - множество AWTKeyStroke для заданной операции

Throws:

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

Since:

1.5

See Also:

isLightweightComponent

public static boolean isLightweightComponent(Component c)

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

Parameters:: c - компонент, подлежащий проверке
Returns:: true, если этот компонент лёгкий

reshape

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

Deprecated.

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

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

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

Изменяет прямоугольник области для этого компонента.

Overrides:

reshape в классе Component

Parameters:

x - новая горизонтальная позиция

y - новая вертикальная позиция

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

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

See Also:

getBounds

public Rectangle getBounds(Rectangle rv)

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

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

getSize

public Dimension getSize(Dimension rv)

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

Overrides:: getSize в классе Component
Parameters:: rv - возвращаемое значение, изменённое на размер компонента
Returns:: rv

getLocation

public Point getLocation(Point rv)

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

Overrides:: getLocation в классе Component
Parameters:: rv - возвращаемое значение, изменённое на координаты компонента
Returns:: rv

getX

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

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

Overrides:: getX в классе Component
Returns:: текущая координата x начала компонента

getY

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

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

Overrides:: getY в классе Component
Returns:: текущая координата y начала компонента

getWidth

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

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

Overrides:: getWidth в классе Component
Returns:: текущая ширина этого компонента

getHeight

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

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

Overrides:: getHeight в классе Component
Returns:: текущая высота этого компонента

isOpaque

public boolean isOpaque()

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

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

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

Overrides:

isOpaque в классе Component

Returns:

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

See Also:

setOpaque

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

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

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

Parameters:

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

See Also:

computeVisibleRect

public void computeVisibleRect(Rectangle visibleRect)

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

Parameters:

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

See Also:

getVisibleRect

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

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

Returns:: видимый прямоугольник

firePropertyChange

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

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

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

firePropertyChange

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

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

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

fireVetoableChange

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

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

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

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)

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

Parameters:: listener - добавляемый слушатель VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

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

Parameters:: listener - удаляемый слушатель VetoableChangeListener

getVetoableChangeListeners

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

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

Возвращает:

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

Since:

1.4

См. также:

getTopLevelAncestor

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

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

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

addAncestorListener

public void addAncestorListener(AncestorListener listener)

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

Параметры:

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

См. также:

removeAncestorListener

public void removeAncestorListener(AncestorListener listener)

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

Параметры:

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

См. также:

getAncestorListeners

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

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

Возвращает:

все AncestorListener компонента или пустой массив, если в настоящее время не зарегистрированы никакие слушатели предков

Since:

1.4

См. также:

getListeners

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

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

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

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

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

Overrides:

getListeners в классе Container

Type Parameters:

T - тип слушателей

Параметры:

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

Возвращает:

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

Исключения:

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

Since:

1.3

См. также:

addNotify

public void addNotify()

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

Overrides:

addNotify в классе Container

См. также:

removeNotify

public void removeNotify()

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

Overrides:

removeNotify в классе Container

См. также:

repaint

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

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

Overrides:

repaint в классе Component

Параметры:

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

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

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

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

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

См. также:

repaint

public void repaint(Rectangle r)

Параметры:

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

См. также:

revalidate

public void revalidate()

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

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

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

Overrides:

revalidate в классе Component

См. также:

isValidateRoot

public boolean isValidateRoot()

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

Overrides:

isValidateRoot в классе Container

Возвращает:

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

См. также:

isOptimizedDrawingEnabled

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

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

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

isPaintingOrigin

protected boolean isPaintingOrigin()

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

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

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

Returns:

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

См. также:

paintImmediately

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

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

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

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

Параметры:

x - значение x региона, подлежащего перерисовке

y - значение y региона, подлежащего перерисовке

w - ширина региона, подлежащего перерисовке

h - высота региона, подлежащего перерисовке

См. также:

paintImmediately

public void paintImmediately(Rectangle r)

Перерисовывает указанный регион немедленно.

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

setDoubleBuffered

public void setDoubleBuffered(boolean aFlag)

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

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

isDoubleBuffered

public boolean isDoubleBuffered()

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

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

getRootPane

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

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

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

paramString

protected String paramString()

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

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

hide

@Deprecated public void hide()

Устарело.

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

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