Класс Component

java.lang.Object
- java.awt.Component

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

Непосредственные известные подклассы:: Button, Canvas, Checkbox, Choice, Container, Label, List, Scrollbar, TextComponent

public abstract class Component
extends Object
implements ImageObserver, MenuContainer, Serializable

A component — это объект, имеющий графическое представление, которое может быть отображено на экране и которое может взаимодействовать с пользователем. Примеры компонентов — это кнопки, флажки и полосы прокрутки типичного графического пользовательского интерфейса.

Класс Component является абстрактным суперклассом компонентов Abstract Window Toolkit, не относящихся к меню. Класс Component также может быть непосредственно расширен для создания лёгкого компонента. Лёгкий компонент — это компонент, не связанный с родным окном. Напротив, тяжёлый компонент связан с родным окном. Метод isLightweight() можно использовать для различения этих двух типов компонентов.

Лёгкие и тяжёлые компоненты могут быть смешаны в одной иерархии компонентов. Однако для правильной работы такой смешанной иерархии компонентов вся иерархия должна быть валидной. Когда иерархия становится невалидной, например, после изменения границ компонентов или добавления/удаления компонентов в/из контейнеров, вся иерархия должна быть валидирована с помощью метода Container.validate(), вызванного на верхнем невалидном контейнере иерархии.

Сериализация

Важно отметить, что будут сохранены только слушатели AWT, соответствующие протоколу Serializable, когда объект сохраняется. Если у объекта AWT есть слушатели, которые не помечены как сериализуемые, они будут удалены на стадии writeObject. Разработчики, как всегда, должны учитывать последствия того, что объект сериализуем. Одна ситуация, за которой нужно следить:

import java.awt.*;
    import java.awt.event.*;
    import java.io.Serializable;

    class MyApp implements ActionListener, Serializable
    {
        BigObjectThatShouldNotBeSerializedWithAButton bigOne;
        Button aButton = new Button();

        MyApp()
        {
            // Oops, now aButton has a listener with a reference
            // to bigOne!
            aButton.addActionListener(this);
        }

        public void actionPerformed(ActionEvent e)
        {
            System.out.println("Hello There");
        }
    }

В этом примере сериализация aButton приведет к сериализации MyApp и всего, на что он ссылается. Проблема в том, что слушатель сериализуем случайно, а не по дизайну. Чтобы разделить решения о MyApp и о ActionListener быть сериализуемыми, можно использовать вложенный класс, как в следующем примере:

import java.awt.*;
    import java.awt.event.*;
    import java.io.Serializable;

    class MyApp implements java.io.Serializable
    {
         BigObjectThatShouldNotBeSerializedWithAButton bigOne;
         Button aButton = new Button();

         static class MyActionListener implements ActionListener
         {
             public void actionPerformed(ActionEvent e)
             {
                 System.out.println("Hello There");
             }
         }

         MyApp()
         {
             aButton.addActionListener(new MyActionListener());
         }
    }

Примечание: Более подробная информация о механизмах рисования, используемых AWT и Swing, включая информацию о том, как написать наиболее эффективный код рисования, находится в Рисование в AWT и Swing.

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

См. также:: Сериализованная форма

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

Модификатор и тип	Класс и описание
`protected class`	`Component.AccessibleAWTComponent` Внутренний класс компонента, используемый для предоставления стандартной поддержки доступности.
`static class`	`Component.BaselineResizeBehavior` Перечисление общих способов изменения базовой линии компонента при изменении размера.
`protected class`	`Component.BltBufferStrategy` Внутренний класс для перерисовки внеэкранных поверхностей на компоненте.
`protected class`	`Component.FlipBufferStrategy` Внутренний класс для переворота буферов на компоненте.

Поля

Модификатор и тип	Поле и описание
`protected AccessibleContext`	`accessibleContext` `AccessibleContext` , связанный с этим `Component`.
`static float`	`BOTTOM_ALIGNMENT` Константа для удобства использования `getAlignmentY`.
`static float`	`CENTER_ALIGNMENT` Константа для удобства использования `getAlignmentY` и `getAlignmentX`.
`static float`	`LEFT_ALIGNMENT` Константа для удобства использования `getAlignmentX`.
`static float`	`RIGHT_ALIGNMENT` Константа для удобства использования `getAlignmentX`.
`static float`	`TOP_ALIGNMENT` Константа для удобства использования `getAlignmentY()`.

Наследованные поля из интерфейса java.awt.image.ImageObserver

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

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

Модификатор	Конструктор и описание
`protected`	`Component()` Создает новый компонент.

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

Модификатор и тип	Метод и описание
`boolean`	`action(Event evt, Object what)` Устаревший. Начиная с версии JDK 1.1, должен зарегистрировать этот компонент как ActionListener на компоненте, который генерирует события действия.
`void`	`add(PopupMenu popup)` Добавляет указанное всплывающее меню к компоненту.
`void`	`addComponentListener(ComponentListener l)` Добавляет указанный слушатель событий компонента для получения событий компонента от этого компонента.
`void`	`addFocusListener(FocusListener l)` Добавляет указанный слушатель событий фокуса для получения событий фокуса от этого компонента при получении компонентом фокуса ввода.
`void`	`addHierarchyBoundsListener(HierarchyBoundsListener l)` Добавляет указанный слушатель изменений границ иерархии для получения событий изменений границ иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
`void`	`addHierarchyListener(HierarchyListener l)` Добавляет указанный слушатель изменений иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
`void`	`addInputMethodListener(InputMethodListener l)` Добавляет указанного слушателя методов ввода для получения событий методов ввода от этого компонента.
`void`	`addKeyListener(KeyListener l)` Добавляет указанного слушателя нажатий клавиш для получения событий нажатия клавиш от этого компонента.
`void`	`addMouseListener(MouseListener l)` Добавляет указанного слушателя мыши для получения событий мыши от этого компонента.
`void`	`addMouseMotionListener(MouseMotionListener l)` Добавляет указанного слушателя перемещения мыши для получения событий перемещения мыши от этого компонента.
`void`	`addMouseWheelListener(MouseWheelListener l)` Добавляет указанного слушателя колеса мыши для получения событий колеса мыши от этого компонента.
`void`	`addNotify()` Делает этот `Component` отображаемым, подключив его к ресурсу нативного экрана.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` Добавляет PropertyChangeListener в список слушателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)` Добавляет PropertyChangeListener в список слушателей для определённого свойства.
`void`	`applyComponentOrientation(ComponentOrientation orientation)` Устанавливает свойство `ComponentOrientation` этого компонента и всех содержащихся в нём компонентов.
`boolean`	`areFocusTraversalKeysSet(int id)` Возвращает, определён ли набор клавиш перемещения фокуса для заданной операции перемещения фокуса для этого компонента.
`Rectangle`	`bounds()` Устаревший. Начиная с версии JDK 1.1, заменён на `getBounds()`.
`int`	`checkImage(Image image, ImageObserver observer)` Возвращает состояние построения экранного представления указанного изображения.
`int`	`checkImage(Image image, int width, int height, ImageObserver observer)` Возвращает состояние построения экранного представления указанного изображения.
`protected AWTEvent`	`coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)` Возможная консолидация события, публикуемого с существующим событием.
`boolean`	`contains(int x, int y)` Проверяет, "содержит" ли этот компонент указанную точку, где `x` и `y` определены относительно системы координат этого компонента.
`boolean`	`contains(Point p)` Проверяет, "содержит" ли этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента.
`Image`	`createImage(ImageProducer producer)` Создаёт изображение из указанного производителя изображений.
`Image`	`createImage(int width, int height)` Создаёт изображаемое изображение вне экрана для использования с двойным буферированием.
`VolatileImage`	`createVolatileImage(int width, int height)` Создаёт динамичное изображаемое изображение вне экрана для использования с двойным буферированием.
`VolatileImage`	`createVolatileImage(int width, int height, ImageCapabilities caps)` Создаёт динамичное изображаемое изображение вне экрана с заданными возможностями.
`void`	`deliverEvent(Event e)` Устаревший. Начиная с версии JDK 1.1, заменён на `dispatchEvent(AWTEvent e)`.
`void`	`disable()` Устаревший. Начиная с версии JDK 1.1, заменён на `setEnabled(boolean)`.
`protected void`	`disableEvents(long eventsToDisable)` Отключает события, определённые заданным параметром маски событий, от доставки этому компоненту.
`void`	`dispatchEvent(AWTEvent e)` Отправляет событие в этот компонент или один из его дочерних компонентов.
`void`	`doLayout()` Просит менеджер макета разложить этот компонент.
`void`	`enable()` Устаревший. Начиная с версии JDK 1.1, заменён на `setEnabled(boolean)`.
`void`	`enable(boolean b)` Устаревший. Начиная с версии JDK 1.1, заменён на `setEnabled(boolean)`.
`protected void`	`enableEvents(long eventsToEnable)` Включает события, определённые заданным параметром маски событий, для доставки этому компоненту.
`void`	`enableInputMethods(boolean enable)` Включает или отключает поддержку методов ввода для этого компонента.
`protected void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)` Поддержка отчёта о связанных изменениях свойств для булевых свойств.
`void`	`firePropertyChange(String propertyName, byte oldValue, byte newValue)` Сообщает о связанном изменении свойства.
`void`	`firePropertyChange(String propertyName, char oldValue, char newValue)` Сообщает о связанном изменении свойства.
`void`	`firePropertyChange(String propertyName, double oldValue, double newValue)` Сообщает о связанном изменении свойства.
`void`	`firePropertyChange(String propertyName, float oldValue, float newValue)` Сообщает о связанном изменении свойства.
`protected void`	`firePropertyChange(String propertyName, int oldValue, int newValue)` Поддержка отчёта о связанных изменениях свойств для целочисленных свойств.
`void`	`firePropertyChange(String propertyName, long oldValue, long newValue)` Сообщает о связанном изменении свойства.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)` Поддержка отчёта о связанных изменениях свойств для свойств типа Object.
`void`	`firePropertyChange(String propertyName, short oldValue, short newValue)` Сообщает о связанном изменении свойства.
`AccessibleContext`	`getAccessibleContext()` Получает `AccessibleContext` , связанное с этим `Component`.
`float`	`getAlignmentX()` Возвращает выравнивание по оси x.
`float`	`getAlignmentY()` Возвращает выравнивание по оси y.
`Color`	`getBackground()` Получает цвет фона этого компонента.
`int`	`getBaseline(int width, int height)` Возвращает базовую линию.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior()` Возвращает перечисление, указывающее, как базовая линия компонента изменяется при изменении размера.
`Rectangle`	`getBounds()` Получает границы этого компонента в виде объекта `Rectangle`.
`Rectangle`	`getBounds(Rectangle rv)` Хранит границы этого компонента в "значении возврата" rv и возвращает rv.
`ColorModel`	`getColorModel()` Получает экземпляр `ColorModel`, используемый для отображения компонента на устройстве вывода.
`Component`	`getComponentAt(int x, int y)` Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов расположение (x, y), и если да, возвращает содержащий компонент.
`Component`	`getComponentAt(Point p)` Возвращает компонент или подкомпонент, содержащий указанную точку.
`ComponentListener[]`	`getComponentListeners()` Возвращает массив всех слушателей событий компонента, зарегистрированных на этом компоненте.
`ComponentOrientation`	`getComponentOrientation()` Получает языкоспецифическую ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
`Cursor`	`getCursor()` Получает установленный курсор в компоненте.
`DropTarget`	`getDropTarget()` Получает `DropTarget` , связанное с этим `Component`.
`Container`	`getFocusCycleRootAncestor()` Возвращает контейнер, являющийся корнем цикла перемещения фокуса для цикла перемещения фокуса этого компонента.
`FocusListener[]`	`getFocusListeners()` Возвращает массив всех слушателей событий фокуса, зарегистрированных на этом компоненте.
`Set<AWTKeyStroke>`	`getFocusTraversalKeys(int id)` Возвращает набор клавиш перемещения фокуса для данной операции перемещения для этого компонента.
`boolean`	`getFocusTraversalKeysEnabled()` Возвращает, включены ли клавиши перемещения фокуса для этого компонента.
`Font`	`getFont()` Получает шрифт этого компонента.

