Spec-Zone.ru › OpenJDK 17

Класс 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 Components and the Containment Hierarchy — разделе The Java Tutorial.

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

  • Базовый класс для стандартных и пользовательских компонентов, использующих архитектуру Swing.
  • «Подключаемый внешний вид» (L&F), который может быть задан программистом или (по желанию) выбран пользователем во время выполнения. Внешний вид каждого компонента предоставляется делегатом UI — объектом, унаследованным от ComponentUI. Дополнительную информацию см. в How to Set the Look and Feel в The Java Tutorial.
  • Полное управление обработкой нажатий клавиш. Дополнительную информацию см. в документе How to Use Key Bindings, статье в The Java Tutorial.
  • Поддержку всплывающих подсказок — коротких описаний, которые появляются, когда курсор находится над компонентом. Дополнительную информацию см. в How to Use Tool Tips в The Java Tutorial.
  • Поддержку доступности. JComponent содержит все методы интерфейса Accessible, но фактически не реализует его. Это ответственность отдельных классов, расширяющих JComponent.
  • Поддержку свойств, специфичных для компонента. С помощью методов putClientProperty(java.lang.Object, java.lang.Object) и getClientProperty(java.lang.Object) вы можете связать пары «имя-объект» с любым объектом, унаследованным от JComponent.
  • Инфраструктура отрисовки, которая включает двойную буферизацию и поддержку границ. Дополнительную информацию см. в Painting и How to Use Borders, обоих разделах The Java Tutorial.
Для получения дополнительной информации по этим темам см. Swing package description и раздел The Java Tutorial The JComponent Class.

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

В релизе 1.4 подсистема фокуса была перестроена. Дополнительную информацию см. в How to Use the Focus Subsystem в разделе The Java Tutorial.

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

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

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

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

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

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип Поле Описание
protected EventListenerList listenerList
Список слушателей событий для этого компонента.
static 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.

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

Modifier and Type Method Description
void addAncestorListener(AncestorListener listener)
Registers listener, so that it will receive AncestorEvents when it or any of its ancestors move or are made visible or invisible.
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, если этот компонент лёгкий, то есть у него нет нативного партнёра в системе окон.
boolean isManagingFocus()
Устарело.
С версии 1.4, заменено на Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean).
boolean isOpaque()
Возвращает true, если этот компонент полностью непрозрачен.
boolean isOptimizedDrawingEnabled()
Возвращает true, если этот компонент выкладывает своих детей плиткой - то есть, если он может гарантировать, что дети не будут перекрываться.
final boolean isPaintingForPrint()
Возвращает true, если текущая операция рисования на этом компоненте является частью операции print.
protected boolean isPaintingOrigin()
Возвращает true, если рисование, вызванное на дочернем компоненте, должно происходить с этого компонента или одного из его предков.
boolean isPaintingTile()
Возвращает true, если компонент в настоящее время рисует плитку.
boolean isRequestFocusEnabled()
Возвращает true, если этот JComponent должен получить фокус; в противном случае возвращает false.
boolean isValidateRoot()
Если этот метод возвращает true, вызовы revalidate потомками этого компонента приведут к валидации всего дерева, начиная с этого корня.
void paint(Graphics g)
Вызывается Swing для рисования компонентов.
protected void paintBorder(Graphics g)
Рисует границу компонента.
protected void paintChildren(Graphics g)
Рисует детей этого компонента.
protected void paintComponent(Graphics g)
Вызывает метод paint делегата пользовательского интерфейса, если делегат пользовательского интерфейса не является null.
void paintImmediately(int x, int y, int w, int h)
Рисует указанную область в этом компоненте и всех его потомках, которые перекрывают область, немедленно.
void paintImmediately(Rectangle r)
Рисует указанную область сейчас.
protected String paramString()
Возвращает строковое представление этого JComponent.
void print(Graphics g)
Вызовите этот метод для печати компонента в указанный Graphics.
void printAll(Graphics g)
Вызовите этот метод для печати компонента.
protected void printBorder(Graphics g)
Печатает границу компонента.
protected void printChildren(Graphics g)
Печатает детей этого компонента.
protected void printComponent(Graphics g)
Вызывается во время операции печати.
protected void processComponentKeyEvent(KeyEvent e)
Обрабатывает любые события клавиш, которые распознает сам компонент.
protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e.
protected void processKeyEvent(KeyEvent e)
Переопределяет processKeyEvent для обработки событий.
protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, происходящие на этом компоненте, передавая их любым зарегистрированным объектам MouseListener, обратитесь к Component.processMouseEvent(MouseEvent) для полного описания этого метода.
protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события движения мыши, такие как MouseEvent.MOUSE_DRAGGED.
final void putClientProperty(Object key, Object value)
Добавляет произвольную пару «свойство клиента»/«значение» к этому компоненту.
void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел, пожалуйста, используйте комбинацию getActionMap() и getInputMap() для аналогичного поведения.
void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел, пожалуйста, используйте комбинацию getActionMap() и getInputMap() для аналогичного поведения.
void removeAncestorListener(AncestorListener listener)
Удаляет listener, чтобы он больше не получал AncestorEvents.
void removeNotify()
Уведомляет этот компонент о том, что у него больше нет родительского компонента.
void removeVetoableChangeListener(VetoableChangeListener listener)
Удаляет VetoableChangeListener из списка слушателей.
void repaint(long tm, int x, int y, int width, int height)
Добавляет указанную область в список грязных областей, если компонент отображается.
void repaint(Rectangle r)
Добавляет указанную область в список грязных областей, если компонент отображается.
boolean requestDefaultFocus()
Устарело.
С версии 1.4, заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
void requestFocus()
Запрашивает, чтобы этот Component получил фокус ввода.
boolean requestFocus(boolean temporary)
Запрашивает, чтобы этот Component получил фокус ввода.
boolean requestFocusInWindow()
Запрашивает, чтобы этот Component получил фокус ввода.
protected boolean requestFocusInWindow(boolean temporary)
Запрашивает, чтобы этот Component получил фокус ввода.
void resetKeyboardActions()
Удаляет все привязки в первом уровне InputMaps и ActionMap.
void reshape(int x, int y, int w, int h)
Устарело.
С версии JDK 5, заменено на Component.setBounds(int, int, int, int).
void revalidate()
Поддерживает отложенную автоматическую компоновку.
void scrollRectToVisible(Rectangle aRect)
Передает сообщение scrollRectToVisible() родителю JComponent.
final void setActionMap(ActionMap am)
Устанавливает ActionMap на am.
void setAlignmentX(float alignmentX)
Устанавливает горизонтальное выравнивание.
void setAlignmentY(float alignmentY)
Устанавливает вертикальное выравнивание.
void setAutoscrolls(boolean autoscrolls)
Устанавливает свойство autoscrolls.
void setBackground(Color bg)
Устанавливает цвет фона этого компонента.
void setBorder(Border border)
Устанавливает границу этого компонента.
void setComponentPopupMenu(JPopupMenu popup)
Устанавливает JPopupMenu для этого JComponent.
void setDebugGraphicsOptions(int debugOptions)
Включает или отключает диагностическую информацию о каждой операции обработки графики, выполненной внутри компонента или одним из его дочерних элементов.
static void setDefaultLocale(Locale l)
Устанавливает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
void setDoubleBuffered(boolean aFlag)
Устанавливает, должен ли этот компонент использовать буфер для рисования.
void setEnabled(boolean enabled)
Устанавливает, включен ли этот компонент.
void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Устанавливает клавиши перемещения фокуса для данной операции перемещения для этого компонента.
void setFont(Font font)
Устанавливает шрифт для этого компонента.
void setForeground(Color fg)
Устанавливает цвет переднего плана этого компонента.
void setInheritsPopupMenu(boolean value)
Устанавливает, будет ли getComponentPopupMenu делегировать родительскому элементу, если этому компоненту не назначено JPopupMenu.
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.
См. также:
  • 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
