Класс 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 class  Component.BaselineResizeBehavior

Перечисление распространённых способов изменения базовой линии компонента при изменении размера.

protected class  Component.BltBufferStrategy

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

protected class  Component.FlipBufferStrategy

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

Поля

Модификатор и тип Поле Описание
protected AccessibleContext accessibleContext

AccessibleContext, связанное с этим Component.

static float BOTTOM_ALIGNMENT

Константа для удобства использования getAlignmentY.

static float CENTER_ALIGNMENT

Константа для удобства использования getAlignmentY и getAlignmentX.

static float LEFT_ALIGNMENT

Константа для удобства использования getAlignmentX.

static float RIGHT_ALIGNMENT

Константа для удобства использования getAlignmentX.

static float TOP_ALIGNMENT

Константа для удобства использования getAlignmentY().

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

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

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

Модификатор Конструктор Описание
protected Component()

Создаёт новый компонент.

Методы

Модификатор и тип Метод Описание
boolean action​(Event evt, Object what)

Устарело.

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

void add​(PopupMenu popup)

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

void addComponentListener​(ComponentListener l)

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

void addFocusListener​(FocusListener l)

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

void addHierarchyBoundsListener​(HierarchyBoundsListener l)

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

void addHierarchyListener​(HierarchyListener l)

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

void addInputMethodListener​(InputMethodListener l)

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

void addKeyListener​(KeyListener l)

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

void addMouseListener​(MouseListener l)

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

void addMouseMotionListener​(MouseMotionListener l)

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

void addMouseWheelListener​(MouseWheelListener l)

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

void addNotify()

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

void addPropertyChangeListener​(PropertyChangeListener listener)

Добавляет PropertyChangeListener в список слушателей.

void addPropertyChangeListener​(String propertyName, PropertyChangeListener listener)

Добавляет PropertyChangeListener в список слушателей для определённого свойства.

void applyComponentOrientation​(ComponentOrientation orientation)

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

boolean areFocusTraversalKeysSet​(int id)

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

Rectangle bounds()

Устарело.

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

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

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

int checkImage​(Image image, ImageObserver observer)

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

protected AWTEvent coalesceEvents​(AWTEvent existingEvent, AWTEvent newEvent)

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

boolean contains​(int x, int y)

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

boolean contains​(Point p)

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

Image createImage​(int width, int height)

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

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 void disableEvents​(long eventsToDisable)

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

void dispatchEvent​(AWTEvent e)

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

void doLayout()

Запрашивает у менеджера компоновки выполнить компоновку этого компонента.

void enable()

Устарело.

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

void enable​(boolean b)

Устарело.

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

protected void enableEvents​(long eventsToEnable)

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

void enableInputMethods​(boolean enable)

Включает или отключает поддержку методов ввода для этого компонента.

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

Поддержка для отчётов о связанных изменениях свойств для булевых свойств.

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

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

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

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

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

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

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

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

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

Поддержка для отчётов о связанных изменениях свойств для целочисленных свойств.

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

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

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

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

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

Поддержка для отчётов о связанных изменениях свойств для свойств типа Object.

AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанное с этим Component.

float getAlignmentX()

Возвращает выравнивание по оси x.

float getAlignmentY()

Возвращает выравнивание по оси y.

Color getBackground()

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

int getBaseline​(int width, int height)

Возвращает линию базовой строки.

Component.BaselineResizeBehavior getBaselineResizeBehavior()

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

Rectangle getBounds()

Получает границы этого компонента в виде объекта Rectangle.

Rectangle getBounds​(Rectangle rv)

Хранит границы этого компонента в "возвращаемом значении" rv и возвращает rv.

ColorModel getColorModel()

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

Component getComponentAt​(int x, int y)

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

Component getComponentAt​(Point p)

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

ComponentListener[] getComponentListeners()

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

ComponentOrientation getComponentOrientation()

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

Cursor getCursor()

Получает установленный курсор в компоненте.

DropTarget getDropTarget()

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

Container getFocusCycleRootAncestor()

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

FocusListener[] getFocusListeners()

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

