Класс Component

java.lang.Object

java.awt.Component

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также:

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

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

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

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

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

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

Модификатор и тип	Поле	Описание
`static final int`	`ABORT`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что асинхронно отслеживаемое изображение было прервано до завершения генерации.
`static final int`	`ALLBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что статическое изображение, которое ранее отрисовывалось, теперь завершено и может быть отрисовано снова в окончательном виде.
`static final int`	`ERROR`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что при асинхронном отслеживании изображения произошла ошибка.
`static final int`	`FRAMEBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что еще один полный кадр многокадрового изображения, который ранее отрисовывался, теперь доступен для повторной отрисовки.
`static final int`	`HEIGHT`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что высота базового изображения теперь доступна и может быть получена из аргумента height метода обратного вызова imageUpdate.
`static final int`	`PROPERTIES`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что свойства изображения теперь доступны.
`static final int`	`SOMEBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что доступно больше пикселей, необходимых для отрисовки масштабированного варианта изображения.
`static final int`	`WIDTH`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что ширина базового изображения теперь доступна и может быть получена из аргумента width метода обратного вызова imageUpdate.

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

Component()

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

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

Modifier and Type	Method	Description
`boolean`	`action(Event evt, Object what)`	Deprecated. Начиная с версии JDK 1.1, следует регистрировать этот компонент в качестве ActionListener для компонента, который инициирует события действий (action events).
`void`	`add(PopupMenu popup)`	Добавляет указанное всплывающее меню к компоненту.
`void`	`addComponentListener(ComponentListener l)`	Добавляет указанный слушатель компонента для получения событий компонента от этого компонента.
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента при получении им фокуса ввода.
`void`	`addHierarchyBoundsListener(HierarchyBoundsListener l)`	Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит данный контейнер.
`void`	`addHierarchyListener(HierarchyListener l)`	Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит данный контейнер.
`void`	`addInputMethodListener(InputMethodListener l)`	Добавляет указанный слушатель метода ввода для получения событий метода ввода от этого компонента.
`void`	`addKeyListener(KeyListener l)`	Добавляет указанный слушатель клавиатуры для получения событий клавиатуры от этого компонента.
`void`	`addMouseListener(MouseListener l)`	Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
`void`	`addMouseMotionListener(MouseMotionListener l)`	Добавляет указанный слушатель перемещения мыши для получения событий перемещения мыши от этого компонента.
`void`	`addMouseWheelListener(MouseWheelListener l)`	Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента.
`void`	`addNotify()`	Делает этот `Component` отображаемым, подключая его к собственному экранному ресурсу.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей для определенного свойства.
`void`	`applyComponentOrientation(ComponentOrientation orientation)`	Устанавливает свойство `ComponentOrientation` этого компонента и всех содержащихся в нем компонентов.
`boolean`	`areFocusTraversalKeysSet(int id)`	Возвращает значение, указывающее, был ли набор клавиш обхода фокуса для данной операции обхода фокуса явно определен для этого Component.
`Rectangle`	`bounds()`	Deprecated. Начиная с версии 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)`	Создает изображение из указанного источника изображений (image producer).
`VolatileImage`	`createVolatileImage(int width, int height)`	Создает энергонезависимое (volatile) закадровое отрисовываемое изображение для использования в двойной буферизации.
`VolatileImage`	`createVolatileImage(int width, int height, ImageCapabilities caps)`	Создает энергонезависимое (volatile) закадровое отрисовываемое изображение с заданными возможностями.
`void`	`deliverEvent(Event e)`	Deprecated. Начиная с версии JDK 1.1, заменено на `dispatchEvent(AWTEvent e)`.
`void`	`disable()`	Deprecated. Начиная с версии JDK 1.1, заменено на `setEnabled(boolean)`.
`protected final void`	`disableEvents(long eventsToDisable)`	Отключает доставку событий, определенных указанным параметром маски событий, этому компоненту.
`final void`	`dispatchEvent(AWTEvent e)`	Диспетчеризирует событие этому компоненту или одному из его подкомпонентов.
`void`	`doLayout()`	Побуждает менеджер компоновки выполнить компоновку этого компонента.
`void`	`enable()`	Deprecated. Начиная с версии JDK 1.1, заменено на `setEnabled(boolean)`.
`void`	`enable(boolean b)`	Deprecated. Начиная с версии JDK 1.1, заменено на `setEnabled(boolean)`.
`protected final void`	`enableEvents(long eventsToEnable)`	Включает доставку событий, определенных указанным параметром маски событий, этому компоненту.
`void`	`enableInputMethods(boolean enable)`	Включает или отключает поддержку методов ввода для этого компонента.
`protected void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)`	Поддержка оповещения об изменениях связных свойств (bound property) для логических свойств.
`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)`	Поддержка оповещения об изменениях связных свойств (bound property) для целочисленных свойств.
`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)`	Поддержка оповещения об изменениях связных свойств (bound property) для свойств типа Object.
`AccessibleContext`	`getAccessibleContext()`	Возвращает `AccessibleContext`, связанный с этим `Component`.
`float`	`getAlignmentX()`	Возвращает выравнивание по оси x.
`float`	`getAlignmentY()`	Возвращает выравнивание по оси y.
`Color`	`getBackground()`	Возвращает цвет фона этого компонента.
`int`	`getBaseline(int width, int height)`	Возвращает базовую линию.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior()`	Возвращает перечисление, указывающее, как базовая линия компонента изменяется при изменении его размера.
`Rectangle`	`getBounds()`	Возвращает границы этого компонента в виде объекта `Rectangle`.
`Rectangle`	`getBounds(Rectangle rv)`	Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
`ColorModel`	`getColorModel()`	Возвращает экземпляр `ColorModel`, используемый для отображения компонента на устройстве вывода.
`Component`	`getComponentAt(int x, int y)`	Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов позицию (x, y), и если да, возвращает содержащий ее компонент.
`Component`	`getComponentAt(Point p)`	Возвращает компонент или подкомпонент, содержащий указанную точку.
`ComponentListener[]`	`getComponentListeners()`	Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
`ComponentOrientation`	`getComponentOrientation()`	Получает языковую ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
`Cursor`	`getCursor()`	Возвращает курсор, установленный в компоненте.
`DropTarget`	`getDropTarget()`	Возвращает `DropTarget`, связанный с этим `Component`.
`Container`	`getFocusCycleRootAncestor()`	Возвращает Container, который является корнем цикла фокуса для цикла обхода фокуса этого Component.
`FocusListener[]`	`getFocusListeners()`	Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
`Set<AWTKeyStroke>`	`getFocusTraversalKeys(int id)`	Возвращает набор Set клавиш обхода фокуса для данной операции обхода для этого Component.
`boolean`	`getFocusTraversalKeysEnabled()`	Возвращает значение, указывающее, включены ли клавиши обхода фокуса для этого Component.
`Font`	`getFont()`	Возвращает шрифт этого компонента.
`FontMetrics`	`getFontMetrics(Font font)`	Возвращает метрики шрифта для указанного шрифта.
`Color`	`getForeground()`	Возвращает цвет переднего плана этого компонента.
`Graphics`	`getGraphics()`	Создает графический контекст для этого компонента.
`GraphicsConfiguration`	`getGraphicsConfiguration()`	Возвращает `GraphicsConfiguration`, связанный с этим `Component`.
`int`	`getHeight()`	Возвращает текущую высоту этого компонента.
`HierarchyBoundsListener[]`	`getHierarchyBoundsListeners()`	Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
`HierarchyListener[]`	`getHierarchyListeners()`	Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
`boolean`	`getIgnoreRepaint()`	Возвращает значение, указывающее, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
`InputContext`	`getInputContext()`	Возвращает контекст ввода, используемый этим компонентом для обработки взаимодействия с методами ввода при вводе текста в этот компонент.
`InputMethodListener[]`	`getInputMethodListeners()`	Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
`InputMethodRequests`	`getInputMethodRequests()`	Возвращает обработчик запросов метода ввода, который поддерживает запросы от методов ввода для этого компонента.
`KeyListener[]`	`getKeyListeners()`	Возвращает массив всех слушателей клавиатуры, зарегистрированных для этого компонента.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, зарегистрированных в настоящее время как `FooListener` для этого `Component`.
`Locale`	`getLocale()`	Возвращает локаль этого компонента.
`Point`	`getLocation()`	Возвращает положение этого компонента в виде точки, указывающей левый верхний угол компонента.
`Point`	`getLocation(Point rv)`	Сохраняет начало координат x,y этого компонента в «возвращаемое значение» rv и возвращает rv.
`Point`	`getLocationOnScreen()`	Возвращает положение этого компонента в виде точки, указывающей левый верхний угол компонента в пространстве координат экрана.
`Dimension`	`getMaximumSize()`	Возвращает максимальный размер этого компонента.
`Dimension`	`getMinimumSize()`	Возвращает минимальный размер этого компонента.
`MouseListener[]`	`getMouseListeners()`	Возвращает массив всех слушателей мыши, зарегистрированных для этого компонента.
`MouseMotionListener[]`	`getMouseMotionListeners()`	Возвращает массив всех слушателей перемещения мыши, зарегистрированных для этого компонента.
`Point`	`getMousePosition()`	Возвращает позицию указателя мыши в системе координат этого `Component`, если `Component` находится непосредственно под указателем мыши, в противном случае возвращает `null`.
`MouseWheelListener[]`	`getMouseWheelListeners()`	Возвращает массив всех слушателей колесика мыши, зарегистрированных для этого компонента.
`String`	`getName()`	Возвращает имя компонента.
`Container`	`getParent()`	Возвращает родительский компонент этого компонента.
`Dimension`	`getPreferredSize()`	Возвращает предпочтительный размер этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех слушателей изменения свойств, зарегистрированных для этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)`	Возвращает массив всех слушателей, связанных с указанным свойством.
`Dimension`	`getSize()`	Возвращает размер этого компонента в виде объекта `Dimension`.
`Dimension`	`getSize(Dimension rv)`	Сохраняет ширину/высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
`Toolkit`	`getToolkit()`	Возвращает инструментарий (toolkit) этого компонента.
`final Object`	`getTreeLock()`	Возвращает объект блокировки этого компонента (объект, владеющий монитором синхронизации потоков) для операций с деревом компонентов AWT и компоновкой.
`int`	`getWidth()`	Возвращает текущую ширину этого компонента.
`int`	`getX()`	Возвращает текущую координату x начала координат компонента.
`int`	`getY()`	Возвращает текущую координату y начала координат компонента.
`boolean`	`gotFocus(Event evt, Object what)`	Deprecated. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
`boolean`	`handleEvent(Event evt)`	Deprecated. Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent).
`boolean`	`hasFocus()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`void`	`hide()`	Deprecated. Начиная с версии 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)`	Deprecated. Начиная с версии JDK 1.1, заменено на contains(int, int).
`void`	`invalidate()`	Делает недействительным этот компонент и его предков.
`boolean`	`isBackgroundSet()`	Возвращает значение, указывающее, был ли цвет фона явно задан для этого Component.
`boolean`	`isCursorSet()`	Возвращает значение, указывающее, был ли курсор явно задан для этого Component.
`boolean`	`isDisplayable()`	Определяет, является ли этот компонент отображаемым.
`boolean`	`isDoubleBuffered()`	Возвращает true, если этот компонент отрисовывается в закадровое изображение («буфер»), которое позже копируется на экран.
`boolean`	`isEnabled()`	Определяет, включен ли этот компонент.
`boolean`	`isFocusable()`	Возвращает значение, указывающее, может ли этот Component получать фокус.
`boolean`	`isFocusCycleRoot(Container container)`	Возвращает значение, указывающее, является ли указанный Container корнем цикла фокуса для цикла обхода фокуса этого Component.
`boolean`	`isFocusOwner()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`boolean`	`isFocusTraversable()`	Deprecated. Начиная с версии 1.4, заменено на `isFocusable()`.
`boolean`	`isFontSet()`	Возвращает значение, указывающее, был ли шрифт явно задан для этого Component.
`boolean`	`isForegroundSet()`	Возвращает значение, указывающее, был ли цвет переднего плана явно задан для этого Component.
`boolean`	`isLightweight()`	Облегченный (lightweight) компонент не имеет платформенного аналога (native peer).
`boolean`	`isMaximumSizeSet()`	Возвращает true, если максимальный размер был установлен в значение, отличное от `null`, в противном случае возвращает false.
`boolean`	`isMinimumSizeSet()`	Возвращает значение, указывающее, был ли вызван метод `setMinimumSize` со значением, отличным от null.
`boolean`	`isOpaque()`	Возвращает true, если этот компонент полностью непрозрачен, по умолчанию возвращает false.
`boolean`	`isPreferredSizeSet()`	Возвращает true, если предпочтительный размер был установлен в значение, отличное от `null`, в противном случае возвращает false.
`boolean`	`isShowing()`	Определяет, отображается ли этот компонент на экране.
`boolean`	`isValid()`	Определяет, является ли этот компонент корректным (valid).
`boolean`	`isVisible()`	Определяет, должен ли этот компонент быть видимым, когда видим его родительский компонент.
`boolean`	`keyDown(Event evt, int key)`	Deprecated. Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
`boolean`	`keyUp(Event evt, int key)`	Deprecated. Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
`void`	`layout()`	Deprecated. Начиная с версии JDK 1.1, заменено на `doLayout()`.
`void`	`list()`	Выводит список этого компонента в стандартный поток системного вывода `System.out`.
`void`	`list(PrintStream out)`	Выводит список этого компонента в указанный поток вывода.
`void`	`list(PrintStream out, int indent)`	Выводит список, начиная с указанного отступа, в указанный поток печати.
`void`	`list(PrintWriter out)`	Выводит список в указанный print writer.
`void`	`list(PrintWriter out, int indent)`	Выводит список, начиная с указанного отступа, в указанный print writer.
`Component`	`locate(int x, int y)`	Deprecated. Начиная с версии JDK 1.1, заменено на getComponentAt(int, int).
`Point`	`location()`	Deprecated. Начиная с версии JDK 1.1, заменено на `getLocation()`.
`boolean`	`lostFocus(Event evt, Object what)`	Deprecated. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
`Dimension`	`minimumSize()`	Deprecated. Начиная с версии JDK 1.1, заменено на `getMinimumSize()`.
`boolean`	`mouseDown(Event evt, int x, int y)`	Deprecated. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseDrag(Event evt, int x, int y)`	Deprecated. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseEnter(Event evt, int x, int y)`	Deprecated. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseExit(Event evt, int x, int y)`	Deprecated. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseMove(Event evt, int x, int y)`	Deprecated. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseUp(Event evt, int x, int y)`	Deprecated. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`void`	`move(int x, int y)`	Deprecated. Начиная с версии JDK 1.1, заменено на `setLocation(int, int)`.
`void`	`nextFocus()`	Deprecated. Начиная с версии JDK 1.1, заменено на transferFocus().
`void`	`paint(Graphics g)`	Отрисовывает этот компонент.
`void`	`paintAll(Graphics g)`	Отрисовывает этот компонент и все его подкомпоненты.
`protected String`	`paramString()`	Возвращает строку, представляющую состояние этого компонента.
`boolean`	`postEvent(Event e)`	Deprecated. Начиная с версии 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()`	Запрашивает передачу фокуса ввода этому Component и делает окно верхнего уровня предка этого Component активным Window.
`protected boolean`	`requestFocus(boolean temporary)`	Запрашивает передачу фокуса ввода этому `Component` и делает окно верхнего уровня предка этого `Component` активным `Window`.
`protected boolean`	`requestFocus(boolean temporary, FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому `Component` и делает окно верхнего уровня предка этого `Component` активным `Window`.
`void`	`requestFocus(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому Component и делает окно верхнего уровня предка этого Component активным Window.
`boolean`	`requestFocusInWindow()`	Запрашивает передачу фокуса ввода этому Component, если предок верхнего уровня этого Component уже является активным Window.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Запрашивает передачу фокуса ввода этому `Component`, если предок верхнего уровня этого `Component` уже является активным `Window`.
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому Component, если предок верхнего уровня этого Component уже является активным Window.
`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)`	Устанавливает состояние фокусируемости этого Component в указанное значение.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Устанавливает клавиши перемещения фокуса для заданной операции перемещения для этого Component.
`void`	`setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)`	Определяет, включены ли клавиши перемещения фокуса для этого Component.
`void`	`setFont(Font f)`	Устанавливает шрифт этого компонента.
`void`	`setForeground(Color c)`	Устанавливает цвет переднего плана этого компонента.
`void`	`setIgnoreRepaint(boolean ignoreRepaint)`	Определяет, следует ли игнорировать сообщения о перерисовке, полученные от операционной системы.
`void`	`setLocale(Locale l)`	Устанавливает языковой стандарт (locale) этого компонента.
`void`	`setLocation(int x, int y)`	Перемещает этот компонент на новую позицию.
`void`	`setLocation(Point p)`	Перемещает этот компонент на новую позицию.
`void`	`setMaximumSize(Dimension maximumSize)`	Устанавливает максимальный размер этого компонента в постоянное значение.
`void`	`setMinimumSize(Dimension minimumSize)`	Устанавливает минимальный размер этого компонента в постоянное значение.
`void`	`setMixingCutoutShape(Shape shape)`	Задает форму «mixing-cutout» для этого легковесного компонента.
`void`	`setName(String name)`	Устанавливает имя компонента в указанную строку.
`void`	`setPreferredSize(Dimension preferredSize)`	Устанавливает предпочтительный размер этого компонента в постоянное значение.
`void`	`setSize(int width, int height)`	Изменяет размер этого компонента так, чтобы он имел ширину `width` и высоту `height`.
`void`	`setSize(Dimension d)`	Изменяет размер этого компонента так, чтобы он имел ширину `d.width` и высоту `d.height`.
`void`	`setVisible(boolean b)`	Отображает или скрывает этот компонент в зависимости от значения параметра `b`.
`void`	`show()`	Устарело. Начиная с версии JDK 1.1, заменено на `setVisible(boolean)`.
`void`	`show(boolean b)`	Устарело. Начиная с версии JDK 1.1, заменено на `setVisible(boolean)`.
`Dimension`	`size()`	Устарело. Начиная с версии JDK 1.1, заменено на `getSize()`.
`String`	`toString()`	Возвращает строковое представление этого компонента и его значений.
`void`	`transferFocus()`	Передает фокус следующему компоненту так, как если бы этот Component был владельцем фокуса.
`void`	`transferFocusBackward()`	Передает фокус предыдущему компоненту так, как если бы этот Component был владельцем фокуса.
`void`	`transferFocusUpCycle()`	Передает фокус на один цикл обхода фокуса вверх.
`void`	`update(Graphics g)`	Обновляет этот компонент.
`void`	`validate()`	Проверяет корректность (валидирует) этот компонент.

Методы, унаследованные из класса Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект «этому».
`protected void`	`finalize()`	Устарело, для удаления: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в будущей версии.
`final Class<?>`	`getClass()`	Возвращает класс среды выполнения для этого `Object`.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Переводит текущий поток в режим ожидания до тех пор, пока он не будет разбужен, обычно посредством оповещения или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в режим ожидания до тех пор, пока он не будет разбужен, обычно посредством оповещения или прерывания, либо пока не истечет определенное время реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в режим ожидания до тех пор, пока он не будет разбужен, обычно посредством оповещения или прерывания, либо пока не истечет определенное время реального времени.

Подробное описание полей

TOP_ALIGNMENT

public static final float TOP_ALIGNMENT

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

См. также:

CENTER_ALIGNMENT

public static final float CENTER_ALIGNMENT

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

См. также:

BOTTOM_ALIGNMENT

public static final float BOTTOM_ALIGNMENT

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

См. также:

LEFT_ALIGNMENT

public static final float LEFT_ALIGNMENT

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

См. также:

RIGHT_ALIGNMENT

public static final float RIGHT_ALIGNMENT

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

См. также:

accessibleContext

protected AccessibleContext accessibleContext

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

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

Component

protected Component()

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

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

getName

public String getName()

Возвращает имя компонента.

Возвращает:

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

С версии:

1.1

См. также:

setName

public void setName(String name)

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

Параметры:

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

С версии:

1.1

См. также:

getParent

public Container getParent()

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

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

setDropTarget

public void setDropTarget(DropTarget dt)

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

Параметры:

dt - объект DropTarget

См. также:

getDropTarget

public DropTarget getDropTarget()

Возвращает DropTarget, связанный с этим Component.

Возвращает:: цель сброса

getGraphicsConfiguration

public GraphicsConfiguration getGraphicsConfiguration()

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

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

getTreeLock

public final Object getTreeLock()

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

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

getToolkit

public Toolkit getToolkit()

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

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

isValid

public boolean isValid()

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

Возвращает:

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

С версии:

1.0

См. также:

isDisplayable

public boolean isDisplayable()

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

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

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

Возвращает:

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

С версии:

1.2

См. также:

isVisible

public boolean isVisible()

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

Возвращает:

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

С версии:

1.0

См. также:

getMousePosition

public Point getMousePosition() throws HeadlessException

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

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

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

Возвращает:

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

Исключения:

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

С версии:

1.5

См. также:

isShowing

public boolean isShowing()

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

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

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

Возвращает:

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

С версии:

1.0

См. также:

isEnabled

public boolean isEnabled()

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

Возвращает:

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

С версии:

1.0

См. также:

setEnabled

public void setEnabled(boolean b)

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

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

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

Параметры:

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

С версии:

1.1

См. также:

enable

@Deprecated public void enable()

Устарело.

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

enable

@Deprecated public void enable(boolean b)

Устарело.

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

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

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

disable

@Deprecated public void disable()

Устарело.

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

isDoubleBuffered

public boolean isDoubleBuffered()

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

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

enableInputMethods

public void enableInputMethods(boolean enable)

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

Параметры:

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

С версии:

1.2

См. также:

setVisible

public void setVisible(boolean b)

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

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

Параметры:

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

С версии:

1.1

См. также:

show

@Deprecated public void show()

Устарело.

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

show

@Deprecated public void show(boolean b)

Устарело.

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

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

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

hide

setVisible(boolean)

Устарело.

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

@Deprecated public void hide()

getForeground

public Color getForeground()

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

Возвращает:

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

С версии:

1.0

См. также:

setForeground

public void setForeground(Color c)

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

Параметры:

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

С версии:

1.0

См. также:

isForegroundSet

public boolean isForegroundSet()

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

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

getBackground

public Color getBackground()

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

Возвращает:

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

С версии:

1.0

См. также:

setBackground

public void setBackground(Color c)

Задает цвет фона этого компонента.

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

Параметры:

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

С версии:

1.0

См. также:

isBackgroundSet

public boolean isBackgroundSet()

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

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

getFont

public Font getFont()

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

Указано в:

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

Возвращает:

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

С версии:

1.0

См. также:

setFont

public void setFont(Font f)

Задает шрифт этого компонента.

Параметры:

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

С версии:

1.0

См. также:

isFontSet

public boolean isFontSet()

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

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

getLocale

public Locale getLocale()

Возвращает языковой стандарт (locale) этого компонента.

Возвращает:

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

Исключения:

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

С версии:

1.1

См. также:

setLocale

public void setLocale(Locale l)

Задает языковой стандарт (locale) этого компонента. Это связанное свойство (bound property).

Параметры:

l - языковой стандарт, который должен стать языковым стандартом этого компонента

С версии:

1.1

См. также:

getColorModel

public ColorModel getColorModel()

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

Возвращает:

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

С версии:

1.0

См. также:

getLocation

public Point getLocation()

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

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

Возвращает:

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

С версии:

1.1

См. также:

getLocationOnScreen

public Point getLocationOnScreen()

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

Возвращает:

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

Исключения:

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

См. также:

location

@Deprecated public Point location()

Устарело.

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

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

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

setLocation

public void setLocation(int x, int y)

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

Параметры:

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

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

С версии:

1.1

См. также:

move

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

Устарело.

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

Перемещает этот компонент на новую позицию.

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

setLocation

public void setLocation(Point p)

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

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

Параметры:

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

С какого года / версии:

1.1

См. также:

getSize

public Dimension getSize()

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

Возвращает:

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

С какого года / версии:

1.1

См. также:

size

@Deprecated public Dimension size()

Устарело.

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

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

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

setSize

public void setSize(int width, int height)

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

Параметры:

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

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

С какого года / версии:

1.1

См. также:

resize

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

Устарело.

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

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

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

setSize

public void setSize(Dimension d)

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

Параметры:

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

Исключения:

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

С какого года / версии:

1.1

См. также:

resize

@Deprecated public void resize(Dimension d)

Устарело.

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

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

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

getBounds

public Rectangle getBounds()

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

Возвращает:

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

См. также:

bounds

@Deprecated public Rectangle bounds()

Устарело.

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

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

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

setBounds

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

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

Параметры:

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

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

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

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

С какого года / версии:

1.1

См. также:

reshape

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

Устарело.

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

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

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

setBounds

public void setBounds(Rectangle r)

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

Параметры:

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

Исключения:

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

С какого года / версии:

1.1

См. также:

getX

public int getX()

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

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

getY

public int getY()

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

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

getWidth

public int getWidth()

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

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

getHeight

public int getHeight()

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

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

getBounds

public Rectangle getBounds(Rectangle rv)

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

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

getSize

public Dimension getSize(Dimension rv)

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

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

getLocation

public Point getLocation(Point rv)

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

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

isOpaque

public boolean isOpaque()

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

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

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

Возвращает:

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

С какого года / версии:

1.2

См. также:

isLightweight

public boolean isLightweight()

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

Этот метод всегда будет возвращать false, если этот компонент не может быть отображен (is not displayable), поскольку невозможно определить легковесность неотрисовываемого компонента.

Возвращает:

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

С какого года / версии:

1.2

См. также:

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

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

Параметры:

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

С какого года / версии:

1.5

См. также:

isPreferredSizeSet

public boolean isPreferredSizeSet()

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

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

getPreferredSize

public Dimension getPreferredSize()

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

Возвращает:

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

См. также:

preferredSize

@Deprecated public Dimension preferredSize()

Устарело.

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

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

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

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

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

Параметры:

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

С какого года / версии:

1.5

См. также:

isMinimumSizeSet

public boolean isMinimumSizeSet()

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

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

getMinimumSize

public Dimension getMinimumSize()

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

Возвращает:

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

См. также:

minimumSize

@Deprecated public Dimension minimumSize()

Устарело.

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

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

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

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

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

Параметры:

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

С какого года / версии:

1.5

См. также:

isMaximumSizeSet

public boolean isMaximumSizeSet()

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

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

getMaximumSize

public Dimension getMaximumSize()

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

Возвращает:

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

См. также:

getAlignmentX

public float getAlignmentX()

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

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

getAlignmentY

public float getAlignmentY()

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

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

getBaseline

public int getBaseline(int width, int height)

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

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

Параметры:

width - ширина, для которой необходимо получить базовую линию

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

Возвращает:

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

Исключения:

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

С какого года / версии:

1.6

См. также:

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior()

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

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

Возвращает:

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

С какого года / версии:

1.6

См. также:

doLayout

public void doLayout()

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

См. также:

layout

@Deprecated public void layout()

Устарело.

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

validate

public void validate()

Проверяет правильность (валидирует) этого компонента.

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

С какого года / версии:

1.0

См. также:

invalidate

public void invalidate()

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

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

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

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

С какого года / версии:

1.0

См. также:

revalidate

public void revalidate()

Выполняет повторную валидацию иерархии компонентов вплоть до ближайшего корня валидации (validate root).

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

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

С какого года / версии:

1.7

См. также:

getGraphics

public Graphics getGraphics()

Создает графический контекст для этого компонента. Этот метод вернет null, если компонент в данный момент не может быть отображен (is not displayable).

Возвращает:

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

С какого года / версии:

1.0

См. также:

getFontMetrics

public FontMetrics getFontMetrics(Font font)

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

Параметры:

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

Возвращает:

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

Начиная с:

1.0

См. также:

setCursor

public void setCursor(Cursor cursor)

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

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

Параметры:

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

Начиная с:

1.1

См. также:

getCursor

public Cursor getCursor()

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

Возвращает:

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

Начиная с:

1.1

См. также:

isCursorSet

public boolean isCursorSet()

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

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

paint

public void paint(Graphics g)

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

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

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

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

Параметры:

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

Начиная с:

1.0

См. также:

update

public void update(Graphics g)

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

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

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

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

Параметры:

g — указанный контекст, используемый для обновления

Начиная с:

1.0

См. также:

paintAll

public void paintAll(Graphics g)

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

Параметры:

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

Начиная с:

1.0

См. также:

repaint

public void repaint()

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

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

Начиная с:

1.0

См. также:

repaint

public void repaint(long tm)

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

Параметры:

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

Начиная с:

1.0

См. также:

repaint

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

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

Параметры:

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

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

width — ширина

height — высота

Начиная с:

1.0

См. также:

repaint

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

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

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

Параметры:

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

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

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

width — ширина

height — высота

Начиная с:

1.0

См. также:

print

public void print(Graphics g)

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

Реализация этого метода по умолчанию вызывает метод paint.

Параметры:

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

Начиная с:

1.0

См. также:

printAll

public void printAll(Graphics g)

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

Параметры:

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

Начиная с:

1.0

См. также:

imageUpdate

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

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

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

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

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

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

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

imageUpdate в интерфейсе ImageObserver

Параметры:

img — отслеживаемое изображение

infoflags — подробнее см. imageUpdate

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

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

w — ширина

h — высота

Возвращает:

false, если флаги информации указывают, что изображение полностью загружено; иначе true.

Начиная с:

1.0

См. также:

createImage

public Image createImage(ImageProducer producer)

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

Параметры:: producer — поставщик изображений
Возвращает:: созданное изображение
Начиная с:: 1.0

createImage

public Image createImage(int width, int height)

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

Параметры:

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

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

Возвращает:

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

Начиная с:

1.0

См. также:

createVolatileImage

public VolatileImage createVolatileImage(int width, int height)

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

Параметры:

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

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

Возвращает:

Начиная с:

1.4

См. также:

createVolatileImage

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

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

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

Начиная с:

1.4

См. также:

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

См. также:

checkImage

public int checkImage(Image image, ImageObserver observer)

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

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

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

Параметры:

image — объект Image, состояние которого проверяется

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

Возвращает:

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

Начиная с:

1.0

См. также:

checkImage

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

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

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

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

Параметры:

image — объект Image, состояние которого проверяется

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

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

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

Возвращает:

Начиная с:

1.0

См. также:

setIgnoreRepaint

public void setIgnoreRepaint(boolean ignoreRepaint)

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

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

Параметры:

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

Начиная с:

1.4

См. также:

getIgnoreRepaint

public boolean getIgnoreRepaint()

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

Возвращает:

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

Начиная с:

1.4

См. также:

contains

public boolean contains(int x, int y)

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

Параметры:

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

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

Возвращает:

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

Начиная с:

1.1

См. также:

inside

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

Устарело.

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

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

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

contains

public boolean contains(Point p)

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

Параметры:

p — точка

Возвращает:

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

Исключения:

NullPointerException — если p имеет значение null

Начиная с:

1.1

См. также:

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

См. также:

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

См. также:

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

См. также:

removeComponentListener

public void removeComponentListener(ComponentListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.1

См. также:

getComponentListeners

public ComponentListener[] getComponentListeners()

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

Возвращает:

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

С версии:

1.4

См. также:

addFocusListener

public void addFocusListener(FocusListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.1

См. также:

removeFocusListener

public void removeFocusListener(FocusListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.1

См. также:

getFocusListeners

public FocusListener[] getFocusListeners()

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

Возвращает:

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

С версии:

1.4

См. также:

addHierarchyListener

public void addHierarchyListener(HierarchyListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.3

См. также:

removeHierarchyListener

public void removeHierarchyListener(HierarchyListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.3

См. также:

getHierarchyListeners

public HierarchyListener[] getHierarchyListeners()

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

Возвращает:

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

С версии:

1.4

См. также:

addHierarchyBoundsListener

public void addHierarchyBoundsListener(HierarchyBoundsListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.3

См. также:

removeHierarchyBoundsListener

public void removeHierarchyBoundsListener(HierarchyBoundsListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.3

См. также:

getHierarchyBoundsListeners

public HierarchyBoundsListener[] getHierarchyBoundsListeners()

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

Возвращает:

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

С версии:

1.4

См. также:

addKeyListener

public void addKeyListener(KeyListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

l - слушатель клавиатуры.

С версии:

1.1

См. также:

removeKeyListener

public void removeKeyListener(KeyListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

l - слушатель клавиатуры

С версии:

1.1

См. также:

getKeyListeners

public KeyListener[] getKeyListeners()

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

Возвращает:

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

С версии:

1.4

См. также:

addMouseListener

public void addMouseListener(MouseListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.1

См. также:

removeMouseListener

public void removeMouseListener(MouseListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.1

См. также:

getMouseListeners

public MouseListener[] getMouseListeners()

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

Возвращает:

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

С версии:

1.4

См. также:

addMouseMotionListener

public void addMouseMotionListener(MouseMotionListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

l - слушатель движения мыши

С версии:

1.1

См. также:

removeMouseMotionListener

public void removeMouseMotionListener(MouseMotionListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

l - слушатель движения мыши

С версии:

1.1

См. также:

getMouseMotionListeners

public MouseMotionListener[] getMouseMotionListeners()

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

Возвращает:

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

С версии:

1.4

См. также:

addMouseWheelListener

public void addMouseWheelListener(MouseWheelListener l)

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

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

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.4

См. также:

removeMouseWheelListener

public void removeMouseWheelListener(MouseWheelListener l)

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

Подробнее о многопоточной модели AWT см. в разделе Вопросы многопоточности AWT.

Параметры:

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

С версии:

1.4

См. также:

getMouseWheelListeners

public MouseWheelListener[] getMouseWheelListeners()

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

Возвращает:

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

С версии:

1.4

См. также:

addInputMethodListener

public void addInputMethodListener(InputMethodListener l)

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

Подробнее о потоковой модели AWT см. в разделе AWT Threading Issues.

Параметры:

l - слушатель методов ввода

Начиная с:

1.2

См. также:

removeInputMethodListener

public void removeInputMethodListener(InputMethodListener l)

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

Подробнее о потоковой модели AWT см. в разделе AWT Threading Issues.

Параметры:

l - слушатель методов ввода

Начиная с:

1.2

См. также:

getInputMethodListeners

public InputMethodListener[] getInputMethodListeners()

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

Возвращает:

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

Начиная с:

1.4

См. также:

getListeners

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

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

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

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

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

Параметры типа:

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

Начиная с:

1.3

См. также:

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()

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

Возвращает:

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

Начиная с:

1.2

См. также:

getInputContext

public InputContext getInputContext()

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

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

enableEvents

protected final void enableEvents(long eventsToEnable)

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

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

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

Параметры:

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

Начиная с:

1.1

См. также:

disableEvents

protected final void disableEvents(long eventsToDisable)

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

Параметры:

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

Начиная с:

1.1

См. также:

coalesceEvents

protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)

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

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

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

processEvent

protected void processEvent(AWTEvent e)

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

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

Параметры:

e - событие

Начиная с:

1.1

См. также:

processComponentEvent

protected void processComponentEvent(ComponentEvent e)

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

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

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

Параметры:

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

Начиная с:

1.1

См. также:

processFocusEvent

protected void processFocusEvent(FocusEvent e)

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

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

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

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

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

Параметры:

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

Начиная с:

1.1

См. также:

processKeyEvent

protected void processKeyEvent(KeyEvent e)

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

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

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

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

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

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

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

Параметры:

e - событие клавиатуры

Начиная с:

1.1

См. также:

processMouseEvent

protected void processMouseEvent(MouseEvent e)

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

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

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

Параметры:

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

Начиная с:

1.1

См. также:

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

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

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

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

Параметры:

e - событие перемещения мыши

Начиная с:

1.1

См. также:

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent e)

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

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

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

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

Параметры:

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

Начиная с:

1.4

См. также:

processInputMethodEvent

protected void processInputMethodEvent(InputMethodEvent e)

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

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

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

Параметры:

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

Начиная с:

1.2

См. также:

processHierarchyEvent

protected void processHierarchyEvent(HierarchyEvent e)

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

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

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

Параметры:

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

Начиная с:

1.3

См. также:

processHierarchyBoundsEvent

protected void processHierarchyBoundsEvent(HierarchyEvent e)

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

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

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

Параметры:

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

Начиная с:

1.3

См. также:

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

См. также:

removeNotify

public void removeNotify()

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

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

С версии:

1.0

См. также:

gotFocus

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

Устарело.

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

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

lostFocus

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

Устарело.

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

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

isFocusTraversable

@Deprecated public boolean isFocusTraversable()

Устарело.

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

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

Возвращает:

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

С версии:

1.1

См. также:

isFocusable

public boolean isFocusable()

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

Возвращает:

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

С версии:

1.4

См. также:

setFocusable

public void setFocusable(boolean focusable)

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

Параметры:

focusable - указывает, может ли этот Component получать фокус

С версии:

1.4

См. также:

setFocusTraversalKeys

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

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

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

Рекомендуемые значения по умолчанию для клавиш перемещения фокуса Component
Идентификатор	Значение	По умолчанию
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.

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

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

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

Параметры:

id - одно из значений KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

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

Исключения:

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

С версии:

1.4

См. также:

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

Параметры:

id - одно из значений KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

Возвращает:

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

Исключения:

С версии:

1.4

См. также:

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

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

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

setFocusTraversalKeysEnabled

public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)

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

Параметры:

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

С версии:

1.4

См. также:

getFocusTraversalKeysEnabled

public boolean getFocusTraversalKeysEnabled()

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

Возвращает:

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

С версии:

1.4

См. также:

requestFocus

public void requestFocus()

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

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

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

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

С версии:

1.0

См. также:

requestFocus

public void requestFocus(FocusEvent.Cause cause)

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

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

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

Параметры:

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

С версии:

См. также:

requestFocus

protected boolean requestFocus(boolean temporary)

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

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

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

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

Параметры:

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

Возвращает:

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

С версии:

1.4

См. также:

requestFocus

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

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

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

Параметры:

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

Возвращает:

С версии:

См. также:

requestFocusInWindow

public boolean requestFocusInWindow()

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

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

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

Возвращает:

С версии:

1.4

См. также:

requestFocusInWindow

public boolean requestFocusInWindow(FocusEvent.Cause cause)

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Начиная с:

См. также:

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

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

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

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

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

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

Параметры:

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

Возвращает:

Начиная с:

1.4

См. также:

getFocusCycleRootAncestor

public Container getFocusCycleRootAncestor()

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

Возвращает:

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

Начиная с:

1.4

См. также:

isFocusCycleRoot

public boolean isFocusCycleRoot(Container container)

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

Параметры:

container - проверяемый Container

Возвращает:

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

Начиная с:

1.4

См. также:

transferFocus

public void transferFocus()

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

Начиная с:

1.1

См. также:

nextFocus

@Deprecated public void nextFocus()

Устарело.

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

transferFocusBackward

public void transferFocusBackward()

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

Начиная с:

1.4

См. также:

transferFocusUpCycle

public void transferFocusUpCycle()

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

Начиная с:

1.4

См. также:

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

public void remove(MenuComponent popup)

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

Указано в:

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

Параметры:

popup - удаляемое всплывающее меню

Начиная с:

1.1

См. также:

paramString

protected String paramString()

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

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

toString

public String toString()

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

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

list

public void list()

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

Начиная с:

1.0

См. также:

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

См. также:

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

См. также:

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

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

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

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

Параметры:

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

См. также:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

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

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

Параметры:

listener - удаляемый PropertyChangeListener

См. также:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

Возвращает:

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

Начиная с:

1.4

См. также:

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

шрифт этого Component ("font")
цвет фона этого Component ("background")
цвет переднего плана этого Component ("foreground")
фокусируемость этого Component ("focusable")
состояние включения клавиш обхода фокуса этого Component ("focusTraversalKeysEnabled")
набор FORWARD_TRAVERSAL_KEYS этого Component ("forwardFocusTraversalKeys")
набор BACKWARD_TRAVERSAL_KEYS этого Component ("backwardFocusTraversalKeys")
набор UP_CYCLE_TRAVERSAL_KEYS этого Component ("upCycleFocusTraversalKeys")

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

Параметры:

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

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

См. также:

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

Параметры:

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

listener - удаляемый PropertyChangeListener

См. также:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

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

Параметры:

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

Возвращает:

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

Начиная с:

1.4

См. также:

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

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

firePropertyChange

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

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

Параметры:

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

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

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

Начиная с:

1.5

См. также:

firePropertyChange

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

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

Параметры:

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

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

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

Начиная с:

1.5

См. также:

firePropertyChange

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

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

Параметры:

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

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

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

Начиная с:

1.5

См. также:

firePropertyChange

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

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

Параметры:

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

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

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

Начиная с:

1.5

См. также:

firePropertyChange

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

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

Параметры:

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

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

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

Начиная с:

1.5

См. также:

firePropertyChange

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

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

Параметры:

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

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

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

Начиная с:

1.5

См. также:

setComponentOrientation

public void setComponentOrientation(ComponentOrientation o)

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

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

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

Параметры:

o - устанавливаемая ориентация

См. также:

getComponentOrientation

public ComponentOrientation getComponentOrientation()

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

Возвращает:

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

См. также:

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation orientation)

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

Параметры:

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

Исключения:

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

Начиная с:

1.4

См. также:

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Возвращает:: объект AccessibleContext этого Component
Начиная с:: 1.3

setMixingCutoutShape

public void setMixingCutoutShape(Shape shape)

Задает фигуру «выреза смешивания» ('mixing-cutout') для этого легковесного компонента. Этот метод используется исключительно в целях поддержки механизма смешивания тяжеловесных и легковесных компонентов (Heavyweight/Lightweight Components Mixing) и не будет иметь никакого эффекта при применении к тяжеловесному компоненту. По умолчанию легковесный компонент рассматривается как непрозрачный прямоугольник в рамках механизма смешивания тяжеловесных и легковесных компонентов. Этот метод позволяет разработчикам задавать произвольную форму для вырезания из тяжеловесных компонентов, расположенных под легковесным компонентом по z-порядку.

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

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

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

Параметры:: shape - новая форма 'mixing-cutout'
Начиная с:: 9

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