См. также:
  • setComponentPopupMenu(javax.swing.JPopupMenu)

getInheritsPopupMenu

public boolean getInheritsPopupMenu()
Возвращает true, если JPopupMenu должен быть унаследован от родителя.
Возвращает:
true, если JPopupMenu должен быть унаследован от родителя
С:
1.5
См. также:
  • setComponentPopupMenu(javax.swing.JPopupMenu)

setComponentPopupMenu

@BeanProperty(preferred=true, description="Popup to show") public void setComponentPopupMenu(JPopupMenu popup)
Устанавливает JPopupMenu для этого JComponent. UI отвечает за регистрацию связей и добавление необходимых обработчиков, чтобы JPopupMenu отображался в нужное время. Время отображения JPopupMenu зависит от внешнего вида: некоторые могут отображать его при событии мыши, некоторые могут активировать сочетание клавиш.

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

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

Параметры:
popup — popup, который будет назначен этому компоненту (может быть null)
С:
1.5
См. также:
  • getComponentPopupMenu()

getComponentPopupMenu

public JPopupMenu getComponentPopupMenu()
Возвращает JPopupMenu, назначенный для этого компонента. Если этому компоненту не назначен JPopupMenu и getInheritsPopupMenu равно true, это вернёт getParent().getComponentPopupMenu() (при условии, что родительский элемент действителен).
Возвращает:
JPopupMenu, назначенный для этого компонента, или null, если нет назначенного popup'а
С:
1.5
См. также:
  • setComponentPopupMenu(javax.swing.JPopupMenu)

updateUI

