Spec-Zone.ru › OpenJDK 25

Класс JComponent

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
Все реализуемые интерфейсы:
ImageObserver, MenuContainer, Serializable
Прямые известные подклассы:
AbstractButton, BasicInternalFrameTitlePane, Box, Box.Filler, JColorChooser, JComboBox, JFileChooser, JInternalFrame, JInternalFrame.JDesktopIcon, JLabel, JLayer, JLayeredPane, JList, JMenuBar, JOptionPane, JPanel, JPopupMenu, JProgressBar, JRootPane, JScrollBar, JScrollPane, JSeparator, JSlider, JSpinner, JSplitPane, JTabbedPane, JTable, JTableHeader, JTextComponent, JToolBar, JToolTip, JTree, JViewport
@JavaBean(defaultProperty="UIClassID") public abstract class JComponent extends Container implements Serializable
Базовый класс всех компонентов Swing, кроме контейнеров верхнего уровня. Чтобы использовать компонент, унаследованный от JComponent, необходимо поместить его в иерархию вложенности, корнем которой является контейнер Swing верхнего уровня. Контейнеры Swing верхнего уровня — такие как JFrame, JDialog и JApplet — представляют собой специализированные компоненты, предоставляющие другим компонентам Swing место для отрисовки. Объяснение иерархий вложенности см. в разделе Компоненты Swing и иерархия вложенности из Учебника Java.

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

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

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

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

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

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

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

С момента появления:
1.2
См. также:
  • KeyStroke
  • Action
  • setBorder(Border)
  • registerKeyboardAction(ActionListener, String, KeyStroke, int)
  • JOptionPane
  • setDebugGraphicsOptions(int)
  • setToolTipText(String)
  • setAutoscrolls(boolean)

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

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

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

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе 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, означающая, что команда должна быть вызвана, когда принимающий компонент находится в окне, имеющем фокус, или сам имеет фокус.

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

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

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

Модификатор и тип Метод Описание
void addAncestorListener(AncestorListener listener)
Регистрирует listener, чтобы он получал AncestorEvents при перемещении или изменении видимости этого компонента либо любого из его предков.
void addNotify()
Уведомляет этот компонент о том, что у него теперь есть родительский компонент.
void addVetoableChangeListener(VetoableChangeListener listener)
Добавляет VetoableChangeListener в список прослушивателей.
void computeVisibleRect(Rectangle visibleRect)
Возвращает «видимый прямоугольник» Component — пересечение видимых прямоугольников этого компонента и всех его предков.
boolean contains(int x, int y)
Предоставляет делегату пользовательского интерфейса возможность определить точную форму этого компонента для обработки мыши.
JToolTip createToolTip()
Возвращает экземпляр JToolTip, который следует использовать для отображения всплывающей подсказки.
void disable()
Устарело.
Начиная с JDK версии 1.1 заменено на java.awt.Component.setEnabled(boolean).
void enable()
Устарело.
Начиная с JDK версии 1.1 заменено на java.awt.Component.setEnabled(boolean).
void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Поддержка уведомления об изменениях привязанных свойств логического типа.
void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка уведомления об изменениях привязанных свойств целочисленного типа.
protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue)
Поддерживает уведомление об изменениях ограниченных свойств.
ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)
Возвращает объект, который выполнит действие, зарегистрированное для заданного сочетания клавиш.
final ActionMap getActionMap()
Возвращает ActionMap, используемый для определения того, какое Action следует вызвать для данной привязки KeyStroke.
float getAlignmentX()
Переопределяет Container.getAlignmentX, чтобы вернуть горизонтальное выравнивание.
float getAlignmentY()
Переопределяет Container.getAlignmentY, чтобы вернуть вертикальное выравнивание.
AncestorListener[] getAncestorListeners()
Возвращает массив всех прослушивателей предков, зарегистрированных для этого компонента.
boolean getAutoscrolls()
Возвращает свойство autoscrolls.
int getBaseline(int width, int height)
Возвращает базовую линию.
Component.BaselineResizeBehavior getBaselineResizeBehavior()
Возвращает перечисление, указывающее, как изменяется базовая линия компонента при изменении его размера.
Border getBorder()
Возвращает границу этого компонента или null, если граница не задана.
Rectangle getBounds(Rectangle rv)
Сохраняет границы этого компонента в «возвращаемом значении» rv и возвращает rv.
final Object getClientProperty(Object key)
Возвращает значение свойства с указанным ключом.
protected Graphics getComponentGraphics(Graphics g)
Возвращает графический объект, используемый для отрисовки этого компонента.
JPopupMenu getComponentPopupMenu()
Возвращает JPopupMenu, назначенный этому компоненту.
int getConditionForKeyStroke(KeyStroke aKeyStroke)
Возвращает условие, определяющее, выполняется ли зарегистрированное действие в ответ на указанное сочетание клавиш.
int getDebugGraphicsOptions()
Возвращает состояние отладки графики.
static Locale getDefaultLocale()
Возвращает локаль по умолчанию, используемую для инициализации свойства локали каждого 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)
Вызывает метод отрисовки делегата пользовательского интерфейса, если делегат не равен 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)
Задает локаль по умолчанию, используемую для инициализации свойства локали каждого 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()
Этот метод вызывается для обновления свойства пользовательского интерфейса значением из текущего внешнего вида.

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

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

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

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

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

