Класс 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 и всего, к чему он ссылается. Проблема в том, что слушатель сериализуем случайно, а не по замыслу. Для разделения решений о MyApp и о том, что ActionListener является сериализуемым, можно использовать вложенный класс, как в следующем примере:

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

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

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

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

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

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

См. также:

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

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

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

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

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

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

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

Component()

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

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

Модификатор и тип	Метод	Описание
`boolean`	`action(Event evt, Object what)`	Устарело. С версии JDK 1.1, следует зарегистрировать этот компонент как ActionListener для компонента, генерирующего события действия.
`void`	`add(PopupMenu popup)`	Добавляет указанное всплывающее меню к компоненту.
`void`	`addComponentListener(ComponentListener l)`	Добавляет указанный слушатель событий компонента для получения событий компонента от этого компонента.
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента, когда этот компонент получает фокус ввода.
`void`	`addHierarchyBoundsListener(HierarchyBoundsListener l)`	Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента, когда иерархия, к которой принадлежит этот контейнер, изменяется.
`void`	`addHierarchyListener(HierarchyListener l)`	Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента, когда иерархия, к которой принадлежит этот контейнер, изменяется.
`void`	`addInputMethodListener(InputMethodListener l)`	Добавляет указанный слушатель методов ввода для получения событий методов ввода от этого компонента.
`void`	`addKeyListener(KeyListener l)`	Добавляет указанный слушатель клавиш для получения событий клавиш от этого компонента.
`void`	`addMouseListener(MouseListener l)`	Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
`void`	`addMouseMotionListener(MouseMotionListener l)`	Добавляет указанный слушатель движения мыши для получения событий движения мыши от этого компонента.
`void`	`addMouseWheelListener(MouseWheelListener l)`	Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента.
`void`	`addNotify()`	Делает этот `Component` отображаемым, подключив его к ресурсу нативного экрана.
`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)`	Возвращает компонент или подкомпонент, содержащий указанную точку.

END_OF_DOCUMENT_MARKER