Set<AWTKeyStroke> getFocusTraversalKeys​(int id)

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

boolean getFocusTraversalKeysEnabled()

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

Font getFont()

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

FontMetrics getFontMetrics​(Font font)

Получает метрики шрифта для указанного шрифта.

Color getForeground()

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

Graphics getGraphics()

Создаёт контекст графики для этого компонента.

GraphicsConfiguration getGraphicsConfiguration()

Получает связанный с этим Component GraphicsConfiguration.

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

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

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 вызван со значением не равным null.

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)

Запрашивает, чтобы этот Component получил фокус ввода по причине cause, и что его родительское окно стало фокусированным.

void requestFocus​(FocusEvent.Cause cause)

Запрашивает, чтобы этот компонент получил фокус ввода по причине cause, и что его родительское окно стало фокусированным.

boolean requestFocusInWindow()

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

protected boolean requestFocusInWindow​(boolean temporary)

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

boolean requestFocusInWindow​(FocusEvent.Cause cause)

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

void reshape​(int x, int y, int width, int height)

Устарело.

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

void resize​(int width, int height)

Устарело.

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

void resize​(Dimension d)

Устарело.

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

void revalidate()

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

void setBackground​(Color c)

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

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

Перемещает и изменяет размер этого компонента.

void setBounds​(Rectangle r)

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

void setComponentOrientation​(ComponentOrientation o)

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

void setCursor​(Cursor cursor)

Устанавливает изображение курсора на указанный курсор.

void setDropTarget​(DropTarget dt)

Ассоциирует DropTarget с этим компонентом.

void setEnabled​(boolean b)

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

void setFocusable​(boolean focusable)

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

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

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

void setFocusTraversalKeysEnabled​(boolean focusTraversalKeysEnabled)

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

void setFont​(Font f)

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

void setForeground​(Color c)

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

void setIgnoreRepaint​(boolean ignoreRepaint)

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

void setLocale​(Locale l)

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

void setLocation​(int x, int y)

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

void setLocation​(Point p)

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

void setMaximumSize​(Dimension maximumSize)

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

void setMinimumSize​(Dimension minimumSize)

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

void setMixingCutoutShape​(Shape shape)

Устанавливает форму 'смешивания-вырезания' для этого облегчённого компонента.

void setName​(String name)

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

void setPreferredSize​(Dimension preferredSize)

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

void setSize​(int width, int height)

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

void setSize​(Dimension d)

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

void setVisible​(boolean b)

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

void show()

Устарело.

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

void show​(boolean b)

Устарело.

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

Dimension size()

Устарело.

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

String toString()

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

void transferFocus()

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

void transferFocusBackward()

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

void transferFocusUpCycle()

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

void update​(Graphics g)

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

void validate()

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

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

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

Поля

TOP_ALIGNMENT

public static final float TOP_ALIGNMENT

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

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

CENTER_ALIGNMENT

public static final float CENTER_ALIGNMENT

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

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

BOTTOM_ALIGNMENT

public static final float BOTTOM_ALIGNMENT

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

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

LEFT_ALIGNMENT

public static final float LEFT_ALIGNMENT

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

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

RIGHT_ALIGNMENT

public static final float RIGHT_ALIGNMENT

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

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

accessibleContext

protected AccessibleContext accessibleContext

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

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

Component

protected Component()

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

Методы

getName

public String getName()

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

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

setName

public void setName(String name)

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

Параметры:
name - строка, которая должна быть именем этого компонента
С момента:
1.1
См. также:
getName()

getParent

public Container getParent()

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

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

setDropTarget

public void setDropTarget(DropTarget dt)

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

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

getDropTarget

public DropTarget getDropTarget()

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

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

getGraphicsConfiguration

public GraphicsConfiguration getGraphicsConfiguration()

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

Возвращает:
GraphicsConfiguration, используемый этим Component или 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
См. также:
validate(), invalidate()

isDisplayable

public boolean isDisplayable()

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

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

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

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

isVisible

public boolean isVisible()

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

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

getMousePosition

public Point getMousePosition()
                       throws HeadlessException

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

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

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

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

isShowing