ui

protected transient ComponentUI ui
Делегат внешнего вида для этого компонента.

listenerList

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

WHEN_FOCUSED

public static final int WHEN_FOCUSED
Константа, используемая для registerKeyboardAction, означающая, что команда должна быть вызвана, когда компонент находится в фокусе.
См. также:
  • Значения констант полей

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

public static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Константа, используемая для registerKeyboardAction, означающая, что команда должна быть вызвана, когда компонент-получатель является предком компонента, находящегося в фокусе, или сам находится в фокусе.
См. также:
  • Значения констант полей

WHEN_IN_FOCUSED_WINDOW

public static final int WHEN_IN_FOCUSED_WINDOW
Константа, используемая для registerKeyboardAction, означающая, что команда должна быть вызвана, когда компонент-получатель находится в окне, имеющем фокус, или сам находится в фокусе.
См. также:
  • Значения констант полей

UNDEFINED_CONDITION

public static final int UNDEFINED_CONDITION
Константа, используемая некоторыми API и означающая, что условие не определено.
См. также:
  • Значения констант полей

TOOL_TIP_TEXT_KEY

public static final String TOOL_TIP_TEXT_KEY
Комментарий, отображаемый, когда курсор находится над компонентом; также известен как «всплывающая подсказка», «контекстная справка» или «всплывающая метка».
См. также:
  • Значения констант полей

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

JComponent

public JComponent()
Конструктор JComponent по умолчанию. Этот конструктор выполняет лишь минимальную инициализацию, помимо вызова конструктора Container. Например, начальный менеджер компоновки равен null. Однако он устанавливает свойство локали компонента в значение, возвращаемое методом 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(JPopupMenu)

getInheritsPopupMenu

public boolean getInheritsPopupMenu()
Возвращает true, если JPopupMenu должен наследоваться от родительского компонента.
Возвращает:
true, если JPopupMenu должен наследоваться от родительского компонента
Начиная с:
1.5
См. также:
  • setComponentPopupMenu(JPopupMenu)

setComponentPopupMenu

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

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

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

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

getComponentPopupMenu

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

updateUI

