Класс 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

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

Класс 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 и всего, на что он ссылается. Проблема в том, что слушатель сериализуем случайно, а не по design. Чтобы отделить решения о 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.

Подробную информацию о системе фокусировки см. в Как использовать подсистему фокуса, разделе учебника The Java Tutorial, а также в Спецификации фокуса для получения дополнительной информации.

См. также:

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

Модификатор и тип	Класс	Описание
`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`	Создаёт новый компонент.

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

Modifier and Type	Method	Description
`boolean`	`action(Event evt, Object what)`	Устарело. С версии JDK 1.1, необходимо зарегистрировать этот компонент как ActionListener на компоненте, который генерирует события действия.
`void`	`add(PopupMenu popup)`	Добавляет указанное всплывающее меню к компоненту.
`void`	`addComponentListener(ComponentListener l)`	Добавляет указанный слушатель компонентных событий для получения событий компонент от этого компонента.
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента при получении им фокуса ввода.
`void`	`addHierarchyBoundsListener(HierarchyBoundsListener l)`	Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента, когда иерархия, к которой принадлежит этот контейнер, изменяется.
`void`	`addHierarchyListener(HierarchyListener l)`	Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента, когда иерархия, к которой принадлежит этот контейнер, изменяется.
`void`	`addInputMethodListener(InputMethodListener l)`	Добавляет указанный слушатель методов ввода для получения событий методов ввода от этого компонента.
`void`	`addKeyListener(KeyListener l)`	Добавляет указанный слушатель нажатий клавиш для получения событий нажатий клавиш от этого компонента.
`void`	`addMouseListener(MouseListener l)`	Добавляет указанного слушателя мыши для получения событий мыши от этого компонента.
`void`	`addMouseMotionListener(MouseMotionListener l)`	Добавляет указанного слушателя перемещения мыши для получения событий перемещения мыши от этого компонента.
`void`	`addMouseWheelListener(MouseWheelListener l)`	Добавляет указанного слушателя колёсика мыши для получения событий колёсика мыши от этого компонента.
`void`	`addNotify()`	Делает этот `Component` отображаемым, подключив его к ресурсу нативного экрана.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей для определённого свойства.
`void`	`applyComponentOrientation(ComponentOrientation orientation)`	Устанавливает свойство `ComponentOrientation` этого компонента и всех содержащихся в нём компонентов.
`boolean`	`areFocusTraversalKeysSet(int id)`	Возвращает, было ли явно определено множество клавиш перехода фокуса для данного действия перехода фокуса для этого компонента.
`Rectangle`	`bounds()`	Устарело. С версии JDK 1.1, заменено на `getBounds()`.
`int`	`checkImage(Image image, 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)`	Создаёт изображение для отрисовки вне экрана для использования в двойной буферизации.
`Image`	`createImage(ImageProducer producer)`	Создаёт изображение из указанного производителя изображений.
`VolatileImage`	`createVolatileImage(int width, int height)`	Создаёт летучее изображение для отрисовки вне экрана для использования в двойной буферизации.
`VolatileImage`	`createVolatileImage(int width, int height, ImageCapabilities caps)`	Создаёт летучее изображение для отрисовки вне экрана с заданными возможностями.
`void`	`deliverEvent(Event e)`	Устарело. С версии JDK 1.1, заменено на `dispatchEvent(AWTEvent e)`.
`void`	`disable()`	Устарело. С версии JDK 1.1, заменено на `setEnabled(boolean)`.
`protected 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`.
`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()`	Возвращает, был ли явно установлен цвет фона для этого компонента.
`boolean`	`isCursorSet()`	Возвращает, был ли явно установлен курсор для этого компонента.
`boolean`	`isDisplayable()`	Определяет, отображается ли этот компонент.
`boolean`	`isDoubleBuffered()`	Возвращает true, если этот компонент отрисовывается на внеэкранном изображении («буфере»), которое копируется на экран позже.
`boolean`	`isEnabled()`	Определяет, включён ли этот компонент.
`boolean`	`isFocusable()`	Возвращает, может ли этот компонент получить фокус.
`boolean`	`isFocusCycleRoot(Container container)`	Возвращает, является ли указанный контейнер корнем цикла обхода фокуса для цикла обхода фокуса этого компонента.