`FontMetrics`	`getFontMetrics(Font font)` Получает метрики шрифта для указанного шрифта.
`Color`	`getForeground()` Получает цвет переднего плана этого компонента.
`Graphics`	`getGraphics()` Создаёт контекст графики для этого компонента.
`GraphicsConfiguration`	`getGraphicsConfiguration()` Получает `GraphicsConfiguration`, связанное с этим `Component`.
`int`	`getHeight()` Возвращает текущую высоту этого компонента.
`HierarchyBoundsListener[]`	`getHierarchyBoundsListeners()` Возвращает массив всех слушателей границ иерархии, зарегистрированных в этом компоненте.
`HierarchyListener[]`	`getHierarchyListeners()` Возвращает массив всех слушателей иерархии, зарегистрированных в этом компоненте.
`boolean`	`getIgnoreRepaint()`
`InputContext`	`getInputContext()` Получает контекст ввода, используемый этим компонентом для обработки коммуникации с методами ввода при вводе текста в этот компонент.
`InputMethodListener[]`	`getInputMethodListeners()` Возвращает массив всех слушателей методов ввода, зарегистрированных в этом компоненте.
`InputMethodRequests`	`getInputMethodRequests()` Получает обработчик запросов метода ввода, который поддерживает запросы от методов ввода для этого компонента.
`KeyListener[]`	`getKeyListeners()` Возвращает массив всех слушателей клавиш, зарегистрированных в этом компоненте.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)` Возвращает массив всех объектов, в настоящее время зарегистрированных как `FooListener` в этом `Component`.
`Locale`	`getLocale()` Получает локаль этого компонента.
`Point`	`getLocation()` Получает расположение этого компонента в виде точки, определяющей верхний левый угол компонента.
`Point`	`getLocation(Point rv)` Хранит начальные координаты x, y этого компонента в «возвращаемом значении» rv и возвращает rv.
`Point`	`getLocationOnScreen()` Получает расположение этого компонента в виде точки, определяющей верхний левый угол компонента в пространстве координат экрана.
`Dimension`	`getMaximumSize()` Получает максимальный размер этого компонента.
`Dimension`	`getMinimumSize()` Получает минимальный размер этого компонента.
`MouseListener[]`	`getMouseListeners()` Возвращает массив всех слушателей мыши, зарегистрированных в этом компоненте.
`MouseMotionListener[]`	`getMouseMotionListeners()` Возвращает массив всех слушателей движения мыши, зарегистрированных в этом компоненте.
`Point`	`getMousePosition()` Возвращает положение указателя мыши в пространстве координат этого `Component`, если `Component` находится непосредственно под указателем мыши, в противном случае возвращает `null`.
`MouseWheelListener[]`	`getMouseWheelListeners()` Возвращает массив всех слушателей колеса мыши, зарегистрированных в этом компоненте.
`String`	`getName()` Получает имя компонента.
`Container`	`getParent()` Получает родительский компонент этого компонента.
`java.awt.peer.ComponentPeer`	`getPeer()` Устаревшее. С версии JDK 1.1 программы не должны напрямую манипулировать виджетами; заменено на `boolean isDisplayable()`.
`Dimension`	`getPreferredSize()` Получает предпочтительный размер этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners()` Возвращает массив всех слушателей изменений свойств, зарегистрированных в этом компоненте.
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)` Возвращает массив всех слушателей, которые были связаны со свойством с указанным именем.
`Dimension`	`getSize()` Возвращает размер этого компонента в виде объекта `Dimension`.
`Dimension`	`getSize(Dimension rv)` Хранит ширину/высоту этого компонента в «возвращаемом значении» rv и возвращает rv.
`Toolkit`	`getToolkit()` Получает инструментарий этого компонента.
`Object`	`getTreeLock()` Получает объект блокировки этого компонента (объект, владеющий монитором синхронизации потоков) для операций AWT-дерева компонентов и компоновки.
`int`	`getWidth()` Возвращает текущую ширину этого компонента.
`int`	`getX()` Возвращает текущую координату x начала координат компонента.
`int`	`getY()` Возвращает текущую координату y начала координат компонента.
`boolean`	`gotFocus(Event evt, Object what)` Устаревшее. С версии JDK 1.1 заменено на processFocusEvent(FocusEvent).
`boolean`	`handleEvent(Event evt)` Устаревшее. С версии JDK 1.1 заменено на processEvent(AWTEvent).
`boolean`	`hasFocus()` Возвращает `true`, если этот `Component` является владельцем фокуса.
`void`	`hide()` Устаревшее. С версии JDK 1.1 заменено на `setVisible(boolean)`.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int w, int h)` Перерисовывает компонент при изменении изображения.
`boolean`	`inside(int x, int y)` Устаревшее. С версии JDK 1.1 заменено на contains(int, int).
`void`	`invalidate()` Отменяет этот компонент и его предков.
`boolean`	`isBackgroundSet()` Возвращает, был ли цвет фона явно задан для этого компонента Component.
`boolean`	`isCursorSet()` Возвращает, был ли курсор явно задан для этого компонента Component.
`boolean`	`isDisplayable()` Определяет, отображается ли этот компонент.
`boolean`	`isDoubleBuffered()` Возвращает true, если этот компонент отрисовывается на внеэкранном изображении («буфере»), которое копируется на экран позже.
`boolean`	`isEnabled()` Определяет, включён ли этот компонент.
`boolean`	`isFocusable()` Возвращает, может ли этот компонент получить фокус.
`boolean`	`isFocusCycleRoot(Container container)` Возвращает, является ли указанный контейнер корнем цикла прохода фокуса для цикла прохода фокуса этого компонента.
`boolean`	`isFocusOwner()` Возвращает `true`, если этот `Component` является владельцем фокуса.
`boolean`	`isFocusTraversable()` Устаревшее. С версии 1.4 заменено на `isFocusable()`.
`boolean`	`isFontSet()` Возвращает, был ли шрифт явно задан для этого компонента Component.
`boolean`	`isForegroundSet()` Возвращает, был ли цвет переднего плана явно задан для этого компонента Component.
`boolean`	`isLightweight()` Легковесный компонент не имеет виджета родного инструментария.
`boolean`	`isMaximumSizeSet()` Возвращает true, если максимальный размер был установлен на ненулевое значение, в противном случае возвращает false.
`boolean`	`isMinimumSizeSet()` Возвращает true, если `setMinimumSize` был вызван с ненулевым значением, в противном случае false.
`boolean`	`isOpaque()` Возвращает true, если этот компонент полностью непрозрачный, по умолчанию возвращает false.
`boolean`	`isPreferredSizeSet()` Возвращает true, если предпочтительный размер был установлен на ненулевое значение, в противном случае возвращает false.
`boolean`	`isShowing()` Определяет, отображается ли этот компонент на экране.
`boolean`	`isValid()` Определяет, валиден ли этот компонент.
`boolean`	`isVisible()` Определяет, должен ли этот компонент отображаться, когда его родитель отображается.
`boolean`	`keyDown(Event evt, int key)` Устаревшее. С версии JDK 1.1 заменено на processKeyEvent(KeyEvent).
`boolean`	`keyUp(Event evt, int key)` Устаревшее. С версии JDK 1.1 заменено на processKeyEvent(KeyEvent).
`void`	`layout()` Устаревшее. С версии JDK 1.1 заменено на `doLayout()`.

`void`	`list()` Выводит список этого компонента в стандартный поток вывода `System.out`.
`void`	`list(PrintStream out)` Выводит список этого компонента в указанный поток вывода.
`void`	`list(PrintStream out, int indent)` Выводит список, начиная с указанного отступа, в указанный поток печати.
`void`	`list(PrintWriter out)` Выводит список в указанный объект PrintWriter.
`void`	`list(PrintWriter out, int indent)` Выводит список, начиная с указанного отступа, в указанный объект PrintWriter.
`Component`	`locate(int x, int y)` Устарело. Начиная с версии JDK 1.1, заменено на getComponentAt(int, int).
`Point`	`location()` Устарело. Начиная с версии JDK 1.1, заменено на `getLocation()`.
`boolean`	`lostFocus(Event evt, Object what)` Устарело. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
`Dimension`	`minimumSize()` Устарело. Начиная с версии JDK 1.1, заменено на `getMinimumSize()`.
`boolean`	`mouseDown(Event evt, int x, int y)` Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseDrag(Event evt, int x, int y)` Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseEnter(Event evt, int x, int y)` Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseExit(Event evt, int x, int y)` Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseMove(Event evt, int x, int y)` Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseUp(Event evt, int x, int y)` Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`void`	`move(int x, int y)` Устарело. Начиная с версии JDK 1.1, заменено на `setLocation(int, int)`.
`void`	`nextFocus()` Устарело. Начиная с версии JDK 1.1, заменено на transferFocus().
`void`	`paint(Graphics g)` Отображает этот компонент.
`void`	`paintAll(Graphics g)` Отображает этот компонент и все его подкомпоненты.
`protected String`	`paramString()` Возвращает строку, представляющую состояние этого компонента.
`boolean`	`postEvent(Event e)` Устарело. Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent).
`Dimension`	`preferredSize()` Устарело. Начиная с версии JDK 1.1, заменено на `getPreferredSize()`.
`boolean`	`prepareImage(Image image, ImageObserver observer)` Подготавливает изображение для отображения на этом компоненте.
`boolean`	`prepareImage(Image image, int width, int height, ImageObserver observer)` Подготавливает изображение для отображения на этом компоненте при указанной ширине и высоте.
`void`	`print(Graphics g)` Печатает этот компонент.
`void`	`printAll(Graphics g)` Печатает этот компонент и все его подкомпоненты.
`protected void`	`processComponentEvent(ComponentEvent e)` Обрабатывает события компонента, происходящие на этом компоненте, пересылая их любым зарегистрированным `ComponentListener` объектам.
`protected void`	`processEvent(AWTEvent e)` Обрабатывает события, происходящие на этом компоненте.
`protected void`	`processFocusEvent(FocusEvent e)` Обрабатывает события фокуса, происходящие на этом компоненте, пересылая их любым зарегистрированным `FocusListener` объектам.
`protected void`	`processHierarchyBoundsEvent(HierarchyEvent e)` Обрабатывает события границ иерархии, происходящие на этом компоненте, пересылая их любым зарегистрированным `HierarchyBoundsListener` объектам.
`protected void`	`processHierarchyEvent(HierarchyEvent e)` Обрабатывает события иерархии, происходящие на этом компоненте, пересылая их любым зарегистрированным `HierarchyListener` объектам.
`protected void`	`processInputMethodEvent(InputMethodEvent e)` Обрабатывает события ввода-вывода метода ввода, происходящие на этом компоненте, пересылая их любым зарегистрированным `InputMethodListener` объектам.
`protected void`	`processKeyEvent(KeyEvent e)` Обрабатывает события клавиш, происходящие на этом компоненте, пересылая их любым зарегистрированным `KeyListener` объектам.
`protected void`	`processMouseEvent(MouseEvent e)` Обрабатывает события мыши, происходящие на этом компоненте, пересылая их любым зарегистрированным `MouseListener` объектам.
`protected void`	`processMouseMotionEvent(MouseEvent e)` Обрабатывает события перемещения мыши, происходящие на этом компоненте, пересылая их любым зарегистрированным `MouseMotionListener` объектам.
`protected void`	`processMouseWheelEvent(MouseWheelEvent e)` Обрабатывает события колёса мыши, происходящие на этом компоненте, пересылая их любым зарегистрированным `MouseWheelListener` объектам.
`void`	`remove(MenuComponent popup)` Удаляет указанное всплывающее меню из компонента.
`void`	`removeComponentListener(ComponentListener l)` Удаляет указанного слушателя компонента, чтобы он больше не получал события компонента от этого компонента.
`void`	`removeFocusListener(FocusListener l)` Удаляет указанного слушателя фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`removeHierarchyBoundsListener(HierarchyBoundsListener l)` Удаляет указанного слушателя границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
`void`	`removeHierarchyListener(HierarchyListener l)` Удаляет указанного слушателя иерархии, чтобы он больше не получал события изменений иерархии от этого компонента.
`void`	`removeInputMethodListener(InputMethodListener l)` Удаляет указанного слушателя методов ввода, чтобы он больше не получал события методов ввода от этого компонента.
`void`	`removeKeyListener(KeyListener l)` Удаляет указанного слушателя клавиш, чтобы он больше не получал события клавиш от этого компонента.
`void`	`removeMouseListener(MouseListener l)` Удаляет указанного слушателя мыши, чтобы он больше не получал события мыши от этого компонента.
`void`	`removeMouseMotionListener(MouseMotionListener l)` Удаляет указанного слушателя перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента.
`void`	`removeMouseWheelListener(MouseWheelListener l)` Удаляет указанного слушателя колёса мыши, чтобы он больше не получал события колёса мыши от этого компонента.
`void`	`removeNotify()` Делает этот `Component` неотображаемым, уничтожив его системные ресурсы на экране.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` Удаляет PropertyChangeListener из списка слушателей.
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)` Удаляет `PropertyChangeListener` из списка слушателей для определённого свойства.
`void`	`repaint()` Перерисовывает этот компонент.
`void`	`repaint(int x, int y, int width, int height)` Перерисовывает указанный прямоугольник этого компонента.
`void`	`repaint(long tm)` Перерисовывает компонент.
`void`	`repaint(long tm, int x, int y, int width, int height)` Перерисовывает указанный прямоугольник этого компонента в течение `tm` миллисекунд.
`void`	`requestFocus()` Запрашивает, чтобы этот компонент получил фокус ввода, и что его родительский элемент верхнего уровня стал фокусированным окном.
`protected boolean`	`requestFocus(boolean temporary)` Запрашивает, чтобы этот `Component` получил фокус ввода, и что его родительский элемент верхнего уровня стал фокусированным `Component`.
`boolean`	`requestFocusInWindow()` Запрашивает, чтобы этот компонент получил фокус ввода, если родительский элемент верхнего уровня этого компонента уже является фокусированным окном.
`protected boolean`	`requestFocusInWindow(boolean temporary)` Запрашивает, чтобы этот `Component` получил фокус ввода, если родительский элемент верхнего уровня этого `Component` уже является фокусированным `Window`.
`void`	`reshape(int x, int y, int width, int height)` Устарело. Начиная с версии JDK 1.1, заменено на `setBounds(int, int, int, int)`.
`void`	`resize(Dimension d)` Устарело. Начиная с версии JDK 1.1, заменено на `setSize(Dimension)`.

`void`	`resize(int width, int height)` Устарело. Начиная с версии JDK 1.1, заменено на `setSize(int, int)`.
`void`	`revalidate()` Перепроверяет иерархию компонентов до ближайшего корня проверки.
`void`	`setBackground(Color c)` Устанавливает цвет фона этого компонента.
`void`	`setBounds(int x, int y, int width, int height)` Перемещает и изменяет размер этого компонента.
`void`	`setBounds(Rectangle r)` Перемещает и изменяет размер этого компонента в соответствии с новой рамкой `r`.
`void`	`setComponentOrientation(ComponentOrientation o)` Устанавливает чувствительную к языку ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
`void`	`setCursor(Cursor cursor)` Устанавливает изображение курсора на указанный курсор.
`void`	`setDropTarget(DropTarget dt)` Связывает `DropTarget` с этим компонентом.
`void`	`setEnabled(boolean b)` Включает или отключает этот компонент в зависимости от значения параметра `b`.
`void`	`setFocusable(boolean focusable)` Устанавливает состояние фокусируемости этого компонента Component на указанное значение.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)` Устанавливает клавиши перехода фокуса для заданной операции перехода для этого компонента Component.
`void`	`setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)` Устанавливает, включены ли клавиши перехода фокуса для этого компонента Component.
`void`	`setFont(Font f)` Устанавливает шрифт этого компонента.
`void`	`setForeground(Color c)` Устанавливает цвет переднего плана этого компонента.
`void`	`setIgnoreRepaint(boolean ignoreRepaint)` Устанавливает, должны ли сообщения о рисовании, полученные от операционной системы, игнорироваться.
`void`	`setLocale(Locale l)` Устанавливает локаль этого компонента.
`void`	`setLocation(int x, int y)` Перемещает этот компонент в новое местоположение.
`void`	`setLocation(Point p)` Перемещает этот компонент в новое местоположение.
`void`	`setMaximumSize(Dimension maximumSize)` Устанавливает максимальный размер этого компонента на постоянное значение.
`void`	`setMinimumSize(Dimension minimumSize)` Устанавливает минимальный размер этого компонента на постоянное значение.
`void`	`setName(String name)` Устанавливает имя компонента на указанную строку.
`void`	`setPreferredSize(Dimension preferredSize)` Устанавливает предпочтительный размер этого компонента на постоянное значение.
`void`	`setSize(Dimension d)` Изменяет размер этого компонента так, чтобы его ширина была `d.width`, а высота `d.height`.
`void`	`setSize(int width, int height)` Изменяет размер этого компонента так, чтобы его ширина была `width`, а высота `height`.
`void`	`setVisible(boolean b)` Отображает или скрывает этот компонент в зависимости от значения параметра `b`.
`void`	`show()` Устарело. Начиная с версии JDK 1.1, заменено на `setVisible(boolean)`.
`void`	`show(boolean b)` Устарело. Начиная с версии JDK 1.1, заменено на `setVisible(boolean)`.
`Dimension`	`size()` Устарело. Начиная с версии JDK 1.1, заменено на `getSize()`.
`String`	`toString()` Возвращает строковое представление этого компонента и его значений.
`void`	`transferFocus()` Передает фокус на следующий компонент, как если бы этот компонент Component был владельцем фокуса.
`void`	`transferFocusBackward()` Передает фокус на предыдущий компонент, как если бы этот компонент Component был владельцем фокуса.
`void`	`transferFocusUpCycle()` Передает фокус на один цикл перехода фокуса вверх.
`void`	`update(Graphics g)` Обновляет этот компонент.
`void`	`validate()` Проверяет этот компонент.

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

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