public void updateUI()
Этот метод вызывается для обновления свойства UI значением из текущего внешнего вида. Подклассы JComponent должны переопределять этот метод следующим образом:
  public void updateUI() {
     setUI((SliderUI)UIManager.getUI(this);
  }
 
Требования к реализации:
Реализация этого метода по умолчанию ничего не делает.
См. также:
  • setUI(ComponentUI)
  • UIManager.getLookAndFeel()
  • UIManager.getUI(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 — новый делегат пользовательского интерфейса
См. также:
  • updateUI()
  • UIManager.getLookAndFeel()
  • UIManager.getUI(JComponent)

getUIClassID

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

getComponentGraphics

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

paintComponent

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

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

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

Параметры:
g — защищаемый объект Graphics
См. также:
  • paint(Graphics)
  • ComponentUI

paintChildren

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

paintBorder

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

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

Параметры:
g — контекст Graphics, в котором выполняется отрисовка
См. также:
  • paint(Graphics)
  • setBorder(Border)

update

public void update(Graphics g)
Вызывает paint. Фон не очищается; см. ComponentUI.update, который вызывается методом paintComponent.
Переопределяет:
update в классе Container
Параметры:
g — контекст Graphics, в котором выполняется отрисовка
См. также:
  • paint(Graphics)
  • paintComponent(Graphics)
  • ComponentUI

paint

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

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

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

printAll

public void printAll(Graphics g)
Вызовите этот метод, чтобы напечатать компонент. Метод вызывает print для компонента.
Переопределяет:
printAll в классе Component
Параметры:
g — контекст Graphics, в котором выполняется отрисовка
См. также:
  • print(Graphics)
  • printComponent(Graphics)
  • printBorder(Graphics)
  • printChildren(Graphics)

print

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

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

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

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

Переопределяет:
print в классе Container
Параметры:
g — контекст Graphics, в котором выполняется отрисовка
См. также:
  • printComponent(Graphics)
  • printBorder(Graphics)
  • printChildren(Graphics)
  • isPaintingForPrint()

printComponent

protected void printComponent(Graphics g)
Вызывается во время печати. Реализация вызывает paintComponent для компонента. Переопределите этот метод, если хотите добавить особое поведение при отрисовке во время печати.
Параметры:
g — контекст Graphics, в котором выполняется отрисовка
Начиная с:
1.3
См. также:
  • print(Graphics)

printChildren

protected void printChildren(Graphics g)
Печатает дочерние компоненты этого компонента. Реализация вызывает paintChildren для компонента. Переопределите этот метод, если хотите печатать дочерние компоненты иначе, чем они отрисовываются.
Параметры:
g — контекст Graphics, в котором выполняется отрисовка
Начиная с:
1.3
См. также:
  • print(Graphics)

printBorder

protected void printBorder(Graphics g)
Печатает границу компонента. Реализация вызывает paintBorder для компонента. Переопределите этот метод, если хотите печатать границу иначе, чем она отрисовывается.
Параметры:
g — контекст Graphics, в котором выполняется отрисовка
Начиная с:
1.3
См. также:
  • print(Graphics)

isPaintingTile

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

isPaintingForPrint

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

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

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

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

isManagingFocus

@Deprecated @BeanProperty(bound=false) public boolean isManagingFocus()
Устарело.
Начиная с версии 1.4, заменено методами Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean).
В выпуске 1.4 подсистема фокуса была переработана. Дополнительную информацию см. в разделе Использование подсистемы фокуса руководства The Java Tutorial.

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

Возвращает:
false
См. также:
  • Component.setFocusTraversalKeys(int, Set)
  • SortingFocusTraversalPolicy

setNextFocusableComponent

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

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

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

getNextFocusableComponent

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

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

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

setRequestFocusEnabled

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

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

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

isRequestFocusEnabled

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

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

Возвращает:
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 — логическое значение, указывающее, является ли изменение фокуса временным
Возвращает:
false, если запрос на изменение фокуса гарантированно завершится неудачей; true, если он, вероятно, будет успешным
Начиная с версии:
1.4
См. также:
  • Component.requestFocusInWindow()
  • Component.requestFocusInWindow(boolean)

requestFocusInWindow

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

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

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

requestFocusInWindow

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

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

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

grabFocus

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

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

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

setVerifyInputWhenFocusTarget

@BeanProperty(description="Whether the Component verifies input before accepting focus.") public void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
Задает значение, указывающее, будет ли средство проверки ввода для текущего владельца фокуса вызвано перед запросом фокуса этим компонентом. Значение по умолчанию — true. Установите false для таких компонентов, как кнопка «Отмена» или полоса прокрутки, которые должны активироваться, даже если средство проверки ввода для текущего владельца фокуса не подтвердило введенные в него данные.
Параметры:
verifyInputWhenFocusTarget — значение свойства verifyInputWhenFocusTarget
Начиная с версии:
1.3
См. также:
  • InputVerifier
  • setInputVerifier(InputVerifier)
  • getInputVerifier()
  • getVerifyInputWhenFocusTarget()

getVerifyInputWhenFocusTarget

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

getFontMetrics

public FontMetrics getFontMetrics(Font font)
Получает FontMetrics для указанного Font.
Переопределяет:
getFontMetrics в классе Component
Параметры:
font — шрифт, для которого нужно получить метрики
Возвращает:
метрики шрифта для font
Выбрасывает:
NullPointerException — если font имеет значение null
Начиная с версии:
1.5
См. также:
  • 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, запрашивается предпочтительный размер у пользовательского интерфейса.
Переопределяет:
setPreferredSize в классе Component
Параметры:
preferredSize — новый предпочтительный размер или null
См. также:
  • Component.getPreferredSize()
  • Component.isPreferredSizeSet()

getPreferredSize

public Dimension getPreferredSize()
Если для preferredSize задано значение, отличное от null, оно просто возвращается. Если метод getPreferredSize делегата пользовательского интерфейса возвращает значение, отличное от null, возвращается оно; в противном случае используется менеджер компоновки компонента.
Переопределяет:
getPreferredSize в классе Container
Возвращает:
значение свойства preferredSize
См. также:
  • setPreferredSize(Dimension)
  • ComponentUI

setMaximumSize

@BeanProperty(description="The maximum size of the component.") public void setMaximumSize(Dimension maximumSize)
Задает максимальный размер этого компонента как постоянное значение. При последующих вызовах getMaximumSize всегда будет возвращаться это значение; пользовательский интерфейс компонента не будет вычислять его. Установка максимального размера в null восстанавливает поведение по умолчанию.

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

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

getMaximumSize

public Dimension getMaximumSize()
Если для максимального размера задано значение, отличное от null, оно просто возвращается. Если метод getMaximumSize делегата пользовательского интерфейса возвращает значение, отличное от null, возвращается оно; в противном случае используется менеджер компоновки компонента.
Переопределяет:
getMaximumSize в классе Container
Возвращает:
значение свойства maximumSize
См. также:
  • setMaximumSize(Dimension)
  • ComponentUI

setMinimumSize

@BeanProperty(description="The minimum size of the component.") public void setMinimumSize(Dimension minimumSize)
Задает минимальный размер этого компонента как постоянное значение. При последующих вызовах getMinimumSize всегда будет возвращаться это значение; пользовательский интерфейс компонента не будет вычислять его. Установка минимального размера в null восстанавливает поведение по умолчанию.

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

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

getMinimumSize

public Dimension getMinimumSize()
Если для минимального размера задано значение, отличное от null, оно просто возвращается. Если метод getMinimumSize делегата пользовательского интерфейса возвращает значение, отличное от null, возвращается оно; в противном случае используется менеджер компоновки компонента.
Переопределяет:
getMinimumSize в классе Container
Возвращает:
значение свойства minimumSize
См. также:
  • setMinimumSize(Dimension)
  • ComponentUI

contains

public boolean contains(int x, int y)
Предоставляет делегату пользовательского интерфейса возможность определить точную форму этого компонента для обработки событий мыши.
Переопределяет:
contains в классе Component
Параметры:
x — координата x точки
y — координата y точки
Возвращает:
true, если эта точка с координатами x,y логически принадлежит компоненту
См. также:
  • 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.

Это ограниченное свойство.

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

getBorder

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

getInsets

@BeanProperty(expert=true) public Insets getInsets()
Если для этого компонента задана граница, возвращает отступы границы; в противном случае вызывает super.getInsets.
Переопределяет:
getInsets в классе Container
Возвращает:
значение свойства отступов
См. также:
  • setBorder(Border)

getInsets

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

getAlignmentY

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

setAlignmentY

@BeanProperty(description="The preferred vertical alignment of the component.") public void setAlignmentY(float alignmentY)
Задает вертикальное выравнивание.
Параметры:
alignmentY — новое вертикальное выравнивание
См. также:
  • getAlignmentY()

getAlignmentX

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

setAlignmentX

@BeanProperty(description="The preferred horizontal alignment of the component.") public void setAlignmentX(float alignmentX)
Задает горизонтальное выравнивание.
Параметры:
alignmentX — новое горизонтальное выравнивание
См. также:
  • getAlignmentX()

setInputVerifier

@BeanProperty(description="The component's input verifier.") public void setInputVerifier(InputVerifier inputVerifier)
Задает средство проверки ввода для этого компонента.
Параметры:
inputVerifier — новое средство проверки ввода
Начиная с версии:
1.3
См. также:
  • InputVerifier

getInputVerifier

public InputVerifier getInputVerifier()
Возвращает средство проверки ввода для этого компонента.
Возвращает:
свойство inputVerifier
Начиная с версии:
1.3
См. также:
  • InputVerifier

getGraphics

@BeanProperty(bound=false) public Graphics getGraphics()
Возвращает графический контекст этого компонента, позволяющий рисовать на компоненте. Используйте этот метод, чтобы получить объект Graphics, а затем вызывать его методы для рисования на компоненте.
Переопределяет:
getGraphics в классе Component
Возвращает:
графический контекст этого компонента
См. также:
  • Component.paint(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)
Включает или отключает диагностическую информацию о каждой графической операции, выполняемой в компоненте или одном из его дочерних компонентов.
Параметры:
debugOptions — определяет способ отображения информации компонентом; одно из следующих значений:
  • DebugGraphics.LOG_OPTION — выводит текстовое сообщение.
  • DebugGraphics.FLASH_OPTION — заставляет изображение несколько раз мигнуть.
  • DebugGraphics.BUFFERED_OPTION — создает ExternalWindow, отображающий операции, выполненные с внеэкранным буфером View.
  • DebugGraphics.NONE_OPTION отключает отладку.
  • Значение 0 не изменяет параметры отладки.
debugOptions объединяется с текущим значением побитовой операцией ИЛИ

getDebugGraphicsOptions

public int getDebugGraphicsOptions()
Возвращает состояние отладки графики.
Возвращает:
флаг, полученный побитовым объединением нуля или более следующих значений:
  • DebugGraphics.LOG_OPTION — выводит текстовое сообщение.
  • DebugGraphics.FLASH_OPTION — заставляет изображение несколько раз мигнуть.
  • DebugGraphics.BUFFERED_OPTION — создает ExternalWindow, отображающий операции, выполненные с внеэкранным буфером View.
  • DebugGraphics.NONE_OPTION отключает отладку.
  • Значение 0 не изменяет параметры отладки.
См. также:
  • 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 заменит это действие.

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

registerKeyboardAction

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

unregisterKeyboardAction

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

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

Параметры:
aKeyStroke — комбинация клавиш, для которой отменяется действие клавиатуры

getRegisteredKeyStrokes

@BeanProperty(bound=false) public KeyStroke[] getRegisteredKeyStrokes()
Возвращает KeyStrokes, которые запускают зарегистрированные действия.
Возвращает:
массив объектов KeyStroke
См. также:
  • registerKeyboardAction(ActionListener, String, KeyStroke, int)

getConditionForKeyStroke

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

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

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

getActionForKeyStroke

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

resetKeyboardActions

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

setInputMap

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

getInputMap

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

getInputMap

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

setActionMap

public final void setActionMap(ActionMap am)
Задаёт ActionMap равным am. Этот метод не устанавливает родителем am объект ActionMap из пользовательского интерфейса (если он был); это должен сделать вызывающий код.
Параметры:
am — новая ActionMap
Начиная с:
1.3

getActionMap

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

getBaseline

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

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

Переопределяет:
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.

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

requestDefaultFocus

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

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

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

setVisible

@BeanProperty(hidden=true, visualUpdate=true) public void setVisible(boolean aFlag)
Делает компонент видимым или невидимым. Переопределяет Component.setVisible.
Переопределяет:
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)
Задаёт, включён ли этот компонент. Включённый компонент может реагировать на ввод пользователя, а выключенный — не может. Некоторые компоненты могут изменять свой внешний вид при отключении, чтобы показать пользователю, что они не могут принимать ввод.

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