`boolean`	`isFocusOwner()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`boolean`	`isFocusTraversable()`	Устарело. С версии 1.4 заменено на `isFocusable()`.
`boolean`	`isFontSet()`	Возвращает, был ли шрифт явно задан для этого компонента.
`boolean`	`isForegroundSet()`	Возвращает, был ли цвет переднего плана явно задан для этого компонента.
`boolean`	`isLightweight()`	Легковесный компонент не имеет собственного элемента в нативном инструменте.
`boolean`	`isMaximumSizeSet()`	Возвращает true, если максимальный размер был задан отличным от `null` значением, иначе возвращает false.
`boolean`	`isMinimumSizeSet()`	Возвращает true, если `setMinimumSize` был вызван с ненулевым значением, иначе false.
`boolean`	`isOpaque()`	Возвращает true, если компонент полностью непрозрачный, по умолчанию возвращает false.
`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` получил фокус ввода, и чтобы его родительское `Component` стало фокусированным `Window`.
`protected boolean`	`requestFocus(boolean temporary, FocusEvent.Cause cause)`	Запрашивает по причине `cause`, чтобы этот `Component` получил фокус ввода, и чтобы его родительское `Component` стало фокусированным `Window`.
`void`	`requestFocus(FocusEvent.Cause cause)`	Запрашивает по причине `cause`, чтобы этот компонент получил фокус ввода, и чтобы его родительское окно стало фокусированным окном.
`boolean`	`requestFocusInWindow()`	Запрашивает, чтобы этот компонент получил фокус ввода, если его родительское окно уже является фокусированным окном.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Запрашивает, чтобы этот `Component` получил фокус ввода, если его родительское `Component` уже является фокусированным `Window`.
`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)`	Устанавливает форму 'mixing-cutout' для этого лёгкого компонента.
`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)`.

END_OF_DOCUMENT_MARKER

`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

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

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

Component

protected Component()

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

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

getName

public String getName()

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

Возвращает:

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

С:

1.1

См. также:

setName

public void setName(String name)

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

Параметры:

name - строка, которая должна быть именем этого компонента

С:

1.1

См. также:

getParent

public Container getParent()

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

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

setDropTarget

public void setDropTarget(DropTarget dt)

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

Параметры:

dt - DropTarget

См. также:

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

См. также:

isDisplayable

public boolean isDisplayable()

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

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

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

Возвращает:

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

С:

1.2

См. также:

isVisible

public boolean isVisible()

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

Возвращает:

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

С:

1.0

См. также:

getMousePosition

public Point getMousePosition() throws HeadlessException

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

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

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

Returns:

координаты мыши относительно этого Component, или null

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true

Since:

1.5

See Also:

isShowing

public boolean isShowing()

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

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

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

Returns:

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

Since:

1.0

See Also:

isEnabled

public boolean isEnabled()

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

Returns:

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

Since:

1.0

See Also:

setEnabled

public void setEnabled(boolean b)

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

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

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

Parameters:

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

Since:

1.1

See Also:

enable

@Deprecated public void enable()

Deprecated.

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

enable

@Deprecated public void enable(boolean b)

Deprecated.

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

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

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

disable

@Deprecated public void disable()

Deprecated.

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

isDoubleBuffered

public boolean isDoubleBuffered()

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

Returns:: false по умолчанию

enableInputMethods

public void enableInputMethods(boolean enable)

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

Parameters:

enable - true для включения, false для отключения

Since:

1.2

See Also:

setVisible

public void setVisible(boolean b)

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

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

Parameters:

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

Since:

1.1

See Also:

show

@Deprecated public void show()

Deprecated.

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

show

@Deprecated public void show(boolean b)

Deprecated.

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

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

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

hide

@Deprecated public void hide()

Deprecated.

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

getForeground

public Color getForeground()

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

Returns:

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

Since:

1.0

See Also:

setForeground

public void setForeground(Color c)

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

Parameters:

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

Since:

1.0

See Also:

isForegroundSet

public boolean isForegroundSet()

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

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

getBackground

public Color getBackground()

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

Returns:

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

Since:

1.0

See Also:

setBackground