Поля

TOP_ALIGNMENT

public static final float TOP_ALIGNMENT

Константа для удобства использования, относящаяся к getAlignmentY(). Указывает выравнивание по верхнему краю компонента.

См. также:: getAlignmentY(), Значения константного поля

CENTER_ALIGNMENT

public static final float CENTER_ALIGNMENT

Константа для удобства использования для getAlignmentY и getAlignmentX. Указывает выравнивание по центру компонента.

См. также:: getAlignmentX(), getAlignmentY(), Значения константного поля

BOTTOM_ALIGNMENT

public static final float BOTTOM_ALIGNMENT

Константа для удобства использования для getAlignmentY. Указывает выравнивание по нижнему краю компонента.

См. также:: getAlignmentY(), Значения константного поля

LEFT_ALIGNMENT

public static final float LEFT_ALIGNMENT

Константа для удобства использования для getAlignmentX. Указывает выравнивание по левому краю компонента.

См. также:: getAlignmentX(), Значения константного поля

RIGHT_ALIGNMENT

public static final float RIGHT_ALIGNMENT

Константа для удобства использования для getAlignmentX. Указывает выравнивание по правому краю компонента.

См. также:: getAlignmentX(), Значения константного поля

accessibleContext

protected AccessibleContext accessibleContext

Связанный AccessibleContext для этого Component.

Конструкторы

Component

protected Component()

Создает новый компонент. Класс Component можно расширять напрямую для создания лёгкого компонента, который не использует непрозрачное нативное окно. Лёгкий компонент должен быть размещён в нативном контейнере на более высоком уровне иерархии компонентов (например, объектом Frame).

Методы

getName

public String getName()

Получает имя компонента.

Возвращает:: имя этого компонента
С:: JDK1.1
См. также:: setName(java.lang.String)

setName

public void setName(String name)

Устанавливает имя компонента заданной строкой.

Параметры:: name - строка, которая станет именем этого компонента
С:: JDK1.1
См. также:: getName()

getParent

public Container getParent()

Получает родительский компонент.

Возвращает:: родительский контейнер этого компонента
С:: JDK1.0

getPeer

@Deprecated
public java.awt.peer.ComponentPeer getPeer()

Устарело. Начиная с JDK версии 1.1, программы не должны напрямую манипулировать объектами-пеерами; заменено на boolean isDisplayable().

setDropTarget

public void setDropTarget(DropTarget dt)

Связывает DropTarget с этим компонентом. Component получит падение только в том случае, если он включен.

Параметры:: dt - Объект DropTarget
См. также:: isEnabled()

getDropTarget

public DropTarget getDropTarget()

Получает связанный DropTarget для этого Component.

getGraphicsConfiguration

public GraphicsConfiguration getGraphicsConfiguration()

Получает связанную GraphicsConfiguration для этого Component. Если Component не назначен определённый GraphicsConfiguration, возвращается GraphicsConfiguration верхнего контейнера объекта Component. Если Component создан, но ещё не добавлен в Container, этот метод возвращает null.

Возвращает:: GraphicsConfiguration используемый этим Component или null
С:: 1.3

getTreeLock

public final Object getTreeLock()

Получает объект блокировки этого компонента (объект, владеющий монитором синхронизации потоков) для операций AWT по дереву компонентов и компоновки.

Возвращает:: объект блокировки этого компонента

getToolkit

public Toolkit getToolkit()

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

Возвращает:: набор инструментов этого компонента
С:: JDK1.0

isValid

public boolean isValid()

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

Возвращает:: true если компонент допустим, false в противном случае
С:: JDK1.0
См. также:: validate(), invalidate()

isDisplayable

public boolean isDisplayable()

Определяет, отображается ли этот компонент. Компонент отображается, когда он подключён к нативному ресурсу экрана.

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

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

Возвращает:: true если компонент отображается, false в противном случае
С:: 1.2
См. также:: Container.add(Component), Window.pack(), Window.show(), Container.remove(Component), Window.dispose()

isVisible

public boolean isVisible()

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

Возвращает:: true если компонент видим, false в противном случае
С:: JDK1.0
См. также:: setVisible(boolean)

getMousePosition

public Point getMousePosition()
                       throws HeadlessException

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

Для Container возвращает ненулевое значение, если мышь находится над самим Container или над любым из его потомков. Используйте Container.getMousePosition(boolean), если вам нужно исключить потомков.

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

Возвращает:: координаты мыши относительно этого Component, или null
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:: 1.5
См. также:: isShowing(), Container.getMousePosition(boolean)

isShowing

public boolean isShowing()

Определяет, отображается ли этот компонент на экране. Это означает, что компонент должен быть видимым, и он должен быть в контейнере, который является видимым и отображается.

Примечание: иногда нет способа определить, действительно ли Component отображается пользователю. Это может произойти, когда:

компонент был добавлен в видимый ScrollPane, но Component в данный момент не находится в области видимости панели прокрутки.
Component скрыт другим Component или Container.

Возвращает:: true если компонент отображается, false в противном случае
С:: JDK1.0
См. также:: setVisible(boolean)

isEnabled

public boolean isEnabled()

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

Возвращает:: true если компонент включен, false в противном случае
С:: JDK1.0
См. также:: setEnabled(boolean)

setEnabled

public void setEnabled(boolean b)

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

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

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

Параметры:: b - Если true, этот компонент включен; в противном случае этот компонент отключён
С:: JDK1.1
См. также:: isEnabled(), isLightweight()

enable

@Deprecated
public void enable()

Устарело. С версии JDK 1.1 заменено на setEnabled(boolean).

enable

@Deprecated
public void enable(boolean b)

Устарело. С версии JDK 1.1 заменено на setEnabled(boolean).

disable

@Deprecated
public void disable()

Устарело. С версии JDK 1.1 заменено на setEnabled(boolean).

isDoubleBuffered

public boolean isDoubleBuffered()

Возвращает true, если этот компонент рисуется на внеэкранном изображении ("буфер"), которое затем копируется на экран. Подклассы компонентов, поддерживающие двойную буферизацию, должны переопределять этот метод, возвращая true, если двойная буферизация включена.

Возвращает:: по умолчанию false

enableInputMethods

public void enableInputMethods(boolean enable)

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

Параметры:: enable - true для включения, false для отключения
С:: 1.2
См. также:: processKeyEvent(java.awt.event.KeyEvent)

setVisible

public void setVisible(boolean b)

Показывает или скрывает этот компонент в зависимости от значения параметра b.

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

Параметры:: b - если true, показывает этот компонент; в противном случае скрывает этот компонент
С:: JDK1.1
См. также:: isVisible(), invalidate()

show

@Deprecated
public void show()

Устарело. С версии JDK 1.1 заменено на setVisible(boolean).

show

@Deprecated
public void show(boolean b)

Устарело. С версии JDK 1.1 заменено на setVisible(boolean).

hide

@Deprecated
public void hide()

Устарело. С версии JDK 1.1 заменено на setVisible(boolean).

getForeground

public Color getForeground()

Получает цвет переднего плана этого компонента.

Возвращает:: цвет переднего плана этого компонента; если у этого компонента нет цвета переднего плана, возвращается цвет переднего плана его родителя
С:: JDK1.0
См. также:: setForeground(java.awt.Color)

setForeground

public void setForeground(Color c)

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

Параметры:: c - цвет, который станет цветом переднего плана этого компонента; если этот параметр null, этот компонент унаследует цвет переднего плана своего родителя
С:: JDK1.0
См. также:: getForeground()

isForegroundSet

public boolean isForegroundSet()

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