Примечание. Отключение облегчённого компонента не мешает ему получать события мыши.

Переопределяет:
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)
Задаёт цвет переднего плана этого компонента. Поддержка этого свойства зависит от реализации оформления и стиля; некоторые реализации могут его игнорировать.
Переопределяет:
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, чтобы учитывать это свойство.

Поддержка этого свойства зависит от реализации оформления и стиля; некоторые реализации могут его игнорировать.

Переопределяет:
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)
Задаёт шрифт этого компонента.
Переопределяет:
setFont в классе Container
Параметры:
font — желаемый Font для этого компонента
См. также:
  • Component.getFont()

getDefaultLocale

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

setDefaultLocale

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

processComponentKeyEvent

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

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

Параметры:
e — событие, которое нужно обработать

processKeyEvent

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

processKeyBinding

protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e. Метод получает соответствующий InputMap, находит привязку, получает действие из ActionMap и затем (если действие найдено, а компонент включён) вызывает notifyAction для уведомления действия.
Параметры:
ks — запрашиваемый KeyStroke
e — KeyEvent
condition — одно из следующих значений:
  • JComponent.WHEN_FOCUSED
  • JComponent.WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
  • JComponent.WHEN_IN_FOCUSED_WINDOW
pressed — true, если клавиша нажата
Возвращает:
true, если для действия существовала привязка и действие было включено
Начиная с:
1.3