public void setBackground(Color c)

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

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

Параметры:

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

С момента:

1.0

См. также:

isBackgroundSet

public boolean isBackgroundSet()

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

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

getFont

public Font getFont()

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

Задано в:

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

Возвращает:

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

С момента:

1.0

См. также:

setFont

public void setFont(Font f)

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

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

Параметры:

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

С момента:

1.0

См. также:

isFontSet

public boolean isFontSet()

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

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

getLocale

public Locale getLocale()

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

Возвращает:

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

Исключения:

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

С момента:

1.1

См. также:

setLocale

public void setLocale(Locale l)

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

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

Параметры:

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

С момента:

1.1

См. также:

getColorModel

public ColorModel getColorModel()

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

Возвращает:

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

С момента:

1.0

См. также:

getLocation

public Point getLocation()

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

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

Возвращает:

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

С момента:

1.1

См. также:

getLocationOnScreen

public Point getLocationOnScreen()

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

Возвращает:

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

Исключения:

IllegalComponentStateException - если компонент не отображается на экране

См. также:

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

См. также:

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

См. также:

getSize

public Dimension getSize()

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

Возвращает:

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

С момента:

1.1

См. также:

размер

@Deprecated public Dimension size()

Устаревший.

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

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

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

установитьРазмер

public void setSize(int width, int height)

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

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

Параметры:

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

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

С:

1.1

См. также:

изменитьРазмер

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

Устаревший.

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

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

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

установитьРазмер

public void setSize(Dimension d)

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

Параметры:

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

Исключения:

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

С:

1.1

См. также:

изменитьРазмер

@Deprecated public void resize(Dimension d)

Устаревший.

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

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

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

getBounds

public Rectangle getBounds()

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

Возвращает:

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

См. также:

bounds

@Deprecated public Rectangle bounds()

Устаревший.

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

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

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

setBounds

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

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

Параметры:

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

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

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

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

С:

1.1

См. также:

reshape

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

Устаревший.

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

Изменяет прямоугольник границ этого компонента.

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

setBounds

public void setBounds(Rectangle r)

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

Параметры:

r - новый прямоугольник границ для этого компонента

Исключения:

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

С:

1.1

См. также:

getX

public int getX()

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

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

getY

public int getY()

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

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

getWidth

public int getWidth()

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

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

getHeight

public int getHeight()

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

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

getBounds

public Rectangle getBounds(Rectangle rv)

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

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

getSize

public Dimension getSize(Dimension rv)

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

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

getLocation

public Point getLocation(Point rv)

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

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

isOpaque

public boolean isOpaque()

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

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

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

Returns:

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

Since:

1.2

See Also:

isLightweight

public boolean isLightweight()

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

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

Returns:

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

Since:

1.2

See Also:

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

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

Parameters:

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

Since:

1.5

See Also:

isPreferredSizeSet

public boolean isPreferredSizeSet()

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

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

getPreferredSize

public Dimension getPreferredSize()

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

Returns:

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

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:

isMinimumSizeSet

public boolean isMinimumSizeSet()

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

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

getMinimumSize

public Dimension getMinimumSize()

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

Returns:

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

See Also:

minimumSize

@Deprecated public Dimension minimumSize()

Deprecated.

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

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

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

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

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

Parameters:

maximumSize - Dimension, содержащий желаемый максимальный размер

Since:

1.5

See Also:

isMaximumSizeSet

public boolean isMaximumSizeSet()

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

Returns:: true, если maximumSize ненулевой, false в противном случае
Since:: 1.5

getMaximumSize

public Dimension getMaximumSize()

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

Returns:

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

See Also:

getAlignmentX

public float getAlignmentX()

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

Returns:: горизонтальное выравнивание этого компонента

getAlignmentY

public float getAlignmentY()

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

Returns:: вертикальное выравнивание этого компонента

getBaseline

public int getBaseline(int width, int height)

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

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

Parameters:

width - ширина для получения линии основания

height - высота для получения линии основания

Returns:

линия основания или < 0, указывающее, что разумной линии основания нет

Throws:

IllegalArgumentException - если ширина или высота < 0

Since:

1.6

See Also:

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior()

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

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

Returns:

перечисление, указывающее, как изменяется базовая линия при изменении размера компонента

Since:

1.6

See Also:

doLayout

public void doLayout()

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

See Also:

layout

@Deprecated public void layout()

Deprecated.

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

validate

public void validate()

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

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

Since:

1.0

See Also:

invalidate

public void invalidate()

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

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

Этот метод вызывается автоматически при изменении любой информации, связанной с компоновкой (например, при установке границ компонента или добавлении компонента в контейнер).

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

Since:

1.0

See Also:

revalidate

public void revalidate()

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

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

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

Since:

1.7

See Also:

getGraphics

public Graphics getGraphics()

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

Returns:

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

Since:

1.0

See Also:

getFontMetrics

public FontMetrics getFontMetrics(Font font)

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

Parameters:

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

Returns:

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

Since:

1.0

See Also:

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:

isCursorSet

public boolean isCursorSet()

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

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

paint

public void paint(Graphics g)

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

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

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

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

Parameters:

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

Since:

1.0

See Also:

обновить

public void update(Graphics g)

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

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

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

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

Параметры:

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

С:

1.0

См. также:

paintAll

public void paintAll(Graphics g)

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

Параметры:

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

С:

1.0

См. также:

перерисовать

public void repaint()

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

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

С:

1.0

См. также:

перерисовать

public void repaint(long tm)

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

Параметры:

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

С:

1.0

См. также:

перерисовать

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

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

Параметры:

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

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

width - ширина

height - высота

С:

1.0

См. также:

перерисовать

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

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

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

Параметры:

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

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

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

width - ширина

height - высота

С:

1.0

См. также:

печать

public void print(Graphics g)

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

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

Параметры:

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

С:

1.0

См. также:

printAll

public void printAll(Graphics g)

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

Параметры:

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

С:

1.0

См. также:

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, если флаги infoflags указывают, что изображение полностью загружено; 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

См. также:

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

См. также:

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 - объект, который будет уведомлён о подготовке изображения

Возвращает:

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

С:

1.0

См. также:

setIgnoreRepaint

public void setIgnoreRepaint(boolean ignoreRepaint)

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

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

Параметры:

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

С:

1.4

См. также:

getIgnoreRepaint

public boolean getIgnoreRepaint()

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

Возвращает:

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

С:

1.4

См. также:

contains

public boolean contains(int x, int y)

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

Параметры:

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

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

Возвращает:

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

С:

1.1

См. также:

inside

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

Устарело.

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

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

Параметры:: x - координата x точки; y - координата y точки
Возвращает:: true, если точка находится внутри компонента; иначе false

contains

public boolean contains(Point p)

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

Параметры:

p - точка

Возвращает:

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

Исключения:

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

См. также:

getComponentAt

public Component getComponentAt(int x, int y)

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

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

Параметры:

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

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

Возвращает:

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

См. также:

locate

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

Устарело.

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

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

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

getComponentAt

public Component getComponentAt(Point p)

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

Параметры:

p - точка

Возвращает:

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

См. также:

deliverEvent

@Deprecated public void deliverEvent(Event e)

Устарело.

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

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

dispatchEvent

public final void dispatchEvent(AWTEvent e)

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

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

postEvent

@Deprecated public boolean postEvent(Event e)

Устарело.

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

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

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

Определено в:: postEvent в интерфейсе MenuContainer
Параметры:: e - событие для обработки
Возвращает:: результаты отправки события

addComponentListener

public void addComponentListener(ComponentListener l)

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

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

Параметры:

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

См. также:

removeComponentListener

public void removeComponentListener(ComponentListener l)

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

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

Параметры:

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

См. также:

getComponentListeners

public ComponentListener[] getComponentListeners()

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

Возвращает:

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

См. также:

addFocusListener

public void addFocusListener(FocusListener l)

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

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

Параметры:

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

См. также:

removeFocusListener

public void removeFocusListener(FocusListener l)

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

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

Parameters:

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

Since:

1.1

See Also:

getFocusListeners

public FocusListener[] getFocusListeners()

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

Returns:

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

Since:

1.4

See Also:

addHierarchyListener

public void addHierarchyListener(HierarchyListener l)

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

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

Parameters:

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

Since:

1.3

See Also:

removeHierarchyListener

public void removeHierarchyListener(HierarchyListener l)

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

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

Parameters:

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

Since:

1.3

See Also:

getHierarchyListeners

public HierarchyListener[] getHierarchyListeners()

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

Returns:

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

Since:

1.4

See Also:

addHierarchyBoundsListener

public void addHierarchyBoundsListener(HierarchyBoundsListener l)

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

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

Parameters:

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

Since:

1.3

See Also:

removeHierarchyBoundsListener

public void removeHierarchyBoundsListener(HierarchyBoundsListener l)

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

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

Parameters:

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

Since:

1.3

See Also:

getHierarchyBoundsListeners

public HierarchyBoundsListener[] getHierarchyBoundsListeners()

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

Returns:

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

Since:

1.4

See Also:

addKeyListener

public void addKeyListener(KeyListener l)

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

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

Parameters:

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

Since:

1.1

See Also:

removeKeyListener

public void removeKeyListener(KeyListener l)

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

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

Parameters:

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

Since:

1.1

See Also:

getKeyListeners

public KeyListener[] getKeyListeners()

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

Returns:

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

Since:

1.4

See Also:

addMouseListener

public void addMouseListener(MouseListener l)

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

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

Parameters:

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

Since:

1.1

See Also:

removeMouseListener

public void removeMouseListener(MouseListener l)

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

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

Parameters:

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

Since:

1.1

See Also:

getMouseListeners

public MouseListener[] getMouseListeners()

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

Returns:

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

Since:

1.4

See Also:

addMouseMotionListener

public void addMouseMotionListener(MouseMotionListener l)

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

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

Parameters:

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

Since:

1.1

See Also:

removeMouseMotionListener

public void removeMouseMotionListener(MouseMotionListener l)

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

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

Parameters:

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

Since:

1.1

See Also:

getMouseMotionListeners

public MouseMotionListener[] getMouseMotionListeners()

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

Returns:

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

Since:

1.4

See Also:

addMouseWheelListener

public void addMouseWheelListener(MouseWheelListener l)

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

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

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

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

Parameters:

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

Since:

1.4

See Also:

removeMouseWheelListener

public void removeMouseWheelListener(MouseWheelListener l)

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

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

Parameters:

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

Since:

1.4

See Also:

getMouseWheelListeners

public MouseWheelListener[] getMouseWheelListeners()

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

Returns:

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

Since:

1.4

See Also:

addInputMethodListener

public void addInputMethodListener(InputMethodListener l)

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

Для получения подробностей о модели потоков AWT см. Вопросы многопоточности AWT.

Parameters:

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

Since:

1.2

See Also:

removeInputMethodListener

public void removeInputMethodListener(InputMethodListener l)

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

Для получения подробностей о модели потоков AWT см. Вопросы многопоточности AWT.

Parameters:

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

Since:

1.2

See Also:

getInputMethodListeners

public InputMethodListener[] getInputMethodListeners()

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

Returns:

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

Since:

1.4

See Also:

getListeners

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

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

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

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

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

Type Parameters:

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

Parameters:

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

Returns:

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

Throws:

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

NullPointerException - если listenerType имеет значение null

Since:

1.3

See Also:

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()

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

Returns:

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

Since:

1.2

See Also:

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:

disableEvents

protected final void disableEvents(long eventsToDisable)

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

Parameters:

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

Since:

1.1

See Also:

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

protected void processComponentEvent(ComponentEvent e)

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

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

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

Parameters:

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

Since:

1.1

See Also:

processFocusEvent

protected void processFocusEvent(FocusEvent e)

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

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

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

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

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

Parameters:

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

Since:

1.1

See Also:

processKeyEvent

protected void processKeyEvent(KeyEvent e)

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

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

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

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

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

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

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

Parameters:

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

Since:

1.1

See Also:

processMouseEvent

protected void processMouseEvent(MouseEvent e)

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

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

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

Parameters:

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

Since:

1.1

See Also:

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

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

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

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

Parameters:

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

Since:

1.1

See Also:

обработкаСобытияКолесаМыши

protected void processMouseWheelEvent(MouseWheelEvent e)

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

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

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

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

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

Параметры:

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

С:

1.4

