Class 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, включая информацию о написании наиболее эффективного кода отрисовки, см. в статье Painting in AWT and Swing.

Подробные сведения о подсистеме фокуса см. в разделе How to Use the Focus Subsystem руководства The Java Tutorial, а также в документе Focus Specification.

См. также:

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

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

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

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

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

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

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

Component()

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

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

Модификатор и тип	Метод	Описание
`boolean`	`action(Event evt, Object what)`	Устарело. Начиная с версии JDK 1.1, следует регистрировать этот компонент как ActionListener на компоненте, который генерирует события действия.
`void`	`add(PopupMenu popup)`	Добавляет указанное всплывающее меню к компоненту.
`void`	`addComponentListener(ComponentListener l)`	Добавляет указанный слушатель компонентов для получения событий компонента от этого компонента.
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента при получении им фокуса ввода.
`void`	`addHierarchyBoundsListener(HierarchyBoundsListener l)`	Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит данный контейнер.
`void`	`addHierarchyListener(HierarchyListener l)`	Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит данный контейнер.
`void`	`addInputMethodListener(InputMethodListener l)`	Добавляет указанный слушатель методов ввода для получения событий методов ввода от этого компонента.
`void`	`addKeyListener(KeyListener l)`	Добавляет указанный слушатель клавиатуры для получения событий клавиш от этого компонента.
`void`	`addMouseListener(MouseListener l)`	Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
`void`	`addMouseMotionListener(MouseMotionListener l)`	Добавляет указанный слушатель движения мыши для получения событий перемещения мыши от этого компонента.
`void`	`addMouseWheelListener(MouseWheelListener l)`	Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента.
`void`	`addNotify()`	Делает этот `Component` отображаемым, подключая его к собственному ресурсу экрана.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей для определенного свойства.
`void`	`applyComponentOrientation(ComponentOrientation orientation)`	Устанавливает свойство `ComponentOrientation` этого компонента и всех содержащихся в нем компонентов.
`boolean`	`areFocusTraversalKeysSet(int id)`	Возвращает значение, указывающее, был ли явно определен набор клавиш перемещения фокуса для заданной операции перемещения фокуса для этого Component.
`Rectangle`	`bounds()`	Устарело. Начиная с версии JDK 1.1, заменено на `getBounds()`.
`int`	`checkImage(Image image, int width, int height, ImageObserver observer)`	Возвращает статус построения экранного представления указанного изображения.
`int`	`checkImage(Image image, ImageObserver observer)`	Возвращает статус построения экранного представления указанного изображения.
`protected AWTEvent`	`coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)`	При необходимости объединяет отправляемое событие с существующим событием.
`boolean`	`contains(int x, int y)`	Проверяет, «содержит» ли этот компонент указанную точку, где `x` и `y` определены относительно системы координат этого компонента.
`boolean`	`contains(Point p)`	Проверяет, «содержит» ли этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента.
`Image`	`createImage(int width, int height)`	Создает закадровое отрисовываемое изображение, используемое для двойной буферизации.
`Image`	`createImage(ImageProducer producer)`	Создает изображение из указанного поставщика данных изображения.
`VolatileImage`	`createVolatileImage(int width, int height)`	Создает энергонезависимое закадровое отрисовываемое изображение, используемое для двойной буферизации.
`VolatileImage`	`createVolatileImage(int width, int height, ImageCapabilities caps)`	Создает энергонезависимое закадровое отрисовываемое изображение с заданными возможностями.
`void`	`deliverEvent(Event e)`	Устарело. Начиная с версии JDK 1.1, заменено на `dispatchEvent(AWTEvent e)`.
`void`	`disable()`	Устарело. Начиная с версии JDK 1.1, заменено на `setEnabled(boolean)`.
`protected final void`	`disableEvents(long eventsToDisable)`	Отключает доставку событий, определенных указанным параметром маски событий, этому компоненту.
`final void`	`dispatchEvent(AWTEvent e)`	Отправляет событие этому компоненту или одному из его подкомпонентов.
`void`	`doLayout()`	Побуждает менеджер компоновки выполнить размещение этого компонента.
`void`	`enable()`	Устарело. Начиная с версии JDK 1.1, заменено на `setEnabled(boolean)`.
`void`	`enable(boolean b)`	Устарело. Начиная с версии JDK 1.1, заменено на `setEnabled(boolean)`.
`protected final void`	`enableEvents(long eventsToEnable)`	Включает доставку событий, определенных указанным параметром маски событий, этому компоненту.
`void`	`enableInputMethods(boolean enable)`	Включает или отключает поддержку методов ввода для этого компонента.
`protected void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)`	Поддержка оповещения об изменениях связанных свойств типа boolean.
`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)`	Поддержка оповещения об изменениях связанных свойств типа integer.
`void`	`firePropertyChange(String propertyName, long oldValue, long newValue)`	Сообщает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, short oldValue, short newValue)`	Сообщает об изменении связанного свойства.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддержка оповещения об изменениях связанных свойств типа Object.
`AccessibleContext`	`getAccessibleContext()`	Получает `AccessibleContext`, связанный с этим `Component`.
`float`	`getAlignmentX()`	Возвращает выравнивание по оси X.
`float`	`getAlignmentY()`	Возвращает выравнивание по оси Y.
`Color`	`getBackground()`	Возвращает фоновый цвет этого компонента.
`int`	`getBaseline(int width, int height)`	Возвращает базовую линию.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior()`	Возвращает перечисление, указывающее, как базовая линия компонента изменяется при изменении размера.
`Rectangle`	`getBounds()`	Возвращает границы этого компонента в виде объекта `Rectangle`.
`Rectangle`	`getBounds(Rectangle rv)`	Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
`ColorModel`	`getColorModel()`	Получает экземпляр `ColorModel`, используемый для отображения компонента на устройстве вывода.
`Component`	`getComponentAt(int x, int y)`	Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов позицию (x, y), и если да, возвращает содержащий компонент.
`Component`	`getComponentAt(Point p)`	Возвращает компонент или подкомпонент, содержащий указанную точку.
`ComponentListener[]`	`getComponentListeners()`	Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
`ComponentOrientation`	`getComponentOrientation()`	Возвращает языковую ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
`Cursor`	`getCursor()`	Возвращает курсор, установленный в компоненте.
`DropTarget`	`getDropTarget()`	Получает `DropTarget`, связанный с этим `Component`.
`Container`	`getFocusCycleRootAncestor()`	Возвращает Container, который является корнем цикла перемещения фокуса для данного Component.
`FocusListener[]`	`getFocusListeners()`	Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
`Set<AWTKeyStroke>`	`getFocusTraversalKeys(int id)`	Возвращает набор клавиш перемещения фокуса для заданной операции перемещения для этого 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)`	Устарело. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
`boolean`	`handleEvent(Event evt)`	Устарело. Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent).
`boolean`	`hasFocus()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`void`	`hide()`	Устарело. Начиная с версии JDK 1.1, заменено на `setVisible(boolean)`.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int w, int h)`	Перерисовывает компонент при изменении изображения.
`boolean`	`inside(int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на contains(int, int).
`void`	`invalidate()`	Делает недействительным этот компонент и его предков.
`boolean`	`isBackgroundSet()`	Возвращает значение, указывающее, был ли явно задан цвет фона для этого 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()`	Устарело. Начиная с версии 1.4, заменено на `isFocusable()`.
`boolean`	`isFontSet()`	Возвращает значение, указывающее, был ли явно задан шрифт для этого Component.
`boolean`	`isForegroundSet()`	Возвращает значение, указывающее, был ли явно задан цвет переднего плана для этого Component.
`boolean`	`isLightweight()`	Облегченный компонент не имеет нативного аналога инструментария (toolkit peer).
`boolean`	`isMaximumSizeSet()`	Возвращает true, если максимальный размер был установлен в значение, отличное от `null`, в противном случае возвращает false.
`boolean`	`isMinimumSizeSet()`	Возвращает значение, указывающее, был ли вызван метод `setMinimumSize` со значением, отличным от null.
`boolean`	`isOpaque()`	Возвращает true, если этот компонент полностью непрозрачен; по умолчанию возвращает false.
`boolean`	`isPreferredSizeSet()`	Возвращает true, если предпочтительный размер был установлен в значение, отличное от `null`, в противном случае возвращает false.
`boolean`	`isShowing()`	Определяет, отображается ли этот компонент на экране.
`boolean`	`isValid()`	Определяет, является ли этот компонент действительным.
`boolean`	`isVisible()`	Определяет, должен ли этот компонент быть видимым, когда виден его родительский компонент.
`boolean`	`keyDown(Event evt, int key)`	Устарело. Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
`boolean`	`keyUp(Event evt, int key)`	Устарело. Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
`void`	`layout()`	Устарело. Начиная с версии JDK 1.1, заменено на `doLayout()`.
`void`	`list()`	Выводит список этого компонента в стандартный системный поток вывода `System.out`.
`void`	`list(PrintStream out)`	Выводит список этого компонента в указанный поток вывода.
`void`	`list(PrintStream out, int indent)`	Выводит список, начиная с указанного отступа, в указанный поток печати.
`void`	`list(PrintWriter out)`	Выводит список в указанный модуль записи печати (print writer).
`void`	`list(PrintWriter out, int indent)`	Выводит список, начиная с указанного отступа, в указанный модуль записи печати.
`Component`	`locate(int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на getComponentAt(int, int).
`Point`	`location()`	Устарело. Начиная с версии JDK 1.1, заменено на `getLocation()`.
`boolean`	`lostFocus(Event evt, Object what)`	Устарело. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
`Dimension`	`minimumSize()`	Устарело. Начиная с версии JDK 1.1, заменено на `getMinimumSize()`.
`boolean`	`mouseDown(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseDrag(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseEnter(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseExit(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseMove(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseUp(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`void`	`move(int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на `setLocation(int, int)`.
`void`	`nextFocus()`	Устарело. Начиная с версии JDK 1.1, заменено на transferFocus().
`void`	`paint(Graphics g)`	Отрисовывает этот компонент.
`void`	`paintAll(Graphics g)`	Отрисовывает этот компонент и все его подкомпоненты.
`protected String`	`paramString()`	Возвращает строку, представляющую состояние этого компонента.
`boolean`	`postEvent(Event e)`	Устарело. Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent).

`Dimension`	`preferredSize()`	Устарело. Начиная с версии JDK 1.1, заменено на `getPreferredSize()`.
`boolean`	`prepareImage(Image image, int width, int height, ImageObserver observer)`	Подготавливает изображение для отрисовки на этом компоненте с указанной шириной и высотой.
`boolean`	`prepareImage(Image image, ImageObserver observer)`	Подготавливает изображение для отрисовки на этом компоненте.
`void`	`print(Graphics g)`	Выводит этот компонент на печать.
`void`	`printAll(Graphics g)`	Выводит на печать этот компонент и все его подкомпоненты.
`protected void`	`processComponentEvent(ComponentEvent e)`	Обрабатывает события компонента, происходящие в этом компоненте, путем их диспетчеризации любым зарегистрированным объектам `ComponentListener`.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события, происходящие в этом компоненте.
`protected void`	`processFocusEvent(FocusEvent e)`	Обрабатывает события фокуса, происходящие в этом компоненте, путем их диспетчеризации любым зарегистрированным объектам `FocusListener`.
`protected void`	`processHierarchyBoundsEvent(HierarchyEvent e)`	Обрабатывает события границ иерархии, происходящие в этом компоненте, путем их диспетчеризации любым зарегистрированным объектам `HierarchyBoundsListener`.
`protected void`	`processHierarchyEvent(HierarchyEvent e)`	Обрабатывает события иерархии, происходящие в этом компоненте, путем их диспетчеризации любым зарегистрированным объектам `HierarchyListener`.
`protected void`	`processInputMethodEvent(InputMethodEvent e)`	Обрабатывает события метода ввода, происходящие в этом компоненте, путем их диспетчеризации любым зарегистрированным объектам `InputMethodListener`.
`protected void`	`processKeyEvent(KeyEvent e)`	Обрабатывает события клавиатуры, происходящие в этом компоненте, путем их диспетчеризации любым зарегистрированным объектам `KeyListener`.
`protected void`	`processMouseEvent(MouseEvent e)`	Обрабатывает события мыши, происходящие в этом компоненте, путем их диспетчеризации любым зарегистрированным объектам `MouseListener`.
`protected void`	`processMouseMotionEvent(MouseEvent e)`	Обрабатывает события перемещения мыши, происходящие в этом компоненте, путем их диспетчеризации любым зарегистрированным объектам `MouseMotionListener`.
`protected void`	`processMouseWheelEvent(MouseWheelEvent e)`	Обрабатывает события колесика мыши, происходящие в этом компоненте, путем их диспетчеризации любым зарегистрированным объектам `MouseWheelListener`.
`void`	`remove(MenuComponent popup)`	Удаляет указанное всплывающее меню из компонента.
`void`	`removeComponentListener(ComponentListener l)`	Удаляет указанный слушатель компонента, чтобы он больше не получал события от этого компонента.
`void`	`removeFocusListener(FocusListener l)`	Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`removeHierarchyBoundsListener(HierarchyBoundsListener l)`	Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
`void`	`removeHierarchyListener(HierarchyListener l)`	Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
`void`	`removeInputMethodListener(InputMethodListener l)`	Удаляет указанный слушатель метода ввода, чтобы он больше не получал события метода ввода от этого компонента.
`void`	`removeKeyListener(KeyListener l)`	Удаляет указанный слушатель клавиатуры, чтобы он больше не получал события клавиатуры от этого компонента.
`void`	`removeMouseListener(MouseListener l)`	Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента.
`void`	`removeMouseMotionListener(MouseMotionListener l)`	Удаляет указанный слушатель перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента.
`void`	`removeMouseWheelListener(MouseWheelListener l)`	Удаляет указанный слушатель колесика мыши, чтобы он больше не получал события колесика мыши от этого компонента.
`void`	`removeNotify()`	Делает этот `Component` неотображаемым, уничтожая его нативный ресурс экрана.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка слушателей.
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Удаляет `PropertyChangeListener` из списка слушателей для указанного свойства.
`void`	`repaint()`	Перерисовывает этот компонент.
`void`	`repaint(int x, int y, int width, int height)`	Перерисовывает указанную прямоугольную область этого компонента.
`void`	`repaint(long tm)`	Перерисовывает компонент.
`void`	`repaint(long tm, int x, int y, int width, int height)`	Перерисовывает указанную прямоугольную область этого компонента в течение `tm` миллисекунд.
`void`	`requestFocus()`	Запрашивает передачу фокуса ввода этому 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

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

TOP_ALIGNMENT

public static final float TOP_ALIGNMENT

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

See Also:

CENTER_ALIGNMENT

public static final float CENTER_ALIGNMENT

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

See Also:

BOTTOM_ALIGNMENT

public static final float BOTTOM_ALIGNMENT

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

See Also:

LEFT_ALIGNMENT

public static final float LEFT_ALIGNMENT

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

See Also:

RIGHT_ALIGNMENT

public static final float RIGHT_ALIGNMENT

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

See Also:

accessibleContext

protected AccessibleContext accessibleContext

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

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

Component

protected Component()

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

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

getName

public String getName()

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

Returns:

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

Since:

1.1

See Also:

setName

public void setName(String name)

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

Parameters:

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

Since:

1.1

See Also:

getParent

public Container getParent()

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

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

setDropTarget

public void setDropTarget(DropTarget dt)

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

Parameters:

dt - объект DropTarget

See Also:

getDropTarget

public DropTarget getDropTarget()

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

Returns:: цель сброса (drop target)

getGraphicsConfiguration

public GraphicsConfiguration getGraphicsConfiguration()

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

Returns:: GraphicsConfiguration, используемая этим Component, или null
Since:: 1.3

getTreeLock

public final Object getTreeLock()

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

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

getToolkit

public Toolkit getToolkit()

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

Returns:: инструментарий этого компонента
Since:: 1.0

isValid

public boolean isValid()

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

Returns:

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

Since:

1.0

See Also:

isDisplayable

public boolean isDisplayable()

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

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

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

Returns:

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

Since:

1.2

See Also:

isVisible

public boolean isVisible()

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

Returns:

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

Since:

1.0

See Also:

getMousePosition

public Point getMousePosition() throws HeadlessException

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

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

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

Returns:

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

Throws:

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

Since:

1.5

See Also:

isShowing

public boolean isShowing()

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

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

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

Returns:

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

Since:

1.0

See Also:

isEnabled

public boolean isEnabled()

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

Returns:

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

Since:

1.0

See Also:

setEnabled

public void setEnabled(boolean b)

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

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

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

Parameters:

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

Since:

1.1

See Also:

enable

@Deprecated public void enable()

Устарело.

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

enable

@Deprecated public void enable(boolean b)

Устарело.

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

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

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

disable

@Deprecated public void disable()

Устарело.

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

isDoubleBuffered

public boolean isDoubleBuffered()

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

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

enableInputMethods

public void enableInputMethods(boolean enable)

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

Parameters:

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

Since:

1.2

See Also:

setVisible

public void setVisible(boolean b)

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

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

Parameters:

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

Since:

1.1

See Also:

show

@Deprecated public void show()

Устарело.

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

show

@Deprecated public void show(boolean b)

Устарело.

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

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

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

hide

@Deprecated public void hide()

Устарело.

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

getForeground

public Color getForeground()

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

Returns:

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

Since:

1.0

See Also:

setForeground

public void setForeground(Color c)

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

Parameters:

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

Since:

1.0

See Also:

isForegroundSet

public boolean isForegroundSet()

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

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

getBackground

public Color getBackground()

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

Returns:

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

Since:

1.0

See Also:

setBackground

public void setBackground(Color c)

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

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

Parameters:

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

Since:

1.0

See Also:

isBackgroundSet

public boolean isBackgroundSet()

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

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

getFont

public Font getFont()

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

Specified by:

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

Returns:

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

Since:

1.0

See Also:

setFont

public void setFont(Font f)

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

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

Parameters:

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

Since:

1.0

See Also:

isFontSet

public boolean isFontSet()

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

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

getLocale

public Locale getLocale()

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

Returns:

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

Throws:

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

Since:

1.1

See Also:

setLocale

public void setLocale(Locale l)

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

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

Parameters:

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

Since:

1.1

See Also:

getColorModel

public ColorModel getColorModel()

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

Returns:

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

Since:

1.0

See Also:

getLocation

public Point getLocation()

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

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

Returns:

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

Since:

1.1

See Also:

getLocationOnScreen

public Point getLocationOnScreen()

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

Returns:

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

Throws:

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

See Also:

location

@Deprecated public Point location()

Устарело.

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

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

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

setLocation

public void setLocation(int x, int y)

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

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

Parameters:

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

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

Since:

1.1

See Also:

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

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

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

Возвращает:

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

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

1.2

См. также:

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

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

Параметры:

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

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

1.5

См. также:

isPreferredSizeSet

public boolean isPreferredSizeSet()

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

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

getPreferredSize

public Dimension getPreferredSize()

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

Возвращает:

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

См. также:

preferredSize

@Deprecated public Dimension preferredSize()

Устарело.

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

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

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

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

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

Параметры:

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

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

1.5

См. также:

isMinimumSizeSet

public boolean isMinimumSizeSet()

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

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

getMinimumSize

public Dimension getMinimumSize()

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

Возвращает:

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

См. также:

minimumSize

@Deprecated public Dimension minimumSize()

Устарело.

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

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

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

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

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

Параметры:

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

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

1.5

См. также:

isMaximumSizeSet

public boolean isMaximumSizeSet()

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

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

getMaximumSize

public Dimension getMaximumSize()

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

Возвращает:

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

См. также:

getAlignmentX

public float getAlignmentX()

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

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

getAlignmentY

public float getAlignmentY()

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

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

getBaseline

public int getBaseline(int width, int height)

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

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

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

1.6

См. также:

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior()

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

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

Возвращает:

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

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

1.6

См. также:

doLayout

public void doLayout()

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

См. также:

layout

@Deprecated public void layout()

Устарело.

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

validate

public void validate()

Выполняет валидацию этого компонента.

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

Возвращает:

графический контекст для этого компонента или 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 для текущего положения курсора, и этот компонент является видимым, отображаемым и доступным (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, если флаги infoflags указывают, что изображение полностью загружено; в противном случае true.

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

1.0

См. также:

createImage

public Image createImage(ImageProducer producer)

Создает изображение из указанного источника изображений (image 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 своего пира для вычисления флагов. Если у этого компонента еще нет пира, вместо этого вызывается метод 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.

Параметры:

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

Начиная с:

1.2

См. также:

removeInputMethodListener

public void removeInputMethodListener(InputMethodListener l)

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

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

Параметры:

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

Возвращает обработчик запросов метода ввода, который поддерживает запросы от методов ввода для этого компонента. Компонент, поддерживающий ввод текста на месте (on-the-spot), должен переопределить этот метод, чтобы он возвращал экземпляр 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 объединяет два типа событий: события перемещения (и перетаскивания) мыши и события отрисовки (и обновления). Для событий перемещения мыши всегда возвращается последнее событие, в результате чего промежуточные перемещения отбрасываются. Для событий отрисовки новое событие объединяется в составное RepaintArea в пире. Новое AWTEvent всегда возвращается.

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

processEvent

protected void processEvent(AWTEvent e)

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

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

Параметры:

e - событие

Начиная с:

1.1

См. также:

processComponentEvent

protected void processComponentEvent(ComponentEvent e)

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

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

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

Параметры:

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 перенаправляются владельцу фокуса. Дополнительную информацию см. в документе Спецификация фокуса.

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

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

С версии:

1.0

См. также:

removeNotify

public void removeNotify()

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

Этот метод вызывается инструментарием (toolkit) внутренне и не должен вызываться непосредственно из программ. Код, переопределяющий этот метод, должен вызывать 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.

Используя API AWTKeyStroke, клиентский код может указать, при каком из двух конкретных событий 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. Если ни для одного из предков этого Component не было явно определено множество Set, возвращается 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), видимым (visible), и все его предки (за исключением 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), видимым (visible), и все его предки (за исключением Window верхнего уровня) должны быть видимыми, чтобы запрос был удовлетворен. Будут предприняты все усилия для выполнения запроса; однако в некоторых случаях это может оказаться невозможным. Разработчики никогда не должны предполагать, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED.

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

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

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

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

Параметры:

Возвращает:

С какого года представлена версия:

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 - поток вывода (print stream)
Исключения:: NullPointerException - если out имеет значение null
С какого года представлена версия:: 1.0

list

public void list(PrintStream out, int indent)

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

Параметры:

out - поток вывода (print stream)

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

Исключения:

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

С какого года представлена версия:

1.0

См. также:

list

public void list(PrintWriter out)

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

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

list

public void list(PrintWriter out, int indent)

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

Параметры:

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

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

Исключения:

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

С какого года представлена версия:

1.1

См. также:

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

шрифт этого 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)

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

Параметры:

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

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

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

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

1.5

См. также:

setComponentOrientation

public void setComponentOrientation(ComponentOrientation o)

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

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

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

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

Параметры:

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') для этого легковесного (lightweight) компонента. Этот метод используется исключительно для механизма смешивания тяжеловесных и легковесных компонентов (Heavyweight/Lightweight Components Mixing) и не будет иметь эффекта при применении к тяжеловесному компоненту. По умолчанию легковесный компонент рассматривается как непрозрачный прямоугольник для целей механизма смешивания тяжеловесных и легковесных компонентов. Этот метод позволяет разработчикам задавать произвольную фигуру, которая будет вырезаться из тяжеловесных компонентов, расположенных под легковесным компонентом в z-порядке.

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

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

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

Параметры:: shape - новая фигура «выреза смешивания»
С какого года / версии:: 9

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