setToolTipText

@BeanProperty(bound=false, preferred=true, description="The text to display in a tool tip.") public void setToolTipText(String text)
Задаёт текст всплывающей подсказки. Текст отображается, когда указатель задерживается над компонентом.

Дополнительные сведения см. в разделе Как использовать всплывающие подсказки руководства The Java Tutorial.

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

getToolTipText

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

getToolTipText

public String getToolTipText(MouseEvent event)
Возвращает строку, используемую в качестве подсказки для события. По умолчанию возвращается строка, заданная с помощью setToolTipText. Если компонент предоставляет более развитый API для поддержки различных подсказок в разных местах, этот метод следует переопределить.
Параметры:
event — MouseEvent, инициировавшее отображение ToolTip
Возвращает:
строку с текстом подсказки

getToolTipLocation

public Point getToolTipLocation(MouseEvent event)
Возвращает координаты всплывающей подсказки в системе координат этого компонента. Если возвращается null, Swing выберет положение самостоятельно. Реализация по умолчанию возвращает null.
Параметры:
event — MouseEvent, вызвавшее отображение подсказки с помощью ToolTipManager
Возвращает:
всегда возвращает null

getPopupLocation

public Point getPopupLocation(MouseEvent event)
Возвращает предпочтительное положение всплывающего меню в системе координат этого компонента. Поддержка этого свойства зависит от реализации оформления и стиля; некоторые реализации могут его игнорировать. Если значение равно null, реализация оформления и стиля выберет подходящее положение.
Параметры:
event — MouseEvent, вызвавшее отображение всплывающего меню, или null, если меню отображается не в результате события мыши
Возвращает:
положение для отображения JPopupMenu или null
Начиная с:
1.5