Возвращает:: true если цвет переднего плана был явно установлен для этого компонента; false в противном случае.
С:: 1.4

getBackground

public Color getBackground()

Получает цвет фона этого компонента.

Возвращает:: цвет фона этого компонента; если у этого компонента нет цвета фона, возвращается цвет фона его родителя
С:: JDK1.0
См. также:: setBackground(java.awt.Color)

setBackground

public void setBackground(Color c)

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

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

Параметры:: c - цвет, который станет цветом фона этого компонента; если этот параметр null, этот компонент унаследует цвет фона своего родителя
С:: JDK1.0
См. также:: getBackground()

isBackgroundSet

public boolean isBackgroundSet()

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

Возвращает:: true если цвет фона был явно установлен для этого компонента; false в противном случае.
С:: 1.4

getFont

public Font getFont()

Получает шрифт этого компонента.

Определено в:: getFont в интерфейсе MenuContainer
Возвращает:: шрифт этого компонента; если для этого компонента шрифт не задан, возвращается шрифт его родителя
С:: JDK1.0
См. также:: setFont(java.awt.Font)

setFont

public void setFont(Font f)

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

Параметры:: f - шрифт, который станет шрифтом этого компонента; если этот параметр null, этот компонент унаследует шрифт своего родителя
С:: JDK1.0
См. также:: getFont(), invalidate()

isFontSet

public boolean isFontSet()

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

Возвращает:: true если шрифт был явно установлен для этого компонента; false в противном случае.
С:: 1.4

getLocale

public Locale getLocale()

Получает локаль этого компонента.

Возвращает:: локаль этого компонента; если у этого компонента нет локали, возвращается локаль его родителя
Исключения:: IllegalComponentStateException - если у Component нет собственной локали и он ещё не был добавлен в иерархию контейнеров, так что локаль не может быть определена из содержащего родителя
С:: JDK1.1
См. также:: setLocale(java.util.Locale)

setLocale

public void setLocale(Locale l)

Устанавливает локаль этого компонента. Это свойство привязано.

Параметры:: l - локаль, которая станет локалью этого компонента
С:: JDK1.1
См. также:: getLocale(), invalidate()

getColorModel

public ColorModel getColorModel()

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

Возвращает:: модель цвета, используемая этим компонентом
С:: JDK1.0
См. также:: ColorModel, ComponentPeer.getColorModel(), Toolkit.getColorModel()

getLocation

public Point getLocation()

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

Из-за асинхронной природы обработки событий ввода-вывода этот метод может возвращать устаревшие значения (например, после нескольких вызовов setLocation() в быстрой последовательности). По этой причине рекомендуемым способом получения позиции компонента является использование java.awt.event.ComponentListener.componentMoved(), который вызывается после того, как операционная система завершила перемещение компонента.

Возвращает:: экземпляр Point, представляющий верхний левый угол границ компонента в пространстве координат родителя компонента
С:: JDK1.1
См. также:: setLocation(int, int), getLocationOnScreen()

getLocationOnScreen

public Point getLocationOnScreen()

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

Возвращает:: экземпляр Point, представляющий верхний левый угол границ компонента в пространстве координат экрана
Исключения:: IllegalComponentStateException - если компонент не отображается на экране
См. также:: setLocation(int, int), getLocation()

location

@Deprecated
public Point location()

Устарело. С версии JDK 1.1 заменено на getLocation().

setLocation

public void setLocation(int x,
                        int y)

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

Этот метод изменяет информацию, связанную с макетом, и поэтому делает недействительной иерархию компонентов.

Параметры:: x - координата x верхнего левого угла нового местоположения в пространстве координат родителя; y - координата y верхнего левого угла нового местоположения в пространстве координат родителя
С момента:: JDK1.1
См. также:: getLocation(), setBounds(int, int, int, int), invalidate()

move

@Deprecated
public void move(int x,
                             int y)

Устаревший. С версии JDK 1.1 заменён на setLocation(int, int).

setLocation

public void setLocation(Point p)

Перемещает этот компонент в новое местоположение. Верхний левый угол нового местоположения задаётся точкой p. Точка p задана в пространстве координат родителя.

Параметры:: p - точка, определяющая верхний левый угол нового местоположения, заданная в пространстве координат родителя этого компонента
С момента:: JDK1.1
См. также:: getLocation(), setBounds(int, int, int, int), invalidate()

getSize

public Dimension getSize()

Возвращает размер этого компонента в виде объекта Dimension. Поле height объекта Dimension содержит высоту этого компонента, а поле width объекта Dimension содержит ширину этого компонента.

Возвращает:: объект Dimension, указывающий на размер этого компонента
С момента:: JDK1.1
См. также:: setSize(int, int)

size

@Deprecated
public Dimension size()

Устаревший. С версии JDK 1.1 заменён на getSize().

setSize

public void setSize(int width,
                    int height)

Изменяет размер этого компонента, установив ширину width и высоту height.

Параметры:: width - новая ширина этого компонента в пикселях; height - новая высота этого компонента в пикселях
С момента:: JDK1.1
См. также:: getSize(), setBounds(int, int, int, int), invalidate()

resize

@Deprecated
public void resize(int width,
                               int height)

Устаревший. С версии JDK 1.1 заменён на setSize(int, int).

setSize

public void setSize(Dimension d)

Изменяет размер этого компонента, установив ширину d.width и высоту d.height.

Параметры:: d - размер, определяющий новый размер этого компонента
Исключения:: NullPointerException - если d равно null
С момента:: JDK1.1
См. также:: setSize(int, int), setBounds(int, int, int, int), invalidate()

resize

@Deprecated
public void resize(Dimension d)

Устаревший. С версии JDK 1.1 заменён на setSize(Dimension).

getBounds

public Rectangle getBounds()

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

Возвращает:: прямоугольник, указывающий границы этого компонента
См. также:: setBounds(int, int, int, int), getLocation(), getSize()

bounds

@Deprecated
public Rectangle bounds()

Устаревший. С версии JDK 1.1 заменён на getBounds().

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

Перемещает и изменяет размер этого компонента. Новое положение верхнего левого угла задается параметрами x и y, а новый размер задается параметрами width и height.

Параметры:: x - новая координата x этого компонента; y - новая координата y этого компонента; width - новая width этого компонента; height - новая height этого компонента
С момента:: JDK1.1
См. также:: getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension), invalidate()

reshape

@Deprecated
public void reshape(int x,
                                int y,
                                int width,
                                int height)

Устаревший. С версии JDK 1.1 заменён на setBounds(int, int, int, int).

setBounds

public void setBounds(Rectangle r)

Перемещает и изменяет размер этого компонента в соответствии с новым прямоугольником границ r. Новое положение компонента задаётся значениями r.x и r.y, а новый размер — значениями r.width и r.height

Параметры:: r - новый прямоугольник границ для этого компонента
Исключения:: NullPointerException - если r равно null
С момента:: JDK1.1
См. также:: getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension), invalidate()

getX

public int getX()

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

Возвращает:: текущую координату x начала компонента
С момента:: 1.2

getY

public int getY()

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

Возвращает:: текущую координату y начала компонента
С момента:: 1.2

getWidth

public int getWidth()

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

Возвращает:: текущую ширину этого компонента
С момента:: 1.2

getHeight

public int getHeight()

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

Возвращает:: текущую высоту этого компонента
С момента:: 1.2

getBounds

public Rectangle getBounds(Rectangle rv)

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

Параметры:: rv - значение возврата, изменённое на границы компонента
Возвращает:: rv

getSize

public Dimension getSize(Dimension rv)

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

Параметры:: rv - значение возврата, изменённое на размер компонента
Возвращает:: rv

getLocation

public Point getLocation(Point rv)

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

Параметры:: rv - значение возврата, изменённое на положение компонента
Возвращает:: rv

isOpaque

public boolean isOpaque()

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

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

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

Возвращает:: true, если этот компонент полностью непрозрачный
С момента:: 1.2
См. также:: isLightweight()

isLightweight

public boolean isLightweight()

Компонент лёгкого типа не имеет собственного объекта-представителя в инструменте разработки. Подклассы Component и Container, кроме тех, что определены в этом пакете, например, Button или Scrollbar, являются лёгкими. Все компоненты Swing являются лёгкими.

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

Возвращает:: true, если у этого компонента есть представитель лёгкого типа; false, если у него есть собственный представитель или нет представителя
С момента:: 1.2
См. также:: isDisplayable()

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

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

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

isPreferredSizeSet

public boolean isPreferredSizeSet()

Возвращает true, если предпочтительный размер был установлен в значение, отличное от null, в противном случае возвращает false.

Возвращает:: true, если setPreferredSize был вызван со значением, отличным от null.
С момента:: 1.5

getPreferredSize

public Dimension getPreferredSize()

Получает предпочтительный размер этого компонента.

Возвращает:: объект Dimension, указывающий предпочтительный размер этого компонента
См. также:: getMinimumSize(), LayoutManager

preferredSize

@Deprecated
public Dimension preferredSize()

Устарело. С версии JDK 1.1 заменено на getPreferredSize().

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

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

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

isMinimumSizeSet

public boolean isMinimumSizeSet()

Возвращает true, если setMinimumSize был вызван со значением, отличным от null.

Возвращает:: true, если setMinimumSize был вызван со значением, отличным от null.
С момента:: 1.5

getMinimumSize

public Dimension getMinimumSize()

Получает минимальный размер этого компонента.

Возвращает:: объект Dimension, указывающий минимальный размер этого компонента
См. также:: getPreferredSize(), LayoutManager

minimumSize

@Deprecated
public Dimension minimumSize()

Устарело. С версии JDK 1.1 заменено на getMinimumSize().

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

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

Параметры:: maximumSize - Dimension, содержащий желаемый максимальный разрешённый размер
С момента:: 1.5
См. также:: getMaximumSize(), isMaximumSizeSet()

isMaximumSizeSet

public boolean isMaximumSizeSet()

Возвращает true, если максимальный размер был установлен в значение, отличное от null, в противном случае возвращает false.

Возвращает:: true, если maximumSize не null, false в противном случае
С момента:: 1.5

getMaximumSize

public Dimension getMaximumSize()

Получает максимальный размер этого компонента.

Возвращает:: объект Dimension, указывающий максимальный размер этого компонента
См. также:: getMinimumSize(), getPreferredSize(), LayoutManager

getAlignmentX

public float getAlignmentX()

Возвращает выравнивание по оси X. Это определяет, как компонент хочет быть выровнен относительно других компонентов. Значение должно быть числом от 0 до 1, где 0 соответствует выравниванию по началу, 1 - по концу, 0,5 - по центру и т.д.

getAlignmentY

public float getAlignmentY()

Возвращает выравнивание по оси Y. Это определяет, как компонент хочет быть выровнен относительно других компонентов. Значение должно быть числом от 0 до 1, где 0 соответствует выравниванию по началу, 1 - по концу, 0,5 - по центру и т.д.

getBaseline

public int getBaseline(int width,
                       int height)

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

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

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

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior()

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

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

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

doLayout

public void doLayout()

Заставляет менеджер компоновки разместить этот компонент. Обычно вызывается при валидации компонента (точнее, контейнера).

См. также:: validate(), LayoutManager

layout

@Deprecated
public void layout()

Устарело. С версии JDK 1.1 заменено на doLayout().

validate

public void validate()

Валидирует этот компонент.

Значение термина «валидировать» определяется предками этого класса. Подробнее см. Container.validate().

С момента:: JDK1.0
См. также:: invalidate(), doLayout(), LayoutManager, Container.validate()

invalidate

public void invalidate()

Делает невалидным этот компонент и его предков.

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

Этот метод может вызываться часто, поэтому он должен работать быстро.

С момента:: JDK1.0
См. также:: validate(), doLayout(), LayoutManager, Container.isValidateRoot()

revalidate

public void revalidate()

Перевалидирует иерархию компонентов до ближайшего корня валидации.

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

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

С момента:: 1.7
См. также:: Container.isValidateRoot()

getGraphics

public Graphics getGraphics()

Создаёт контекст графики для этого компонента. Этот метод вернёт null если этот компонент в данный момент не отображается.

Возвращает:: контекст графического отображения для данного компонента, или null если его нет
С:: JDK1.0
См. также:: paint(java.awt.Graphics)

getFontMetrics

public FontMetrics getFontMetrics(Font font)

Получает метрики шрифта для указанного шрифта. Предупреждение: Поскольку метрики шрифта зависят от FontRenderContext, а этот метод не предоставляет его, он может вернуть только метрики для контекста рендеринга по умолчанию, которые могут не соответствовать метрикам, используемым при рендеринге на компоненте, если используется функциональность Graphics2D. Вместо этого метрики можно получить во время рендеринга, вызвав Graphics.getFontMetrics() или API измерения текста для класса Font.

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