public void updateUI()
Этот метод вызывается для обновления свойства UI значением из текущего внешнего вида. Подклассы JComponent должны переопределять этот метод так:
   public void updateUI() {
      setUI((SliderUI)UIManager.getUI(this);
   }
  
Требования к реализации:
Метод по умолчанию ничего не делает.
См. также:
  • setUI(javax.swing.plaf.ComponentUI)
  • UIManager.getLookAndFeel()
  • UIManager.getUI(javax.swing.JComponent)

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

getUIClassID

@BeanProperty(bound=false, expert=true, description="UIClassID") public String getUIClassID()
Возвращает ключ UIDefaults, используемый для поиска имени класса swing.plaf.ComponentUI, который определяет внешний вид для этого компонента. Большинству приложений никогда не потребуется вызывать этот метод. Подклассы JComponent, которые поддерживают подключаемый внешний вид, должны переопределять этот метод, чтобы вернуть ключ UIDefaults, который сопоставляется с подклассом ComponentUI, который определяет их внешний вид.
Возвращает:
ключ UIDefaults для подкласса ComponentUI
См. также:
  • UIDefaults.getUI(javax.swing.JComponent)

getComponentGraphics

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

paintComponent

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

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

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

Parameters:
g - защищаемый объект Graphics
See Also:
  • paint(java.awt.Graphics)
  • ComponentUI

paintChildren

protected void paintChildren(Graphics g)
Рисует дочерние компоненты этого компонента. Если shouldUseBuffer имеет значение true, ни один родительский компонент не имеет буфера, и дочерние компоненты могут использовать буфер, если у них есть буфер. В противном случае один родительский компонент имеет буфер, который используется в данный момент, и дочерние компоненты не должны использовать буфер для рисования.
Parameters:
g - контекст Graphics для рисования
See Also:
  • paint(java.awt.Graphics)
  • Container.paint(java.awt.Graphics)

paintBorder

protected void paintBorder(Graphics g)
Рисует границу компонента.

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

Parameters:
g - контекст Graphics для рисования
See Also:
  • paint(java.awt.Graphics)
  • setBorder(javax.swing.border.Border)

update

public void update(Graphics g)
Вызывает paint. Не очищает фон, но см. ComponentUI.update, который вызывается paintComponent.
Overrides:
update в классе Container
Parameters:
g - контекст Graphics для рисования
See Also:
  • paint(java.awt.Graphics)
  • paintComponent(java.awt.Graphics)
  • ComponentUI

paint

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

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

Overrides:
paint в классе Container
Parameters:
g - контекст Graphics для рисования
See Also:
  • paintComponent(java.awt.Graphics)
  • paintBorder(java.awt.Graphics)
  • paintChildren(java.awt.Graphics)
  • getComponentGraphics(java.awt.Graphics)
  • repaint(long, int, int, int, int)

printAll

public void printAll(Graphics g)
Вызовите этот метод для печати компонента. Этот метод вызывает print для компонента.
Overrides:
printAll в классе Component
Parameters:
g - контекст Graphics для рисования
See Also:
  • print(java.awt.Graphics)
  • printComponent(java.awt.Graphics)
  • printBorder(java.awt.Graphics)
  • printChildren(java.awt.Graphics)

print

public void print(Graphics g)
Вызовите этот метод для печати компонента в указанный Graphics. Этот метод приведёт к вызовам printComponent, printBorder и printChildren. Рекомендуется переопределить один из перечисленных методов, а не этот, если вы хотите настроить внешний вид печати. Однако, может быть полезно переопределить этот метод, если вы хотите подготовить состояние перед вызовом поведения родительского класса. Например, если вы хотели изменить цвет фона компонента перед печатью, вы можете сделать следующее:
     public void print(Graphics g) {
         Color orig = getBackground();
         setBackground(Color.WHITE);

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

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

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

Overrides:
print в классе Container
Parameters:
g - контекст Graphics для рисования
See Also:
  • printComponent(java.awt.Graphics)
  • printBorder(java.awt.Graphics)
  • printChildren(java.awt.Graphics)
  • isPaintingForPrint()

printComponent

protected void printComponent(Graphics g)
Вызывается во время операции печати. Реализовано для вызова paintComponent на компоненте. Переопределите этот метод, если хотите добавить специальное поведение рисования при печати.
Parameters:
g - контекст Graphics для рисования
Since:
1.3
See Also:
  • print(java.awt.Graphics)

printChildren

protected void printChildren(Graphics g)
Печатает дочерние компоненты этого компонента. Реализовано для вызова paintChildren на компоненте. Переопределите этот метод, если хотите распечатать дочерние элементы по-другому, чем при рисовании.
Parameters:
g - контекст Graphics для рисования
Since:
1.3
See Also:
  • print(java.awt.Graphics)

printBorder

protected void printBorder(Graphics g)
Печатает границу компонента. Реализовано для вызова paintBorder на компоненте. Переопределите этот метод, если хотите распечатать границу по-другому, чем она рисуется.
Parameters:
g - контекст Graphics для рисования
Since:
1.3
See Also:
  • print(java.awt.Graphics)

isPaintingTile

@BeanProperty(bound=false) public boolean isPaintingTile()
Возвращает true, если компонент в настоящее время рисует плитку. Если этот метод возвращает true, метод paint будет вызван снова для другой плитки. Этот метод возвращает false, если вы не рисуете плитку или если последняя плитка нарисована. Используйте этот метод для сохранения некоторого состояния, которое может потребоваться между плитками.
Returns:
true, если компонент в настоящее время рисует плитку, в противном случае false

isPaintingForPrint

@BeanProperty(bound=false) public final boolean isPaintingForPrint()
Возвращает true, если текущая операция рисования на этом компоненте является частью операции print. Этот метод полезен, когда вы хотите настроить то, что вы печатаете, по сравнению с тем, что вы показываете на экране.

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

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

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

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 при вычислении цикла перемещения фокуса.

Возвращает:
false
См. также:
  • Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>)
  • SortingFocusTraversalPolicy

setNextFocusableComponent

@Deprecated public void setNextFocusableComponent(Component aComponent)
Устарело.
Начиная с 1.4, заменено на FocusTraversalPolicy
В версии 1.4 подсистема фокуса была перестроена. Дополнительную информацию можно найти в Руководстве по использованию подсистемы фокуса в учебнике Java.

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

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

getNextFocusableComponent

@Deprecated public Component getNextFocusableComponent()
Устарело.
Начиная с 1.4, заменено на FocusTraversalPolicy.
В версии 1.4 подсистема фокуса была перестроена. Дополнительную информацию можно найти в Руководстве по использованию подсистемы фокуса в учебнике Java.

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

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

setRequestFocusEnabled

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

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

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

isRequestFocusEnabled

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

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

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

requestFocus

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

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

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

requestFocus

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

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

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

requestFocusInWindow

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

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

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

requestFocusInWindow

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

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

Overrides:
requestFocusInWindow в классе Component
Parameters:
temporary — логическое значение, указывающее, является ли изменение фокуса временным
Returns:
false, если запрос на изменение фокуса гарантированно завершится неудачей; true, если он, вероятно, завершится успешно
Since:
1.4
See Also:
  • Component.requestFocusInWindow()
  • Component.requestFocusInWindow(boolean)

grabFocus

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

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

See Also:
  • requestFocusInWindow()

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:
  • InputVerifier
  • setInputVerifier(javax.swing.InputVerifier)
  • getInputVerifier()
  • getVerifyInputWhenFocusTarget()

getVerifyInputWhenFocusTarget

public boolean getVerifyInputWhenFocusTarget()
Возвращает значение, указывающее, будет ли вызываться проверщик ввода для текущего владельца фокуса перед тем, как этот компонент затребует фокус.
Returns:
значение свойства verifyInputWhenFocusTarget
Since:
1.3
See Also:
  • InputVerifier
  • setInputVerifier(javax.swing.InputVerifier)
  • getInputVerifier()
  • setVerifyInputWhenFocusTarget(boolean)

getFontMetrics

public FontMetrics getFontMetrics(Font font)
Получает FontMetrics для указанного Font.
Overrides:
getFontMetrics в классе Component
Parameters:
font — шрифт, для которого требуется получить метрики шрифта
Returns:
метрики шрифта для font
Throws:
NullPointerException — если font равен null
Since:
1.5
See Also:
  • Component.getFont()
  • ComponentPeer.getFontMetrics(Font)
  • Toolkit.getFontMetrics(Font)

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:
  • Component.getPreferredSize()
  • Component.isPreferredSizeSet()

getPreferredSize

public Dimension getPreferredSize()
Если preferredSize был установлен на значение, отличное от null, то просто возвращает его. Если метод getPreferredSize делегата UI возвращает значение, отличное от null, то возвращает это значение; в противном случае обращается к менеджеру компоновки компонента.
Overrides:
getPreferredSize в классе Container
Returns:
значение свойства preferredSize
See Also:
  • setPreferredSize(java.awt.Dimension)
  • ComponentUI

setMaximumSize

@BeanProperty(description="The maximum size of the component.") public void setMaximumSize(Dimension maximumSize)
Устанавливает максимальный размер этого компонента на постоянное значение. Последующие вызовы getMaximumSize всегда возвращают это значение; UI компонента не будет запрашивать его вычисление. Установка максимального размера на null восстанавливает стандартное поведение.
Overrides:
setMaximumSize в классе Component
Parameters:
maximumSize — Dimension, содержащий желаемый максимальный разрешенный размер
See Also:
  • getMaximumSize()

getMaximumSize

public Dimension getMaximumSize()
Если максимальный размер был установлен на значение, отличное от null, то просто возвращает его. Если метод getMaximumSize делегата UI возвращает значение, отличное от null, то возвращает это значение; в противном случае обращается к менеджеру компоновки компонента.
Overrides:
getMaximumSize в классе Container
Returns:
значение свойства maximumSize
See Also:
  • setMaximumSize(java.awt.Dimension)
  • ComponentUI

setMinimumSize

@BeanProperty(description="The minimum size of the component.") public void setMinimumSize(Dimension minimumSize)
Устанавливает минимальный размер этого компонента на постоянное значение. Последующие вызовы getMinimumSize всегда возвращают это значение; UI компонента не будет запрашивать его вычисление. Установка минимального размера на null восстанавливает стандартное поведение.
Overrides:
setMinimumSize в классе Component
Parameters:
minimumSize — новый минимальный размер этого компонента
See Also:
  • getMinimumSize()

getMinimumSize

public Dimension getMinimumSize()
Если минимальный размер был установлен на значение, отличное от null, то просто возвращает его. Если метод getMinimumSize делегата UI возвращает значение, отличное от null, то возвращает это значение; в противном случае обращается к менеджеру компоновки компонента.
Overrides:
getMinimumSize в классе Container
Returns:
значение свойства minimumSize
See Also:
  • setMinimumSize(java.awt.Dimension)
  • ComponentUI

contains

public boolean contains(int x, int y)
Предоставляет делегату UI возможность определить точную форму этого компонента для обработки мыши.
Overrides:
contains в классе Component
Parameters:
x — координата x точки
y — координата y точки
Returns:
true, если этот компонент логически содержит x,y
See Also:
  • Component.contains(int, int)
  • ComponentUI

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.

Это связанное свойство.

Parameters:
border - граница, которая должна быть отображена для этого компонента
See Also:
  • Border
  • CompoundBorder

getBorder

public Border getBorder()
Возвращает границу этого компонента или null, если граница в настоящее время не установлена.
Returns:
объект границы для этого компонента
See Also:
  • setBorder(javax.swing.border.Border)

getInsets

@BeanProperty(expert=true) public Insets getInsets()
Если на этом компоненте установлена граница, возвращает отступы границы; в противном случае вызывает super.getInsets.
Overrides:
getInsets в классе Container
Returns:
значение свойства отступов
See Also:
  • setBorder(javax.swing.border.Border)

getInsets

public Insets getInsets(Insets insets)
Возвращает объект Insets, содержащий значения отступов этого компонента. Переданный объект Insets будет повторно использован, если это возможно. Однако вызывающие методы не могут предполагать, что будет возвращен тот же объект. Все существующие значения в этом объекте перезаписываются. Если insets равен null, новый будет выделен.
Parameters:
insets - объект Insets, который может быть повторно использован
Returns:
объект Insets
See Also:
  • getInsets()

getAlignmentY

public float getAlignmentY()
Переопределяет Container.getAlignmentY для возвращения вертикального выравнивания.
Overrides:
getAlignmentY в классе Container
Returns:
значение свойства alignmentY
See Also:
  • setAlignmentY(float)
  • Component.getAlignmentY()

setAlignmentY

@BeanProperty(description="The preferred vertical alignment of the component.") public void setAlignmentY(float alignmentY)
Устанавливает вертикальное выравнивание.
Parameters:
alignmentY - новое вертикальное выравнивание
See Also:
  • getAlignmentY()

getAlignmentX

public float getAlignmentX()
Переопределяет Container.getAlignmentX для возвращения горизонтального выравнивания.
Overrides:
getAlignmentX в классе Container
Returns:
значение свойства alignmentX
See Also:
  • setAlignmentX(float)
  • Component.getAlignmentX()

setAlignmentX

@BeanProperty(description="The preferred horizontal alignment of the component.") public void setAlignmentX(float alignmentX)
Устанавливает горизонтальное выравнивание.
Parameters:
alignmentX - новое горизонтальное выравнивание
See Also:
  • getAlignmentX()

setInputVerifier

@BeanProperty(description="The component\'s input verifier.") public void setInputVerifier(InputVerifier inputVerifier)
Устанавливает верификатор ввода для этого компонента.
Parameters:
inputVerifier - новый верификатор ввода
Since:
1.3
See Also:
  • InputVerifier

getInputVerifier

public InputVerifier getInputVerifier()
Возвращает верификатор ввода для этого компонента.
Returns:
свойство inputVerifier
Since:
1.3
See Also:
  • InputVerifier

getGraphics

@BeanProperty(bound=false) public Graphics getGraphics()
Возвращает контекст графики этого компонента, который позволяет рисовать на компоненте. Используйте этот метод для получения объекта Graphics, а затем вызывайте операции на этом объекте для рисования на компоненте.
Overrides:
getGraphics в классе Component
Returns:
контекст графики этого компонента
See Also:
  • Component.paint(java.awt.Graphics)

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)
Включает или отключает диагностическую информацию о каждой графической операции, выполненной внутри компонента или одного из его дочерних элементов.
Parameters:
debugOptions - определяет, как компонент должен отображать информацию; один из следующих вариантов:
  • DebugGraphics.LOG_OPTION - вызывает вывод текстового сообщения.
  • DebugGraphics.FLASH_OPTION - вызывает несколько вспышек отрисовки.
  • DebugGraphics.BUFFERED_OPTION - создает ExternalWindow, отображающий операции, выполненные на offscreen буфере View.
  • DebugGraphics.NONE_OPTION отключает отладку.
  • Значение 0 не вносит изменений в параметры отладки.