public boolean isShowing()

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

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

  • компонент был добавлен в видимую ScrollPane, но Component в данный момент не находится в области просмотра прокрутки.
  • Component закрыт другим Component или Container.
Возвращает:
true, если компонент отображается, false в противном случае
С момента:
1.0
См. также:
setVisible(boolean)

isEnabled

public boolean isEnabled()

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

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

setEnabled

public void setEnabled(boolean b)

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

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

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

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

enable

@Deprecated
public void enable()
Устарело.
С версии JDK 1.1, заменено на setEnabled(boolean).

enable

@Deprecated
public void enable(boolean b)
Устарело.
С версии JDK 1.1, заменено на setEnabled(boolean).

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

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

disable

@Deprecated
public void disable()
Устарело.
С версии JDK 1.1, заменено на setEnabled(boolean).

isDoubleBuffered

public boolean isDoubleBuffered()

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

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

enableInputMethods

public void enableInputMethods(boolean enable)

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

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

setVisible

public void setVisible(boolean b)

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

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

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

show

@Deprecated
public void show()
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).

show

@Deprecated
public void show(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).

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

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

hide

@Deprecated
public void hide()
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).

getForeground

public Color getForeground()

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

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

setForeground

public void setForeground(Color c)

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

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

isForegroundSet

public boolean isForegroundSet()

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

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

getBackground

public Color getBackground()

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

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

setBackground

public void setBackground(Color c)

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

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

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

isBackgroundSet

public boolean isBackgroundSet()

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

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

getFont

public Font getFont()

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

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

setFont

public void setFont(Font f)

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

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

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

isFontSet

public boolean isFontSet()

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

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

getLocale

public Locale getLocale()

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

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

setLocale

public void setLocale(Locale l)

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

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

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

getColorModel

public ColorModel getColorModel()

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

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

getLocation

public Point getLocation()

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

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

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

getLocationOnScreen

public Point getLocationOnScreen()

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

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

location

@Deprecated
public Point location()
Устарело.
Начиная с версии JDK 1.1, заменено на getLocation().

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

Возвращает:
местоположение верхнего левого угла этого компонента

setLocation

public void setLocation(int x,
                        int y)

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

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

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

move

@Deprecated
public void move(int x,
                 int y)
Устарело.
Начиная с версии JDK 1.1, заменено на setLocation(int, int).

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

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

setLocation

public void setLocation(Point p)

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

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

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

getSize

public Dimension getSize()

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

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

size

@Deprecated
public Dimension size()
Устарело.
С версии JDK 1.1 заменено на getSize().

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

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

setSize

public void setSize(int width,
                    int height)

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

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

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

resize

@Deprecated
public void resize(int width,
                   int height)
Устарело.
С версии JDK 1.1 заменено на setSize(int, int).

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

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

setSize

public void setSize(Dimension d)

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

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

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

resize

@Deprecated
public void resize(Dimension d)
Устарело.
С версии JDK 1.1 заменено на setSize(Dimension).

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

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

getBounds

public Rectangle getBounds()

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

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

bounds

@Deprecated
public Rectangle bounds()
Устарело.
С версии JDK 1.1 заменено на getBounds().

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

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

setBounds

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

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

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

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

reshape

@Deprecated
public void reshape(int x,
                    int y,
                    int width,
                    int height)
Устарело.
С версии JDK 1.1 заменено на setBounds(int, int, int, int).

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

Параметры:
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
См. также:
getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension), invalidate()

getX

public int getX()

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

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

getY

public int getY()

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

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

getWidth

public int getWidth()

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

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

getHeight

public int getHeight()

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

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

getBounds

public Rectangle getBounds(Rectangle rv)

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

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

getSize

public Dimension getSize(Dimension rv)

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

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

getLocation

public Point getLocation(Point rv)

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

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

isOpaque

public boolean isOpaque()

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

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

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

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

isLightweight

public boolean isLightweight()

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

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

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

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

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

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

isPreferredSizeSet

public boolean isPreferredSizeSet()

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

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

getPreferredSize

public Dimension getPreferredSize()

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

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

preferredSize