setCursor

public void setCursor(Cursor cursor)

Устанавливает изображение курсора на указанный курсор. Это изображение курсора отображается, когда метод contains для данного компонента возвращает true для текущего положения курсора, и этот компонент виден, отображается и активен. Установка курсора для Container вызывает отображение этого курсора во всех подкомпонентах контейнера, за исключением тех, у которых установлен не-null курсор.

Метод может не иметь визуального эффекта, если реализация Java платформы и/или родная система не поддерживают изменение формы курсора мыши.

Параметры:: cursor - Одна из констант, определённых классом Cursor; если этот параметр null, то этот компонент будет наследовать курсор от родительского
С:: JDK1.1
См. также:: isEnabled(), isShowing(), getCursor(), contains(int, int), Toolkit.createCustomCursor(java.awt.Image, java.awt.Point, java.lang.String), Cursor

getCursor

public Cursor getCursor()

Получает курсор, установленный в компоненте. Если в компоненте курсор не установлен, возвращается курсор родительского компонента. Если курсор не установлен ни в одной из компонент иерархии, возвращается Cursor.DEFAULT_CURSOR.

С:: JDK1.1
См. также:: setCursor(java.awt.Cursor)

isCursorSet

public boolean isCursorSet()

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

Возвращает:: true если курсор был явно установлен для данного компонента; false в противном случае.
С:: 1.4

paint

public void paint(Graphics g)

Отображает этот компонент.

Этот метод вызывается, когда содержимое компонента должно быть отображено; например, когда компонент впервые отображается или повреждён и нуждается в восстановлении. Прямоугольник обрезки в параметре Graphics устанавливается на область, которая должна быть отображена. Подклассы Component, которые переопределяют этот метод, не должны вызывать super.paint(g).

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

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

Параметры:: g - контекст графического отображения, который необходимо использовать для отображения
С:: JDK1.0
См. также:: update(java.awt.Graphics)

update

public void update(Graphics g)

Обновляет этот компонент.

Если этот компонент не является лёгким компонентом, AWT вызывает метод update в ответ на вызов repaint. Можно предположить, что фон не очищается.

Метод update класса Component вызывает метод paint этого компонента для перерисовки этого компонента. Этот метод обычно переопределяется подклассами, которые должны выполнить дополнительные действия в ответ на вызов repaint. Подклассы Component, переопределяющие этот метод, должны либо вызывать super.update(g), либо вызывать paint(g) напрямую из своего метода update.

Начало координат контекста графического отображения, его точка (0, 0), является верхним левым углом данного компонента. Область обрезки контекста графического отображения является ограничивающим прямоугольником данного компонента.

Параметры:: g - указанный контекст, используемый для обновления
С:: JDK1.0
См. также:: paint(java.awt.Graphics), repaint()

paintAll

public void paintAll(Graphics g)

Отображает этот компонент и все его подкомпоненты.

Начало координат контекста графического отображения, его точка (0, 0), является верхним левым углом данного компонента. Область обрезки контекста графического отображения — ограничивающий прямоугольник данного компонента.

Параметры:: g - контекст графического отображения, используемый для отображения
С:: JDK1.0
См. также:: paint(java.awt.Graphics)

repaint

public void repaint()

Перерисовывает этот компонент.

Если этот компонент является лёгким компонентом, этот метод вызывает метод paint этого компонента как можно скорее. В противном случае этот метод вызывает метод update этого компонента как можно скорее.

С:: JDK1.0
См. также:: update(Graphics)

repaint

public void repaint(long tm)

Перерисовывает компонент. Если этот компонент является лёгким компонентом, это приводит к вызову paint в течение tm миллисекунд.

Параметры:: tm - максимальное время в миллисекундах до обновления
С:: JDK1.0
См. также:: paint(java.awt.Graphics), update(Graphics)

repaint

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

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

Параметры:: x - координата x; y - координата y; width - ширина; height - высота
С:: JDK1.0
См. также:: update(Graphics)

repaint

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

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

Если этот компонент является лёгким компонентом, этот метод вызывает метод paint этого компонента. В противном случае этот метод вызывает метод update этого компонента.

Параметры:: tm - максимальное время в миллисекундах до обновления; x - координата x; y - координата y; width - ширина; height - высота
С:: JDK1.0
См. также:: update(Graphics)

print

public void print(Graphics g)

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

По умолчанию этот метод вызывает метод paint.

Начало координат контекста графического отображения, его точка (0, 0), является верхним левым углом данного компонента. Область обрезки контекста графического отображения — ограничивающий прямоугольник данного компонента.

Параметры:: g - графический контекст, используемый для печати
С тех пор:: JDK1.0
См. также:: paint(Graphics)

printAll

public void printAll(Graphics g)

Печатает этот компонент и все его подкомпоненты.

Начало графического контекста, его (0, 0) координатная точка, находится в левом верхнем углу этого компонента. Область обрезки графического контекста — это прямоугольник, ограничивающий этот компонент.

Параметры:: g - графический контекст, используемый для печати
С тех пор:: JDK1.0
См. также:: print(Graphics)

imageUpdate

public boolean imageUpdate(Image img,
                           int infoflags,
                           int x,
                           int y,
                           int w,
                           int h)

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

Метод imageUpdate компонента Component поэтапно отображает изображение на компоненте по мере поступления дополнительных битов изображения.

Если системная переменная awt.image.incrementaldraw отсутствует или имеет значение true, изображение отображается по частям. Если системная переменная имеет любое другое значение, то изображение не отображается, пока не будет загружено полностью.

Кроме того, если поэтапное отображение включено, значение системной переменной awt.image.redrawrate интерпретируется как целое число, задающее максимальную частоту перерисовки в миллисекундах. Если системная переменная отсутствует или не может быть интерпретирована как целое число, частота перерисовки составляет 100 мс.

Интерпретация аргументов x, y, width, и height зависит от значения аргумента infoflags.

Определено в:: imageUpdate в интерфейсе ImageObserver
Параметры:: img - наблюдаемое изображение; infoflags - см. imageUpdate для получения дополнительной информации; x - координата x; y - координата y; w - ширина; h - высота
Возвращает:: false , если флаги состояния указывают на полную загрузку изображения; true в противном случае.
С тех пор:: JDK1.0
См. также:: ImageObserver, Graphics.drawImage(Image, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, java.awt.image.ImageObserver), ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

createImage

public Image createImage(ImageProducer producer)

Создаёт изображение из указанного поставщика изображений.

Параметры:: producer - поставщик изображений
Возвращает:: созданное изображение
С тех пор:: JDK1.0

createImage

public Image createImage(int width,
                         int height)

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

Параметры:: width - указанная ширина; height - указанная высота
Возвращает:: отрисовываемое изображение вне экрана, которое можно использовать для буферизации двойного буфера. Возвращаемое значение может быть null, если компонент не отображается. Это всегда произойдёт, если GraphicsEnvironment.isHeadless() возвращает true.
С тех пор:: JDK1.0
См. также:: isDisplayable(), GraphicsEnvironment.isHeadless()

createVolatileImage

public VolatileImage createVolatileImage(int width,
                                         int height)

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

Параметры:: width - заданная ширина.; height - заданная высота.
Возвращает:: отрисовываемое изображение вне экрана, которое можно использовать для буферизации двойного буфера. Возвращаемое значение может быть null, если компонент не отображается. Это всегда произойдёт, если GraphicsEnvironment.isHeadless() возвращает true.
С тех пор:: 1.4
См. также:: VolatileImage, isDisplayable(), GraphicsEnvironment.isHeadless()

createVolatileImage

public VolatileImage createVolatileImage(int width,
                                         int height,
                                         ImageCapabilities caps)
                                  throws AWTException

Создаёт отрисовываемое изображение вне экрана, используемое для буферизации двойного буфера, с заданными возможностями. Содержимое этого изображения может быть потеряно в любой момент из-за проблем с операционной системой, поэтому изображение должно управляться с помощью интерфейса VolatileImage.

Параметры:: width - заданная ширина.; height - заданная высота.; caps - возможности изображения
Возвращает:: объект VolatileImage, который можно использовать для управления потерями содержимого поверхности и возможностями.
Исключения:: AWTException - если изображение с указанными возможностями не может быть создано
С тех пор:: 1.4
См. также:: VolatileImage

prepareImage

public boolean prepareImage(Image image,
                            ImageObserver observer)

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

Параметры:: image - Image, для которого подготавливается представление на экране; observer - объект ImageObserver, который уведомляется при подготовке изображения
Возвращает:: true , если изображение уже полностью подготовлено; false в противном случае
С тех пор:: JDK1.0

prepareImage

public boolean prepareImage(Image image,
                            int width,
                            int height,
                            ImageObserver observer)

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

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

Параметры:: image - экземпляр Image для которого подготавливается представление на экране; width - ширина желаемого представления на экране; height - высота желаемого представления на экране; observer - объект ImageObserver, который уведомляется при подготовке изображения
Возвращает:: true , если изображение уже полностью подготовлено; false в противном случае
С тех пор:: JDK1.0
См. также:: ImageObserver

checkImage

public int checkImage(Image image,
                      ImageObserver observer)

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

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

Информация о флагах, возвращаемых этим методом, содержится в описании интерфейса ImageObserver.

Параметры:: image - объект Image, чьё состояние проверяется; observer - объект ImageObserver, который уведомляется о подготовке изображения
Возвращает:: побитовое включительно ИЛИ ImageObserver флагов, показывающих какую информацию об изображении в данный момент доступна
С тех пор:: JDK1.0
См. также:: prepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserver

checkImage

public int checkImage(Image image,
                      int width,
                      int height,
                      ImageObserver observer)

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

Метод checkImage компонента Component вызывает метод checkImage своего пэра для расчёта флагов. Если у этого компонента ещё нет пэра, вместо этого вызывается метод checkImage инструментария компонента.

Информация о флагах, возвращаемых этим методом, содержится в описании интерфейса ImageObserver.

Параметры:: image - объект Image, чьё состояние проверяется; width - ширина масштабированного варианта, состояние которого проверяется; height - высота масштабированного варианта, состояние которого проверяется; observer - объект ImageObserver, который уведомляется о подготовке изображения
Возвращает:: побитовое включительно ИЛИ ImageObserver флагов, показывающих какую информацию об изображении в данный момент доступна
С тех пор:: JDK1.0
См. также:: prepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserver

setIgnoreRepaint

public void setIgnoreRepaint(boolean ignoreRepaint)

Устанавливает, следует ли игнорировать сообщения о перерисовке, полученные от операционной системы. Это не влияет на события перерисовки, генерируемые в программном обеспечении AWT, если только они не являются непосредственным ответом на сообщение о перерисовке на уровне ОС.

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

С момента:: 1.4
См. также:: getIgnoreRepaint(), Canvas.createBufferStrategy(int), Window.createBufferStrategy(int), BufferStrategy, GraphicsDevice.setFullScreenWindow(java.awt.Window)

getIgnoreRepaint

public boolean getIgnoreRepaint()

Возвращает:: следует ли игнорировать сообщения о перерисовке, полученные от операционной системы.
С момента:: 1.4
См. также:: setIgnoreRepaint(boolean)

contains

public boolean contains(int x,
                        int y)

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

Параметры:: x - координата x точки; y - координата y точки
С момента:: JDK1.1
См. также:: getComponentAt(int, int)

inside

@Deprecated
public boolean inside(int x,
                                  int y)

Устарело. С версии JDK 1.1 заменено на contains(int, int).

contains

public boolean contains(Point p)

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

Параметры:: p - точка
Исключения:: NullPointerException - если p является null
С момента:: JDK1.1
См. также:: getComponentAt(Point)

getComponentAt

public Component getComponentAt(int x,
                                int y)

Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов указанное расположение (x, y), и в случае успеха возвращает содержащий компонент. Этот метод ищет только на один уровень вглубь. Если точка (x, y) находится внутри подкомпонента, у которого есть свои подкомпоненты, он не ищет по дереву подкомпонентов.

Метод locate класса Component просто возвращает сам компонент, если расположение (x, y) находится внутри его ограничивающей рамки, и null в противном случае.

Параметры:: x - координата x; y - координата y
Возвращает:: компонент или подкомпонент, содержащий расположение (x, y); null если расположение находится вне этого компонента
С момента:: JDK1.0
См. также:: contains(int, int)

locate

@Deprecated
public Component locate(int x,
                                    int y)