См. также:

обработкаСобытияМетодаВвода

protected void processInputMethodEvent(InputMethodEvent e)

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

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

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

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

Параметры:

e - событие метода ввода

С:

1.2

См. также:

обработкаСобытияИерархии

protected void processHierarchyEvent(HierarchyEvent e)

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

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

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

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

Параметры:

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

С:

1.3

См. также:

обработкаСобытияГраницИерархии

protected void processHierarchyBoundsEvent(HierarchyEvent e)

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

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

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

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

Параметры:

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

С:

1.3

См. также:

обработатьСобытие

@Deprecated public boolean handleEvent(Event evt)

Устарело.

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

Параметры:: evt - обрабатываемое событие
Возвращает:: true, если событие было обработано, false в противном случае

щелчокМыши

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

Устарело.

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

Параметры:: evt - обрабатываемое событие; x - координата x; y - координата y
Возвращает:: false

перетаскиваниеМыши

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

Устарело.

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

Параметры:: evt - обрабатываемое событие; x - координата x; y - координата y
Возвращает:: false

отпусканиеМыши

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

Устарело.

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

Параметры:: evt - обрабатываемое событие; x - координата x; y - координата y
Возвращает:: false

движениеМыши

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

Устарело.

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

Параметры:: evt - обрабатываемое событие; x - координата x; y - координата y
Возвращает:: false

входМыши

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

Устарело.

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

Параметры:: evt - обрабатываемое событие; x - координата x; y - координата y
Возвращает:: false

выходМыши

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

Устарело.

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

Параметры:: evt - обрабатываемое событие; x - координата x; y - координата y
Возвращает:: false

нажатиеКлавиши

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

Устарело.

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

Параметры:: evt - обрабатываемое событие; key - нажатая клавиша
Возвращает:: false

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

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

Устарело.

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

Параметры:: evt - обрабатываемое событие; key - нажатая клавиша
Возвращает:: false

action

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

Устарело.

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

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

addNotify

public void addNotify()

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

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

С:

1.0

См. также:

removeNotify

public void removeNotify()

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

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

С:

1.0

См. также:

gotFocus

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

Устарело.

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

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

lostFocus

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

Устарело.

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

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

isFocusTraversable

@Deprecated public boolean isFocusTraversable()

Устарело.

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

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

Возвращает:

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

С:

1.1

См. также:

isFocusable

public boolean isFocusable()

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

Возвращает:

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

С:

1.4

См. также:

setFocusable

public void setFocusable(boolean focusable)

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

Параметры:

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

С:

1.4

См. также:

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.

Параметры:

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

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

Исключения:

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

С:

1.4

См. также:

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

Параметры:

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

Возвращает:

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

Исключения:

С:

1.4

См. также:

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

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

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

setFocusTraversalKeysEnabled

public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)

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

Параметры:

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

С тех пор:

1.4

См. также:

getFocusTraversalKeysEnabled

public boolean getFocusTraversalKeysEnabled()

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

Возвращает:

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

С тех пор:

1.4

См. также:

requestFocus

public void requestFocus()

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

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

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

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

С тех пор:

1.0

См. также:

requestFocus

public void requestFocus(FocusEvent.Cause cause)

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

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

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

Параметры:

cause - причина запроса фокуса

С тех пор:

См. также:

requestFocus

protected boolean requestFocus(boolean temporary)

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

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

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

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

Параметры:

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

Возвращает:

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

С тех пор:

1.4

См. также:

requestFocus

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

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

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

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

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

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

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

Parameters:

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

Returns:

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

Since:

See Also:

requestFocusInWindow

public boolean requestFocusInWindow()

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

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

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

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

Returns:

Since:

1.4

See Also:

requestFocusInWindow

public boolean requestFocusInWindow(FocusEvent.Cause cause)

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

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

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

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

Parameters:

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

Returns:

Since:

See Also:

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

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

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

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

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

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

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

Parameters:

Returns:

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

Since:

1.4

See Also:

getFocusCycleRootAncestor

public Container getFocusCycleRootAncestor()

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

Returns:

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

Since:

1.4

See Also:

isFocusCycleRoot

public boolean isFocusCycleRoot(Container container)

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

Parameters:

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