debugOptions побитово ИЛИ'ится в текущее значение

getDebugGraphicsOptions

public int getDebugGraphicsOptions()
Возвращает состояние отладки графики.
Returns:
побитово ИЛИ'енный флаг нуля или более следующих вариантов:
  • DebugGraphics.LOG_OPTION - вызывает вывод текстового сообщения.
  • DebugGraphics.FLASH_OPTION - вызывает несколько вспышек отрисовки.
  • DebugGraphics.BUFFERED_OPTION - создает ExternalWindow, отображающий операции, выполненные на offscreen буфере View.
  • DebugGraphics.NONE_OPTION отключает отладку.
  • Значение 0 не вносит изменений в параметры отладки.
See Also:
  • setDebugGraphicsOptions(int)

registerKeyboardAction

public void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел, пожалуйста, используйте комбинацию getActionMap() и getInputMap() для достижения аналогичного поведения. Например, для привязки KeyStroke aKeyStroke к Action anAction используйте теперь:
   component.getInputMap().put(aKeyStroke, aCommand);
   component.getActionMap().put(aCommmand, anAction);
 
. Вышеприведенное предположение предполагает, что вы хотите, чтобы привязка применялась для WHEN_FOCUSED. Для регистрации привязок для других состояний фокуса используйте метод getInputMap, который принимает целое число.

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

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

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

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

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

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

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