Устарело. С версии JDK 1.1 заменено на getComponentAt(int, int).

getComponentAt

public Component getComponentAt(Point p)

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

Параметры:: p - точка
С момента:: JDK1.1
См. также:: contains(int, int)

deliverEvent

@Deprecated
public void deliverEvent(Event e)

Устарело. С версии JDK 1.1 заменено на dispatchEvent(AWTEvent e).

dispatchEvent

public final void dispatchEvent(AWTEvent e)

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

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

postEvent

@Deprecated
public boolean postEvent(Event e)

Устарело. С версии JDK 1.1 заменено на dispatchEvent(AWTEvent).

Определено в:: postEvent в интерфейсе MenuContainer

addComponentListener

public void addComponentListener(ComponentListener l)

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

См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.

Параметры:: l - слушатель событий компонентов
С момента:: JDK1.1
См. также:: ComponentEvent, ComponentListener, removeComponentListener(java.awt.event.ComponentListener), getComponentListeners()

removeComponentListener

public void removeComponentListener(ComponentListener l)

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

См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.

Параметры:: l - слушатель событий компонентов
С момента:: JDK1.1
См. также:: ComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), getComponentListeners()

getComponentListeners

public ComponentListener[] getComponentListeners()

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

Возвращает:: всех ComponentListener этого компонента или пустой массив, если слушатели событий компонентов не зарегистрированы
С момента:: 1.4
См. также:: addComponentListener(java.awt.event.ComponentListener), removeComponentListener(java.awt.event.ComponentListener)

addFocusListener

public void addFocusListener(FocusListener l)

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

См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.

Параметры:: l - слушатель событий фокуса
С момента:: JDK1.1
См. также:: FocusEvent, FocusListener, removeFocusListener(java.awt.event.FocusListener), getFocusListeners()

removeFocusListener

public void removeFocusListener(FocusListener l)

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

См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.

Параметры:: l - слушатель событий фокуса
С момента:: JDK1.1
См. также:: FocusEvent, FocusListener, addFocusListener(java.awt.event.FocusListener), getFocusListeners()

getFocusListeners

public FocusListener[] getFocusListeners()

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

Возвращает:: всех слушателей событий фокуса этого компонента или пустой массив, если слушатели событий фокуса не зарегистрированы
С момента:: 1.4
См. также:: addFocusListener(java.awt.event.FocusListener), removeFocusListener(java.awt.event.FocusListener)

addHierarchyListener

public void addHierarchyListener(HierarchyListener l)

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

См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.

Параметры:: l - слушатель изменений иерархии
С момента:: 1.3
См. также:: HierarchyEvent, HierarchyListener, removeHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()

removeHierarchyListener

public void removeHierarchyListener(HierarchyListener l)

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

Для получения подробной информации о модели потоков AWT см. AWT Threading Issues.

Parameters:: l - слушатель иерархии
Since:: 1.3
See Also:: HierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()

getHierarchyListeners

public HierarchyListener[] getHierarchyListeners()

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

Returns:: все слушатели иерархии этого компонента или пустой массив, если слушатели иерархии не зарегистрированы
Since:: 1.4
See Also:: addHierarchyListener(java.awt.event.HierarchyListener), removeHierarchyListener(java.awt.event.HierarchyListener)

addHierarchyBoundsListener

public void addHierarchyBoundsListener(HierarchyBoundsListener l)

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

Для получения подробной информации о модели потоков AWT см. AWT Threading Issues.

Parameters:: l - слушатель границ иерархии
Since:: 1.3
See Also:: HierarchyEvent, HierarchyBoundsListener, removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()

removeHierarchyBoundsListener

public void removeHierarchyBoundsListener(HierarchyBoundsListener l)

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

Для получения подробной информации о модели потоков AWT см. AWT Threading Issues.

Parameters:: l - слушатель границ иерархии
Since:: 1.3
See Also:: HierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()

getHierarchyBoundsListeners

public HierarchyBoundsListener[] getHierarchyBoundsListeners()

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

Returns:: все слушатели границ иерархии этого компонента или пустой массив, если слушатели границ иерархии не зарегистрированы
Since:: 1.4
See Also:: addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener)

addKeyListener

public void addKeyListener(KeyListener l)

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

Для получения подробной информации о модели потоков AWT см. AWT Threading Issues.

Parameters:: l - слушатель нажатия клавиш.
Since:: JDK1.1
See Also:: KeyEvent, KeyListener, removeKeyListener(java.awt.event.KeyListener), getKeyListeners()

removeKeyListener

public void removeKeyListener(KeyListener l)

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

Для получения подробной информации о модели потоков AWT см. AWT Threading Issues.

Parameters:: l - слушатель нажатия клавиш
Since:: JDK1.1
See Also:: KeyEvent, KeyListener, addKeyListener(java.awt.event.KeyListener), getKeyListeners()

getKeyListeners

public KeyListener[] getKeyListeners()

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

Returns:: все слушатели нажатия клавиш этого компонента или пустой массив, если слушатели нажатия клавиш не зарегистрированы
Since:: 1.4
See Also:: addKeyListener(java.awt.event.KeyListener), removeKeyListener(java.awt.event.KeyListener)

addMouseListener

public void addMouseListener(MouseListener l)

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

Для получения подробной информации о модели потоков AWT см. AWT Threading Issues.

Parameters:: l - слушатель мыши
Since:: JDK1.1
See Also:: MouseEvent, MouseListener, removeMouseListener(java.awt.event.MouseListener), getMouseListeners()

removeMouseListener

public void removeMouseListener(MouseListener l)

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

Для получения подробной информации о модели потоков AWT см. AWT Threading Issues.

Parameters:: l - слушатель мыши
Since:: JDK1.1
See Also:: MouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), getMouseListeners()

getMouseListeners

public MouseListener[] getMouseListeners()

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

Returns:: все слушатели мыши этого компонента или пустой массив, если слушатели мыши не зарегистрированы
Since:: 1.4
See Also:: addMouseListener(java.awt.event.MouseListener), removeMouseListener(java.awt.event.MouseListener)

addMouseMotionListener

public void addMouseMotionListener(MouseMotionListener l)

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

Для получения подробной информации о модели потоков AWT см. AWT Threading Issues.

Parameters:: l - слушатель движения мыши
Since:: JDK1.1
See Also:: MouseEvent, MouseMotionListener, removeMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()

removeMouseMotionListener

public void removeMouseMotionListener(MouseMotionListener l)

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

Для получения подробной информации о модели потоков AWT см. AWT Threading Issues.

Параметры:: l - слушатель перемещения мыши
С тех пор:: JDK1.1
См. также:: MouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()

getMouseMotionListeners

public MouseMotionListener[] getMouseMotionListeners()

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

Возвращает:: все слушатели перемещения мыши этого компонента или пустой массив, если слушатели не зарегистрированы
С тех пор:: 1.4
См. также:: addMouseMotionListener(java.awt.event.MouseMotionListener), removeMouseMotionListener(java.awt.event.MouseMotionListener)

addMouseWheelListener

public void addMouseWheelListener(MouseWheelListener l)

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

Для получения информации о том, как распределяются события прокрутки колесом мыши, см. описание класса MouseWheelEvent.

Если l равно null, исключение не генерируется, и действие не выполняется.

Подробную информацию о модели потоков AWT см. в AWT Threading Issues.

Параметры:: l - слушатель событий прокрутки колесом мыши
С тех пор:: 1.4
См. также:: MouseWheelEvent, MouseWheelListener, removeMouseWheelListener(java.awt.event.MouseWheelListener), getMouseWheelListeners()

removeMouseWheelListener

public void removeMouseWheelListener(MouseWheelListener l)

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

Подробную информацию о модели потоков AWT см. в AWT Threading Issues.

Параметры:: l - слушатель событий прокрутки колесом мыши.
С тех пор:: 1.4
См. также:: MouseWheelEvent, MouseWheelListener, addMouseWheelListener(java.awt.event.MouseWheelListener), getMouseWheelListeners()

getMouseWheelListeners

public MouseWheelListener[] getMouseWheelListeners()

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

Возвращает:: все слушатели событий прокрутки колесом мыши этого компонента или пустой массив, если слушатели не зарегистрированы
С тех пор:: 1.4
См. также:: addMouseWheelListener(java.awt.event.MouseWheelListener), removeMouseWheelListener(java.awt.event.MouseWheelListener)

addInputMethodListener

public void addInputMethodListener(InputMethodListener l)

Добавляет указанного слушателя событий ввода для получения событий ввода от этого компонента. Компонент будет получать события ввода от систем ввода только в том случае, если он также переопределяет getInputMethodRequests для возвращения экземпляра InputMethodRequests. Если слушатель l равен null, исключение не генерируется, и действие не выполняется.

Подробную информацию о модели потоков AWT см. в AWT Threading Issues.

Параметры:: l - слушатель событий ввода
С тех пор:: 1.2
См. также:: InputMethodEvent, InputMethodListener, removeInputMethodListener(java.awt.event.InputMethodListener), getInputMethodListeners(), getInputMethodRequests()

removeInputMethodListener

public void removeInputMethodListener(InputMethodListener l)

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

Подробную информацию о модели потоков AWT см. в AWT Threading Issues.

Параметры:: l - слушатель событий ввода
С тех пор:: 1.2
См. также:: InputMethodEvent, InputMethodListener, addInputMethodListener(java.awt.event.InputMethodListener), getInputMethodListeners()

getInputMethodListeners

public InputMethodListener[] getInputMethodListeners()

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

Возвращает:: все слушатели событий ввода этого компонента или пустой массив, если слушатели не зарегистрированы
С тех пор:: 1.4
См. также:: addInputMethodListener(java.awt.event.InputMethodListener), removeInputMethodListener(java.awt.event.InputMethodListener)

getListeners

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

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

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

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

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

Параметры:: listenerType - тип запрашиваемых слушателей; этот параметр должен указать интерфейс, наследуемый от java.util.EventListener
Возвращает:: массив всех объектов, зарегистрированных в качестве FooListener в этом компоненте, или пустой массив, если такие слушатели не были добавлены
Исключения:: ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener; NullPointerException - если listenerType равно null
С тех пор:: 1.3
См. также:: getComponentListeners(), getFocusListeners(), getHierarchyListeners(), getHierarchyBoundsListeners(), getKeyListeners(), getMouseListeners(), getMouseMotionListeners(), getMouseWheelListeners(), getInputMethodListeners(), getPropertyChangeListeners()

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()

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

Возвращает:: обработчик запросов систем ввода для этого компонента, по умолчанию null
С тех пор:: 1.2
См. также:: addInputMethodListener(java.awt.event.InputMethodListener)

getInputContext

public InputContext getInputContext()

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

Возвращает:: контекст ввода, используемый этим компонентом; null если контекст определить невозможно
С тех пор:: 1.2

enableEvents

protected final void enableEvents(long eventsToEnable)

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

Типы событий автоматически включаются при добавлении слушателя для данного типа события в компонент.

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

Параметры:: eventsToEnable - маска событий, определяющая типы событий
С тех пор:: JDK1.1
См. также:: processEvent(java.awt.AWTEvent), disableEvents(long), AWTEvent

disableEvents

protected final void disableEvents(long eventsToDisable)

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

Параметры:: eventsToDisable - маска событий, определяющая типы событий
С тех пор:: JDK1.1
См. также:: enableEvents(long)

coalesceEvents

protected AWTEvent coalesceEvents(AWTEvent existingEvent,
                                  AWTEvent newEvent)

Потенциально объединяет событие, которое отправляется с существующим событием. Этот метод вызывается EventQueue.postEvent , если событие с тем же ID, что и событие, которое должно быть отправлено, находится в очереди (оба события должны иметь этот компонент в качестве своего источника). Этот метод либо возвращает объединенное событие, которое заменяет существующее событие (а новое событие затем отбрасывается), либо null , чтобы указать, что объединение не должно выполняться (добавить второе событие в конец очереди). Любой параметр события может быть изменен и возвращен, поскольку другой отбрасывается, если только не возвращается null .

Эта реализация coalesceEvents объединяет два типа событий: события перемещения мыши (и перетаскивания) и события отрисовки (и обновления). Для событий перемещения мыши всегда возвращается последнее событие, что приводит к отбрасыванию промежуточных перемещений. Для событий отрисовки новое событие объединяется в сложное RepaintArea в сопоставленном объекте. Всегда возвращается новый AWTEvent.

Parameters:: existingEvent - событие, уже находящееся в EventQueue; newEvent - событие, отправляемое в EventQueue
Returns:: объединенное событие или null , указывающее, что объединение не было выполнено