Returns:

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

Since:

1.4

See Also:

transferFocus

public void transferFocus()

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

Since:

1.1

See Also:

nextFocus

@Deprecated public void nextFocus()

Устарело.

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

transferFocusBackward

public void transferFocusBackward()

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

Since:

1.4

See Also:

transferFocusUpCycle

public void transferFocusUpCycle()

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

Since:

1.4

See Also:

hasFocus

public boolean hasFocus()

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

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

isFocusOwner

public boolean isFocusOwner()

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

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

add

public void add(PopupMenu popup)

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

Parameters:

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

Throws:

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

Since:

1.1

See Also:

remove

public void remove(MenuComponent popup)

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

Specified by:

remove in interface MenuContainer

Parameters:

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

Since:

1.1

See Also:

paramString

protected String paramString()

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

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

toString

public String toString()

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

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

list

public void list()

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

Since:

1.0

See Also:

list

public void list(PrintStream out)

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

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

list

public void list(PrintStream out, int indent)

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

Параметры:

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

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

Исключения:

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

С тех пор:

1.0

См. также:

list

public void list(PrintWriter out)

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

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

list

public void list(PrintWriter out, int indent)

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

Параметры:

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

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

Исключения:

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

С тех пор:

1.1

См. также:

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

шрифт этого компонента ("font")
цвет фона этого компонента ("background")
цвет текста этого компонента ("foreground")
возможность фокусировки этого компонента ("focusable")
состояние активации клавиш перехода фокуса для этого компонента ("focusTraversalKeysEnabled")
множество клавиш перехода фокуса ВПЕРЕД ("forwardFocusTraversalKeys")
множество клавиш перехода фокуса НАЗАД ("backwardFocusTraversalKeys")
множество клавиш перехода фокуса ВВЕРХ ("upCycleFocusTraversalKeys")
предпочтительный размер этого компонента ("preferredSize")
минимальный размер этого компонента ("minimumSize")
максимальный размер этого компонента ("maximumSize")
имя этого компонента ("name")

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

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

Параметры:

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

См. также:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

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

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

Параметры:

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

См. также:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

Возвращает:

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

С тех пор:

1.4

См. также:

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

шрифт этого компонента ("font")
цвет фона этого компонента ("background")
цвет текста этого компонента ("foreground")
возможность фокусировки этого компонента ("focusable")
состояние активации клавиш перехода фокуса для этого компонента ("focusTraversalKeysEnabled")
множество клавиш перехода фокуса ВПЕРЕД ("forwardFocusTraversalKeys")
множество клавиш перехода фокуса НАЗАД ("backwardFocusTraversalKeys")
множество клавиш перехода фокуса ВВЕРХ ("upCycleFocusTraversalKeys")

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

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

Параметры:

propertyName - имя свойства (из списка выше)

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

См. также:

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

Параметры:

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

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

См. также:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

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

Параметры:

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

Возвращает:

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

С тех пор:

1.4

См. также:

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

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

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

Parameters:

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

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

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

Since:

1.5

See Also:

firePropertyChange

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

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

Parameters:

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

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

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

Since:

1.5

See Also:

firePropertyChange

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

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

Parameters:

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

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

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

Since:

1.5

See Also:

firePropertyChange

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

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

Parameters:

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

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

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

Since:

1.5

See Also:

firePropertyChange

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

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

Parameters:

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

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

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

Since:

1.5

See Also:

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

Returns:

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

See Also:

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation orientation)

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

Parameters:

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

Throws:

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

Since:

1.4

See Also:

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Returns:: AccessibleContext этого Component
Since:: 1.3

setMixingCutoutShape

public void setMixingCutoutShape(Shape shape)

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

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

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

Самый распространённый пример, когда нужна форма 'mixing-cutout', - это компонент панели стекла. Метод JRootPane.setGlassPane(java.awt.Component) автоматически устанавливает empty-shape в качестве формы 'mixing-cutout' для данного компонента панели стекла. Если разработчик нуждается в какой-либо другой форме 'mixing-cutout' для панели стекла (что редко), это необходимо изменить вручную после установки панели стекла на панель корня.

Parameters:: shape - новая форма 'mixing-cutout'
Since:: 9

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