@Deprecated
public Dimension preferredSize()
Устаревшее.
Начиная с JDK версии 1.1, заменено на getPreferredSize().

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

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

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

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

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

isMinimumSizeSet

public boolean isMinimumSizeSet()

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

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

getMinimumSize

public Dimension getMinimumSize()

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

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

minimumSize

@Deprecated
public Dimension minimumSize()
Устаревшее.
Начиная с JDK версии 1.1, заменено на getMinimumSize().

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

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

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

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

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

isMaximumSizeSet

public boolean isMaximumSizeSet()

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

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

getMaximumSize

public Dimension getMaximumSize()

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

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

getAlignmentX

public float getAlignmentX()

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

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

getAlignmentY

public float getAlignmentY()

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

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

getBaseline

public int getBaseline(int width,
                       int height)

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

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

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

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior()

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

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

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

doLayout

public void doLayout()

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

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

layout

@Deprecated
public void layout()
Устаревшее.
Начиная с JDK версии 1.1, заменено на doLayout().

validate

public void validate()

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

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

С:
1.0
См. также:
invalidate(), doLayout(), LayoutManager, Container.validate()

invalidate

public void invalidate()

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

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

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

С:
1.0
См. также:
validate(), doLayout(), LayoutManager, Container.isValidateRoot()

revalidate

public void revalidate()

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

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

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

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

getGraphics

public Graphics getGraphics()

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

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

getFontMetrics

public FontMetrics getFontMetrics(Font font)

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

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

setCursor

public void setCursor(Cursor cursor)

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

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

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

getCursor

public Cursor getCursor()

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

Возвращает:
курсор для этого компонента
С:
1.1
См. также:
setCursor(java.awt.Cursor)

isCursorSet

public boolean isCursorSet()

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

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

paint

public void paint(Graphics g)

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

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

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

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

Параметры:
g - контекст графики для отрисовки
С:
1.0
См. также:
update(java.awt.Graphics)

update

public void update(Graphics g)

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

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

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

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

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

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

paintAll

public void paintAll(Graphics g)

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

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

Параметры:
g - контекст графики для отрисовки
С:
1.0
См. также:
paint(java.awt.Graphics)

repaint

public void repaint()

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

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

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

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

repaint

public void repaint(long tm)

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

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

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

repaint

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

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

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

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

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

repaint

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

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

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

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

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

print

public void print(Graphics g)

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

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

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

Параметры:
g - контекст графики для печати
С:
1.0
См. также:
paint(Graphics)

printAll

public void printAll(Graphics g)

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

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

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

imageUpdate

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

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

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

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

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

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

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

createImage

public Image createImage(ImageProducer producer)

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

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

createImage

public Image createImage(int width,
                         int height)

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

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

createVolatileImage

public VolatileImage createVolatileImage(int width,
                                         int height)

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

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

createVolatileImage

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

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

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

prepareImage

public boolean prepareImage(Image image,
                            ImageObserver observer)

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

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

prepareImage

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

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

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

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

checkImage

public int checkImage(Image image,
                      ImageObserver observer)

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

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

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

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

checkImage

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

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

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

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

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

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

setIgnoreRepaint

public void setIgnoreRepaint(boolean ignoreRepaint)

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

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

Параметры:
ignoreRepaint - true, если сообщения о рисовании от операционной системы должны игнорироваться; в противном случае false
С тех пор:
1.4
См. также:
getIgnoreRepaint(), Canvas.createBufferStrategy(int), Window.createBufferStrategy(int), BufferStrategy, GraphicsDevice.setFullScreenWindow(java.awt.Window)

getIgnoreRepaint

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

contains

public boolean contains(int x,
                        int y)

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

Параметры:
x - координата x точки
y - координата y точки
Возвращает:
true, если точка находится внутри компонента; в противном случае false
С тех пор:
1.1
См. также:
getComponentAt(int, int)

inside

@Deprecated
public boolean inside(int x,
                      int y)
Устарело.
Начиная с версии JDK 1.1, заменено на contains(int, int).

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

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

contains

public boolean contains(Point p)

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