registerKeyboardAction

public void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел, пожалуйста, используйте комбинацию getActionMap() и getInputMap() для достижения аналогичного поведения.
Parameters:
anAction - действие, которое будет зарегистрировано для данной комбинации клавиш и условия
aKeyStroke - a KeyStroke
aCondition - условие, которое должно быть связано с данной комбинацией клавиш и действием
See Also:
  • getActionMap()
  • getInputMap(int)

unregisterKeyboardAction

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

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

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

getRegisteredKeyStrokes

@BeanProperty(bound=false) public KeyStroke[] getRegisteredKeyStrokes()
Возвращает KeyStrokes, которые инициируют зарегистрированные действия.
Returns:
массив объектов KeyStroke
See Also:
  • registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

getConditionForKeyStroke

public int getConditionForKeyStroke(KeyStroke aKeyStroke)
Возвращает условие, определяющее, происходит ли зарегистрированное действие в ответ на указанную комбинацию клавиш.

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

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

getActionForKeyStroke

public ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)
Возвращает объект, который выполнит действие, зарегистрированное для данной комбинации клавиш.
Parameters:
aKeyStroke - комбинация клавиш, для которой требуется вернуть слушателя
Returns:
объект ActionListener, который вызывается при нажатии клавиш

resetKeyboardActions

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

setInputMap

public final void setInputMap(int condition, InputMap map)
Устанавливает InputMap для использования в условиях condition до map. Значение null подразумевает, что вы не хотите использовать никакие привязки, даже из интерфейса. Это не переустановит интерфейсный InputMap (если он был). condition имеет одно из следующих значений:
  • WHEN_IN_FOCUSED_WINDOW
  • WHEN_FOCUSED
  • WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Если condition равно WHEN_IN_FOCUSED_WINDOW и map не является экземпляром ComponentInputMap, будет выброшено исключение IllegalArgumentException. Аналогично, если condition не является одним из указанных значений, будет выброшено исключение IllegalArgumentException.
Parameters:
condition - одно из перечисленных значений
map - InputMap для использования в данном условии
Throws:
IllegalArgumentException - если condition равно WHEN_IN_FOCUSED_WINDOW, а map не является экземпляром ComponentInputMap; или если condition не является одним из допустимых значений, указанных выше
Since:
1.3

getInputMap

public final InputMap getInputMap(int condition)
Возвращает InputMap, используемый во время condition.
Parameters:
condition - одно из значений WHEN_IN_FOCUSED_WINDOW, WHEN_FOCUSED, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Returns:
InputMap для указанного condition
Since:
1.3

getInputMap

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

setActionMap

public final void setActionMap(ActionMap am)
Устанавливает ActionMap на am. Это не устанавливает родителя am как ActionMap из интерфейса (если он был), это ответственность вызывающего кода.
Parameters:
am - новое значение ActionMap
Since:
1.3

getActionMap

public final ActionMap getActionMap()
Возвращает ActionMap, используемый для определения, какое Action следует запустить для конкретной KeyStroke привязки. Возвращённый ActionMap, если не указано иное, будет иметь ActionMap из интерфейса в качестве родителя.
Returns:
ActionMap, содержащий привязки ключ/действие
Since:
1.3

getBaseline

public int getBaseline(int width, int height)
Возвращает линию основания. Линия основания измеряется от верхней части компонента. Этот метод предназначен в первую очередь для LayoutManager для выравнивания компонентов вдоль своей линии основания. Значение, меньшее 0, указывает, что у этого компонента нет разумной линии основания, и что LayoutManager не должны выравнивать этот компонент по своей линии основания.

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

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

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
См. также:
  • getBaseline(int, int)

requestDefaultFocus

@Deprecated public boolean requestDefaultFocus()
Устарело.
Начиная с 1.4, заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
В релизе 1.4 система фокуса была перестроена. Дополнительную информацию можно найти в Как использовать систему фокуса, разделе учебника Java.

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

Возвращает:
true, если этот компонент может запросить фокус, false — если нет
См. также:
  • FocusTraversalPolicy.getDefaultComponent(java.awt.Container)

setVisible

@BeanProperty(hidden=true, visualUpdate=true) public void setVisible(boolean aFlag)
Делает компонент видимым или невидимым. Переопределяет Component.setVisible.
Overrides:
setVisible в классе Component
Параметры:
aFlag - true для отображения компонента; false для его скрытия
См. также:
  • Component.isVisible()
  • Component.invalidate()

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 в противном случае
См. также:
  • Component.isEnabled()
  • Component.isLightweight()

setForeground

@BeanProperty(preferred=true, visualUpdate=true, description="The foreground color of the component.") public void setForeground(Color fg)
Устанавливает цвет переднего плана этого компонента. Виджет может игнорировать это свойство.
Overrides:
setForeground в классе Component
Параметры:
fg - желаемый цвет переднего плана Color
См. также:
  • Component.getForeground()

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 - желаемый цвет фона Color
См. также:
  • Component.getBackground()
  • setOpaque(boolean)

setFont

@BeanProperty(preferred=true, visualUpdate=true, description="The font for the component.") public void setFont(Font font)
Устанавливает шрифт для этого компонента.
Overrides:
setFont в классе Container
Параметры:
font - желаемый Font для этого компонента
См. также:
  • Component.getFont()

getDefaultLocale

