Класс 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`	Вложенный класс Component, используемый для предоставления стандартной поддержки доступности.
`static enum`	`Component.BaselineResizeBehavior`	Перечисление распространённых способов изменения базовой линии компонента при изменении размера.
`protected class`	`Component.BltBufferStrategy`	Вложенный класс для перерисовки поверхностей вне экрана на компоненте.
`protected class`	`Component.FlipBufferStrategy`	Вложенный класс для переключения буферов на компоненте.

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

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

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

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

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

Component()

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

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

Модификатор и тип	Метод	Описание
`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` отображаемым, подключив его к ресурсу native экрана.
`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, int width, int height, ImageObserver observer)`	Возвращает статус построения экранного представления указанного изображения.
`int`	`checkImage(Image image, 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(int width, int height)`	Создаёт изображениe без отображения для использования с буферизацией двойной буферизации.
`Image`	`createImage(ImageProducer producer)`	Создаёт изображение из указанного производителя изображений.
`VolatileImage`	`createVolatileImage(int width, int height)`	Создаёт динамическое изображениe без отображения для использования с буферизацией двойной буферизации.
`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 final void`	`disableEvents(long eventsToDisable)`	Отключает события, определённые указанным параметром маски событий, от доставки этому компоненту.
`final void`	`dispatchEvent(AWTEvent e)`	Пересылает событие этому компоненту или одному из его подкомпонентов.
`void`	`doLayout()`	Просит менеджер компоновки расположить этот компонент.
`void`	`enable()`	Устаревший. Начиная с версии JDK 1.1, заменён на `setEnabled(boolean)`.
`void`	`enable(boolean b)`	Устаревший. Начиная с версии JDK 1.1, заменён на `setEnabled(boolean)`.
`protected final 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)`	Отчитывается о связанном изменении свойства.
`void`	`firePropertyChange(String propertyName, short oldValue, short newValue)`	Отчитывается о связанном изменении свойства.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддержка отчётности о связанных изменениях свойств для свойств типа Object.
`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`.

END_OF_DOCUMENT_MARKER

`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()`	Возвращает родителя этого компонента.
`Dimension`	`getPreferredSize()`	Возвращает предпочтительный размер этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех слушателей изменений свойств, зарегистрированных на этом компоненте.
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)`	Возвращает массив всех слушателей, которые были связаны с заданным свойством.
`Dimension`	`getSize()`	Возвращает размер этого компонента в виде объекта `Dimension`.
`Dimension`	`getSize(Dimension rv)`	Сохраняет ширину/высоту этого компонента в «значении возврата» rv и возвращает rv.
`Toolkit`	`getToolkit()`	Возвращает инструментарий этого компонента.
`final 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()`	Возвращает значение true, если цвет фона был явно задан для этого компонента.
`boolean`	`isCursorSet()`	Возвращает значение true, если курсор был явно задан для этого компонента.
`boolean`	`isDisplayable()`	Определяет, отображается ли этот компонент.
`boolean`	`isDoubleBuffered()`	Возвращает true, если этот компонент нарисован на внеэкранном изображении («буфер»), которое копируется на экран позже.
`boolean`	`isEnabled()`	Определяет, включён ли этот компонент.
`boolean`	`isFocusable()`	Возвращает, может ли этот компонент получить фокус.
`boolean`	`isFocusCycleRoot(Container container)`	Возвращает, является ли указанный Контейнер корнем цикла обхода фокуса для цикла обхода фокуса этого компонента.
`boolean`	`isFocusOwner()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`boolean`	`isFocusTraversable()`	Устарело. С версии 1.4 заменено на `isFocusable()`.
`boolean`	`isFontSet()`	Возвращает значение true, если шрифт был явно задан для этого компонента.
`boolean`	`isForegroundSet()`	Возвращает значение true, если цвет переднего плана был явно задан для этого компонента.
`boolean`	`isLightweight()`	Легковесный компонент не имеет собственного инструментария.
`boolean`	`isMaximumSizeSet()`	Возвращает true, если максимальный размер был установлен на значение, отличное от `null`, в противном случае возвращает false.
`boolean`	`isMinimumSizeSet()`	Возвращает true, если `setMinimumSize` был вызван со значением, отличным от null.
`boolean`	`isOpaque()`	Возвращает true, если этот компонент полностью непрозрачен, по умолчанию возвращает false.

END_OF_DOCUMENT_MARKER

`boolean`	`isPreferredSizeSet()`	Возвращает true, если предпочтительный размер установлен в значение, отличное от `null`, иначе возвращает 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, int width, int height, ImageObserver observer)`	Подготавливает изображение для отрисовки на этом компоненте при указанной ширине и высоте.
`boolean`	`prepareImage(Image image, 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` и фокус окна для его родительского окна.
`protected boolean`	`requestFocus(FocusEvent.Cause cause)`	Запрашивает фокус ввода для этого `Component` по причине `cause` и фокус окна для его родительского окна.
`void`	`requestFocus(FocusEvent.Cause cause)`	Запрашивает фокус ввода для этого компонента по причине `cause` и фокус окна для его родительского окна.
`boolean`	`requestFocusInWindow()`	Запрашивает фокус ввода для этого компонента, если его родительское окно уже имеет фокус.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Запрашивает фокус ввода для этого `Component`, если его родительское окно уже имеет фокус.
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Запрашивает фокус ввода для этого компонента по причине `cause`, если его родительское окно уже имеет фокус.
`void`	`reshape(int x, int y, int width, int height)`	Устарело. С версии JDK 1.1 заменено на `setBounds(int, int, int, int)`.
`void`	`resize(int width, int height)`	Устарело. С версии JDK 1.1 заменено на `setSize(int, int)`.
`void`	`resize(Dimension d)`	Устарело. С версии JDK 1.1 заменено на `setSize(Dimension)`.
`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)`	Устанавливает состояние фокусируемости этого компонента на указанное значение.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Устанавливает клавиши перехода фокуса для данного действия перехода для этого компонента.
`void`	`setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)`	Устанавливает, включены ли клавиши перехода фокуса для этого компонента.
`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`	`setMixingCutoutShape(Shape shape)`	Устанавливает форму 'смешивания-вырезания' для этого лёгкого компонента.
`void`	`setName(String name)`	Устанавливает имя компонента на указанную строку.
`void`	`setPreferredSize(Dimension preferredSize)`	Устанавливает предпочтительный размер этого компонента на постоянное значение.
`void`	`setSize(int width, int height)`	Изменяет размер этого компонента на ширину `width` и высоту `height`.
`void`	`setSize(Dimension d)`	Изменяет размер этого компонента на ширину `d.width` и высоту `d.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()`	Передаёт фокус следующему компоненту, как если бы этот компонент был владельцем фокуса.
`void`	`transferFocusBackward()`	Передаёт фокус предыдущему компоненту, как если бы этот компонент был владельцем фокуса.
`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(). Указывает выравнивание по верхнему краю компонента.

См. также:

CENTER_ALIGNMENT

public static final float CENTER_ALIGNMENT

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

См. также:

BOTTOM_ALIGNMENT

public static final float BOTTOM_ALIGNMENT

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

См. также:

LEFT_ALIGNMENT

public static final float LEFT_ALIGNMENT

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

См. также:

RIGHT_ALIGNMENT

public static final float RIGHT_ALIGNMENT

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

См. также:

accessibleContext

protected AccessibleContext accessibleContext

%%CODE_BLOCK_601%%%, связанный с этим Component.

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

Component

protected Component()

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

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

getName

public String getName()

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

Возвращает:

имя этого компонента

С момента:

1.1

См. также:

setName(java.lang.String)

setName

public void setName(String name)

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

Параметры:

name - строка, которая будет именем этого компонента

С момента:

1.1

См. также:

getName()

getParent

public Container getParent()

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

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

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()

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

Возвращает:: инструмент для работы с этим компонентом
С момента:: 1.0

isValid

public boolean isValid()

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

Возвращает:

true если компонент допустим, false в противном случае

С момента:

1.0

См. также:

validate()
invalidate()

isDisplayable

public boolean isDisplayable()

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

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

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

Возвращает:

true если компонент отображаем, false в противном случае

С момента:

1.2

См. также:

isVisible

public boolean isVisible()

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

Возвращает:

true если компонент видим, false в противном случае

С момента:

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

public boolean isShowing()

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

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

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

Возвращает:

true если компонент отображается, false в противном случае

С:

1.0

См. также:

setVisible(boolean)

isEnabled

public boolean isEnabled()

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

Возвращает:

true если компонент включён, false в противном случае

С:

1.0

См. также:

setEnabled(boolean)

setEnabled

public void setEnabled(boolean b)

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

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

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

Параметры:

b - Если true, этот компонент включён; в противном случае этот компонент выключен

С:

1.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).

Включает или выключает этот компонент.

Параметры:: b - true для включения этого компонента; в противном случае false

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, отображает этот компонент; в противном случае скрывает этот компонент

С:

1.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).

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

Параметры:: b - true для отображения этого компонента; в противном случае false

hide

@Deprecated public void hide()

Устарело.

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

getForeground

public Color getForeground()

Возвращает цвет переднего плана этого компонента.

Возвращает:

цвет переднего плана этого компонента; если у этого компонента нет цвета переднего плана, возвращается цвет переднего плана родителя

С:

1.0

См. также:

setForeground(java.awt.Color)

setForeground

public void setForeground(Color c)

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

Параметры:

c - цвет, который станет цветом переднего плана этого компонента; если этот параметр null, то этот компонент будет унаследовать цвет переднего плана своего родителя

С:

1.0

См. также:

getForeground()

isForegroundSet

public boolean isForegroundSet()

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

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

getBackground

public Color getBackground()

Возвращает цвет фона этого компонента.

Возвращает:

цвет фона этого компонента; если у этого компонента нет цвета фона, возвращается цвет фона родителя

С:

1.0

См. также:

setBackground(java.awt.Color)

setBackground

public void setBackground(Color c)

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

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

Параметры:

c - цвет, который станет цветом фона этого компонента; если этот параметр null, то этот компонент будет унаследовать цвет фона своего родителя

С:

1.0

См. также:

getBackground()

isBackgroundSet

public boolean isBackgroundSet()

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

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

getFont

public Font getFont()

Возвращает шрифт этого компонента.

Определено в:

getFont в интерфейсе MenuContainer

Возвращает:

шрифт этого компонента; если шрифт не был задан для этого компонента, возвращается шрифт родителя

С:

1.0

См. также:

setFont(java.awt.Font)

setFont

public void setFont(Font f)

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

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

Параметры:

f - шрифт, который станет шрифтом этого компонента; если этот параметр null то этот компонент будет унаследовать шрифт своего родителя

С:

1.0

См. также:

getFont()
invalidate()

isFontSet

public boolean isFontSet()

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

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

getLocale

public Locale getLocale()

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

Возвращает:

локаль этого компонента; если у этого компонента нет локали, возвращается локаль его родителя

Исключения:

IllegalComponentStateException - если у Component нет собственной локали и он еще не добавлен в иерархию контейнеров, так что локаль не может быть определена из родительского контейнера

С:

1.1

См. также:

setLocale(java.util.Locale)

setLocale

public void setLocale(Locale l)

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

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

Параметры:

l - локаль, которая станет локалью этого компонента

С:

1.1

См. также:

getLocale()
invalidate()

getColorModel

public ColorModel getColorModel()

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

Возвращает:

модель цветов, используемая этим компонентом

С:

1.0

См. также:

ColorModel
ComponentPeer.getColorModel()
Toolkit.getColorModel()

getLocation

public Point getLocation()

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

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

Возвращает:

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

С:

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

С:

1.1

См. также:

getLocation()
setBounds(int, int, int, int)
invalidate()

move

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

Устарело.

Начиная с JDK версии 1.1, заменено на setLocation(int, int).

Перемещает этот компонент в новое расположение.

Параметры:: x - координата x верхнего левого угла нового расположения в пространстве координат родителя; y - координата y верхнего левого угла нового расположения в пространстве координат родителя

setLocation

public void setLocation(Point p)

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

Параметры:

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

С:

1.1

См. также:

getLocation()
setBounds(int, int, int, int)
invalidate()

getSize

public Dimension getSize()

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

Возвращает:

объект Dimension, указывающий размер этого компонента

С:

1.1

См. также:

setSize(int, int)

size

@Deprecated public Dimension size()

Устарело.

Начиная с JDK версии 1.1, заменено на getSize().

Возвращает размер этого компонента в виде объекта Dimension.

Возвращает:: объект Dimension, указывающий размер этого компонента

setSize

public void setSize(int width, int height)

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

Параметры:

width - новая ширина этого компонента в пикселях

height - новая высота этого компонента в пикселях

С:

1.1

См. также:

getSize()
setBounds(int, int, int, int)
invalidate()

resize

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

Устарело.

Начиная с JDK версии 1.1, заменено на setSize(int, int).

Изменяет размер этого компонента.

Параметры:: width - новая ширина компонента; height - новая высота компонента

setSize

public void setSize(Dimension d)

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

Параметры:

d - размер, определяющий новый размер этого компонента

Исключения:

NullPointerException - если d равен null

С:

1.1

См. также:

setSize(int, int)
setBounds(int, int, int, int)
invalidate()

resize

@Deprecated public void resize(Dimension d)

Устарело.

Начиная с JDK версии 1.1, заменено на setSize(Dimension).

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

Параметры:: d - новый размер этого компонента

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.

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

Parameters:

x - новые координаты x этого компонента

y - новые координаты y этого компонента

width - новый width этого компонента

height - новый height этого компонента

Since:

1.1

See Also:

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)

Deprecated.

С версии JDK 1.1 заменено на setBounds(int, int, int, int).

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

Parameters:: x - координата x левого верхнего угла прямоугольника; y - координата y левого верхнего угла прямоугольника; width - ширина прямоугольника; height - высота прямоугольника

setBounds

public void setBounds(Rectangle r)

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

Parameters:

r - новый прямоугольник ограничивающей области для этого компонента

Throws:

NullPointerException - если r является null

Since:

1.1

See Also:

getBounds()
setLocation(int, int)
setLocation(Point)
setSize(int, int)
setSize(Dimension)
invalidate()

getX

public int getX()

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

Returns:: текущую координату x начала координат компонента
Since:: 1.2

getY

public int getY()

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

Returns:: текущую координату y начала координат компонента
Since:: 1.2

getWidth

public int getWidth()

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

Returns:: текущую ширину этого компонента
Since:: 1.2

getHeight

public int getHeight()

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

Returns:: текущую высоту этого компонента
Since:: 1.2

getBounds

public Rectangle getBounds(Rectangle rv)

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

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

getSize

public Dimension getSize(Dimension rv)

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

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

getLocation

public Point getLocation(Point rv)

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

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

isOpaque

public boolean isOpaque()

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

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

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

Returns:

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

Since:

1.2

See Also:

isLightweight()

isLightweight

public boolean isLightweight()

Легковесный компонент не имеет родного компаньона инструментария. Подклассы Component и Container, кроме определенных в этом пакете, таких как Button или Scrollbar, являются легковесными. Все компоненты Swing являются легковесными.

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

Returns:

true, если у этого компонента есть лёгковесный компаньон; false, если у него есть родной компаньон или нет компаньона

Since:

1.2

See Also:

isDisplayable()

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

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

Parameters:

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

Since:

1.5

See Also:

getPreferredSize()
isPreferredSizeSet()

isPreferredSizeSet

public boolean isPreferredSizeSet()

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

Returns:: true, если setPreferredSize был вызван со значением, отличным от null.
Since:: 1.5

getPreferredSize

public Dimension getPreferredSize()

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

Returns:

объект Dimension, указывающий предпочтительный размер этого компонента

See Also:

preferredSize

@Deprecated public Dimension preferredSize()

Deprecated.

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

Возвращает предпочтительный размер компонента.

Returns:: предпочтительный размер компонента

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

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

Parameters:

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

Since:

1.5

See Also:

getMinimumSize()
isMinimumSizeSet()

isMinimumSizeSet

public boolean isMinimumSizeSet()

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

Returns:: true, если setMinimumSize был вызван со значением, отличным от null.
Since:: 1.5

getMinimumSize

public Dimension getMinimumSize()

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

Возвращает:

объект размера, указывающий минимальный размер этого компонента

См. также:

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, если максимальный размер был установлен на ненулевое значение, иначе возвращает false.

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

getMaximumSize

public Dimension getMaximumSize()

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

Возвращает:

объект размера, указывающий максимальный размер этого компонента

См. также:

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()

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

См. также:

layout

@Deprecated public void layout()

Устарело.

Начиная с версии JDK 1.1, заменено на doLayout().

validate

public void validate()

Проверяет этот компонент.

Значение термина проверка определяется предками этого класса. См. Container.validate() для получения дополнительной информации.

С:

1.0

См. также:

invalidate

public void invalidate()

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

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

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

С:

1.0

См. также:

revalidate

public void revalidate()

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

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

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

С:

1.7

См. также:

Container.isValidateRoot()

getGraphics

public Graphics getGraphics()

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

Возвращает:

контекст графики для этого компонента или null , если его нет

С:

1.0

См. также:

paint(java.awt.Graphics)

getFontMetrics

public FontMetrics getFontMetrics(Font font)

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

Параметры:

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

Возвращает:

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

С:

1.0

См. также:

getFont()
ComponentPeer.getFontMetrics(Font)
Toolkit.getFontMetrics(Font)

setCursor

public void setCursor(Cursor cursor)

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

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

Parameters:

cursor - Одна из констант, определенных классом Cursor; если этот параметр равен null, то этот компонент будет наследоваться курсор от своего родителя

Since:

1.1

See Also:

getCursor

public Cursor getCursor()

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

Returns:

курсор для этого компонента

Since:

1.1

See Also:

setCursor(java.awt.Cursor)

isCursorSet

public boolean isCursorSet()

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

Returns:: true если курсор был явно установлен для этого компонента; false в противном случае.
Since:: 1.4

paint

public void paint(Graphics g)

Рисует этот компонент.

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

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

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

Parameters:

g - контекст графики, используемый для рисования

Since:

1.0

See Also:

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

Parameters:

g - указанный контекст для обновления

Since:

1.0

See Also:

paint(java.awt.Graphics)
repaint()

paintAll

public void paintAll(Graphics g)

Рисует этот компонент и все его подкомпоненты.

Parameters:

g - контекст графики, используемый для рисования

Since:

1.0

See Also:

paint(java.awt.Graphics)

repaint

public void repaint()

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

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

Since:

1.0

See Also:

update(Graphics)

repaint

public void repaint(long tm)

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

Parameters:

tm - максимальное время в миллисекундах до обновления

Since:

1.0

See Also:

paint(java.awt.Graphics)
update(Graphics)

repaint

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

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

Parameters:

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

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

width - ширина

height - высота

Since:

1.0

See Also:

update(Graphics)

repaint

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

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

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

Parameters:

tm - максимальное время в миллисекундах до обновления

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

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

width - ширина

height - высота

Since:

1.0

See Also:

update(Graphics)

print

public void print(Graphics g)

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

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

Parameters:

g - контекст графики, используемый для печати

Since:

1.0

See Also:

paint(Graphics)

printAll

public void printAll(Graphics g)

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

Parameters:

g - контекст графики, используемый для печати

Since:

1.0

See Also:

print(Graphics)

END_OF_DOCUMENT_MARKER

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 в противном случае.

С:

1.0

См. также:

createImage

public Image createImage(ImageProducer producer)

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

Параметры:: producer - производитель изображений
Возвращает:: созданное изображение
С:: 1.0

createImage

public Image createImage(int width, int height)

Создаёт отключаемое изображение, предназначенное для двойной буферизации.

Параметры:

width - заданная ширина

height - заданная высота

Возвращает:

отключаемое изображение, которое можно использовать для двойной буферизации. Значение null, если компонент не отображается, или GraphicsEnvironment.isHeadless() возвращает true.

С:

1.0

См. также:

createVolatileImage

public VolatileImage createVolatileImage(int width, int height)

Создаёт летучее отключаемое изображение, предназначенное для двойной буферизации.

Параметры:

width - заданная ширина

height - заданная высота

Возвращает:

С:

1.4

См. также:

createVolatileImage

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

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

Параметры:

width - заданная ширина

height - заданная высота

caps - возможности изображения

Возвращает:

объект VolatileImage, который можно использовать для управления потерей содержимого поверхности и возможностями. Значение null, если компонент не отображается, или GraphicsEnvironment.isHeadless() возвращает true.

Исключения:

AWTException - если изображение с заданными возможностями создать невозможно

С:

1.4

См. также:

VolatileImage

prepareImage

public boolean prepareImage(Image image, ImageObserver observer)

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

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

prepareImage

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

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

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

Параметры:

image - экземпляр изображения, для которого необходимо подготовить экранное представление

width - ширина желаемого экранного представления

height - высота желаемого экранного представления

observer - объект, который будет уведомлён о подготовке изображения

Возвращает:

true если изображение уже полностью подготовлено; false в противном случае

С:

1.0

См. также:

ImageObserver

checkImage

public int checkImage(Image image, ImageObserver observer)

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

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

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

Параметры:

image - объект изображения, состояние которого проверяется

observer - объект, который будет уведомлён о подготовке изображения

Возвращает:

побитовое включительно ИЛИ флагов ImageObserver, указывающих, какая информация об изображении в настоящее время доступна

С:

1.0

См. также:

checkImage

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

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

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

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

Параметры:

image - объект изображения, состояние которого проверяется

width - ширина масштабированной копии, состояние которой проверяется

height - высота масштабированной копии, состояние которой проверяется

observer - объект, который будет уведомлён о подготовке изображения

Возвращает:

С:

1.0

См. также:

setIgnoreRepaint

public void setIgnoreRepaint(boolean ignoreRepaint)

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

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

Parameters:

ignoreRepaint - true ли сообщения о перерисовке от ОС должны игнорироваться; в противном случае false

Since:

1.4

See Also:

getIgnoreRepaint

public boolean getIgnoreRepaint()

Returns:

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

Since:

1.4

See Also:

setIgnoreRepaint(boolean)

contains

public boolean contains(int x, int y)

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

Parameters:

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

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

Returns:

true если точка находится внутри компонента; в противном случае false

Since:

1.1

See Also:

getComponentAt(int, int)

inside

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

Устарело.

Начиная с JDK версии 1.1, заменено на contains(int, int).

Проверяет, находится ли точка внутри этого компонента.

Parameters:: x - координата x точки; y - координата y точки
Returns:: true если точка находится внутри компонента; в противном случае false

contains

public boolean contains(Point p)

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

Parameters:

p - точка

Returns:

true если точка находится внутри компонента; в противном случае false

Throws:

NullPointerException - если p является null

Since:

1.1

See Also:

getComponentAt(Point)

getComponentAt

public Component getComponentAt(int x, int y)

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

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

Parameters:

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

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

Returns:

компонент или дочерний компонент, содержащий расположение (x, y); null если расположение находится вне этого компонента

Since:

1.0

See Also:

contains(int, int)

locate

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

Устарело.

Начиная с JDK версии 1.1, заменено на getComponentAt(int, int).

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

Parameters:: x - координата x для поиска компонентов; y - координата y для поиска компонентов
Returns:: компонент в указанном расположении или null

getComponentAt

public Component getComponentAt(Point p)

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

Parameters:

p - точка

Returns:

компонент в указанном расположении или null

Since:

1.1

See Also:

contains(int, int)

deliverEvent

@Deprecated public void deliverEvent(Event e)

Устарело.

Начиная с JDK версии 1.1, заменено на dispatchEvent(AWTEvent e).

Parameters:: e - событие для доставки

dispatchEvent

public final void dispatchEvent(AWTEvent e)

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

Parameters:: e - событие

postEvent

@Deprecated public boolean postEvent(Event e)

Устарело.

Начиная с JDK версии 1.1, заменено на dispatchEvent(AWTEvent).

Описание скопировано из интерфейса: MenuContainer

Отправляет событие слушателям.

Specified by:: postEvent в интерфейсе MenuContainer
Parameters:: e - событие для отправки
Returns:: результаты отправки события

addComponentListener

public void addComponentListener(ComponentListener l)

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

См. Проблемы с потоками AWT для получения дополнительной информации о модели потоков AWT.

Parameters:

l - слушатель событий компонента

Since:

1.1

See Also:

ComponentEvent
ComponentListener
removeComponentListener(java.awt.event.ComponentListener)
getComponentListeners()

removeComponentListener

public void removeComponentListener(ComponentListener l)

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

См. Проблемы с потоками AWT для получения дополнительной информации о модели потоков AWT.

Parameters:

l - слушатель событий компонента

Since:

1.1

See Also:

ComponentEvent
ComponentListener
addComponentListener(java.awt.event.ComponentListener)
getComponentListeners()

getComponentListeners

public ComponentListener[] getComponentListeners()

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

Returns:

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

Since:

1.4

See Also:

addComponentListener(java.awt.event.ComponentListener)
removeComponentListener(java.awt.event.ComponentListener)

addFocusListener

public void addFocusListener(FocusListener l)

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

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

Parameters:

l - слушатель фокуса

Since:

1.1

See Also:

FocusEvent
FocusListener
removeFocusListener(java.awt.event.FocusListener)
getFocusListeners()

removeFocusListener

public void removeFocusListener(FocusListener l)

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

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

Parameters:

l - слушатель фокуса

Since:

1.1

See Also:

FocusEvent
FocusListener
addFocusListener(java.awt.event.FocusListener)
getFocusListeners()

getFocusListeners

public FocusListener[] getFocusListeners()

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

Returns:

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

Since:

1.4

See Also:

addFocusListener(java.awt.event.FocusListener)
removeFocusListener(java.awt.event.FocusListener)

addHierarchyListener

public void addHierarchyListener(HierarchyListener l)

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

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

Parameters:

l - слушатель изменения иерархии

Since:

1.3

See Also:

HierarchyEvent
HierarchyListener
removeHierarchyListener(java.awt.event.HierarchyListener)
getHierarchyListeners()

removeHierarchyListener

public void removeHierarchyListener(HierarchyListener l)

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

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

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 Threading Issues для получения подробной информации о модели потоков AWT.

Parameters:

l - слушатель границ иерархии

Since:

1.3

See Also:

HierarchyEvent
HierarchyBoundsListener
removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener)
getHierarchyBoundsListeners()

removeHierarchyBoundsListener

public void removeHierarchyBoundsListener(HierarchyBoundsListener l)

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

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

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 Threading Issues для получения подробной информации о модели потоков AWT.

Parameters:

l - слушатель нажатия клавиш.

Since:

1.1

See Also:

KeyEvent
KeyListener
removeKeyListener(java.awt.event.KeyListener)
getKeyListeners()

removeKeyListener

public void removeKeyListener(KeyListener l)

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

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

Parameters:

l - обработчик событий нажатия клавиш

Since:

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

Parameters:

l - обработчик событий мыши

Since:

1.1

See Also:

MouseEvent
MouseListener
removeMouseListener(java.awt.event.MouseListener)
getMouseListeners()

removeMouseListener

public void removeMouseListener(MouseListener l)

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

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

Parameters:

l - обработчик событий мыши

Since:

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

Parameters:

l - обработчик событий движения мыши

Since:

1.1

See Also:

MouseEvent
MouseMotionListener
removeMouseMotionListener(java.awt.event.MouseMotionListener)
getMouseMotionListeners()

removeMouseMotionListener

public void removeMouseMotionListener(MouseMotionListener l)

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

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

Parameters:

l - обработчик событий движения мыши

Since:

1.1

See Also:

MouseEvent
MouseMotionListener
addMouseMotionListener(java.awt.event.MouseMotionListener)
getMouseMotionListeners()

getMouseMotionListeners

public MouseMotionListener[] getMouseMotionListeners()

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

Returns:

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

Since:

1.4

See Also:

addMouseMotionListener(java.awt.event.MouseMotionListener)
removeMouseMotionListener(java.awt.event.MouseMotionListener)

addMouseWheelListener

public void addMouseWheelListener(MouseWheelListener l)

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

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

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

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

Parameters:

l - обработчик событий прокрутки мыши

Since:

1.4

See Also:

MouseWheelEvent
MouseWheelListener
removeMouseWheelListener(java.awt.event.MouseWheelListener)
getMouseWheelListeners()

removeMouseWheelListener

public void removeMouseWheelListener(MouseWheelListener l)

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

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

Parameters:

l - обработчик событий прокрутки мыши.

Since:

1.4

See Also:

MouseWheelEvent
MouseWheelListener
addMouseWheelListener(java.awt.event.MouseWheelListener)
getMouseWheelListeners()

getMouseWheelListeners

public MouseWheelListener[] getMouseWheelListeners()

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

Returns:

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

Since:

1.4

See Also:

addMouseWheelListener(java.awt.event.MouseWheelListener)
removeMouseWheelListener(java.awt.event.MouseWheelListener)

addInputMethodListener

public void addInputMethodListener(InputMethodListener l)

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

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

Parameters:

l - слушатель событий ввода

Since:

1.2

See Also:

InputMethodEvent
InputMethodListener
removeInputMethodListener(java.awt.event.InputMethodListener)
getInputMethodListeners()
getInputMethodRequests()

removeInputMethodListener

public void removeInputMethodListener(InputMethodListener l)

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

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

Parameters:

l - слушатель событий ввода

Since:

1.2

See Also:

InputMethodEvent
InputMethodListener
addInputMethodListener(java.awt.event.InputMethodListener)
getInputMethodListeners()

getInputMethodListeners

public InputMethodListener[] getInputMethodListeners()

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

Returns:

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

Since:

1.4

See Also:

addInputMethodListener(java.awt.event.InputMethodListener)
removeInputMethodListener(java.awt.event.InputMethodListener)

getListeners

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

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

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

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

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

Type Parameters:

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

Parameters:

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

Returns:

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

Throws:

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

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

Since:

1.3

See Also:

getComponentListeners()
getFocusListeners()
getHierarchyListeners()
getHierarchyBoundsListeners()
getKeyListeners()
getMouseListeners()
getMouseMotionListeners()
getMouseWheelListeners()
getInputMethodListeners()
getPropertyChangeListeners()

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()

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

Returns:

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

Since:

1.2

See Also:

addInputMethodListener(java.awt.event.InputMethodListener)

getInputContext

public InputContext getInputContext()

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

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

enableEvents

protected final void enableEvents(long eventsToEnable)

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

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

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

Parameters:

eventsToEnable - маска событий, определяющая типы событий

Since:

1.1

See Also:

processEvent(java.awt.AWTEvent)
disableEvents(long)
AWTEvent

disableEvents

protected final void disableEvents(long eventsToDisable)

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

Parameters:

eventsToDisable - маска событий, определяющая типы событий

Since:

1.1

See Also:

enableEvents(long)

coalesceEvents

protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)

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

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

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

processEvent

protected void processEvent(AWTEvent e)

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

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

Parameters:

e - событие

Since:

1.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)

Обработка события изменения компонента

protected void processComponentEvent(ComponentEvent e)

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

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

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

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

Параметры:

e - событие изменения компонента

С:

1.1

См. также:

ComponentEvent
ComponentListener
addComponentListener(java.awt.event.ComponentListener)
enableEvents(long)

Обработка события фокуса

protected void processFocusEvent(FocusEvent e)

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

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

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

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

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

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

Параметры:

e - событие фокуса

С:

1.1

См. также:

FocusEvent
FocusListener
KeyboardFocusManager
addFocusListener(java.awt.event.FocusListener)
enableEvents(long)
dispatchEvent(java.awt.AWTEvent)

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

protected void processKeyEvent(KeyEvent e)

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

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

Объект KeyListener зарегистрирован с помощью addKeyListener.
События нажатия клавиш включены с помощью enableEvents.

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

Начиная с J2SE 1.4, события нажатия клавиш перенаправляются на владелец фокуса. Подробную информацию см. в Спецификации фокуса.

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

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

Параметры:

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

С:

1.1

См. также:

KeyEvent
KeyListener
KeyboardFocusManager
DefaultKeyboardFocusManager
processEvent(java.awt.AWTEvent)
dispatchEvent(java.awt.AWTEvent)
addKeyListener(java.awt.event.KeyListener)
enableEvents(long)
isShowing()

Обработка события мыши

protected void processMouseEvent(MouseEvent e)

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

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

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

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

Параметры:

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

С:

1.1

См. также:

MouseEvent
MouseListener
addMouseListener(java.awt.event.MouseListener)
enableEvents(long)

Обработка события движения мыши

protected void processMouseMotionEvent(MouseEvent e)

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

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

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

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

Параметры:

e - событие движения мыши

С:

1.1

См. также:

MouseEvent
MouseMotionListener
addMouseMotionListener(java.awt.event.MouseMotionListener)
enableEvents(long)

Обработка события колеса мыши

protected void processMouseWheelEvent(MouseWheelEvent e)

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

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

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

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

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

Параметры:

e - событие колеса мыши

С:

1.4

См. также:

MouseWheelEvent
MouseWheelListener
addMouseWheelListener(java.awt.event.MouseWheelListener)
enableEvents(long)

Обработка события ввода

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

Parameters:

e - событие иерархии

Since:

1.3

See Also:

HierarchyEvent
HierarchyListener
addHierarchyListener(java.awt.event.HierarchyListener)
enableEvents(long)

processHierarchyBoundsEvent

protected void processHierarchyBoundsEvent(HierarchyEvent e)

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

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

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

Parameters:

e - событие иерархии

Since:

1.3

See Also:

HierarchyEvent
HierarchyBoundsListener
addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener)
enableEvents(long)

handleEvent

@Deprecated public boolean handleEvent(Event evt)

Устарело.

Начиная с JDK версии 1.1, заменено на processEvent(AWTEvent).

Parameters:: evt - обрабатываемое событие
Returns:: true если событие было обработано, false в противном случае

mouseDown

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

Устарело.

Начиная с JDK версии 1.1, заменено на processMouseEvent(MouseEvent).

Parameters:: evt - обрабатываемое событие; x - координата x; y - координата y
Returns:: false

mouseDrag

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

Устарело.

Начиная с JDK версии 1.1, заменено на processMouseMotionEvent(MouseEvent).

Parameters:: evt - обрабатываемое событие; x - координата x; y - координата y
Returns:: false

mouseUp

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

Устарело.

Начиная с JDK версии 1.1, заменено на processMouseEvent(MouseEvent).

Parameters:: evt - обрабатываемое событие; x - координата x; y - координата y
Returns:: false

mouseMove

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

Устарело.

Начиная с JDK версии 1.1, заменено на processMouseMotionEvent(MouseEvent).

Parameters:: evt - обрабатываемое событие; x - координата x; y - координата y
Returns:: false

mouseEnter

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

Устарело.

Начиная с JDK версии 1.1, заменено на processMouseEvent(MouseEvent).

Parameters:: evt - обрабатываемое событие; x - координата x; y - координата y
Returns:: false

mouseExit

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

Устарело.

Начиная с JDK версии 1.1, заменено на processMouseEvent(MouseEvent).

Parameters:: evt - обрабатываемое событие; x - координата x; y - координата y
Returns:: false

keyDown

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

Устарело.

Начиная с JDK версии 1.1, заменено на processKeyEvent(KeyEvent).

Parameters:: evt - обрабатываемое событие; key - нажатая клавиша
Returns:: false

keyUp

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

Устарело.

Начиная с JDK версии 1.1, заменено на processKeyEvent(KeyEvent).

Parameters:: evt - обрабатываемое событие; key - нажатая клавиша
Returns:: false

action

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

Устарело.

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

Parameters:: evt - обрабатываемое событие; what - объект, над которым выполняется действие
Returns:: false

addNotify

public void addNotify()

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

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

Since:

1.0

See Also:

isDisplayable()
removeNotify()
invalidate()

removeNotify

public void removeNotify()

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

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

Since:

1.0

See Also:

isDisplayable()
addNotify()

gotFocus

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

Устарело.

Начиная с JDK версии 1.1, заменено на processFocusEvent(FocusEvent).

Parameters:: evt - обрабатываемое событие; what - объект, получивший фокус
Returns:: false

lostFocus

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

Устарело.

Начиная с JDK версии 1.1, заменено на processFocusEvent(FocusEvent).

Parameters:: evt - обрабатываемое событие; what - объект, потерявший фокус
Returns:: false

isFocusTraversable

@Deprecated public boolean isFocusTraversable()

Устарело.

Начиная с 1.4, заменено на isFocusable().

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

Returns:

true если этот Component может получить фокус; false в противном случае

Since:

1.1

See Also:

setFocusable(boolean)

isFocusable

public boolean isFocusable()

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

Returns:

true если этот компонент может получить фокус; false в противном случае.

Since:

1.4

See Also:

setFocusable(boolean)

setFocusable

public void setFocusable(boolean focusable)

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

Parameters:

focusable - указывает, является ли этот компонент Component фокусируемым

Since:

1.4

See Also:

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 указано, все события KeyEvent, связанные с клавишей перемещения фокуса, включая соответствующее событие KEY_TYPED, будут обработаны и не будут перенаправлены ни одному компоненту. При попытке указать событие KEY_TYPED как сопоставление с операцией перемещения фокуса или сопоставления одного события с несколькими операциями перемещения фокуса по умолчанию возникнет ошибка во время выполнения.

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

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

Parameters:

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

keystrokes - набор AWTKeyStroke для указанной операции

Throws:

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

Since:

1.4

See Also:

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

Parameters:

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

Returns:

набор AWTKeyStrokes для указанной операции. Набор будет неизменяемым и может быть пустым. null никогда не будет возвращен.

Throws:

Since:

1.4

See Also:

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

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

Parameters:: id - одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
Returns:: true если набор клавиш перемещения фокуса для данной операции перемещения фокуса был явно определен для этого компонента; false в противном случае.
Throws:: IllegalArgumentException - если id не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
Since:: 1.4

setFocusTraversalKeysEnabled

public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)

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

Parameters:

focusTraversalKeysEnabled - флаг, указывающий, включены ли клавиши перемещения фокуса для этого компонента

Since:

1.4

See Also:

getFocusTraversalKeysEnabled()
setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>)
getFocusTraversalKeys(int)

getFocusTraversalKeysEnabled

public boolean getFocusTraversalKeysEnabled()

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

Returns:

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

Since:

1.4

See Also:

setFocusTraversalKeysEnabled(boolean)
setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>)
getFocusTraversalKeys(int)

requestFocus

public void requestFocus()

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

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

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

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

Since:

1.0

See Also:

requestFocusInWindow()
FocusEvent
addFocusListener(java.awt.event.FocusListener)
isFocusable()
isDisplayable()
KeyboardFocusManager.clearGlobalFocusOwner()

requestFocus

public void requestFocus(FocusEvent.Cause cause)

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

Эффект запроса на получение фокуса также может зависеть от переданного значения причины. Если запрос выполнен успешно, сгенерированное в результате событие {FocusEvent} получит значение причины, заданное в качестве аргумента метода. Если запрос отклонен из-за того, что родительское окно компонента не может стать активным окном, запрос будет запомнен и выполнен, когда окно позже получит фокус от пользователя.

Данный метод нельзя использовать для снятия фокуса со всех компонентов. Используйте KeyboardFocusManager.clearGlobalFocusOwner() вместо этого.

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

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

Parameters:

cause - причина, по которой запрашивается фокус

Since:

See Also:

requestFocus

protected boolean requestFocus(boolean temporary)

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

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

Данный метод нельзя использовать для снятия фокуса со всех компонентов. Используйте KeyboardFocusManager.clearGlobalFocusOwner вместо этого.

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

Parameters:

temporary - true, если изменение фокуса временное, например, при потере фокуса окном; для получения дополнительной информации о временных изменениях фокуса обратитесь к Спецификации фокуса

Returns:

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

Since:

1.4

See Also:

requestFocus

protected boolean requestFocus(boolean temporary, FocusEvent.Cause cause)

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

Parameters:

cause - причина, по которой запрашивается фокус

Returns:

Since:

See Also:

requestFocusInWindow

public boolean requestFocusInWindow()

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

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

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

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

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

Returns:

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

Since:

1.4

See Also:

requestFocus()
FocusEvent
addFocusListener(java.awt.event.FocusListener)
isFocusable()
isDisplayable()
KeyboardFocusManager.clearGlobalFocusOwner()

requestFocusInWindow

public boolean requestFocusInWindow(FocusEvent.Cause cause)

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

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

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

Parameters:

cause - причина, по которой запрашивается фокус

Returns:

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

Since:

See Also:

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

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

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

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

Parameters:

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

Returns:

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

Since:

1.4

See Also:

requestFocus()
FocusEvent
addFocusListener(java.awt.event.FocusListener)
isFocusable()
isDisplayable()
KeyboardFocusManager.clearGlobalFocusOwner()

getFocusCycleRootAncestor

public Container getFocusCycleRootAncestor()

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

Returns:

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

Since:

1.4

See Also:

Container.isFocusCycleRoot()

isFocusCycleRoot

public boolean isFocusCycleRoot(Container container)

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

Parameters:

container - контейнер, подлежащий проверке

Returns:

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

Since:

1.4

See Also:

Container.isFocusCycleRoot()

transferFocus

public void transferFocus()

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

Since:

1.1

See Also:

requestFocus()

nextFocus

@Deprecated public void nextFocus()

Устарело.

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

transferFocusBackward

public void transferFocusBackward()

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

Since:

1.4

See Also:

requestFocus()

transferFocusUpCycle

public void transferFocusUpCycle()

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

Since:

1.4

See Also:

hasFocus

public boolean hasFocus()

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

Returns:: true если этот Component является владельцем фокуса; false в противном случае
Since:: 1.2

isFocusOwner

public boolean isFocusOwner()

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

Returns:: true если этот Component является владельцем фокуса; false в противном случае
Since:: 1.4

add

public void add(PopupMenu popup)

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

Parameters:

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

Throws:

NullPointerException - если popup является null

Since:

1.1

See Also:

remove(MenuComponent)

remove

public void remove(MenuComponent popup)

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

Specified by:

remove в интерфейсе MenuContainer

Parameters:

popup - всплывающее меню, которое необходимо удалить

Since:

1.1

See Also:

add(PopupMenu)

paramString

protected String paramString()

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

Returns:: строковое представление состояния этого компонента
Since:: 1.0

toString

public String toString()

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

Overrides:: toString в классе Object
Returns:: строковое представление этого компонента
Since:: 1.0

list

public void list()

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

Since:

1.0

See Also:

System.out

list

public void list(PrintStream out)

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

Parameters:: out - поток вывода
Throws:: NullPointerException - если out является null
Since:: 1.0

list

public void list(PrintStream out, int indent)

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

Parameters:

out - поток вывода

indent - количество пробелов для отступа

Throws:

NullPointerException - если out является null

Since:

1.0

See Also:

PrintStream.println(java.lang.Object)

list

public void list(PrintWriter out)

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

Parameters:: out - объект PrintWriter для вывода
Throws:: NullPointerException - если out является null
Since:: 1.1

list

public void list(PrintWriter out, int indent)

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

Parameters:

out - объект PrintWriter для вывода

indent - количество пробелов для отступа

Throws:

NullPointerException - если out является null

Since:

1.1

See Also:

PrintStream.println(java.lang.Object)

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

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

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

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

Parameters:

listener - слушатель изменений свойств, который нужно добавить

See Also:

removePropertyChangeListener(java.beans.PropertyChangeListener)
getPropertyChangeListeners()
addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

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

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

Parameters:

listener - удаляемый слушатель изменений свойств

See Also:

addPropertyChangeListener(java.beans.PropertyChangeListener)
getPropertyChangeListeners()
removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

Returns:

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

Since:

1.4

See Also:

addPropertyChangeListener(java.beans.PropertyChangeListener)
removePropertyChangeListener(java.beans.PropertyChangeListener)
getPropertyChangeListeners(java.lang.String)
PropertyChangeSupport.getPropertyChangeListeners()

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

шрифт этого компонента ("font")
цвет фона этого компонента ("background")
цвет переднего плана этого компонента ("foreground")
признак фокусируемости этого компонента ("focusable")
состояние включения/выключения клавиш перехода фокуса для этого компонента ("focusTraversalKeysEnabled")
множество клавиш перехода фокуса вперёд ("forwardFocusTraversalKeys")
множество клавиш перехода фокуса назад ("backwardFocusTraversalKeys")
множество клавиш перехода фокуса вверх по циклу ("upCycleFocusTraversalKeys")

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

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

Parameters:

propertyName - одно из названий свойств, перечисленных выше

listener - слушатель изменения свойств, который нужно добавить

See Also:

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)

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

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

Parameters:

propertyName - допустимое имя свойства

listener - PropertyChangeListener, который нужно удалить

See Also:

addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)
getPropertyChangeListeners(java.lang.String)
removePropertyChangeListener(java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

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

Parameters:

propertyName - имя свойства

Returns:

все PropertyChangeListener , связанные с указанным свойством; если такие слушатели не были добавлены или propertyName равно null, возвращается пустой массив

Since:

1.4

See Also:

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.

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

Parameters:

propertyName - программное имя свойства, которое было изменено

oldValue - старое значение свойства (как байт)

newValue - новое значение свойства (как байт)

Since:

1.5

See Also:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

Parameters:

propertyName - программное имя свойства, которое было изменено

oldValue - старое значение свойства (как символ)

newValue - новое значение свойства (как символ)

Since:

1.5

See Also:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

Parameters:

propertyName - программное имя свойства, которое было изменено

oldValue - старое значение свойства (как короткое целое)

newValue - новое значение свойства (как короткое целое)

Since:

1.5

See Also:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

Parameters:

propertyName - программное имя свойства, которое было изменено

oldValue - старое значение свойства (как длинное целое)

newValue - новое значение свойства (как длинное целое)

Since:

1.5

See Also:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

Parameters:

propertyName - программное имя свойства, которое было изменено

oldValue - старое значение свойства (как число с плавающей точкой)

newValue - новое значение свойства (как число с плавающей точкой)

Since:

1.5

See Also:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

Parameters:

propertyName - программное имя свойства, которое было изменено

oldValue - старое значение свойства (как двойное число)

newValue - новое значение свойства (как двойное число)

Since:

1.5

See Also:

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.

Parameters:

o - направление, которое нужно установить

See Also:

getComponentOrientation

public ComponentOrientation getComponentOrientation()

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

Возвращает:

ориентацию для упорядочения элементов или текста

См. также:

ComponentOrientation

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation orientation)

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

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

Параметры:

orientation - новая ориентация компонента для этого компонента и компонентов, содержащихся в нем.

Исключения:

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

См. также:

setComponentOrientation(java.awt.ComponentOrientation)
getComponentOrientation()
invalidate()

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Возвращает:: AccessibleContext этого Component
См. также:: new Rectangle()

setMixingCutoutShape

public void setMixingCutoutShape(Shape shape)

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

Аргумент shape может иметь следующие значения:

null - возвращает форму вырезания по умолчанию (прямоугольник, равный getBounds() компонента)
пустая-форма - не вырезает ничего из тяжёлых компонентов. Это делает этот лёгкий компонент эффективным прозрачным. Обратите внимание, что потомки лёгкого компонента по-прежнему влияют на формы тяжёлых компонентов. Примером пустой-формы является new Rectangle().
не-пустая-форма - заданная форма будет вырезана из тяжёлых компонентов.

Наиболее распространённым примером, когда нужна форма «вырезания смешивания», является компонент-стекло. Метод JRootPane.setGlassPane(java.awt.Component) автоматически устанавливает пустую-форму как форму «вырезания смешивания» для данного компонента-стекла. Если разработчику нужен другой вид формы «вырезания смешивания» для компонента-стекла (что редко), это нужно изменить вручную после установки компонента-стекла в основной области.

Параметры:: shape - новая форма «вырезания смешивания»
См. также:: new Rectangle()

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