Параметры:
p - точка
Возвращает:
true, если точка находится внутри компонента; в противном случае false
Исключение:
NullPointerException - если p является null
С тех пор:
1.1
См. также:
getComponentAt(Point)

getComponentAt

public Component getComponentAt(int x,
                                int y)

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

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

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

locate

@Deprecated
public Component locate(int x,
                        int y)
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentAt(int, int).

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

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

getComponentAt

public Component getComponentAt(Point p)

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

Параметры:
p - точка
Возвращает:
компонент в указанном месте или null
С тех пор:
1.1
См. также:
contains(int, int)

deliverEvent

@Deprecated
public void deliverEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent e).
Параметры:
e - событие для доставки

dispatchEvent

public final void dispatchEvent(AWTEvent e)

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

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

postEvent

@Deprecated
public boolean postEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent).

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

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

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

addComponentListener

public void addComponentListener(ComponentListener l)

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

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

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

removeComponentListener

public void removeComponentListener(ComponentListener l)

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

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

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

getComponentListeners

public ComponentListener[] getComponentListeners()

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

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

addFocusListener

public void addFocusListener(FocusListener l)

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

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

Параметры:
l - слушатель фокуса
С тех пор:
1.1
См. также:
FocusEvent, FocusListener, removeFocusListener(java.awt.event.FocusListener), getFocusListeners()

removeFocusListener

public void removeFocusListener(FocusListener l)

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

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

Параметры:
l - слушатель фокуса
С тех пор:
1.1
См. также:
FocusEvent, FocusListener, addFocusListener(java.awt.event.FocusListener), getFocusListeners()

getFocusListeners

public FocusListener[] getFocusListeners()

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

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

addHierarchyListener

public void addHierarchyListener(HierarchyListener l)

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

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

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

removeHierarchyListener

public void removeHierarchyListener(HierarchyListener l)

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

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

Параметры:
l — слушатель иерархии
С тех пор:
1.3
См. также:
HierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()

getHierarchyListeners

public HierarchyListener[] getHierarchyListeners()

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

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

addHierarchyBoundsListener

public void addHierarchyBoundsListener(HierarchyBoundsListener l)

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

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

Параметры:
l — слушатель границ иерархии
С тех пор:
1.3
См. также:
HierarchyEvent, HierarchyBoundsListener, removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()

removeHierarchyBoundsListener

public void removeHierarchyBoundsListener(HierarchyBoundsListener l)

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

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

Параметры:
l — слушатель границ иерархии
С тех пор:
1.3
См. также:
HierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()

getHierarchyBoundsListeners

public HierarchyBoundsListener[] getHierarchyBoundsListeners()

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

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

addKeyListener

public void addKeyListener(KeyListener l)

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

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

Параметры:
l — слушатель нажатия клавиш.
С тех пор:
1.1
См. также:
KeyEvent, KeyListener, removeKeyListener(java.awt.event.KeyListener), getKeyListeners()

removeKeyListener

public void removeKeyListener(KeyListener l)

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

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

Параметры:
l — слушатель нажатия клавиш
С тех пор:
1.1
См. также:
KeyEvent, KeyListener, addKeyListener(java.awt.event.KeyListener), getKeyListeners()

getKeyListeners

public KeyListener[] getKeyListeners()

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

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

addMouseListener

public void addMouseListener(MouseListener l)

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

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

Параметры:
l — слушатель мыши
С тех пор:
1.1
См. также:
MouseEvent, MouseListener, removeMouseListener(java.awt.event.MouseListener), getMouseListeners()

removeMouseListener

public void removeMouseListener(MouseListener l)

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

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

Параметры:
l — слушатель мыши
С тех пор:
1.1
См. также:
MouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), getMouseListeners()

getMouseListeners

public MouseListener[] getMouseListeners()

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

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

addMouseMotionListener

public void addMouseMotionListener(MouseMotionListener l)

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

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

Параметры:
l - слушатель движений мыши
С:
1.1
См. также:
MouseEvent, MouseMotionListener, removeMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()

removeMouseMotionListener

public void removeMouseMotionListener(MouseMotionListener l)

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

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