processEvent

protected void processEvent(AWTEvent e)

Обрабатывает события, происходящие в этом компоненте. По умолчанию этот метод вызывает соответствующий метод process<event type>Event для данного класса событий.

Обратите внимание, что если параметр события равен null , поведение не определено и может привести к исключению.

Parameters:: e - событие
Since:: JDK1.1
See Also:: processComponentEvent(java.awt.event.ComponentEvent), processFocusEvent(java.awt.event.FocusEvent), processKeyEvent(java.awt.event.KeyEvent), processMouseEvent(java.awt.event.MouseEvent), processMouseMotionEvent(java.awt.event.MouseEvent), processInputMethodEvent(java.awt.event.InputMethodEvent), processHierarchyEvent(java.awt.event.HierarchyEvent), processMouseWheelEvent(java.awt.event.MouseWheelEvent)

processComponentEvent

protected void processComponentEvent(ComponentEvent e)

Обрабатывает события компонента, происходящие в этом компоненте, путем их отправки в любые зарегистрированные объекты ComponentListener .

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

Объект ComponentListener регистрируется через addComponentListener .
События компонента включены через enableEvents .

Parameters:: e - событие компонента
Since:: JDK1.1
See Also:: ComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), enableEvents(long)

processFocusEvent

protected void processFocusEvent(FocusEvent e)

Обрабатывает события фокуса, происходящие в этом компоненте, путем их отправки в любые зарегистрированные объекты FocusListener .

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

Объект FocusListener регистрируется через addFocusListener .
События фокуса включены через enableEvents .

Если события фокуса включены для Component , текущий KeyboardFocusManager определяет, следует ли отправлять событие фокуса зарегистрированным объектам FocusListener . Если события должны быть отправлены, KeyboardFocusManager вызывает метод dispatchEvent объекта Component , что приводит к вызову метода processFocusEvent объекта Component .

Если события фокуса включены для Component , вызов метода dispatchEvent объекта Component с FocusEvent в качестве аргумента приведет к вызову метода processFocusEvent объекта Component независимо от текущего KeyboardFocusManager .

Parameters:: e - событие фокуса
Since:: JDK1.1
See Also:: FocusEvent, FocusListener, KeyboardFocusManager, addFocusListener(java.awt.event.FocusListener), enableEvents(long), dispatchEvent(java.awt.AWTEvent)

processKeyEvent

protected void processKeyEvent(KeyEvent e)

Обрабатывает события клавиатуры, происходящие в этом компоненте, путем их отправки в любые зарегистрированные объекты KeyListener .

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

Объект KeyListener регистрируется через addKeyListener .
События клавиатуры включены через enableEvents .

Если события клавиатуры включены для Component , текущий KeyboardFocusManager определяет, следует ли отправлять событие клавиатуры зарегистрированным объектам KeyListener . DefaultKeyboardFocusManager не будет отправлять события клавиатуры Component , который не является владельцем фокуса или не отображается.

Начиная с J2SE 1.4, KeyEvent перенаправляются владельцу фокуса. Дополнительную информацию см. в Спецификации фокуса .

Вызов метода dispatchEvent объекта Component с KeyEvent в качестве аргумента приведет к вызову метода processKeyEvent объекта Component независимо от текущего KeyboardFocusManager , если компонент отображается, имеет фокус и включен, а события клавиатуры включены на нем.

Если параметр события равен null , поведение не определено и может привести к исключению.

Parameters:: e - событие клавиатуры
Since:: JDK1.1
See Also:: KeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, processEvent(java.awt.AWTEvent), dispatchEvent(java.awt.AWTEvent), addKeyListener(java.awt.event.KeyListener), enableEvents(long), isShowing()

processMouseEvent

protected void processMouseEvent(MouseEvent e)

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

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

Объект MouseListener регистрируется через addMouseListener .
События мыши включены через enableEvents .

Parameters:: e - событие мыши
Since:: JDK1.1
See Also:: MouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), enableEvents(long)

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

Обрабатывает события движения мыши, происходящие в этом компоненте, путем их отправки в любые зарегистрированные объекты MouseMotionListener .

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

Объект MouseMotionListener регистрируется через addMouseMotionListener .
События движения мыши включены через enableEvents .

Parameters:: e - событие движения мыши
Since:: JDK1.1
See Also:: MouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), enableEvents(long)

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent e)

Обрабатывает события колесика мыши, происходящие в этом компоненте, путем их отправки в любые зарегистрированные объекты MouseWheelListener .

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

Объект MouseWheelListener регистрируется через addMouseWheelListener .
События колесика мыши включены через enableEvents .

Для получения информации о том, как отправляются события колесика мыши, см. описание класса для MouseWheelEvent.

Параметры:: e - событие перетаскивания мыши
С тех пор:: 1.4
См. также:: MouseWheelEvent, MouseWheelListener, addMouseWheelListener(java.awt.event.MouseWheelListener), enableEvents(long)

processInputMethodEvent

protected void processInputMethodEvent(InputMethodEvent e)

Обрабатывает события ввода, происходящие на этом компоненте, рассылаю их всем зарегистрированным объектам InputMethodListener.

Этот метод не вызывается, если события ввода не включены для этого компонента. События ввода включаются в одном из следующих случаев:

Объект InputMethodListener зарегистрирован с помощью addInputMethodListener.
События ввода включены с помощью enableEvents.

Обратите внимание, что если параметр события null , поведение не определено и может привести к исключению.

Параметры:: e - событие ввода
С тех пор:: 1.2
См. также:: InputMethodEvent, InputMethodListener, addInputMethodListener(java.awt.event.InputMethodListener), enableEvents(long)

processHierarchyEvent

protected void processHierarchyEvent(HierarchyEvent e)

Обрабатывает события иерархии, происходящие на этом компоненте, рассылаю их всем зарегистрированным объектам HierarchyListener.

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

Объект HierarchyListener зарегистрирован с помощью addHierarchyListener.
События иерархии включены с помощью enableEvents.

Обратите внимание, что если параметр события null , поведение не определено и может привести к исключению.

Параметры:: e - событие иерархии
С тех пор:: 1.3
См. также:: HierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), enableEvents(long)

processHierarchyBoundsEvent

protected void processHierarchyBoundsEvent(HierarchyEvent e)

Обрабатывает события границ иерархии, происходящие на этом компоненте, рассылаю их всем зарегистрированным объектам HierarchyBoundsListener.

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

Объект HierarchyBoundsListener зарегистрирован с помощью addHierarchyBoundsListener.
События границ иерархии включены с помощью enableEvents.

Обратите внимание, что если параметр события null , поведение не определено и может привести к исключению.

Параметры:: e - событие иерархии
С тех пор:: 1.3
См. также:: HierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), enableEvents(long)

handleEvent

@Deprecated
public boolean handleEvent(Event evt)

Устарело. С JDK версии 1.1 заменено на processEvent(AWTEvent).

mouseDown

@Deprecated
public boolean mouseDown(Event evt,
                                     int x,
                                     int y)

Устарело. С JDK версии 1.1, заменено на processMouseEvent(MouseEvent).

mouseDrag

@Deprecated
public boolean mouseDrag(Event evt,
                                     int x,
                                     int y)

Устарело. С JDK версии 1.1, заменено на processMouseMotionEvent(MouseEvent).

mouseUp

@Deprecated
public boolean mouseUp(Event evt,
                                   int x,
                                   int y)

Устарело. С JDK версии 1.1, заменено на processMouseEvent(MouseEvent).

mouseMove

@Deprecated
public boolean mouseMove(Event evt,
                                     int x,
                                     int y)

Устарело. С JDK версии 1.1, заменено на processMouseMotionEvent(MouseEvent).

mouseEnter

@Deprecated
public boolean mouseEnter(Event evt,
                                      int x,
                                      int y)

Устарело. С JDK версии 1.1, заменено на processMouseEvent(MouseEvent).

mouseExit

@Deprecated
public boolean mouseExit(Event evt,
                                     int x,
                                     int y)

Устарело. С JDK версии 1.1, заменено на processMouseEvent(MouseEvent).

keyDown

@Deprecated
public boolean keyDown(Event evt,
                                   int key)

Устарело. С JDK версии 1.1, заменено на processKeyEvent(KeyEvent).

keyUp

@Deprecated
public boolean keyUp(Event evt,
                                 int key)

Устарело. С JDK версии 1.1, заменено на processKeyEvent(KeyEvent).

action

@Deprecated
public boolean action(Event evt,
                                  Object what)

Устарело. С JDK версии 1.1, необходимо зарегистрировать этот компонент как ActionListener на компоненте, который генерирует события действия.

addNotify

public void addNotify()

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

Этот метод изменяет информацию, связанную с макетом, и, следовательно, делает иерархию компонентов недействительной.

С тех пор:: JDK1.0
См. также:: isDisplayable(), removeNotify(), invalidate()

removeNotify

public void removeNotify()

Делает этот Component неотображаемым, уничтожив его ресурс нативного экрана.

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

С тех пор:: JDK1.0
См. также:: isDisplayable(), addNotify()

gotFocus

@Deprecated
public boolean gotFocus(Event evt,
                                    Object what)

Устарело. С JDK версии 1.1 заменено на processFocusEvent(FocusEvent).

lostFocus

@Deprecated
public boolean lostFocus(Event evt,
                                     Object what)

Устарело. С JDK версии 1.1 заменено на processFocusEvent(FocusEvent).

isFocusTraversable

@Deprecated
public boolean isFocusTraversable()

Устарело. С 1.4, заменено на isFocusable().

Возвращает, может ли этот Component стать владельцем фокуса.

Возвращает:: true , если этот Component фокусируемый; false в противном случае
С тех пор:: JDK1.1
См. также:: setFocusable(boolean)

isFocusable

public boolean isFocusable()

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

Возвращает:: true , если этот компонент может получить фокус; false в противном случае.
С тех пор:: 1.4
См. также:: setFocusable(boolean)

setFocusable

public void setFocusable(boolean focusable)

Устанавливает состояние фокусировки этого компонента в указанное значение. Это значение переопределяет фокусируемость по умолчанию компонента.

Параметры:: focusable - указывает, фокусируемый ли этот компонент
С тех пор:: 1.4
См. также:: isFocusable()

setFocusTraversalKeys

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

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

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

Идентификатор	Значение	Значение по умолчанию
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	Нормальное перемещение фокуса вперед с помощью клавиатуры	TAB при KEY_PRESSED, CTRL-TAB при KEY_PRESSED
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	Нормальное перемещение фокуса назад с помощью клавиатуры	SHIFT-TAB при KEY_PRESSED, CTRL-SHIFT-TAB при KEY_PRESSED
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	Перейти на один цикл перемещения фокуса вверх	нет

Для отключения клавиши перемещения используйте пустой набор; рекомендуется использовать Collections.EMPTY_SET.

Используя API AWTKeyStroke, код клиента может указать, на котором из двух конкретных событий KeyEvents, KEY_PRESSED или KEY_RELEASED, произойдет операция перемещения фокуса. Независимо от того, какое событие KeyEvent указано, однако, все события KeyEvents, связанные с клавишей перемещения фокуса, включая связанное событие KEY_TYPED, будут потреблены и не будут отправлены ни одному компоненту. Временная ошибка — указать событие KEY_TYPED в качестве отображения операции перемещения фокуса или отобразить одно и то же событие для нескольких операций перемещения фокуса по умолчанию.

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

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

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

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

Возвращает набор клавиш перехода фокуса для данной операции перехода фокуса для этого компонента. (См. setFocusTraversalKeys для полного описания каждой клавиши.)

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

Параметры:: id - один из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
Возвращает:: набор AWTKeyStrokes для указанной операции. Набор будет неизменяемым и может быть пустым. null никогда не возвращается.
Исключения:: IllegalArgumentException - если id не равен одному из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
С:: 1.4
См. также:: setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

Возвращает, был ли набор клавиш перехода фокуса для данной операции перехода фокуса явно определён для этого компонента. Если этот метод возвращает false, этот компонент наследует набор от предка или от текущего KeyboardFocusManager.

Параметры:: id - один из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
Возвращает:: true если набор клавиш перехода фокуса для данной операции перехода фокуса был явно определён для этого компонента; false в противном случае.
Исключения:: IllegalArgumentException - если id не равен одному из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
С:: 1.4

setFocusTraversalKeysEnabled

public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)

Устанавливает, включены ли клавиши перехода фокуса для этого компонента. Для компонентов, у которых клавиши перехода фокуса отключены, поступают события клавиш перехода фокуса. Для компонентов, у которых клавиши перехода фокуса включены, эти события не видны; вместо этого события автоматически преобразуются в операции перехода.