public static Locale getDefaultLocale()
Возвращает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании. Локаль по умолчанию имеет область видимости "AppContext", чтобы апплеты (и потенциально несколько лёгких приложений, работающих в одной виртуальной машине) могли иметь собственные настройки. Аплет может безопасно изменять локаль по умолчанию, так как это не повлияет на другие апплеты (или браузер).
Возвращает:
локаль по умолчанию.
С момента:
1.4
См. также:
  • setDefaultLocale(java.util.Locale)
  • Component.getLocale()
  • Component.setLocale(java.util.Locale)

setDefaultLocale

public static void setDefaultLocale(Locale l)
Устанавливает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании. Начальное значение — локаль по умолчанию виртуальной машины. Локаль по умолчанию имеет область видимости "AppContext", чтобы апплеты (и потенциально несколько лёгких приложений, работающих в одной виртуальной машине) могли иметь собственные настройки. Аплет может безопасно изменять локаль по умолчанию, так как это не повлияет на другие апплеты (или браузер). Передача null сбросит текущую локаль обратно к локали по умолчанию виртуальной машины.
Параметры:
l - желаемая локаль по умолчанию для новых компонентов.
С момента:
1.4
См. также:
  • getDefaultLocale()
  • Component.getLocale()
  • Component.setLocale(java.util.Locale)

processComponentKeyEvent

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

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

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

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

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

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

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 для получения дополнительной информации.

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

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

public String getToolTipText()
Возвращает строку подсказки, которая была установлена с помощью setToolTipText.
Возвращает:
текст подсказки
См. также:
  • TOOL_TIP_TEXT_KEY

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

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
См. также:
  • JViewport

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

@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-компоненты, которые поддерживают выбор элементов и обычно отображаются в JScrollPane (JTable, JList, JTree, JTextArea и JEditorPane) уже обрабатывают события перетаскивания мыши таким образом. Чтобы включить автоматическую прокрутку в любой другой компонент, добавьте обработчик движения мыши, который вызывает scrollRectToVisible. Например, для JPanel, myPanel:
 MouseMotionListener doScrollRectToVisible = new MouseMotionAdapter() {
     public void mouseDragged(MouseEvent e) {
        Rectangle r = new Rectangle(e.getX(), e.getY(), 1, 1);
        ((JPanel)e.getSource()).scrollRectToVisible(r);
    }
 };
 myPanel.addMouseMotionListener(doScrollRectToVisible);
 
Значение свойства autoScrolls по умолчанию равно false.
Параметры:
autoscrolls - если true, генерируются искусственные события перетаскивания мыши при перетаскивании мыши за пределы границ компонента и удерживании кнопки мыши; в противном случае false
См. также:
  • getAutoscrolls()
  • JViewport
  • JScrollPane

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

public boolean getAutoscrolls()
Получает свойство autoscrolls.
Возвращает:
значение свойства autoscrolls
См. также:
  • JViewport
  • setAutoscrolls(boolean)

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

@BeanProperty(hidden=true, description="Mechanism for transfer of data to and from the component") public void setTransferHandler(TransferHandler newHandler)
Устанавливает TransferHandler, который обеспечивает поддержку передачи данных в и из этого компонента с помощью функций "Вырезать/Копировать/Вставить" и перетаскивания. Может быть null, если компонент не поддерживает операции передачи данных.

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

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

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

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

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

getTransferHandler

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

processMouseEvent

protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, возникающие на этом компоненте, пересылая их зарегистрированным объектам MouseListener. См. Component.processMouseEvent(MouseEvent) для полного описания этого метода.
Переопределяет:
processMouseEvent в классе Component
Параметры:
e - событие мыши
С:
1.5
См. также:
  • Component.processMouseEvent(java.awt.event.MouseEvent)

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события перемещения мыши, такие как MouseEvent.MOUSE_DRAGGED.
Переопределяет:
processMouseMotionEvent в классе Component
Параметры:
e - событие MouseEvent
См. также:
  • MouseEvent

enable

@Deprecated public void enable()
Устарело.
С версии JDK 1.1 заменено на java.awt.Component.setEnabled(boolean).
Переопределяет:
enable в классе Component

disable

@Deprecated public void disable()
Устарело.
С версии JDK 1.1 заменено на java.awt.Component.setEnabled(boolean).
Переопределяет:
disable в классе Component

getClientProperty

public final Object getClientProperty(Object key)
Возвращает значение свойства с заданным ключом. Только добавленные свойства putClientProperty вернут значение отличное от null.
Параметры:
key - запрашиваемый ключ
Возвращает:
значение этого свойства или null
См. также:
  • putClientProperty(java.lang.Object, java.lang.Object)

putClientProperty

public final void putClientProperty(Object key, Object value)
Добавляет произвольное свойство "клиентское свойство" с ключом/значением к этому компоненту.

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

 componentA.putClientProperty("to the left of", componentB);
 
Если значение равно null, этот метод удалит свойство. Изменения в клиентских свойствах отражаются событиями PropertyChange. Наименование свойства (для событий PropertyChange) равно key.toString().

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

Параметры:
key - новый ключ клиентского свойства
value - новое значение клиентского свойства; если null, этот метод удалит свойство
См. также:
  • getClientProperty(java.lang.Object)
  • Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

setFocusTraversalKeys

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

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

Переопределяет:
setFocusTraversalKeys в классе Container
Параметры:
id - одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
keystrokes - множество AWTKeyStroke для указанной операции
Исключения:
IllegalArgumentException - если id не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или если keystrokes содержит null, или если какой-либо keystroke представляет событие KEY_TYPED, или если какой-либо keystroke уже отображен на другую операцию перехода фокуса для этого компонента
С:
1.5
См. также:
  • KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
  • KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
  • KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

isLightweightComponent

public static boolean isLightweightComponent(Component c)
Возвращает true, если этот компонент легковесный, то есть у него нет псевдонима окна системы взаимодействия.
Параметры:
c - проверяемый Component
Возвращает:
true, если компонент легковесный

reshape

@Deprecated public void reshape(int x, int y, int w, int h)
Устарело.
С версии JDK 5 заменено на Component.setBounds(int, int, int, int).

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

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

getBounds