Параметры:
l - слушатель движений мыши
С:
1.1
См. также:
MouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()

getMouseMotionListeners

public MouseMotionListener[] getMouseMotionListeners()

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

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

addMouseWheelListener

public void addMouseWheelListener(MouseWheelListener l)

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

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

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

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

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

removeMouseWheelListener

public void removeMouseWheelListener(MouseWheelListener l)

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

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

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

getMouseWheelListeners

public MouseWheelListener[] getMouseWheelListeners()

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

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

addInputMethodListener

public void addInputMethodListener(InputMethodListener l)

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

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

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

removeInputMethodListener

public void removeInputMethodListener(InputMethodListener l)

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

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

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

getInputMethodListeners

public InputMethodListener[] getInputMethodListeners()

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

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

getListeners

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

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

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

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

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()

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

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

getInputContext

public InputContext getInputContext()

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

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

enableEvents

protected final void enableEvents(long eventsToEnable)

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

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

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

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

disableEvents

protected final void disableEvents(long eventsToDisable)

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

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

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(java.awt.event.ComponentEvent), processFocusEvent(java.awt.event.FocusEvent), processKeyEvent(java.awt.event.KeyEvent), processMouseEvent(java.awt.event.MouseEvent), processMouseMotionEvent(java.awt.event.MouseEvent), processInputMethodEvent(java.awt.event.InputMethodEvent), processHierarchyEvent(java.awt.event.HierarchyEvent), processMouseWheelEvent(java.awt.event.MouseWheelEvent)

processComponentEvent

protected void processComponentEvent(ComponentEvent e)

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

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

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

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

Параметры:
e - событие компонента
С:
1.1
См. также:
ComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), enableEvents(long)

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
См. также:
FocusEvent, FocusListener, KeyboardFocusManager, addFocusListener(java.awt.event.FocusListener), enableEvents(long), dispatchEvent(java.awt.AWTEvent)

processKeyEvent

protected void processKeyEvent(KeyEvent e)

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

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

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

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

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

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

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

Параметры:
e - событие нажатия клавиши
С:
1.1
См. также:
KeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, processEvent(java.awt.AWTEvent), dispatchEvent(java.awt.AWTEvent), addKeyListener(java.awt.event.KeyListener), enableEvents(long), isShowing()

processMouseEvent

protected void processMouseEvent(MouseEvent e)

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

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

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

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

Параметры:
e - событие мыши
С:
1.1
См. также:
MouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), enableEvents(long)

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

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

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

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

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

Параметры:
e - событие движения мыши
С версии:
1.1
См. также:
MouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), enableEvents(long)

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent e)

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

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

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

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

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

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

processInputMethodEvent

protected void processInputMethodEvent(InputMethodEvent e)

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

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

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

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

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

processHierarchyEvent

protected void processHierarchyEvent(HierarchyEvent e)

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

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

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

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

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

processHierarchyBoundsEvent

protected void processHierarchyBoundsEvent(HierarchyEvent e)

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

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

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

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

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

handleEvent

@Deprecated
public boolean handleEvent(Event evt)
Устарело.
Начиная с версии JDK 1.1 заменено на processEvent(AWTEvent).
Параметры:
evt - событие для обработки
Возвращает:
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 отображаемым, подключив его к собственному ресурсу экрана. Этот метод вызывается внутренне инструментарием и не должен вызываться напрямую программами.

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

С версии:
1.0
См. также:
isDisplayable(), removeNotify(), invalidate()

removeNotify

public void removeNotify()

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

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

С версии:
1.0
См. также:
isDisplayable(), addNotify()

gotFocus

@Deprecated
public boolean gotFocus(Event evt,
                        Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
Параметры:
evt - событие для обработки
what - объект, получивший фокус
Возвращает:
false

lostFocus

@Deprecated
public boolean lostFocus(Event evt,
                         Object what)
Устарело.
Начиная с JDK версии 1.1, заменено на processFocusEvent(FocusEvent).
Параметры:
evt - событие для обработки
what - объект, получивший фокус
Возвращает:
false

isFocusTraversable

@Deprecated
public boolean isFocusTraversable()
Устарело.
Начиная с версии 1.4, заменено на isFocusable().

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

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

isFocusable

public boolean isFocusable()

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

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

setFocusable

public void setFocusable(boolean focusable)

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

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

setFocusTraversalKeys

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

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

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

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

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

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

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

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

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

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

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

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

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

setFocusTraversalKeysEnabled

public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)

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

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

