Класс 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
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
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
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 |
Регистрирует listener, чтобы он получал AncestorEvents при перемещении или изменении видимости этого компонента либо любого из его предков. |
void |
addNotify() |
Уведомляет этот компонент о том, что у него теперь есть родительский компонент. |
void |
addVetoableChangeListener |
Добавляет VetoableChangeListener в список прослушивателей. |
void |
computeVisibleRect |
Возвращает «видимый прямоугольник» Component — пересечение видимых прямоугольников этого компонента и всех его предков. |
boolean |
contains |
Предоставляет делегату пользовательского интерфейса возможность определить точную форму этого компонента для обработки мыши. |
JToolTip |
createToolTip() |
Возвращает экземпляр JToolTip, который следует использовать для отображения всплывающей подсказки. |
void |
disable() |
Устарело. |
void |
enable() |
Устарело. Начиная с JDK версии 1.1 заменено на java.awt.Component.setEnabled(boolean). |
void |
firePropertyChange |
Поддержка уведомления об изменениях привязанных свойств логического типа. |
void |
firePropertyChange |
Поддержка уведомления об изменениях привязанных свойств целочисленного типа. |
protected void |
fireVetoableChange |
Поддерживает уведомление об изменениях ограниченных свойств. |
ActionListener |
getActionForKeyStroke |
Возвращает объект, который выполнит действие, зарегистрированное для заданного сочетания клавиш. |
final ActionMap |
getActionMap() |
Возвращает ActionMap, используемый для определения того, какое Action следует вызвать для данной привязки KeyStroke. |
float |
getAlignmentX() |
Переопределяет Container.getAlignmentX, чтобы вернуть горизонтальное выравнивание. |
float |
getAlignmentY() |
Переопределяет Container.getAlignmentY, чтобы вернуть вертикальное выравнивание. |
AncestorListener[] |
getAncestorListeners() |
Возвращает массив всех прослушивателей предков, зарегистрированных для этого компонента. |
boolean |
getAutoscrolls() |
Возвращает свойство autoscrolls. |
int |
getBaseline |
Возвращает базовую линию. |
Component.BaselineResizeBehavior |
getBaselineResizeBehavior() |
Возвращает перечисление, указывающее, как изменяется базовая линия компонента при изменении его размера. |
Border |
getBorder() |
Возвращает границу этого компонента или null, если граница не задана. |
Rectangle |
getBounds |
Сохраняет границы этого компонента в «возвращаемом значении» rv и возвращает rv. |
final Object |
getClientProperty |
Возвращает значение свойства с указанным ключом. |
protected Graphics |
getComponentGraphics |
Возвращает графический объект, используемый для отрисовки этого компонента. |
JPopupMenu |
getComponentPopupMenu() |
Возвращает JPopupMenu, назначенный этому компоненту. |
int |
getConditionForKeyStroke |
Возвращает условие, определяющее, выполняется ли зарегистрированное действие в ответ на указанное сочетание клавиш. |
int |
getDebugGraphicsOptions() |
Возвращает состояние отладки графики. |
static Locale |
getDefaultLocale() |
Возвращает локаль по умолчанию, используемую для инициализации свойства локали каждого JComponent при создании. |
FontMetrics |
getFontMetrics |
Возвращает FontMetrics для указанного Font. |
Graphics |
getGraphics() |
Возвращает графический контекст этого компонента, позволяющий выполнять рисование на компоненте. |
int |
getHeight() |
Возвращает текущую высоту этого компонента. |
boolean |
getInheritsPopupMenu() |
Возвращает true, если JPopupMenu должен наследоваться от родителя. |
final InputMap |
getInputMap() |
Возвращает InputMap, используемый, когда компонент находится в фокусе. |
final InputMap |
getInputMap |
Возвращает InputMap, используемый во время condition. |
InputVerifier |
getInputVerifier() |
Возвращает проверяющий ввод для этого компонента. |
Insets |
getInsets() |
Если для этого компонента задана граница, возвращает ее внутренние отступы; в противном случае вызывает super.getInsets. |
Insets |
getInsets |
Возвращает объект Insets, содержащий значения внутренних отступов этого компонента. |
<T extends EventListener> |
getListeners |
Возвращает массив всех объектов, зарегистрированных в данный момент в качестве FooListener для этого JComponent. |
Point |
getLocation |
Сохраняет координаты x,y начала этого компонента в «возвращаемом значении» rv и возвращает rv. |
Dimension |
getMaximumSize() |
Если максимальный размер задан ненулевым значением null, просто возвращает его. |
Dimension |
getMinimumSize() |
Если минимальный размер задан ненулевым значением null, просто возвращает его. |
Component |
getNextFocusableComponent() |
Устарело. Начиная с версии 1.4 заменено на FocusTraversalPolicy. |
Point |
getPopupLocation |
Возвращает предпочтительное место отображения всплывающего меню в системе координат этого компонента. |
Dimension |
getPreferredSize() |
Если preferredSize задано ненулевым значением null, просто возвращает его. |
KeyStroke[] |
getRegisteredKeyStrokes() |
Возвращает KeyStrokes, который инициирует зарегистрированные действия. |
JRootPane |
getRootPane() |
Возвращает предка JRootPane для этого компонента. |
Dimension |
getSize |
Сохраняет ширину и высоту этого компонента в «возвращаемом значении» rv и возвращает rv. |
Point |
getToolTipLocation |
Возвращает координаты всплывающей подсказки в системе координат этого компонента. |
String |
getToolTipText() |
Возвращает строку всплывающей подсказки, заданную с помощью setToolTipText. |
String |
getToolTipText |
Возвращает строку, используемую в качестве всплывающей подсказки для события. |
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 |
Возвращает 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 |
Вызывается Swing для отрисовки компонентов. |
protected void |
paintBorder |
Отрисовывает границу компонента. |
protected void |
paintChildren |
Отрисовывает дочерние компоненты этого компонента. |
protected void |
paintComponent |
Вызывает метод отрисовки делегата пользовательского интерфейса, если делегат не равен null. |
void |
paintImmediately |
Немедленно отрисовывает указанную область этого компонента и всех его потомков, перекрывающих эту область. |
void |
paintImmediately |
Немедленно отрисовывает указанную область. |
protected String |
paramString() |
Возвращает строковое представление этого JComponent. |
void |
print |
Вызовите этот метод, чтобы вывести компонент на указанный Graphics. |
void |
printAll |
Вызовите этот метод, чтобы вывести компонент на печать. |
protected void |
printBorder |
Печатает границу компонента. |
protected void |
printChildren |
Печатает дочерние компоненты этого компонента. |
protected void |
printComponent |
Вызывается во время операции печати. |
protected void |
processComponentKeyEvent |
Обрабатывает события клавиатуры, распознаваемые самим компонентом. |
protected boolean |
processKeyBinding |
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e. |
protected void |
processKeyEvent |
Переопределяет processKeyEvent для обработки событий. |
protected void |
processMouseEvent |
Обрабатывает события мыши, происходящие на этом компоненте, передавая их зарегистрированным объектам MouseListener; полное описание этого метода см. в разделе Component.processMouseEvent(MouseEvent). |
protected void |
processMouseMotionEvent |
Обрабатывает события движения мыши, например MouseEvent.MOUSE_DRAGGED. |
final void |
putClientProperty |
Добавляет этому компоненту произвольное свойство клиента «ключ/значение». |
void |
registerKeyboardAction |
Этот метод устарел; для аналогичного поведения используйте сочетание getActionMap() и getInputMap(). |
void |
registerKeyboardAction |
Этот метод устарел; для аналогичного поведения используйте сочетание getActionMap() и getInputMap(). |
void |
removeAncestorListener |
Отменяет регистрацию listener, чтобы он больше не получал AncestorEvents. |
void |
removeNotify() |
Уведомляет этот компонент о том, что у него больше нет родительского компонента. |
void |
removeVetoableChangeListener |
Удаляет VetoableChangeListener из списка прослушивателей. |
void |
repaint |
Добавляет указанную область в список областей, требующих перерисовки, если компонент отображается. |
void |
repaint |
Добавляет указанную область в список областей, требующих перерисовки, если компонент отображается. |
boolean |
requestDefaultFocus() |
Устарело. Начиная с версии 1.4 заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
|
void |
requestFocus() |
Запрашивает, чтобы этот Component получил фокус ввода. |
boolean |
requestFocus |
Запрашивает, чтобы этот Component получил фокус ввода. |
boolean |
requestFocusInWindow() |
Запрашивает, чтобы этот Component получил фокус ввода. |
protected boolean |
requestFocusInWindow |
Запрашивает, чтобы этот Component получил фокус ввода. |
void |
resetKeyboardActions() |
Отменяет все привязки на первом уровне InputMaps и ActionMap. |
void |
reshape |
Устарело. Начиная с JDK 5 заменено на Component.setBounds(int, int, int, int). |
void |
revalidate() |
Поддерживает отложенное автоматическое размещение. |
void |
scrollRectToVisible |
Пересылает сообщение scrollRectToVisible() родительскому компоненту JComponent. |
final void |
setActionMap |
Задает ActionMap равным am. |
void |
setAlignmentX |
Задает горизонтальное выравнивание. |
void |
setAlignmentY |
Задает вертикальное выравнивание. |
void |
setAutoscrolls |
Задает свойство autoscrolls. |
void |
setBackground |
Задает цвет фона этого компонента. |
void |
setBorder |
Задает границу этого компонента. |
void |
setComponentPopupMenu |
Задает JPopupMenu для этого JComponent. |
void |
setDebugGraphicsOptions |
Включает или отключает диагностическую информацию о каждой графической операции, выполняемой в компоненте или одном из его дочерних компонентов. |
static void |
setDefaultLocale |
Задает локаль по умолчанию, используемую для инициализации свойства локали каждого JComponent при создании. |
void |
setDoubleBuffered |
Задает, должен ли этот компонент использовать буфер для отрисовки. |
void |
setEnabled |
Включает или отключает этот компонент. |
void |
setFocusTraversalKeys |
Задает клавиши перехода фокуса для указанной операции перехода этого компонента. |
void |
setFont |
Задает шрифт этого компонента. |
void |
setForeground |
Задает цвет переднего плана этого компонента. |
void |
setInheritsPopupMenu |
Задает, должен ли getComponentPopupMenu делегировать вызов родительскому компоненту, если этому компоненту не назначен JPopupMenu. |
final void |
setInputMap |
Задает InputMap для использования при условии condition для map. |
void |
setInputVerifier |
Задает проверяющий ввод для этого компонента. |
void |
setMaximumSize |
Задает максимальный размер этого компонента как постоянное значение. |
void |
setMinimumSize |
Задает минимальный размер этого компонента как постоянное значение. |
void |
setNextFocusableComponent |
Устарело. Начиная с версии 1.4 заменено на FocusTraversalPolicy
|
void |
setOpaque |
Если задано значение true, компонент отрисовывает каждый пиксель в пределах своих границ. |
void |
setPreferredSize |
Задает предпочтительный размер этого компонента. |
void |
setRequestFocusEnabled |
Предоставляет подсказку о том, должен ли этот JComponent получать фокус. |
void |
setToolTipText |
Регистрирует текст для отображения во всплывающей подсказке. |
void |
setTransferHandler |
Задает TransferHandler, обеспечивающий поддержку передачи данных в этот компонент и из него с помощью вырезания, копирования, вставки, а также перетаскивания. |
protected void |
setUI |
Задает делегат внешнего вида для этого компонента. |
void |
setVerifyInputWhenFocusTarget |
Задает значение, указывающее, будет ли вызван проверяющий ввод текущего владельца фокуса до того, как этот компонент запросит фокус. |
void |
setVisible |
Делает компонент видимым или невидимым. |
void |
unregisterKeyboardAction |
Этот метод устарел. |
void |
update |
Вызывает 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
Подробное описание полей
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
- См. также:
TOOL_TIP_TEXT_KEY
public static final String TOOL_TIP_TEXT_KEY
- См. также:
Подробное описание конструкторов
JComponent
public JComponent()
JComponent по умолчанию. Этот конструктор выполняет лишь минимальную инициализацию, помимо вызова конструктора Container. Например, начальный менеджер компоновки равен null. Однако он устанавливает свойство локали компонента в значение, возвращаемое методом JComponent.getDefaultLocale.- См. также:
Подробное описание методов
setInheritsPopupMenu
@BeanProperty(description="Whether or not the JPopupMenu is inherited") public void setInheritsPopupMenu(boolean value)
getComponentPopupMenu передавать запрос родительскому компоненту, если этому компоненту не назначен JPopupMenu. Значение по умолчанию — false, однако некоторые подклассы JComponent, реализованные как набор JComponent, могут установить это свойство в true.
Это связанное свойство.
- Параметры:
-
value— наследуется ли JPopupMenu - Начиная с:
- 1.5
- См. также:
getInheritsPopupMenu
public boolean getInheritsPopupMenu()
- Возвращает:
- true, если JPopupMenu должен наследоваться от родительского компонента
- Начиная с:
- 1.5
- См. также:
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
public JPopupMenu getComponentPopupMenu()
JPopupMenu, назначенное этому компоненту. Если компоненту не назначено JPopupMenu, а getInheritsPopupMenu равно true, этот метод вернет getParent().getComponentPopupMenu() (если родительский компонент действителен).- Возвращает:
-
JPopupMenu, назначенное этому компоненту, илиnull, если всплывающее меню не назначено - Начиная с:
- 1.5
- См. также:
updateUI
public void updateUI()
JComponent должны переопределять этот метод следующим образом:
public void updateUI() {
setUI((SliderUI)UIManager.getUI(this);
}
- Требования к реализации:
- Реализация этого метода по умолчанию ничего не делает.
- См. также:
getUI
public ComponentUI getUI()
- Возвращает:
- объект
ComponentUI, который отображает этот компонент - Начиная с:
- 9
setUI
@BeanProperty(hidden=true, visualUpdate=true, description="The component's look and feel delegate.") protected void setUI(ComponentUI newUI)
JComponent обычно переопределяют этот метод, чтобы сузить тип аргумента. Например, в JSlider:
public void setUI(SliderUI newUI) {
super.setUI(newUI);
}
Кроме того, подклассы JComponent должны предоставлять метод getUI, возвращающий правильный тип. Например:
public SliderUI getUI() {
return (SliderUI)ui;
}
- Параметры:
-
newUI— новый делегат пользовательского интерфейса - См. также:
getUIClassID
@BeanProperty(bound=false, expert=true, description="UIClassID") public String getUIClassID()
UIDefaults, используемый для поиска имени класса swing.plaf.ComponentUI, определяющего внешний вид этого компонента. Большинству приложений никогда не потребуется вызывать этот метод. Подклассы JComponent, поддерживающие подключаемый внешний вид, должны переопределить этот метод, чтобы возвращать ключ UIDefaults, связанный с подклассом ComponentUI, определяющим их внешний вид.- Возвращает:
- ключ
UIDefaultsдля подклассаComponentUI - См. также:
getComponentGraphics
protected Graphics getComponentGraphics(Graphics g)
DebugGraphics, при необходимости создается новый объект DebugGraphics. В противном случае просто настраиваются цвет переднего плана и шрифт указанного графического контекста.- Параметры:
-
g— исходный объектGraphics - Возвращает:
- объект
Graphics, настроенный для этого компонента
paintComponent
protected void paintComponent(Graphics g)
null. Делегату передается копия объекта Graphics, чтобы защитить остальной код отрисовки от необратимых изменений (например, Graphics.translate). При переопределении этого метода в подклассе не следует вносить постоянные изменения в переданный объект Graphics. Например, не следует изменять Rectangle области отсечения или преобразование. Если необходимо выполнить такие операции, может быть удобнее создать новый объект Graphics на основе переданного Graphics и изменять его. Кроме того, если вы не вызываете реализацию суперкласса, необходимо учитывать свойство непрозрачности: если этот компонент непрозрачен, его фон нужно полностью залить непрозрачным цветом. Если не учитывать свойство непрозрачности, вероятно появление визуальных артефактов.
Переданный объект Graphics может иметь установленное преобразование, отличное от тождественного. В этом случае последовательное применение другого преобразования может привести к неожиданным результатам.
- Параметры:
-
g— защищаемый объектGraphics - См. также:
paintChildren
protected void paintChildren(Graphics g)
shouldUseBuffer равно true, ни у одного предка компонента нет буфера, и дочерние компоненты могут использовать собственные буферы, если они у них есть. В противном случае один из предков в данный момент использует буфер, поэтому дочерним компонентам не следует использовать буфер для отрисовки.- Параметры:
-
g— контекстGraphics, в котором выполняется отрисовка - См. также:
paintBorder
protected void paintBorder(Graphics g)
При переопределении этого метода в подклассе не следует вносить постоянные изменения в переданный объект Graphics. Например, не следует изменять Rectangle области отсечения или преобразование. Если необходимо выполнить такие операции, может быть удобнее создать новый объект Graphics на основе переданного Graphics и изменять его.
- Параметры:
-
g— контекстGraphics, в котором выполняется отрисовка - См. также:
update
paint
public void paint(Graphics g)
paint напрямую; вместо этого следует использовать метод repaint, чтобы запланировать перерисовку компонента. Этот метод передает задачу отрисовки трем защищенным методам: paintComponent, paintBorder и paintChildren. Они вызываются в указанном порядке, чтобы дочерние компоненты отображались поверх самого компонента. Как правило, компонент и его дочерние компоненты не должны отрисовывать содержимое в области отступов, выделенной для границы. Как обычно, подклассы могут просто переопределить этот метод. Подклассу, которому нужно лишь настроить метод paint делегата пользовательского интерфейса (внешнего вида), следует переопределить только paintComponent.
printAll
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.
printComponent
protected void printComponent(Graphics g)
paintComponent для компонента. Переопределите этот метод, если хотите добавить особое поведение при отрисовке во время печати.- Параметры:
-
g— контекстGraphics, в котором выполняется отрисовка - Начиная с:
- 1.3
- См. также:
printChildren
protected void printChildren(Graphics g)
paintChildren для компонента. Переопределите этот метод, если хотите печатать дочерние компоненты иначе, чем они отрисовываются.- Параметры:
-
g— контекстGraphics, в котором выполняется отрисовка - Начиная с:
- 1.3
- См. также:
printBorder
protected void printBorder(Graphics g)
paintBorder для компонента. Переопределите этот метод, если хотите печатать границу иначе, чем она отрисовывается.- Параметры:
-
g— контекстGraphics, в котором выполняется отрисовка - Начиная с:
- 1.3
- См. также:
isPaintingTile
@BeanProperty(bound=false) public boolean isPaintingTile()
- Возвращает:
- true, если в данный момент компонент отрисовывает фрагмент; в противном случае false
isPaintingForPrint
@BeanProperty(bound=false) public final boolean isPaintingForPrint()
true, если текущая операция отрисовки этого компонента является частью операции print. Этот метод полезен, когда нужно настроить то, что выводится на печать, в отличие от отображаемого на экране. Изменения значения этого свойства можно отслеживать, прослушивая события изменения свойств этого компонента с именем "paintingForPrint".
Примечание. Этот метод предоставляет дополнительную функциональность к функциональности других высокоуровневых API Swing для печати. Однако он касается исключительно отрисовки, и его не следует считать источником информации о более высокоуровневых процессах печати. Например, операция JTable.print() не обязательно приводит к непрерывной отрисовке всего компонента, и возвращаемое значение этого метода может измениться несколько раз во время операции. Компонент даже может отрисовываться на экране одновременно с выполнением печати. В таком случае метод возвращает true только тогда, когда таблица отрисовывается в рамках процесса печати.
- Возвращает:
- true, если текущая операция отрисовки этого компонента является частью операции печати
- Начиная с:
- 1.6
- См. также:
isManagingFocus
@Deprecated @BeanProperty(bound=false) public boolean isManagingFocus()
Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean). Изменяет клавиши перехода фокуса этого JComponent на CTRL+TAB и CTRL+SHIFT+TAB. Кроме того, SortingFocusTraversalPolicy не учитывает потомков этого JComponent при вычислении цикла перехода фокуса.
- Возвращает:
- false
- См. также:
setNextFocusableComponent
@Deprecated public void setNextFocusableComponent(Component aComponent)
FocusTraversalPolicy
Переопределяет порядок FocusTraversalPolicy по умолчанию в цикле перехода фокуса этого JComponent, безусловно задавая указанный Component в качестве следующего Component в цикле, а этот JComponent — в качестве предыдущего Component для указанного Component в цикле.
- Параметры:
-
aComponent—Component, который должен следовать за этимJComponentв цикле перехода фокуса - См. также:
getNextFocusableComponent
@Deprecated public Component getNextFocusableComponent()
FocusTraversalPolicy. Возвращает Component, заданный предыдущим вызовом setNextFocusableComponent(Component) для этого JComponent.
- Возвращает:
Component, который будет следовать за этимJComponentв цикле перехода фокуса, илиnull, если он не был задан явно- См. также:
setRequestFocusEnabled
public void setRequestFocusEnabled(boolean requestFocusEnabled)
JComponent получать фокус. Это лишь подсказка; потребители, запрашивающие фокус, сами решают, учитывать ли это свойство. Обычно оно учитывается при работе с мышью, но не с клавиатурой. Например, реализации внешнего вида могут проверять, равно ли это свойство true, прежде чем запрашивать фокус при работе с мышью. Это часто используется, если щелчок мышью по JComponent не должен переводить фокус на него, но при этом JComponent должен оставаться доступным при переходе с помощью клавиатуры. Если этот JComponent вообще не должен получать фокус, используйте вместо этого метод setFocusable. Дополнительную информацию см. в разделе Использование подсистемы фокуса руководства The Java Tutorial.
- Параметры:
-
requestFocusEnabled— указывает, должен ли этотJComponentполучать фокус - См. также:
isRequestFocusEnabled
public boolean isRequestFocusEnabled()
true, если этот JComponent должен получать фокус; в противном случае возвращает false. Дополнительную информацию см. в разделе Использование подсистемы фокуса руководства The Java Tutorial.
- Возвращает:
-
true, если этот компонент должен получать фокус; в противном случае возвращаетfalse - См. также:
requestFocus
public void requestFocus()
Component получил фокус ввода. Полное описание этого метода см. в Component.requestFocus(). Обратите внимание, что использовать этот метод не рекомендуется, поскольку его поведение зависит от платформы. Вместо него рекомендуется использовать requestFocusInWindow(). Дополнительные сведения о фокусе см. в разделе Как использовать подсистему фокуса учебника Учебник Java.
- Переопределяет:
-
requestFocusв классеComponent - Начиная с версии:
- 1.4
- См. также:
requestFocus
public boolean requestFocus(boolean temporary)
Component получил фокус ввода. Полное описание этого метода см. в Component.requestFocus(boolean). Обратите внимание, что использовать этот метод не рекомендуется, поскольку его поведение зависит от платформы. Вместо него рекомендуется использовать requestFocusInWindow(boolean). Дополнительные сведения о фокусе см. в разделе Как использовать подсистему фокуса учебника Учебник Java.
- Переопределяет:
-
requestFocusв классеComponent - Параметры:
-
temporary— логическое значение, указывающее, является ли изменение фокуса временным - Возвращает:
-
false, если запрос на изменение фокуса гарантированно завершится неудачей;true, если он, вероятно, будет успешным - Начиная с версии:
- 1.4
- См. также:
requestFocusInWindow
public boolean requestFocusInWindow()
Component получил фокус ввода. Полное описание этого метода см. в Component.requestFocusInWindow(). Дополнительные сведения о фокусе см. в разделе Как использовать подсистему фокуса учебника Учебник Java.
- Переопределяет:
-
requestFocusInWindowв классеComponent - Возвращает:
-
false, если запрос на изменение фокуса гарантированно завершится неудачей;true, если он, вероятно, будет успешным - Начиная с версии:
- 1.4
- См. также:
requestFocusInWindow
protected boolean requestFocusInWindow(boolean temporary)
Component получил фокус ввода. Полное описание этого метода см. в Component.requestFocusInWindow(boolean). Дополнительные сведения о фокусе см. в разделе Как использовать подсистему фокуса учебника Учебник Java.
- Переопределяет:
-
requestFocusInWindowв классеComponent - Параметры:
-
temporary— логическое значение, указывающее, является ли изменение фокуса временным - Возвращает:
-
false, если запрос на изменение фокуса гарантированно завершится неудачей;true, если он, вероятно, будет успешным - Начиная с версии:
- 1.4
- См. также:
grabFocus
public void grabFocus()
Этот метод предназначен для использования реализациями механизмов управления фокусом. Клиентскому коду не следует использовать этот метод; вместо этого следует использовать requestFocusInWindow().
- См. также:
setVerifyInputWhenFocusTarget
@BeanProperty(description="Whether the Component verifies input before accepting focus.") public void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
- Параметры:
-
verifyInputWhenFocusTarget— значение свойстваverifyInputWhenFocusTarget - Начиная с версии:
- 1.3
- См. также:
getVerifyInputWhenFocusTarget
public boolean getVerifyInputWhenFocusTarget()
- Возвращает:
- значение свойства
verifyInputWhenFocusTarget - Начиная с версии:
- 1.3
- См. также:
getFontMetrics
public FontMetrics getFontMetrics(Font font)
FontMetrics для указанного Font.- Переопределяет:
-
getFontMetricsв классеComponent - Параметры:
-
font— шрифт, для которого нужно получить метрики - Возвращает:
- метрики шрифта для
font - Выбрасывает:
-
NullPointerException— еслиfontимеет значение null - Начиная с версии:
- 1.5
- См. также:
setPreferredSize
@BeanProperty(preferred=true, description="The preferred size of the component.") public void setPreferredSize(Dimension preferredSize)
preferredSize имеет значение null, запрашивается предпочтительный размер у пользовательского интерфейса.- Переопределяет:
-
setPreferredSizeв классеComponent - Параметры:
-
preferredSize— новый предпочтительный размер или null - См. также:
getPreferredSize
public Dimension getPreferredSize()
preferredSize задано значение, отличное от null, оно просто возвращается. Если метод getPreferredSize делегата пользовательского интерфейса возвращает значение, отличное от null, возвращается оно; в противном случае используется менеджер компоновки компонента.- Переопределяет:
-
getPreferredSizeв классеContainer - Возвращает:
- значение свойства
preferredSize - См. также:
setMaximumSize
@BeanProperty(description="The maximum size of the component.") public void setMaximumSize(Dimension maximumSize)
getMaximumSize всегда будет возвращаться это значение; пользовательский интерфейс компонента не будет вычислять его. Установка максимального размера в null восстанавливает поведение по умолчанию. Подклассы могут переопределить это поведение, возвращая собственный максимальный размер в методе getMaximumSize.
- Переопределяет:
-
setMaximumSizeв классеComponent - Параметры:
-
maximumSize—Dimension, содержащий желаемый максимально допустимый размер - См. также:
getMaximumSize
public Dimension getMaximumSize()
null, оно просто возвращается. Если метод getMaximumSize делегата пользовательского интерфейса возвращает значение, отличное от null, возвращается оно; в противном случае используется менеджер компоновки компонента.- Переопределяет:
-
getMaximumSizeв классеContainer - Возвращает:
- значение свойства
maximumSize - См. также:
setMinimumSize
@BeanProperty(description="The minimum size of the component.") public void setMinimumSize(Dimension minimumSize)
getMinimumSize всегда будет возвращаться это значение; пользовательский интерфейс компонента не будет вычислять его. Установка минимального размера в null восстанавливает поведение по умолчанию. Подклассы могут переопределить это поведение, возвращая собственный минимальный размер в методе getMinimumSize.
- Переопределяет:
-
setMinimumSizeв классеComponent - Параметры:
-
minimumSize— новый минимальный размер этого компонента - См. также:
getMinimumSize
public Dimension getMinimumSize()
null, оно просто возвращается. Если метод getMinimumSize делегата пользовательского интерфейса возвращает значение, отличное от null, возвращается оно; в противном случае используется менеджер компоновки компонента.- Переопределяет:
-
getMinimumSizeв классеContainer - Возвращает:
- значение свойства
minimumSize - См. также:
contains
public boolean contains(int x, int y)
setBorder
@BeanProperty(preferred=true, visualUpdate=true, description="The component's border.") public void setBorder(Border border)
Border отвечает за определение отступов компонента (переопределяя любые отступы, заданные непосредственно для компонента), а также за отрисовку декоративных элементов границы внутри этих отступов, если это необходимо. Для создания декоративных и недекоративных областей (например, полей и внутренних отступов) компонентов Swing следует использовать границы, а не отступы. Составные границы позволяют вкладывать несколько границ в один компонент. Хотя технически границу можно задать для любого объекта, наследующего JComponent, реализации внешнего вида многих стандартных компонентов Swing плохо работают с границами, заданными пользователем. В общем случае, если требуется задать границу стандартному компоненту Swing, отличному от JPanel или JLabel, рекомендуется поместить компонент в JPanel и задать границу для JPanel.
Это ограниченное свойство.
- Параметры:
-
border— граница, которая будет отображаться для этого компонента - См. также:
getBorder
public Border getBorder()
null, если граница не задана.- Возвращает:
- объект границы для этого компонента
- См. также:
getInsets
getInsets
public Insets getInsets(Insets insets)
Insets, содержащий значения отступов этого компонента. Переданный объект Insets будет использован повторно, если это возможно. Однако вызывающие методы не должны рассчитывать на то, что будет возвращен тот же объект. Все существующие значения в этом объекте перезаписываются. Если insets имеет значение null, будет создан новый объект.- Параметры:
-
insets— объектInsets, который может быть использован повторно - Возвращает:
- объект
Insets - См. также:
getAlignmentY
public float getAlignmentY()
Container.getAlignmentY для возврата вертикального выравнивания.- Переопределяет:
-
getAlignmentYв классеContainer - Возвращает:
- значение свойства
alignmentY - См. также:
setAlignmentY
@BeanProperty(description="The preferred vertical alignment of the component.") public void setAlignmentY(float alignmentY)
- Параметры:
-
alignmentY— новое вертикальное выравнивание - См. также:
getAlignmentX
public float getAlignmentX()
Container.getAlignmentX для возврата горизонтального выравнивания.- Переопределяет:
-
getAlignmentXв классеContainer - Возвращает:
- значение свойства
alignmentX - См. также:
setAlignmentX
@BeanProperty(description="The preferred horizontal alignment of the component.") public void setAlignmentX(float alignmentX)
- Параметры:
-
alignmentX— новое горизонтальное выравнивание - См. также:
setInputVerifier
@BeanProperty(description="The component's input verifier.") public void setInputVerifier(InputVerifier inputVerifier)
- Параметры:
-
inputVerifier— новое средство проверки ввода - Начиная с версии:
- 1.3
- См. также:
getInputVerifier
public InputVerifier getInputVerifier()
- Возвращает:
- свойство
inputVerifier - Начиная с версии:
- 1.3
- См. также:
getGraphics
@BeanProperty(bound=false) public Graphics getGraphics()
Graphics, а затем вызывать его методы для рисования на компоненте.- Переопределяет:
-
getGraphicsв классеComponent - Возвращает:
- графический контекст этого компонента
- См. также:
setDebugGraphicsOptions
@BeanProperty(bound=false, preferred=true, enumerationValues={"DebugGraphics.NONE_OPTION","DebugGraphics.LOG_OPTION","DebugGraphics.FLASH_OPTION","DebugGraphics.BUFFERED_OPTION"}, description="Diagnostic options for graphics operations.") public void setDebugGraphicsOptions(int debugOptions) - Параметры:
-
debugOptions— определяет способ отображения информации компонентом; одно из следующих значений:- DebugGraphics.LOG_OPTION — выводит текстовое сообщение.
- DebugGraphics.FLASH_OPTION — заставляет изображение несколько раз мигнуть.
- DebugGraphics.BUFFERED_OPTION — создает
ExternalWindow, отображающий операции, выполненные с внеэкранным буфером View. - DebugGraphics.NONE_OPTION отключает отладку.
- Значение 0 не изменяет параметры отладки.
debugOptionsобъединяется с текущим значением побитовой операцией ИЛИ
getDebugGraphicsOptions
public int getDebugGraphicsOptions()
- Возвращает:
- флаг, полученный побитовым объединением нуля или более следующих значений:
- DebugGraphics.LOG_OPTION — выводит текстовое сообщение.
- DebugGraphics.FLASH_OPTION — заставляет изображение несколько раз мигнуть.
- DebugGraphics.BUFFERED_OPTION — создает
ExternalWindow, отображающий операции, выполненные с внеэкранным буфером View. - DebugGraphics.NONE_OPTION отключает отладку.
- Значение 0 не изменяет параметры отладки.
- См. также:
registerKeyboardAction
public void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
getActionMap() и getInputMap(). Например, чтобы привязать KeyStroke aKeyStroke к Action anAction, теперь используйте: component.getInputMap().put(aKeyStroke, aCommand); component.getActionMap().put(aCommmand, anAction);В примере выше предполагается, что привязка должна применяться для
WHEN_FOCUSED. Чтобы зарегистрировать привязки для других состояний фокуса, используйте метод getInputMap, принимающий целое число. Регистрирует новое действие клавиатуры. anAction будет вызвано, если произойдет событие клавиатуры, соответствующее aKeyStroke, и будет выполнена проверка aCondition. Объект KeyStroke задает определенную комбинацию клавиши и одного или нескольких модификаторов (alt, shift, ctrl, meta).
Если указано, aCommand будет установлено в доставляемом событии.
aCondition может принимать одно из следующих значений:
- WHEN_FOCUSED
- Действие вызывается, только если нажатие клавиши происходит, когда компонент находится в фокусе.
- WHEN_IN_FOCUSED_WINDOW
- Действие вызывается, если нажатие клавиши происходит, когда компонент находится в фокусе или находится в окне, имеющем фокус. Обратите внимание, что компонент не обязательно должен быть непосредственным потомком окна — он может находиться в любом месте иерархии вложенных компонентов окна. Иными словами, действие, зарегистрированное для этого компонента, вызывается, когда фокус находится на любом компоненте окна.
- WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
- Действие вызывается, если нажатие клавиши происходит, когда компонент находится в фокусе или является предком компонента, находящегося в фокусе.
Комбинация нажатий клавиш и условий позволяет определять высокоуровневые (семантические) события действий для заданной комбинации клавиши и модификатора (с помощью класса KeyStroke) и направлять их родительскому или дочернему компоненту компонента, находящегося в фокусе, либо самому этому компоненту. Иными словами, в любой иерархической структуре компонентов произвольную комбинацию клавиш можно напрямую направить соответствующему компоненту иерархии и вызвать определенный метод (обычно с помощью объектов-адаптеров).
Если для принимающего контейнера уже зарегистрировано действие с тем же charCode и теми же модификаторами, anAction заменит это действие.
- Параметры:
-
anAction— регистрируемыйAction -
aCommand— команда, задаваемая в доставляемом событии -
aKeyStroke—KeyStroke, связываемый с действием -
aCondition— условие, которое должно быть выполнено; см. выше - См. также:
registerKeyboardAction
public void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
getActionMap() и getInputMap().- Параметры:
-
anAction— действие, регистрируемое для заданной комбинации клавиш и условия -
aKeyStroke— объектKeyStroke -
aCondition— условие, связываемое с заданной комбинацией клавиш и действием - См. также:
unregisterKeyboardAction
public void unregisterKeyboardAction(KeyStroke aKeyStroke)
ActionMap/InputMap или поместить фиктивную привязку в InputMap. Удаление привязки из InputMap позволяет активировать привязки в родительских InputMap, тогда как фиктивная привязка в InputMap фактически полностью отключает эту привязку. Отменяет действие клавиатуры. Это удалит привязку из ActionMap (если она существует), а также из InputMap.
- Параметры:
-
aKeyStroke— комбинация клавиш, для которой отменяется действие клавиатуры
getRegisteredKeyStrokes
@BeanProperty(bound=false) public KeyStroke[] getRegisteredKeyStrokes()
KeyStrokes, которые запускают зарегистрированные действия.- Возвращает:
- массив объектов
KeyStroke - См. также:
getConditionForKeyStroke
public int getConditionForKeyStroke(KeyStroke aKeyStroke)
В платформе Java 2 версии 1.3 один KeyStroke может быть связан с несколькими условиями. Например, клавиша «a» может быть привязана к двум условиям: WHEN_FOCUSED и WHEN_IN_FOCUSED_WINDOW.
- Параметры:
-
aKeyStroke— комбинация клавиш, для которой запрашивается условие действия - Возвращает:
- условие действия для комбинации клавиш
getActionForKeyStroke
public ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)
- Параметры:
-
aKeyStroke— комбинация клавиш, для которой возвращается слушатель - Возвращает:
- объект
ActionListener, вызываемый при нажатии соответствующей клавиши
resetKeyboardActions
public void resetKeyboardActions()
InputMaps и ActionMap. В результате удаляются все локальные привязки, а привязки, определённые в родительском InputMap/ActionMaps (обычно пользовательский интерфейс определяется на втором уровне), сохраняются.setInputMap
public final void setInputMap(int condition, InputMap map)
InputMap, используемую при условии condition, в map. Значение null означает, что вы не хотите использовать никакие привязки, даже из пользовательского интерфейса. При этом пользовательский интерфейс InputMap не будет установлен повторно (если он был). condition принимает одно из следующих значений: -
WHEN_IN_FOCUSED_WINDOW -
WHEN_FOCUSED -
WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
condition имеет значение WHEN_IN_FOCUSED_WINDOW, а map не является ComponentInputMap, будет выброшено исключение IllegalArgumentException. Аналогично, если condition не входит в список указанных значений, будет выброшено исключение IllegalArgumentException.- Параметры:
-
condition— одно из перечисленных выше значений -
map—InputMap, используемая для указанного условия - Исключения:
-
IllegalArgumentException— еслиconditionимеет значениеWHEN_IN_FOCUSED_WINDOW, аmapне является экземпляромComponentInputMap; или еслиconditionне входит в список допустимых значений, указанных выше - Начиная с:
- 1.3
getInputMap
public final InputMap getInputMap(int condition)
InputMap, используемую во время condition.- Параметры:
-
condition— одно из значений WHEN_IN_FOCUSED_WINDOW, WHEN_FOCUSED, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT - Возвращает:
InputMapдля указанногоcondition- Начиная с:
- 1.3
getInputMap
public final InputMap getInputMap()
InputMap, используемую, когда компонент находится в фокусе. Это вспомогательный метод для getInputMap(WHEN_FOCUSED).- Возвращает:
InputMap, используемую, когда компонент находится в фокусе- Начиная с:
- 1.3
setActionMap
public final void setActionMap(ActionMap am)
ActionMap равным am. Этот метод не устанавливает родителем am объект ActionMap из пользовательского интерфейса (если он был); это должен сделать вызывающий код.- Параметры:
-
am— новаяActionMap - Начиная с:
- 1.3
getActionMap
public final ActionMap getActionMap()
ActionMap, используемую для определения того, какое Action нужно вызвать для конкретной привязки KeyStroke. Возвращаемый объект ActionMap, если не задано иное, будет иметь родительский объект ActionMap из пользовательского интерфейса.- Возвращает:
ActionMap, содержащую привязки клавиш и действий- Начиная с:
- 1.3
getBaseline
public int getBaseline(int width, int height)
LayoutManager, выравнивающих компоненты по базовой линии. Возвращаемое значение меньше 0 означает, что у компонента нет подходящей базовой линии и LayoutManager не следует выравнивать этот компонент по базовой линии. Этот метод вызывает одноимённый метод ComponentUI. Если у компонента нет ComponentUI, будет возвращено значение -1. Если возвращено значение >= 0, базовая линия компонента корректна для любого размера >= минимального размера, а getBaselineResizeBehavior можно использовать для определения изменения базовой линии с изменением размера.
- Переопределяет:
-
getBaselineв классеComponent - Параметры:
-
width— ширина, для которой нужно получить базовую линию -
height— высота, для которой нужно получить базовую линию - Возвращает:
- базовую линию или значение < 0, указывающее на отсутствие подходящей базовой линии
- Исключения:
-
IllegalArgumentException— если ширина или высота < 0 - Начиная с:
- 1.6
- См. также:
getBaselineResizeBehavior
@BeanProperty(bound=false) public Component.BaselineResizeBehavior getBaselineResizeBehavior()
Этот метод вызывает одноимённый метод ComponentUI. Если у компонента нет ComponentUI, будет возвращено BaselineResizeBehavior.OTHER. Подклассы никогда не должны возвращать null; если базовую линию вычислить невозможно, следует вернуть BaselineResizeBehavior.OTHER. Сначала вызывающим методам следует запросить базовую линию с помощью getBaseline; если возвращено значение >= 0, можно использовать этот метод. Допустимо, чтобы этот метод возвращал значение, отличное от BaselineResizeBehavior.OTHER, даже если getBaseline возвращает значение меньше 0.
- Переопределяет:
-
getBaselineResizeBehaviorв классеComponent - Возвращает:
- перечисление, указывающее, как изменяется базовая линия при изменении размера компонента
- Начиная с:
- 1.6
- См. также:
requestDefaultFocus
@Deprecated public boolean requestDefaultFocus()
FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
Запрашивает фокус для компонента JComponent — его FocusTraversalPolicy — по умолчанию Component. Если этот JComponent является корнем цикла фокуса, используется его FocusTraversalPolicy. В противном случае используется FocusTraversalPolicy предка этого JComponent, являющегося корнем цикла фокуса.
- Возвращает:
- true, если этот компонент может запросить получение фокуса ввода; false, если не может
- См. также:
setVisible
@BeanProperty(hidden=true, visualUpdate=true) public void setVisible(boolean aFlag)
Component.setVisible.- Переопределяет:
-
setVisibleв классеComponent - Параметры:
-
aFlag— true, чтобы сделать компонент видимым; false, чтобы сделать его невидимым - См. также:
setEnabled
@BeanProperty(expert=true, preferred=true, visualUpdate=true, description="The enabled state of the component.") public void setEnabled(boolean enabled)
Примечание. Отключение компонента не отключает его дочерние элементы.
Примечание. Отключение облегчённого компонента не мешает ему получать события мыши.
- Переопределяет:
-
setEnabledв классеComponent - Параметры:
-
enabled— true, если компонент должен быть включён; в противном случае false - См. также:
setForeground
@BeanProperty(preferred=true, visualUpdate=true, description="The foreground color of the component.") public void setForeground(Color fg)
- Переопределяет:
-
setForegroundв классеComponent - Параметры:
-
fg— желаемый цвет переднего планаColor - См. также:
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 - См. также:
setFont
getDefaultLocale
public static Locale getDefaultLocale()
- Возвращает:
- языковой стандарт
Localeпо умолчанию. - Начиная с:
- 1.4
- См. также:
setDefaultLocale
public static void setDefaultLocale(Locale l)
null сбросит текущий языковой стандарт к языковому стандарту виртуальной машины по умолчанию.- Параметры:
-
l— желаемый языковой стандартLocaleпо умолчанию для новых компонентов. - Начиная с:
- 1.4
- См. также:
processComponentKeyEvent
protected void processComponentKeyEvent(KeyEvent e)
Реализация этого метода ничего не делает. Обычно подклассы переопределяют его, если самостоятельно обрабатывают некоторые события клавиатуры. Если событие обработано, его следует пометить как обработанное.
- Параметры:
-
e— событие, которое нужно обработать
processKeyEvent
protected void processKeyEvent(KeyEvent e)
processKeyEvent для обработки событий.- Переопределяет:
-
processKeyEventв классеComponent - Параметры:
-
e— событие клавиатуры - См. также:
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, всплывающая подсказка для этого компонента отключается - См. также:
getToolTipText
public String getToolTipText()
setToolTipText.- Возвращает:
- текст всплывающей подсказки
- См. также:
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 - См. также:
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
public boolean getAutoscrolls()
autoscrolls.- Возвращает:
- значение свойства
autoscrolls - См. также:
setTransferHandler
@BeanProperty(hidden=true, description="Mechanism for transfer of data to and from the component") public void setTransferHandler(TransferHandler newHandler)
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
- См. также:
getTransferHandler
public TransferHandler getTransferHandler()
transferHandler.- Возвращает:
- значение свойства
transferHandler - Начиная с:
- 1.4
- См. также:
processMouseEvent
protected void processMouseEvent(MouseEvent e)
MouseListener. Полное описание этого метода см. в Component.processMouseEvent(MouseEvent).- Переопределяет:
-
processMouseEventв классеComponent - Параметры:
-
e— событие мыши - Начиная с:
- 1.5
- См. также:
processMouseMotionEvent
protected void processMouseMotionEvent(MouseEvent e)
- Переопределяет:
-
processMouseMotionEventв классеComponent - Параметры:
-
e—MouseEvent - См. также:
enable
disable
getClientProperty
public final Object getClientProperty(Object key)
putClientProperty, будет возвращено значение, отличное от null.- Параметры:
-
key— запрашиваемое свойство - Возвращает:
- значение этого свойства или
null - См. также:
putClientProperty
public final void putClientProperty(Object key, Object value)
Методы get/putClientProperty предоставляют доступ к небольшой хеш-таблице для каждого экземпляра. Вызывающий код может использовать get/putClientProperty, чтобы снабдить аннотациями компоненты, созданные другим модулем. Например, таким способом менеджер компоновки может хранить ограничения для каждого дочернего компонента. Пример:
componentA.putClientProperty("to the left of", componentB);
Если значение равно null, этот метод удалит свойство. Об изменениях клиентских свойств сообщают события PropertyChange. Имя свойства (для событий PropertyChange) — key.toString(). Словарь clientProperty не предназначен для поддержки крупных расширений JComponent и не должен рассматриваться как альтернатива созданию подклассов при проектировании нового компонента.
- Параметры:
-
key— новый ключ клиентского свойства -
value— новое значение клиентского свойства; если оно равноnull, этот метод удалит свойство - См. также:
setFocusTraversalKeys
public void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Component.setFocusTraversalKeys(int, 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
- См. также:
isLightweightComponent
public static boolean isLightweightComponent(Component c)
- Параметры:
-
c— проверяемыйComponent - Возвращает:
- true, если компонент является облегчённым
reshape
@Deprecated public void reshape(int x, int y, int w, int h)
Component.setBounds(int, int, int, int). Перемещает компонент и изменяет его размер.
ComponentgetBounds
public Rectangle getBounds(Rectangle rv)
rv, используемый как «возвращаемое значение», и возвращает rv. Если rv равен null, выделяется новый Rectangle. Эта версия getBounds полезна, если вызывающий код хочет избежать выделения нового объекта Rectangle в куче.getSize
public Dimension getSize(Dimension rv)
rv, используемый как «возвращаемое значение», и возвращает rv. Если rv равен null, выделяется новый объект Dimension. Эта версия getSize полезна, если вызывающий код хочет избежать выделения нового объекта Dimension в куче.getLocation
public Point getLocation(Point rv)
rv, используемый как «возвращаемое значение», и возвращает rv. Если rv равен null, выделяется новый Point. Эта версия getLocation полезна, если вызывающий код хочет избежать выделения нового объекта Point в куче.- Переопределяет:
-
getLocationв классеComponent - Параметры:
-
rv— возвращаемое значение, изменяемое для хранения положения компонента - Возвращает:
rv
getX
@BeanProperty(bound=false) public int getX()
component.getBounds().x или component.getLocation().x, поскольку не приводит к выделению памяти в куче.getY
@BeanProperty(bound=false) public int getY()
component.getBounds().y или component.getLocation().y, поскольку не приводит к выделению памяти в куче.getWidth
@BeanProperty(bound=false) public int getWidth()
component.getBounds().width или component.getSize().width, поскольку не приводит к выделению памяти в куче.getHeight
@BeanProperty(bound=false) public int getHeight()
component.getBounds().height или component.getSize().height, поскольку не приводит к выделению памяти в куче.isOpaque
public boolean isOpaque()
Непрозрачный компонент закрашивает каждый пиксель в пределах своих прямоугольных границ. Непрозрачный не полностью компонент закрашивает лишь часть пикселей или не закрашивает ни одного, позволяя пикселям под ним «просвечивать». Таким образом, компонент, который закрашивает не все свои пиксели, обладает некоторой степенью прозрачности.
Подклассы, гарантирующие полную закраску своего содержимого, должны переопределить этот метод и вернуть true.
setOpaque
@BeanProperty(expert=true, description="The component's opacity") public void setOpaque(boolean isOpaque)
Значение этого свойства по умолчанию равно false для JComponent. Однако значение этого свойства по умолчанию для большинства стандартных подклассов JComponent (например, JButton и JTree) зависит от оформления.
- Параметры:
-
isOpaque— true, если компонент должен быть непрозрачным - См. также:
computeVisibleRect
public void computeVisibleRect(Rectangle visibleRect)
Component — пересечение видимых прямоугольников этого компонента и всех его предков. Возвращаемое значение сохраняется в visibleRect.- Параметры:
-
visibleRect—Rectangle, вычисленный как пересечение всех видимых прямоугольников этого компонента и всех его предков; это возвращаемое значение метода - См. также:
getVisibleRect
@BeanProperty(bound=false) public Rectangle getVisibleRect()
Component — пересечение видимого прямоугольника этого компонента, new Rectangle(0, 0, getWidth(), getHeight()) и видимых прямоугольников всех его предков.- Возвращает:
- видимый прямоугольник
firePropertyChange
public void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
- Переопределяет:
-
firePropertyChangeв классеComponent - Параметры:
-
propertyName— свойство, значение которого изменилось -
oldValue— предыдущее значение свойства -
newValue— новое значение свойства
firePropertyChange
public void firePropertyChange(String propertyName, int oldValue, int newValue)
- Переопределяет:
-
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
- См. также:
getTopLevelAncestor
@BeanProperty(bound=false) public Container getTopLevelAncestor()
Window или Applet) либо null, если этот компонент не был добавлен ни в один контейнер.- Возвращает:
Containerверхнего уровня, в котором находится этот компонент, либоnull, если он не находится ни в одном контейнере
addAncestorListener
public void addAncestorListener(AncestorListener listener)
listener, чтобы он получал AncestorEvents при перемещении этого компонента или любого из его предков, а также при изменении их видимости. События также отправляются при добавлении компонента или его предков в иерархию вложенности либо при удалении из неё.- Параметры:
-
listener— регистрируемыйAncestorListener - См. также:
removeAncestorListener
public void removeAncestorListener(AncestorListener listener)
listener, чтобы он больше не получал AncestorEvents.- Параметры:
-
listener— удаляемыйAncestorListener - См. также:
getAncestorListeners
@BeanProperty(bound=false) public AncestorListener[] getAncestorListeners()
- Возвращает:
- все
AncestorListenerкомпонента или пустой массив, если слушатели предков в данный момент не зарегистрированы - Начиная с:
- 1.4
- См. также:
getListeners
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
FooListener для этого JComponent. FooListener регистрируются с помощью метода addFooListener. В аргументе listenerType можно указать литерал класса, например FooListener.class. Например, можно запросить у JComponent c список его слушателей мыши с помощью следующего кода:
MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));Если таких слушателей нет, метод возвращает пустой массив.
- Переопределяет:
-
getListenersв классеContainer - Параметры типа:
T— тип слушателей- Параметры:
-
listenerType— тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, являющийся потомкомjava.util.EventListener - Возвращает:
- массив всех объектов, зарегистрированных как
FooListenerдля этого компонента, или пустой массив, если такие слушатели не добавлены - Вызывает:
-
ClassCastException— еслиlistenerTypeне указывает класс или интерфейс, реализующийjava.util.EventListener - Начиная с:
- 1.3
- См. также:
addNotify
public void addNotify()
KeyboardAction. Этот метод вызывается внутренними средствами инструментария и не должен вызываться программами напрямую.removeNotify
public void removeNotify()
KeyboardAction, настроенные в цепочке родительских компонентов. Этот метод вызывается внутренними средствами инструментария и не должен вызываться программами напрямую.- Переопределяет:
-
removeNotifyв классеContainer - См. также:
repaint
public void repaint(long tm, int x, int y, int width, int height)
repaint
public void repaint(Rectangle r)
- Параметры:
-
r—Rectangle, содержащий область, требующую перерисовки - См. также:
revalidate
public void revalidate()
Вызывает invalidate, а затем добавляет validateRoot этого компонента в список компонентов, требующих проверки. Проверка будет выполнена после обработки всех ожидающих событий. Иными словами, после вызова этого метода будет проверен первый validateRoot (если он есть), найденный при обходе иерархии вложенности этого компонента вверх. По умолчанию JRootPane, JScrollPane и JTextField возвращают true из метода isValidateRoot.
Этот метод автоматически вызывается для компонента при изменении значения свойства, затрагивающем его размер, положение или внутреннюю компоновку. Это автоматическое обновление отличается от AWT, поскольку программам обычно больше не нужно вызывать validate, чтобы обновить содержимое графического интерфейса.
- Переопределяет:
-
revalidateв классеComponent - См. также:
isValidateRoot
public boolean isValidateRoot()
revalidate из дочерних компонентов приведут к проверке всего дерева, начинающегося с этого корневого компонента. По умолчанию возвращает false. JScrollPane переопределяет этот метод и возвращает true.- Переопределяет:
-
isValidateRootв классеContainer - Возвращает:
- всегда возвращает false
- См. также:
isOptimizedDrawingEnabled
@BeanProperty(bound=false) public boolean isOptimizedDrawingEnabled()
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
public void paintImmediately(int x, int y, int w, int h)
Вызывать этот метод требуется редко. В большинстве случаев эффективнее вызвать repaint, который откладывает фактическую отрисовку и объединяет избыточные запросы в один вызов рисования. Этот метод полезен, если необходимо обновить изображение на экране во время обработки текущего события.
Этот метод следует переопределить, если необходимо изменить область, требующую перерисовки, для компонентов, являющихся источниками рисования.
- Параметры:
-
x— координата x области для рисования -
y— координата y области для рисования -
w— ширина области для рисования -
h— высота области для рисования - См. также:
paintImmediately
public void paintImmediately(Rectangle r)
- Параметры:
-
r—Rectangle, содержащий область для рисования
setDoubleBuffered
public void setDoubleBuffered(boolean aFlag)
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
© 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
java.awt.Component.setEnabled(boolean).