public Rectangle getBounds(Rectangle rv)
Хранит границы этого компонента в "возвращаемом значении" rv и возвращает rv. Если rv равно null, выделяется новый Rectangle. Этот вариант getBounds полезен, если вызывающий не хочет выделять новый Rectangle объект в куче.
Переопределяет:
getBounds в классе Component
Параметры:
rv - возвращаемое значение, изменённое на границы компонента
Возвращает:
rv; если rv равно null, возвращается новый Rectangle с границами этого компонента

getSize

public Dimension getSize(Dimension rv)
Хранит ширину/высоту этого компонента в "возвращаемом значении" rv и возвращает rv. Если rv равно null, выделяется новый объект Dimension. Этот вариант getSize полезен, если вызывающий не хочет выделять новый Dimension объект в куче.
Переопределяет:
getSize в классе Component
Параметры:
rv - возвращаемое значение, изменённое на размер компонента
Возвращает:
rv

getLocation

public Point getLocation(Point rv)
Хранит координаты x, y начала этого компонента в "возвращаемом значении" rv и возвращает rv. Если rv равно null, выделяется новый Point. Этот вариант getLocation полезен, если вызывающий не хочет выделять новый Point объект в куче.
Переопределяет:
getLocation в классе Component
Параметры:
rv - возвращаемое значение, изменённое на расположение компонента
Возвращает:
rv

getX

@BeanProperty(bound=false) public int getX()
Возвращает текущую координату x начала компонента. Этот метод предпочтительнее, чем запись component.getBounds().x или component.getLocation().x, так как он не вызывает выделения объектов в куче.
Переопределяет:
getX в классе Component
Возвращает:
текущую координату x начала компонента

getY

@BeanProperty(bound=false) public int getY()
Возвращает текущую координату y начала компонента. Этот метод предпочтительнее, чем написание component.getBounds().y, или component.getLocation().y, потому что он не вызывает выделения памяти.
Overrides:
getY в классе Component
Возвращает:
текущую координату y начала компонента

getWidth

@BeanProperty(bound=false) public int getWidth()
Возвращает текущую ширину этого компонента. Этот метод предпочтительнее, чем написание component.getBounds().width, или component.getSize().width, потому что он не вызывает выделения памяти.
Overrides:
getWidth в классе Component
Возвращает:
текущую ширину этого компонента

getHeight

@BeanProperty(bound=false) public int getHeight()
Возвращает текущую высоту этого компонента. Этот метод предпочтительнее, чем написание component.getBounds().height, или component.getSize().height, потому что он не вызывает выделения памяти.
Overrides:
getHeight в классе Component
Возвращает:
текущую высоту этого компонента

isOpaque

public boolean isOpaque()
Возвращает true, если этот компонент полностью непрозрачен.

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

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

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

setOpaque

@BeanProperty(expert=true, description="The component\'s opacity") public void setOpaque(boolean isOpaque)
Если true, компонент рисует каждый пиксель в пределах своих границ. В противном случае компонент может не рисовать некоторые или все свои пиксели, позволяя подлежащим пикселям просвечивать.

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

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

computeVisibleRect

public void computeVisibleRect(Rectangle visibleRect)
Возвращает "прямоугольник видимой области" Component - пересечение видимых прямоугольников для этого компонента и всех его предков. Результат сохраняется в visibleRect.
Параметры:
visibleRect - прямоугольник Rectangle, вычисленный как пересечение всех видимых прямоугольников для этого компонента и всех его предков - это значение, возвращаемое данным методом
См. также:
  • getVisibleRect()

getVisibleRect

@BeanProperty(bound=false) public Rectangle getVisibleRect()
Возвращает "прямоугольник видимой области" Component - пересечение видимого прямоугольника этого компонента, new Rectangle(0, 0, getWidth(), getHeight()) и видимых прямоугольников всех его предков.
Возвращает:
видимый прямоугольник

firePropertyChange

public void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Поддержка для отслеживания изменений свойств типа boolean. Этот метод можно вызывать, когда связанное свойство изменилось, и он отправит соответствующее PropertyChangeEvent всем зарегистрированным слушателям PropertyChangeListeners.
Overrides:
firePropertyChange в классе Component
Параметры:
propertyName - свойство, значение которого изменилось
oldValue - предыдущее значение свойства
newValue - новое значение свойства

firePropertyChange

public void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка для отслеживания изменений свойств типа int. Этот метод можно вызывать, когда связанное свойство изменилось, и он отправит соответствующее PropertyChangeEvent всем зарегистрированным слушателям PropertyChangeListeners.
Overrides:
firePropertyChange в классе Component
Параметры:
propertyName - свойство, значение которого изменилось
oldValue - предыдущее значение свойства
newValue - новое значение свойства

fireVetoableChange

protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue) throws PropertyVetoException
Поддержка отслеживания изменений ограниченных свойств. Этот метод можно вызывать, когда ограниченное свойство изменилось, и он отправит соответствующее событие PropertyChangeEvent всем зарегистрированным слушателям VetoableChangeListeners.
Параметры:
propertyName - имя свойства, за которым ведется наблюдение
oldValue - старое значение свойства
newValue - новое значение свойства
Исключения:
PropertyVetoException - когда попытка установить свойство отменена компонентом

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)
Добавляет слушателя VetoableChangeListener в список слушателей. Слушатель регистрируется для всех свойств.
Параметры:
listener - добавляемый слушатель VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)
Удаляет слушателя VetoableChangeListener из списка слушателей. Это удаляет слушателя VetoableChangeListener, который был зарегистрирован для всех свойств.
Параметры:
listener - удаляемый слушатель VetoableChangeListener

getVetoableChangeListeners

@BeanProperty(bound=false) public VetoableChangeListener[] getVetoableChangeListeners()
Возвращает массив всех слушателей изменений вето, зарегистрированных в этом компоненте.
Возвращает:
все слушатели изменений вето компонента или пустой массив, если слушатели изменений вето в данный момент не зарегистрированы
Since:
1.4
См. также:
  • addVetoableChangeListener(java.beans.VetoableChangeListener)
  • removeVetoableChangeListener(java.beans.VetoableChangeListener)

getTopLevelAncestor

@BeanProperty(bound=false) public Container getTopLevelAncestor()
Возвращает верхнего предка этого компонента (либо содержащую Window или Applet), или null если этот компонент не добавлен ни в одну контейнерную структуру.
Возвращает:
верхнего Container, в котором находится этот компонент, или null, если компонент не находится ни в одном контейнере