getFocusTraversalKeysEnabled

public boolean getFocusTraversalKeysEnabled()

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

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

requestFocus

public void requestFocus()

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

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

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

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

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

requestFocus

public void requestFocus(FocusEvent.Cause cause)

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

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

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

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

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

Параметры:
cause - причина запроса фокуса
С:
9
См. также:
FocusEvent, FocusEvent.Cause, requestFocusInWindow(FocusEvent.Cause), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocus

protected boolean requestFocus(boolean temporary)

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

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

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

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

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

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

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

requestFocus

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

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

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

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

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

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

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

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

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

requestFocusInWindow

public boolean requestFocusInWindow()

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

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

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

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

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

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

requestFocusInWindow

public boolean requestFocusInWindow(FocusEvent.Cause cause)

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

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

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

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

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

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

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

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

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

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

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

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

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

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

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

getFocusCycleRootAncestor

public Container getFocusCycleRootAncestor()

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

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

isFocusCycleRoot

public boolean isFocusCycleRoot(Container container)

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

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

transferFocus

public void transferFocus()

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

С момента:
1.1
См. также:
requestFocus()

nextFocus

@Deprecated
public void nextFocus()
Устарело.
С версии JDK 1.1, заменено на transferFocus().

transferFocusBackward

public void transferFocusBackward()

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

С момента:
1.4
См. также:
requestFocus()

transferFocusUpCycle

public void transferFocusUpCycle()

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

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

hasFocus

public boolean hasFocus()

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

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

isFocusOwner

public boolean isFocusOwner()

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

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

add

public void add(PopupMenu popup)

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

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

remove

public void remove(MenuComponent popup)

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

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

paramString

protected String paramString()

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

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

toString

public String toString()

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

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

list

public void list()

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

С версии:
1.0
См. также:
System.out

list

public void list(PrintStream out)

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

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

list

public void list(PrintStream out,
                 int indent)

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

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

list

public void list(PrintWriter out)

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

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

list

public void list(PrintWriter out,
                 int indent)

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

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

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

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

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

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

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

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

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

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

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

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

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)

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

  • шрифт этого компонента ("font")
  • цвет фона этого компонента ("background")
  • цвет переднего плана этого компонента ("foreground")
  • возможность получения фокуса этим компонентом ("focusable")
  • состояние включения клавиш перехода фокуса этого компонента ("focusTraversalKeysEnabled")
  • набор клавиш прямого перехода фокуса этого компонента ("forwardFocusTraversalKeys")
  • набор клавиш обратного перехода фокуса этого компонента ("backwardFocusTraversalKeys")
  • набор клавиш циклического перехода фокуса вверх этого компонента ("upCycleFocusTraversalKeys")
Обратите внимание, что если этот Component наследует связанное свойство, то событие не будет вызвано в ответ на изменение унаследованного свойства.

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

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

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName,
                                         PropertyChangeListener listener)

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

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

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

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

setComponentOrientation

public void setComponentOrientation(ComponentOrientation o)

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

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

Для установки ориентации отдельного компонента используйте этот метод. Для установки ориентации всей иерархии компонентов используйте applyComponentOrientation.

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

Параметры:
o - задаваемое направление
См. также:
ComponentOrientation, invalidate()

getComponentOrientation

public ComponentOrientation getComponentOrientation()

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

Возвращает:
направление для упорядочения элементов или текста
См. также:
ComponentOrientation

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation orientation)

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

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

setMixingCutoutShape

public void setMixingCutoutShape(Shape shape)

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

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

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

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

Параметры:
shape - новая форма 'вырезки смешивания'
С тех пор:
9

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

Spec-Zone .ru
спецификации, руководства, описания, API