`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()`	Возвращает, был ли `setMinimumSize` вызван с ненулевым значением.
`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)`	Выводит список в указанный поток вывода.
`void`	`list(PrintWriter out, int indent)`	Выводит список, начиная с указанного отступа, в указанный поток вывода.
`Component`	`locate(int x, int y)`	Устарело. С версии JDK 1.1 заменено на getComponentAt(int, int).
`Point`	`location()`	Устарело. С версии JDK 1.1 заменено на `getLocation()`.
`boolean`	`lostFocus(Event evt, Object what)`	Устарело. С версии JDK 1.1 заменено на processFocusEvent(FocusEvent).
`Dimension`	`minimumSize()`	Устарело. С версии JDK 1.1 заменено на `getMinimumSize()`.
`boolean`	`mouseDown(Event evt, int x, int y)`	Устарело. С версии JDK 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseDrag(Event evt, int x, int y)`	Устарело. С версии JDK 1.1 заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseEnter(Event evt, int x, int y)`	Устарело. С версии JDK 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseExit(Event evt, int x, int y)`	Устарело. С версии JDK 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseMove(Event evt, int x, int y)`	Устарело. С версии JDK 1.1 заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseUp(Event evt, int x, int y)`	Устарело. С версии JDK 1.1 заменено на processMouseEvent(MouseEvent).
`void`	`move(int x, int y)`	Устарело. С версии JDK 1.1 заменено на `setLocation(int, int)`.
`void`	`nextFocus()`	Устарело. С версии JDK 1.1 заменено на transferFocus().
`void`	`paint(Graphics g)`	Отрисовывает этот компонент.
`void`	`paintAll(Graphics g)`	Отрисовывает этот компонент и все его дочерние компоненты.
`protected String`	`paramString()`	Возвращает строку, представляющую состояние этого компонента.
`boolean`	`postEvent(Event e)`	Устарело. С версии JDK 1.1 заменено на dispatchEvent(AWTEvent).
`Dimension`	`preferredSize()`	Устарело. С версии JDK 1.1 заменено на `getPreferredSize()`.
`boolean`	`prepareImage(Image image, int width, int height, ImageObserver observer)`	Подготавливает изображение для отображения на этом компоненте с заданной шириной и высотой.
`boolean`	`prepareImage(Image image, ImageObserver observer)`	Подготавливает изображение для отображения на этом компоненте.
`void`	`print(Graphics g)`	Печатает этот компонент.
`void`	`printAll(Graphics g)`	Печатает этот компонент и все его дочерние компоненты.
`protected void`	`processComponentEvent(ComponentEvent e)`	Обрабатывает события компонента, возникающие в этом компоненте, перенаправляя их зарегистрированным `ComponentListener` объектам.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события, возникающие в этом компоненте.
`protected void`	`processFocusEvent(FocusEvent e)`	Обрабатывает события фокуса, возникающие в этом компоненте, перенаправляя их зарегистрированным `FocusListener` объектам.
`protected void`	`processHierarchyBoundsEvent(HierarchyEvent e)`	Обрабатывает события границ иерархии, возникающие в этом компоненте, перенаправляя их зарегистрированным `HierarchyBoundsListener` объектам.
`protected void`	`processHierarchyEvent(HierarchyEvent e)`	Обрабатывает события иерархии, возникающие в этом компоненте, перенаправляя их зарегистрированным `HierarchyListener` объектам.
`protected void`	`processInputMethodEvent(InputMethodEvent e)`	Обрабатывает события ввода метода, возникающие в этом компоненте, перенаправляя их зарегистрированным `InputMethodListener` объектам.
`protected void`	`processKeyEvent(KeyEvent e)`	Обрабатывает события клавиш, возникающие в этом компоненте, перенаправляя их зарегистрированным `KeyListener` объектам.
`protected void`	`processMouseEvent(MouseEvent e)`	Обрабатывает события мыши, возникающие в этом компоненте, перенаправляя их зарегистрированным `MouseListener` объектам.
`protected void`	`processMouseMotionEvent(MouseEvent e)`	Обрабатывает события движения мыши, возникающие в этом компоненте, перенаправляя их зарегистрированным `MouseMotionListener` объектам.
`protected void`	`processMouseWheelEvent(MouseWheelEvent e)`	Обрабатывает события колёсика мыши, возникающие в этом компоненте, перенаправляя их зарегистрированным `MouseWheelListener` объектам.

`void`	`remove(MenuComponent popup)`	Удаляет указанное всплывающее меню из компонента.
`void`	`removeComponentListener(ComponentListener l)`	Удаляет указанного слушателя компонента, чтобы он больше не получал события компонента от этого компонента.
`void`	`removeFocusListener(FocusListener l)`	Удаляет указанного слушателя фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`removeHierarchyBoundsListener(HierarchyBoundsListener l)`	Удаляет указанного слушателя границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
`void`	`removeHierarchyListener(HierarchyListener l)`	Удаляет указанного слушателя иерархии, чтобы он больше не получал события изменений иерархии от этого компонента.
`void`	`removeInputMethodListener(InputMethodListener l)`	Удаляет указанного слушателя ввода, чтобы он больше не получал события ввода от этого компонента.
`void`	`removeKeyListener(KeyListener l)`	Удаляет указанного слушателя клавиш, чтобы он больше не получал события клавиш от этого компонента.
`void`	`removeMouseListener(MouseListener l)`	Удаляет указанного слушателя мыши, чтобы он больше не получал события мыши от этого компонента.
`void`	`removeMouseMotionListener(MouseMotionListener l)`	Удаляет указанного слушателя движения мыши, чтобы он больше не получал события движения мыши от этого компонента.
`void`	`removeMouseWheelListener(MouseWheelListener l)`	Удаляет указанного слушателя колесика мыши, чтобы он больше не получал события колесика мыши от этого компонента.
`void`	`removeNotify()`	Делает этот `Component` неотображаемым, уничтожив его ресурс экрана.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка слушателей.
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Удаляет `PropertyChangeListener` из списка слушателей для определённого свойства.
`void`	`repaint()`	Перерисовывает этот компонент.
`void`	`repaint(int x, int y, int width, int height)`	Перерисовывает указанный прямоугольник этого компонента.
`void`	`repaint(long tm)`	Перерисовывает компонент.
`void`	`repaint(long tm, int x, int y, int width, int height)`	Перерисовывает указанный прямоугольник этого компонента в течение `tm` миллисекунд.
`void`	`requestFocus()`	Запрашивает, чтобы этот компонент получил фокус ввода, и чтобы его родительское окно стало фокусированным.
`protected boolean`	`requestFocus(boolean temporary)`	Запрашивает, чтобы этот `Component` получил фокус ввода, и чтобы его родительское окно стало фокусированным.
`protected boolean`	`requestFocus(boolean temporary, FocusEvent.Cause cause)`	Запрашивает, по причине `cause`, чтобы этот `Component` получил фокус ввода, и чтобы его родительское окно стало фокусированным.
`void`	`requestFocus(FocusEvent.Cause cause)`	Запрашивает, по причине `cause`, чтобы этот компонент получил фокус ввода, и чтобы его родительское окно стало фокусированным.
`boolean`	`requestFocusInWindow()`	Запрашивает, чтобы этот компонент получил фокус ввода, если его родительское окно уже фокусированным.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Запрашивает, чтобы этот `Component` получил фокус ввода, если его родительское окно уже фокусированным.
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Запрашивает, по причине `cause`, чтобы этот компонент получил фокус ввода, если его родительское окно уже фокусированным.
`void`	`reshape(int x, int y, int width, int height)`	Устаревшее. С версии JDK 1.1, заменено на `setBounds(int, int, int, int)`.
`void`	`resize(int width, int height)`	Устаревшее. С версии JDK 1.1, заменено на `setSize(int, int)`.
`void`	`resize(Dimension d)`	Устаревшее. С версии JDK 1.1, заменено на `setSize(Dimension)`.
`void`	`revalidate()`	Перевалидирует иерархию компонентов до ближайшего корня валидации.
`void`	`setBackground(Color c)`	Устанавливает цвет фона этого компонента.
`void`	`setBounds(int x, int y, int width, int height)`	Перемещает и изменяет размер этого компонента.
`void`	`setBounds(Rectangle r)`	Перемещает и изменяет размер этого компонента, чтобы соответствовать новой области `r`.
`void`	`setComponentOrientation(ComponentOrientation o)`	Устанавливает чувствительный к языку порядок, который будет использоваться для упорядочения элементов или текста в этом компоненте.
`void`	`setCursor(Cursor cursor)`	Устанавливает изображение курсора на указанный курсор.
`void`	`setDropTarget(DropTarget dt)`	Ассоциирует `DropTarget` с этим компонентом.
`void`	`setEnabled(boolean b)`	Включает или отключает этот компонент в зависимости от значения параметра `b`.
`void`	`setFocusable(boolean focusable)`	Устанавливает состояние фокуса для этого компонента в указанное значение.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Устанавливает клавиши перехода фокуса для данного действия перехода для этого компонента.
`void`	`setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)`	Устанавливает, включены ли клавиши перехода фокуса для этого компонента.
`void`	`setFont(Font f)`	Устанавливает шрифт этого компонента.
`void`	`setForeground(Color c)`	Устанавливает цвет переднего плана этого компонента.
`void`	`setIgnoreRepaint(boolean ignoreRepaint)`	Устанавливает, будут ли игнорироваться сообщения об отрисовке, полученные от операционной системы.
`void`	`setLocale(Locale l)`	Устанавливает локаль этого компонента.
`void`	`setLocation(int x, int y)`	Перемещает этот компонент в новое местоположение.
`void`	`setLocation(Point p)`	Перемещает этот компонент в новое местоположение.
`void`	`setMaximumSize(Dimension maximumSize)`	Устанавливает максимальный размер этого компонента в постоянное значение.
`void`	`setMinimumSize(Dimension minimumSize)`	Устанавливает минимальный размер этого компонента в постоянное значение.
`void`	`setMixingCutoutShape(Shape shape)`	Устанавливает форму 'смешивания-вырезания' для этого лёгковесного компонента.
`void`	`setName(String name)`	Устанавливает имя компонента в указанную строку.
`void`	`setPreferredSize(Dimension preferredSize)`	Устанавливает предпочтительный размер этого компонента в постоянное значение.
`void`	`setSize(int width, int height)`	Изменяет размер этого компонента, чтобы он имел ширину `width` и высоту `height`.
`void`	`setSize(Dimension d)`	Изменяет размер этого компонента, чтобы он имел ширину `d.width` и высоту `d.height`.
`void`	`setVisible(boolean b)`	Отображает или скрывает этот компонент в зависимости от значения параметра `b`.
`void`	`show()`	Устаревшее. С версии JDK 1.1, заменено на `setVisible(boolean)`.
`void`	`show(boolean b)`	Устаревшее. С версии JDK 1.1, заменено на `setVisible(boolean)`.

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.

Возвращает:: объект drop target

getGraphicsConfiguration

public GraphicsConfiguration getGraphicsConfiguration()

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

Возвращает:: конфигурацию графики, используемую этим Component или null, или же null
С:: 1.3

getTreeLock

public final Object getTreeLock()

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

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

getToolkit

public Toolkit getToolkit()

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

Возвращает:: toolkit этого компонента
С:: 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.

Возвращает:

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

Исключение:

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

С:

1.5

См. также:

isShowing

public boolean isShowing()

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

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

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

Возвращает:

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

С:

1.0

См. также:

isEnabled

public boolean isEnabled()

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

Возвращает:

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

С:

1.0

См. также:

setEnabled

public void setEnabled(boolean b)

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

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

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

Параметры:

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

С:

1.1

См. также:

enable

@Deprecated public void enable()

Устарело.

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

enable

@Deprecated public void enable(boolean b)

Устарело.

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

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

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

disable

@Deprecated public void disable()

Устарело.

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

isDoubleBuffered

public boolean isDoubleBuffered()

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

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

enableInputMethods

public void enableInputMethods(boolean enable)

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

Параметры:

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

С:

1.2

См. также:

setVisible

public void setVisible(boolean b)

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

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

Параметры:

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

С:

1.1

См. также:

show

@Deprecated public void show()

Устарело.

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

show

@Deprecated public void show(boolean b)

Устарело.

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

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

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

hide

@Deprecated public void hide()

Устарело.

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

getForeground

public Color getForeground()

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

Возвращает:

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

С:

1.0

См. также:

setForeground

public void setForeground(Color c)

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

Параметры:

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

С:

1.0

См. также:

isForegroundSet

public boolean isForegroundSet()

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

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

getBackground

public Color getBackground()

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

Возвращает:

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

С:

1.0

См. также:

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

См. также:

size

@Deprecated public Dimension size()

Устаревшее.

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

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

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

setSize

public void setSize(int width, int height)

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

Параметры:

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

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

С:

1.1

См. также:

resize

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

Устарело.

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

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

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

setSize

public void setSize(Dimension d)

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

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

Параметры:

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

Исключения:

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

С:

1.1

См. также:

resize

@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 в куче.

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

isOpaque

public boolean isOpaque()

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

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

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

Возвращает:

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

С:

1.2

См. также:

END_OF_DOCUMENT_MARKER

isLightweight

public boolean isLightweight()

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

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

Возвращает:

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

С момента:

1.2

См. также:

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

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

Параметры:

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

С момента:

1.5

См. также:

isPreferredSizeSet

public boolean isPreferredSizeSet()

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

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

getPreferredSize

public Dimension getPreferredSize()

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

Возвращает:

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

См. также:

preferredSize

@Deprecated public Dimension preferredSize()

Устарело.

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

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

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

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

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

Параметры:

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

С момента:

1.5

См. также:

isMinimumSizeSet

public boolean isMinimumSizeSet()

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

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

getMinimumSize

public Dimension getMinimumSize()

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

Возвращает:

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

См. также:

minimumSize

@Deprecated public Dimension minimumSize()

Устарело.

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

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

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

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

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

Параметры:

maximumSize - объект Dimension содержащий желаемый максимальный разрешённый размер

С момента:

1.5

См. также:

isMaximumSizeSet

public boolean isMaximumSizeSet()

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

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

getMaximumSize

public Dimension getMaximumSize()

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

Возвращает:

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

См. также:

getAlignmentX

public float getAlignmentX()

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

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

getAlignmentY

public float getAlignmentY()

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

Возвращает:: вертикальное выравнивание компонента

getBaseline

public int getBaseline(int width, int height)

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

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

Параметры:

width - ширина для получения линии базы

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

Возвращает:

линию базы или < 0, указывая, что нет подходящей линии базы

Исключения:

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

С момента:

1.6

См. также:

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior()

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

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

Возвращает:

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

С момента:

1.6

См. также:

doLayout

public void doLayout()

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

См. также:

layout

@Deprecated public void layout()

Устарело.

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

validate

public void validate()

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

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

С момента:

1.0

См. также:

invalidate

public void invalidate()

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

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

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

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

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

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

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

Parameters:

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

Since:

1.0

See Also:

update

public void update(Graphics g)

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

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

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

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

Parameters:

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

Since:

1.0

See Also:

paintAll

public void paintAll(Graphics g)

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

Parameters:

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

Since:

1.0

See Also:

repaint

public void repaint()

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

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

Since:

1.0

See Also:

перерисовка

public void repaint(long tm)

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

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

Параметры:

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

С:

1.0

См. также:

перерисовка

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

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

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

Параметры:

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.

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

Параметры:

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

С:

1.0

См. также:

печатьВсех

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

См. также:

создатьИзображение

public Image createImage(ImageProducer producer)

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

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

создатьИзображение

public Image createImage(int width, int height)

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

Параметры:

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

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

Возвращает:

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

С:

1.0

См. также:

создатьЛегкоизменяемоеИзображение

public VolatileImage createVolatileImage(int width, int height)

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

Параметры:

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

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

Возвращает:

С:

1.4

См. также:

создатьЛегкоизменяемоеИзображение

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)

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

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

prepareImage

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

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

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

Parameters:

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

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

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

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

Returns:

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

Since:

1.0

See Also:

checkImage

public int checkImage(Image image, ImageObserver observer)

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

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

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

Parameters:

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

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

Returns:

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

Since:

1.0

See Also:

checkImage

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

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

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

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

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

Parameters:

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

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

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

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

Returns:

Since:

1.0

See Also:

setIgnoreRepaint

public void setIgnoreRepaint(boolean ignoreRepaint)

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

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

Parameters:

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

Since:

1.4

See Also:

getIgnoreRepaint

public boolean getIgnoreRepaint()

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

Returns:

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

Since:

1.4

See Also:

contains

public boolean contains(int x, int y)

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

Parameters:

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

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

Returns:

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

Since:

1.1

See Also:

inside

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

Deprecated.

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

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

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

contains

public boolean contains(Point p)

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

Parameters:

p - точка

Returns:

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

Throws:

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

Since:

1.1

See Also:

getComponentAt

public Component getComponentAt(int x, int y)

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

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

Parameters:

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

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

Returns:

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

Since:

1.0

See Also:

locate

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

Deprecated.

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

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

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

getComponentAt

public Component getComponentAt(Point p)

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

Parameters:

p - точка

Returns:

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

Since:

1.1

See Also:

deliverEvent

@Deprecated public void deliverEvent(Event e)

Устарело.

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

Parameters:: e - событие для передачи

dispatchEvent

public final void dispatchEvent(AWTEvent e)

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

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

postEvent

@Deprecated public boolean postEvent(Event e)

Устарело.

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

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

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

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

addComponentListener

public void addComponentListener(ComponentListener l)

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

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

Parameters:

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

Since:

1.1

See Also:

removeComponentListener

public void removeComponentListener(ComponentListener l)

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

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

Parameters:

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

Since:

1.1

See Also:

getComponentListeners

public ComponentListener[] getComponentListeners()

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

Returns:

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

Since:

1.4

See Also:

addFocusListener

public void addFocusListener(FocusListener l)

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

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

Parameters:

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

Since:

1.1

See Also:

removeFocusListener

public void removeFocusListener(FocusListener l)

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

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

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.

Parameters:

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

Since:

1.3

See Also:

removeHierarchyListener

public void removeHierarchyListener(HierarchyListener l)

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

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

Parameters:

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

Since:

1.3

See Also:

getHierarchyListeners

public HierarchyListener[] getHierarchyListeners()

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

Возвращает:

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

Since:

1.4

См. также:

addHierarchyBoundsListener

public void addHierarchyBoundsListener(HierarchyBoundsListener l)

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

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

Параметры:

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

Since:

1.3

См. также:

removeHierarchyBoundsListener

public void removeHierarchyBoundsListener(HierarchyBoundsListener l)

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

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

Параметры:

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

Since:

1.3

См. также:

getHierarchyBoundsListeners

public HierarchyBoundsListener[] getHierarchyBoundsListeners()

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

Возвращает:

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

Since:

1.4

См. также:

addKeyListener

public void addKeyListener(KeyListener l)

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

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

Параметры:

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

Since:

1.1

См. также:

removeKeyListener

public void removeKeyListener(KeyListener l)

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

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

Параметры:

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

Since:

1.1

См. также:

getKeyListeners

public KeyListener[] getKeyListeners()

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

Возвращает:

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

Since:

1.4

См. также:

addMouseListener

public void addMouseListener(MouseListener l)

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

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

Параметры:

l - слушатель мыши

Since:

1.1

См. также:

removeMouseListener

public void removeMouseListener(MouseListener l)

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

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

Параметры:

l - слушатель мыши

Since:

1.1

См. также:

getMouseListeners

public MouseListener[] getMouseListeners()

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

Возвращает:

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

Since:

1.4

См. также:

addMouseMotionListener

public void addMouseMotionListener(MouseMotionListener l)

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

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

Параметры:

l - слушатель перемещения мыши

Since:

1.1

См. также:

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. FooListener регистрируются с помощью метода 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. Одновременно он также должен обрабатывать события методов ввода.

Возвращает:

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

С:

1.2

См. также:

getInputContext

public InputContext getInputContext()

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

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

enableEvents

protected final void enableEvents(long eventsToEnable)

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

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

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

Параметры:

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

С:

1.1

См. также:

disableEvents

protected final void disableEvents(long eventsToDisable)

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

Параметры:

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

С:

1.1

См. также:

coalesceEvents

protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)

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

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

Параметры:: existingEvent - событие, уже находящееся в EventQueue; newEvent - событие, размещаемое в EventQueue
Возвращает:: коалесцированное событие или null для обозначения того, что никакой коалесценции не выполнено

processEvent

protected void processEvent(AWTEvent e)

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

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

Параметры:

e - событие

С:

1.1

См. также:

processComponentEvent

protected void processComponentEvent(ComponentEvent e)

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

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

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

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

Параметры:

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

С:

1.1

См. также:

processFocusEvent

protected void processFocusEvent(FocusEvent e)

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

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

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

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

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

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

Параметры:

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

С:

1.1

См. также:

processKeyEvent

protected void processKeyEvent(KeyEvent e)

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

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

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

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

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

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

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

Parameters:

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

Since:

1.1

See Also:

processMouseEvent

protected void processMouseEvent(MouseEvent e)

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

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

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

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

Parameters:

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

Since:

1.1

See Also:

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

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

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

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

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

Parameters:

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

Since:

1.1

See Also:

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent e)

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

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

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

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

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

Parameters:

e - событие прокрутки колёса мыши

Since:

1.4

See Also:

processInputMethodEvent

protected void processInputMethodEvent(InputMethodEvent e)

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

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

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

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

Parameters:

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

Since:

1.2

See Also:

processHierarchyEvent

protected void processHierarchyEvent(HierarchyEvent e)

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

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

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

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

Parameters:

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

Since:

1.3

See Also:

processHierarchyBoundsEvent

protected void processHierarchyBoundsEvent(HierarchyEvent e)

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

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

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

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

Parameters:

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

Since:

1.3

See Also:

handleEvent

@Deprecated public boolean handleEvent(Event evt)

Устарел.

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

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

mouseDown

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

Устарело.

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

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

mouseDrag

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

Устарело.

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

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

mouseUp

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

Устарело.

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

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

mouseMove

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

Устарело.

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

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

mouseEnter

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

Устарело.

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

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

mouseExit

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

Устарело.

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

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

keyDown

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

Устарело.

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

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

keyUp

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

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

Since:

1.0

См. также:

removeNotify

public void removeNotify()

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

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

Since:

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

Since:

1.1

См. также:

isFocusable

public boolean isFocusable()

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

Возвращает:

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

Since:

1.4

См. также:

setFocusable

public void setFocusable(boolean focusable)

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

Параметры:

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

Since:

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

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

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

Parameters:

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

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

Throws:

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

Since:

1.4

See Also:

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

Parameters:

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

Returns:

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

Throws:

Since:

1.4

See Also:

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

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

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

setFocusTraversalKeysEnabled

public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)

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

Parameters:

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

Since:

1.4

See Also:

getFocusTraversalKeysEnabled

public boolean getFocusTraversalKeysEnabled()

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

Returns:

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

Since:

1.4

See Also:

requestFocus

public void requestFocus()

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

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

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

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

Since:

1.0

See Also:

requestFocus

public void requestFocus(FocusEvent.Cause cause)

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

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

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

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

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

Parameters:

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

Since:

See Also:

requestFocus

protected boolean requestFocus(boolean temporary)

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

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

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

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

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

Parameters:

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

Returns:

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

Since:

1.4

See Also:

requestFocus

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

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

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

Parameters:

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

Returns:

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

Since:

See Also:

requestFocusInWindow

public boolean requestFocusInWindow()

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

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

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

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

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

Returns:

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

Since:

1.4

See Also:

requestFocusInWindow

public boolean requestFocusInWindow(FocusEvent.Cause cause)

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

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

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

Parameters:

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

Returns:

Since:

See Also:

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

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

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

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

Parameters:

Returns:

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, если этот Component является владельцем фокуса. Этот метод устарел и заменён на isFocusOwner().

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

isFocusOwner

public boolean isFocusOwner()

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

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

add

public void add(PopupMenu popup)

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

Parameters:

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

Throws:

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

Since:

1.1

See Also:

remove

public void remove(MenuComponent popup)

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

Specified by:

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

Parameters:

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

Since:

1.1

See Also:

paramString

protected String paramString()

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

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

toString

public String toString()

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

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

list

public void list()

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

Since:

1.0

See Also:

list

public void list(PrintStream out)

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

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

list

public void list(PrintStream out, int indent)

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

Parameters:

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

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

Throws:

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

Since:

1.0

See Also:

list

public void list(PrintWriter out)

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

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

list

public void list(PrintWriter out, int indent)

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

Parameters:

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

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

Throws:

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

Since:

1.1

See Also:

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

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

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

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

Parameters:

listener - добавляемый обработчик событий изменения свойств

See Also:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

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

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

Parameters:

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

See Also:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

Returns:

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

Since:

1.4

See Also:

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

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

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

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

Parameters:

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

listener - добавляемый обработчик изменений свойства

See Also:

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

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

Parameters:

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

listener - удаляемый обработчик PropertyChangeListener

See Also:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

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

Parameters:

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

Returns:

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

Since:

1.4

See Also:

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

Parameters:

propertyName - программируемое имя изменённого свойства

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

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

Since:

1.5

See Also:

firePropertyChange

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 - старое значение свойства (в виде числа с плавающей точкой)

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

Since:

1.5

See Also:

firePropertyChange

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

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

Parameters:

propertyName - программируемое имя изменённого свойства

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

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

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

Возвращает:

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

См. также:

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation orientation)

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

Параметры:

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

Исключения:

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

С:

1.4

См. также:

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

setMixingCutoutShape

public void setMixingCutoutShape(Shape shape)

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

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

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

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

Параметры:: shape - новая форма 'mixing-cutout'
С:: 9

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