createToolTip

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

scrollRectToVisible

public void scrollRectToVisible(Rectangle aRect)
Перенаправляет запрос scrollRectToVisible() родительскому компоненту JComponent. Компоненты, способные обработать этот запрос, например JViewport, переопределяют этот метод и выполняют прокрутку.
Параметры:
aRect — видимый Rectangle
См. также:
  • JViewport

setAutoscrolls

@BeanProperty(bound=false, expert=true, description="Determines if this component automatically scrolls its contents when dragged.") public void setAutoscrolls(boolean autoscrolls)
Задаёт свойство autoscrolls. Если true, при перетаскивании мыши за пределы компонента будут синтетически генерироваться события перетаскивания мыши, когда движение мыши приостановлено (пока кнопка остаётся нажатой). Синтетические события создают впечатление, что жест перетаскивания возобновился в направлении, заданном при пересечении границы компонента. Компоненты с поддержкой автоматической прокрутки должны обрабатывать события mouseDragged, вызывая scrollRectToVisible с прямоугольником, содержащим координаты события мыши. Все компоненты Swing, поддерживающие выбор элементов и обычно отображаемые в JScrollPane (JTable, JList, JTree, JTextArea и JEditorPane), уже обрабатывают события перетаскивания мыши таким образом. Чтобы включить автоматическую прокрутку для любого другого компонента, добавьте слушатель движения мыши, вызывающий scrollRectToVisible. Например, для JPanel — myPanel:
MouseMotionListener doScrollRectToVisible = new MouseMotionAdapter() {
    public void mouseDragged(MouseEvent e) {
       Rectangle r = new Rectangle(e.getX(), e.getY(), 1, 1);
       ((JPanel)e.getSource()).scrollRectToVisible(r);
   }
};
myPanel.addMouseMotionListener(doScrollRectToVisible);
Значение свойства autoScrolls по умолчанию — false.
Параметры:
autoscrolls — если true, при перетаскивании мыши за пределы компонента генерируются синтетические события перетаскивания мыши, пока кнопка мыши остаётся нажатой; в противном случае false
См. также:
  • getAutoscrolls()
  • JViewport
  • JScrollPane