addAncestorListener

public void addAncestorListener(AncestorListener listener)
Регистрирует слушателя listener, чтобы он получал события AncestorEvents, когда он или любой из его предков перемещаются или становятся видимыми или невидимыми. События также отправляются, когда компонент или его предки добавляются или удаляются из иерархии контейнеров.
Параметры:
listener - регистрируемый слушатель AncestorListener
См. также:
  • AncestorEvent

removeAncestorListener

public void removeAncestorListener(AncestorListener listener)
Отменяет регистрацию слушателя listener, чтобы он больше не получал события AncestorEvents.
Параметры:
listener - слушатель AncestorListener для удаления
См. также:
  • addAncestorListener(javax.swing.event.AncestorListener)

getAncestorListeners

@BeanProperty(bound=false) public AncestorListener[] getAncestorListeners()
Возвращает массив всех слушателей предков, зарегистрированных в этом компоненте.
Возвращает:
все слушатели предков компонента или пустой массив, если слушатели предков не зарегистрированы
Since:
1.4
См. также:
  • addAncestorListener(javax.swing.event.AncestorListener)
  • removeAncestorListener(javax.swing.event.AncestorListener)

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)
Возвращает массив всех объектов, в настоящее время зарегистрированных в качестве FooListener на этом JComponent. FooListener регистрируются с помощью метода addFooListener.

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

MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));
Если такие слушатели не существуют, этот метод возвращает пустой массив.
Overrides:
getListeners в классе Container
Type Parameters:
T - тип слушателей
Parameters:
listenerType - тип запрашиваемых слушателей; этот параметр должен указать интерфейс, унаследованный от java.util.EventListener
Returns:
массив всех объектов, зарегистрированных в качестве FooListener на этом компоненте, или пустой массив, если такие слушатели не были добавлены
Throws:
ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener
Since:
1.3
See Also:
  • getVetoableChangeListeners()
  • getAncestorListeners()

addNotify

public void addNotify()
Уведомляет этот компонент о том, что у него теперь есть родительский компонент. При вызове этого метода устанавливается цепочка родительских компонентов с KeyboardAction слушателями событий. Этот метод вызывается инструментарием внутри и не должен вызываться программами напрямую.
Overrides:
addNotify в классе Container
See Also:
  • registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

removeNotify

public void removeNotify()
Уведомляет этот компонент о том, что у него больше нет родительского компонента. При вызове этого метода любые KeyboardAction, установленные в цепочке родительских компонентов, удаляются. Этот метод вызывается инструментарием внутри и не должен вызываться программами напрямую.
Overrides:
removeNotify в классе Container
See Also:
  • registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

repaint

public void repaint(long tm, int x, int y, int width, int height)
Добавляет указанную область в список областей, требующих перерисовки, если компонент отображается. Компонент будет перерисован после обработки всех текущих ожидающих событий.
Overrides:
repaint в классе Component
Parameters:
tm - этот параметр не используется
x - значение x области, требующей перерисовки
y - значение y области, требующей перерисовки
width - ширина области, требующей перерисовки
height - высота области, требующей перерисовки
See Also:
  • isPaintingOrigin()
  • Component.isShowing()
  • RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)

repaint

public void repaint(Rectangle r)
Добавляет указанную область в список областей, требующих перерисовки, если компонент отображается. Компонент будет перерисован после обработки всех текущих ожидающих событий.
Parameters:
r - Rectangle, содержащая область, требующую перерисовки
See Also:
  • isPaintingOrigin()
  • Component.isShowing()
  • RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)

revalidate

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

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

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

Overrides:
revalidate в классе Component
See Also:
  • Component.invalidate()
  • Container.validate()
  • isValidateRoot()
  • RepaintManager.addInvalidComponent(javax.swing.JComponent)

isValidateRoot

public boolean isValidateRoot()
Если этот метод возвращает true, вызовы revalidate потомками этого компонента заставят валидировать всю ветвь, начиная с этого корня. По умолчанию возвращает false. JScrollPane переопределяет этот метод и возвращает true.
Overrides:
isValidateRoot в классе Container
Returns:
всегда возвращает false
See Also:
  • revalidate()
  • Component.invalidate()
  • Container.validate()
  • Container.isValidateRoot()

isOptimizedDrawingEnabled

@BeanProperty(bound=false) public boolean isOptimizedDrawingEnabled()
Возвращает true, если этот компонент заполняет своих потомков — то есть, если он может гарантировать, что потомки не перекрываются. Система перерисовки значительно эффективнее в этом распространённом случае. Подклассы JComponent, которые не могут гарантировать это, такие как JLayeredPane, должны переопределить этот метод, чтобы вернуть false.
Returns:
всегда возвращает true

isPaintingOrigin

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

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

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

Returns:
всегда возвращает false
See Also:
  • paintImmediately(int, int, int, int)

paintImmediately

public void paintImmediately(int x, int y, int w, int h)
Перерисовывает указанную область в этом компоненте и всех его потомках, которые перекрывают эту область, немедленно.

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

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

Parameters:
x - значение x области, подлежащей перерисовке
y - значение y области, подлежащей перерисовке
w - ширина области, подлежащей перерисовке
h - высота области, подлежащей перерисовке
See Also:
  • repaint(long, int, int, int, int)
  • isPaintingOrigin()

paintImmediately

public void paintImmediately(Rectangle r)
Перерисовывает указанную область сейчас.
Parameters:
r - Rectangle, содержащая область, подлежащую перерисовке

setDoubleBuffered

public void setDoubleBuffered(boolean aFlag)
Устанавливает, должен ли этот компонент использовать буфер для перерисовки. Если установлено true, все операции рисования с этого компонента будут выполняться в буфере офскрин-рисования. Буфер офскрин-рисования будет скопирован на экран. Если компонент буферизован, а один из его предков также буферизован, будет использован буфер предка.
Parameters:
aFlag - если true, этот компонент будет буферизован

isDoubleBuffered

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

getRootPane

@BeanProperty(bound=false) public JRootPane getRootPane()
Возвращает предка типа JRootPane для этого компонента.
Возвращает:
JRootPane, содержащий этот компонент, или null, если такой JRootPane не найден

paramString

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

hide

@Deprecated public void hide()
Устарело.
Overrides:
hide в классе Component

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API