Параметры:: focusTraversalKeysEnabled - включены ли клавиши перехода фокуса для этого компонента
С:: 1.4
См. также:: getFocusTraversalKeysEnabled(), setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), getFocusTraversalKeys(int)

getFocusTraversalKeysEnabled

public boolean getFocusTraversalKeysEnabled()

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

Возвращает:: включены ли клавиши перехода фокуса для этого компонента
С:: 1.4
См. также:: setFocusTraversalKeysEnabled(boolean), setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), getFocusTraversalKeys(int)

requestFocus

public void requestFocus()

Запрашивает, чтобы этот компонент получил фокус ввода, а также чтобы его верхнеуровневый предок стал фокусированным окном. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением верхнеуровневого окна) должны быть видимыми, чтобы запрос был удовлетворён. Будут предприняты все усилия для выполнения запроса; однако в некоторых случаях это может быть невозможно. Разработчики никогда не должны предполагать, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED. Если этот запрос отклоняется, потому что верхнеуровневое окно этого компонента не может стать фокусированным окном, запрос будет запомнен и будет выполнен, когда окно позже получит фокус от пользователя.

Этот метод не может использоваться для установления компонента, не обладающего фокусом. Используйте KeyboardFocusManager.clearGlobalFocusOwner() вместо этого.

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

Примечание: Не все передачи фокуса происходят в результате вызова этого метода. Таким образом, компонент может получить фокус без вызова этого или любого другого requestFocus метода Component.

С:: JDK1.0
См. также:: requestFocusInWindow(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocus

protected boolean requestFocus(boolean temporary)

Запрашивает, чтобы этот Component получил фокус ввода, и чтобы верхнеуровневый предок этого Component стал фокусированным Window. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением верхнеуровневого окна) должны быть видимыми, чтобы запрос был удовлетворён. Будут предприняты все усилия для выполнения запроса; однако в некоторых случаях это может быть невозможно. Разработчики никогда не должны предполагать, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED. Если этот запрос отклоняется, потому что верхнеуровневое окно этого компонента не может стать фокусированным окном, запрос будет запомнен и будет выполнен, когда окно позже получит фокус от пользователя.

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

Этот метод не может использоваться для установления компонента, не обладающего фокусом. Используйте KeyboardFocusManager.clearGlobalFocusOwner вместо этого.

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

Параметры:: temporary - true, если изменение фокуса временное, например, когда окно теряет фокус; для получения дополнительной информации о временных изменениях фокуса см. Спецификацию фокуса
Возвращает:: false если запрос на изменение фокуса гарантированно завершится неудачей; true если он, вероятно, будет выполнен успешно
С:: 1.4
См. также:: FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocusInWindow

public boolean requestFocusInWindow()

Запрашивает, чтобы этот компонент получил фокус ввода, если непосредственный предок этого компонента уже является фокусированным окном. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением непосредственного предка — окна) должны быть видимыми, чтобы запрос был удовлетворён. Будет предпринята вся возможная попытка выполнить запрос; однако в некоторых случаях это может быть невозможно. Разработчики никогда не должны предполагать, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED.

Этот метод возвращает булево значение. Если возвращается false, запрос гарантированно завершится неудачно. Если возвращается true, запрос будет выполнен успешно, если он не будет отклонен или не произойдёт экстраординарное событие, например, утилизация объекта-представителя компонента, прежде чем запрос будет удовлетворён системой управления окнами. Опять же, хотя возвращаемое значение true указывает на то, что запрос, скорее всего, будет успешным, разработчики никогда не должны предполагать, что этот компонент является владельцем фокуса, пока компонент не получит событие FOCUS_GAINED.

Этот метод нельзя использовать для установки владельца фокуса в значение null. Используйте KeyboardFocusManager.clearGlobalFocusOwner() вместо этого.

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

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

Возвращает:: false если запрос на изменение фокуса гарантированно завершится неудачно; true если он, скорее всего, будет успешным
С тех пор:: 1.4
См. также:: requestFocus(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

Запрашивает, чтобы этот Component получил фокус ввода, если непосредственный предок этого Component уже является фокусированным Window. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением непосредственного предка — окна) должны быть видимыми, чтобы запрос был удовлетворён. Будет предпринята вся возможная попытка выполнить запрос; однако в некоторых случаях это может быть невозможно. Разработчики никогда не должны предполагать, что этот компонент является владельцем фокуса, пока компонент не получит событие FOCUS_GAINED.

Этот метод нельзя использовать для установки владельца фокуса в значение null. Используйте KeyboardFocusManager.clearGlobalFocusOwner вместо этого.

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

Параметры:: temporary - true, если изменение фокуса временное, например, когда окно теряет фокус; для получения дополнительной информации о временных изменениях фокуса см. Спецификацию фокуса
Возвращает:: false если запрос на изменение фокуса гарантированно завершится неудачно; true если он, скорее всего, будет успешным
С тех пор:: 1.4
См. также:: requestFocus(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

getFocusCycleRootAncestor

public Container getFocusCycleRootAncestor()

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

Возвращает:: ближайший предок этого компонента, являющийся корнем цикла прохождения фокуса
С тех пор:: 1.4
См. также:: Container.isFocusCycleRoot()

isFocusCycleRoot

public boolean isFocusCycleRoot(Container container)

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

Параметры:: container - контейнер, который нужно проверить
Возвращает:: true если указанный контейнер является корнем цикла прохождения фокуса для этого компонента; false в противном случае
С тех пор:: 1.4
См. также:: Container.isFocusCycleRoot()

transferFocus

public void transferFocus()

Передаёт фокус на следующий компонент, как если бы этот компонент был владельцем фокуса.

С тех пор:: JDK1.1
См. также:: requestFocus()

nextFocus

@Deprecated
public void nextFocus()

Устаревшее. С версии JDK 1.1 заменено на transferFocus().

transferFocusBackward

public void transferFocusBackward()

Передаёт фокус на предыдущий компонент, как если бы этот компонент был владельцем фокуса.

С тех пор:: 1.4
См. также:: requestFocus()

transferFocusUpCycle

public void transferFocusUpCycle()

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

С тех пор:: 1.4
См. также:: requestFocus(), Container.isFocusCycleRoot(), Container.setFocusCycleRoot(boolean)

hasFocus

public boolean hasFocus()

Возвращает true если этот Component является владельцем фокуса. Этот метод устарел и был заменён на isFocusOwner().

Возвращает:: true если этот Component является владельцем фокуса; false в противном случае
С тех пор:: 1.2

isFocusOwner

public boolean isFocusOwner()

Возвращает true если этот Component является владельцем фокуса.

Возвращает:: true если этот Component является владельцем фокуса; false в противном случае
С тех пор:: 1.4

add

public void add(PopupMenu popup)

Добавляет указанное всплывающее меню к компоненту.

Параметры:: popup - всплывающее меню, которое нужно добавить к компоненту.
Исключения:: NullPointerException - если popup является null
С тех пор:: JDK1.1
См. также:: remove(MenuComponent)

remove

public void remove(MenuComponent popup)

Удаляет указанное всплывающее меню из компонента.

Определено в:: remove в интерфейсе MenuContainer
Параметры:: popup - всплывающее меню, которое нужно удалить
С тех пор:: JDK1.1
См. также:: add(PopupMenu)

paramString

protected String paramString()

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

Возвращает:: строковое представление состояния этого компонента
С тех пор:: JDK1.0

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого компонента
С тех пор:: JDK1.0

list

public void list()

Выводит список этого компонента в стандартный поток вывода System.out.

С тех пор:: JDK1.0
См. также:: System.out

Список

public void list(PrintStream out)

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

Параметры:: out - поток вывода
Исключения:: NullPointerException - если out имеет значение null
С момента:: JDK1.0

Список

public void list(PrintStream out,
                 int indent)

Выводит список, начиная с указанного отступа, в указанный поток вывода.

Параметры:: out - поток вывода; indent - количество пробелов для отступа
Исключения:: NullPointerException - если out имеет значение null
С момента:: JDK1.0
См. также:: PrintStream.println(java.lang.Object)

Список

public void list(PrintWriter out)

Выводит список в указанный объект PrintWriter.

Параметры:: out - объект PrintWriter для вывода
Исключения:: NullPointerException - если out имеет значение null
С момента:: JDK1.1

Список

public void list(PrintWriter out,
                 int indent)

Выводит список, начиная с указанного отступа, в указанный объект PrintWriter.

Параметры:: out - объект PrintWriter для вывода; indent - количество пробелов для отступа
Исключения:: NullPointerException - если out имеет значение null
С момента:: JDK1.1
См. также:: PrintStream.println(java.lang.Object)

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

Шрифт компонента ("font")
Цвет фона компонента ("background")
Цвет переднего плана компонента ("foreground")
Возможность получения фокуса компонентом ("focusable")
Включен/выключен режим перемещения фокуса по клавишам ("focusTraversalKeysEnabled")
Набор клавиш для перемещения вперёд ("forwardFocusTraversalKeys")
Набор клавиш для перемещения назад ("backwardFocusTraversalKeys")
Набор клавиш для перемещения по уровням ("upCycleFocusTraversalKeys")
Предпочтительный размер компонента ("preferredSize")
Минимальный размер компонента ("minimumSize")
Максимальный размер компонента ("maximumSize")
Имя компонента ("name")

Обратите внимание, что если этот Component наследует связанное свойство, то событие не будет генерироваться в ответ на изменение наследуемого свойства.

Если listener является null, исключение не выбрасывается, и никаких действий не выполняется.

Параметры:: listener - обработчик изменений свойств
См. также:: removePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(), addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

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

Если listener равен null, исключение не выбрасывается, и никаких действий не выполняется.

Параметры:: listener - обработчик изменений свойств для удаления
См. также:: addPropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(), removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

Возвращает массив всех обработчиков изменений свойств, зарегистрированных в этом компоненте.

Возвращает:: все обработчики изменений свойств этого компонента или пустой массив, если обработчики изменений свойств не зарегистрированы
С момента:: 1.4
См. также:: addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), PropertyChangeSupport.getPropertyChangeListeners()

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)

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

Шрифт компонента ("font")
Цвет фона компонента ("background")
Цвет переднего плана компонента ("foreground")
Возможность получения фокуса компонентом ("focusable")
Включен/выключен режим перемещения фокуса по клавишам ("focusTraversalKeysEnabled")
Набор клавиш для перемещения вперёд ("forwardFocusTraversalKeys")
Набор клавиш для перемещения назад ("backwardFocusTraversalKeys")
Набор клавиш для перемещения по уровням ("upCycleFocusTraversalKeys")

Если propertyName или listener равно null, исключение не выбрасывается, и никаких действий не выполняется.

Параметры:: propertyName - одно из названий свойств, перечисленных выше; listener - обработчик изменений свойств
См. также:: removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName,
                                         PropertyChangeListener listener)

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

Если propertyName или listener равно null, исключение не выбрасывается, и никаких действий не выполняется.

Параметры:: propertyName - допустимое имя свойства; listener - обработчик изменений свойств для удаления
См. также:: addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), removePropertyChangeListener(java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

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

Возвращает:: все обработчики изменений свойств, связанные с указанным свойством; если такие слушатели не добавлены или если propertyName равно null, возвращается пустой массив
С момента:: 1.4
См. также:: addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners()

firePropertyChange

protected void firePropertyChange(String propertyName,
                                  Object oldValue,
                                  Object newValue)

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

setComponentOrientation

public void setComponentOrientation(ComponentOrientation o)

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

В момент создания ориентация компонента устанавливается в ComponentOrientation.UNKNOWN, что указывает на то, что она не была явно указана. Ориентация UNKNOWN ведет себя так же, как ComponentOrientation.LEFT_TO_RIGHT.

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

См. также:: ComponentOrientation, invalidate()

getComponentOrientation

public ComponentOrientation getComponentOrientation()

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

См. также:: ComponentOrientation

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation orientation)

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

Параметры:: orientation - новая ориентация компонента этого компонента и компонентов, содержащихся в нем.
Исключения:: NullPointerException - если orientation равно null.
С момента:: 1.4
См. также:: setComponentOrientation(java.awt.ComponentOrientation), getComponentOrientation(), invalidate()

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает AccessibleContext , связанный с этим Component. Реализованный данным базовым классом метод возвращает null. Классы, расширяющие Component, должны реализовать этот метод, чтобы вернуть AccessibleContext , связанный с подклассом.

Возвращает:: AccessibleContext этого Component
С момента:: 1.3

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