getAutoscrolls

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

setTransferHandler

@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.

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

Параметры:
newHandler — новый TransferHandler
Начиная с:
1.4
См. также:
  • TransferHandler
  • getTransferHandler()

getTransferHandler

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

processMouseEvent

protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, возникающие в этом компоненте, передавая их всем зарегистрированным объектам MouseListener. Полное описание этого метода см. в Component.processMouseEvent(MouseEvent).
Переопределяет:
processMouseEvent в классе Component
Параметры:
e — событие мыши
Начиная с:
1.5
См. также:
  • Component.processMouseEvent(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(Object, 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(Object)
  • Container.addPropertyChangeListener(PropertyChangeListener)

setFocusTraversalKeys

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

Этот метод может вызвать исключение 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, если какое-либо нажатие клавиши представляет событие KEY_TYPED или если какое-либо нажатие клавиши уже сопоставлено с другой операцией перехода фокуса для этого компонента
Начиная с:
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, поскольку не приводит к выделению памяти в куче.
Переопределяет:
getY в классе Component
Возвращает:
текущую координату y начала компонента

getWidth

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

getHeight

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

isOpaque

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

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

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

Переопределяет:
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 всем зарегистрированным PropertyChangeListener.
Переопределяет:
firePropertyChange в классе Component
Параметры:
propertyName — свойство, значение которого изменилось
oldValue — предыдущее значение свойства
newValue — новое значение свойства

firePropertyChange

public void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка уведомления об изменениях связанных свойств типа integer. Этот метод можно вызвать при изменении связанного свойства; он отправит соответствующее событие PropertyChangeEvent всем зарегистрированным PropertyChangeListener.
Переопределяет:
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()
Возвращает массив всех слушателей отменяемых изменений, зарегистрированных для этого компонента.
Возвращает:
все VetoableChangeListener компонента или пустой массив, если слушатели отменяемых изменений в данный момент не зарегистрированы
Начиная с:
1.4
См. также:
  • addVetoableChangeListener(VetoableChangeListener)
  • removeVetoableChangeListener(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(AncestorListener)

getAncestorListeners

@BeanProperty(bound=false) public AncestorListener[] getAncestorListeners()
Возвращает массив всех слушателей предков, зарегистрированных для этого компонента.
Возвращает:
все AncestorListener компонента или пустой массив, если слушатели предков в данный момент не зарегистрированы
Начиная с:
1.4
См. также:
  • addAncestorListener(AncestorListener)
  • removeAncestorListener(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));
Если таких слушателей нет, метод возвращает пустой массив.
Переопределяет:
getListeners в классе Container
Параметры типа:
T — тип слушателей
Параметры:
listenerType — тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, являющийся потомком java.util.EventListener
Возвращает:
массив всех объектов, зарегистрированных как FooListener для этого компонента, или пустой массив, если такие слушатели не добавлены
Вызывает:
ClassCastException — если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener
Начиная с:
1.3
См. также:
  • getVetoableChangeListeners()
  • getAncestorListeners()

addNotify

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

removeNotify

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

repaint

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

repaint

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

revalidate

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

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

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

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

isValidateRoot

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

isOptimizedDrawingEnabled

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

isPaintingOrigin

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

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

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

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

paintImmediately

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

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

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

Параметры:
x — координата x области для рисования
y — координата y области для рисования
w — ширина области для рисования
h — высота области для рисования
См. также:
  • repaint(long, int, int, int, int)
  • isPaintingOrigin()

paintImmediately

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

setDoubleBuffered

public void setDoubleBuffered(boolean aFlag)
Задаёт, должен ли этот компонент использовать буфер для отрисовки. Если задано значение true, вся отрисовка этого компонента будет выполняться во внеэкранном буфере. Затем содержимое внеэкранного буфера будет скопировано на экран. Если Component буферизуется и один из его предков также буферизуется, будет использоваться буфер предка.
Параметры:
aFlag — если значение true, компонент будет использовать двойную буферизацию

isDoubleBuffered

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

getRootPane

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

paramString

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

hide

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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, которая содержит более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

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

Spec-Zone.ru

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