Класс Component
- java.lang.Object
-
- java.awt.Component
- Все реализуемые интерфейсы:
-
ImageObserver,MenuContainer,Serializable
- Прямые известные подклассы:
-
Button,Canvas,Checkbox,Choice,Container,Label,List,Scrollbar,TextComponent
public abstract class Component extends Object implements ImageObserver, MenuContainer, Serializable
Компонент — это объект, имеющий графическое представление, которое может быть отображено на экране и может взаимодействовать с пользователем. Примерами компонентов являются кнопки, флажки и полосы прокрутки типичного графического интерфейса пользователя.
Класс Component является абстрактным суперклассом компонентов Abstract Window Toolkit, не относящихся к меню. Класс Component также может быть непосредственно расширен для создания лёгкого компонента. Лёгкий компонент — это компонент, не связанный с родным окном. Напротив, тяжёлый компонент связан с родным окном. Метод isLightweight() может быть использован для различения двух типов компонентов.
Лёгкие и тяжёлые компоненты могут быть смешаны в одной иерархии компонентов. Однако для корректной работы такой смешанной иерархии компонентов вся иерархия должна быть валидной. Когда иерархия становится невалидной, например, после изменения границ компонентов или добавления/удаления компонентов в/из контейнеров, вся иерархия должна быть валидирована с помощью метода Container.validate(), вызываемого на верхнем невалидном контейнере иерархии.
Сериализация
Важно отметить, что только слушатели AWT, которые соответствуют протоколуSerializable, будут сохранены при сохранении объекта. Если объект AWT имеет слушателей, которые не помечены как сериализуемые, они будут удалены в момент writeObject. Разработчики всегда должны учитывать последствия от того, что объект сериализуем. Один из ситуаций, на которую стоит обратить внимание: import java.awt.*;
import java.awt.event.*;
import java.io.Serializable;
class MyApp implements ActionListener, Serializable
{
BigObjectThatShouldNotBeSerializedWithAButton bigOne;
Button aButton = new Button();
MyApp()
{
// Oops, now aButton has a listener with a reference
// to bigOne!
aButton.addActionListener(this);
}
public void actionPerformed(ActionEvent e)
{
System.out.println("Hello There");
}
} В этом примере сериализация aButton сама по себе приведет к сериализации MyApp и всех ссылок на него. Проблема в том, что слушатель сериализуется случайно, а не по назначению. Чтобы разделить решения о MyApp и о том, что ActionListener является сериализуемым, можно использовать вложенный класс, как в следующем примере: import java.awt.*;
import java.awt.event.*;
import java.io.Serializable;
class MyApp implements java.io.Serializable
{
BigObjectThatShouldNotBeSerializedWithAButton bigOne;
Button aButton = new Button();
static class MyActionListener implements ActionListener
{
public void actionPerformed(ActionEvent e)
{
System.out.println("Hello There");
}
}
MyApp()
{
aButton.addActionListener(new MyActionListener());
}
} Примечание: Для получения дополнительной информации о механизмах рисования, используемых AWT и Swing, включая информацию о том, как написать самый эффективный код рисования, см. Рисование в AWT и Swing.
Для получения подробностей о подсистеме фокуса см. Как использовать подсистему фокуса, раздел в Руководстве Java, и Спецификацию фокуса для получения дополнительной информации.
- См. также:
- Форматированный вывод
Вложенные классы
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class | Component.AccessibleAWTComponent | Вложенный класс компонента, используемый для предоставления стандартной поддержки доступности. |
static class | Component.BaselineResizeBehavior | Перечисление распространённых способов изменения базовой линии компонента при изменении размера. |
protected class | Component.BltBufferStrategy | Вложенный класс для перерисовки внеэкранных поверхностей на компоненте. |
protected class | Component.FlipBufferStrategy | Вложенный класс для переключения буферов на компоненте. |
Поля
| Модификатор и тип | Поле | Описание |
|---|---|---|
protected AccessibleContext | accessibleContext |
|
static float | BOTTOM_ALIGNMENT | Константа для удобства использования |
static float | CENTER_ALIGNMENT | Константа для удобства использования |
static float | LEFT_ALIGNMENT | Константа для удобства использования |
static float | RIGHT_ALIGNMENT | Константа для удобства использования |
static float | TOP_ALIGNMENT | Константа для удобства использования |
Поля, объявленные в интерфейсе java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected | Component() | Создаёт новый компонент. |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean | action(Event evt,
Object what) | Устарело. Начиная с версии JDK 1.1, необходимо зарегистрировать этот компонент в качестве ActionListener на компоненте, который генерирует события действия. |
void | add(PopupMenu popup) | Добавляет указанное всплывающее меню к компоненту. |
void | addComponentListener(ComponentListener l) | Добавляет указанный слушатель событий компонента для получения событий компонента от этого компонента. |
void | addFocusListener(FocusListener l) | Добавляет указанный слушатель событий фокуса для получения событий фокуса от этого компонента, когда этот компонент получает фокус ввода. |
void | addHierarchyBoundsListener(HierarchyBoundsListener l) | Добавляет указанный слушатель изменений границ иерархии для получения событий изменений границ иерархии от этого компонента, когда изменяется иерархия, к которой принадлежит этот контейнер. |
void | addHierarchyListener(HierarchyListener l) | Добавляет указанный слушатель изменений иерархии для получения событий изменений иерархии от этого компонента, когда изменяется иерархия, к которой принадлежит этот контейнер. |
void | addInputMethodListener(InputMethodListener l) | Добавляет указанного слушателя событий метода ввода для получения событий метода ввода от этого компонента. |
void | addKeyListener(KeyListener l) | Добавляет указанного слушателя событий клавиш для получения событий клавиш от этого компонента. |
void | addMouseListener(MouseListener l) | Добавляет указанного слушателя событий мыши для получения событий мыши от этого компонента. |
void | addMouseMotionListener(MouseMotionListener l) | Добавляет указанного слушателя движений мыши для получения событий движений мыши от этого компонента. |
void | addMouseWheelListener(MouseWheelListener l) | Добавляет указанного слушателя колеса мыши для получения событий колеса мыши от этого компонента. |
void | addNotify() | Делает этот |
void | addPropertyChangeListener(PropertyChangeListener listener) | Добавляет PropertyChangeListener в список слушателей. |
void | addPropertyChangeListener(String propertyName,
PropertyChangeListener listener) | Добавляет PropertyChangeListener в список слушателей для определённого свойства. |
void | applyComponentOrientation(ComponentOrientation orientation) | Устанавливает свойство |
boolean | areFocusTraversalKeysSet(int id) | Возвращает, определён ли явно набор клавиш перехода фокуса для данной операции перехода фокуса для этого компонента. |
Rectangle | bounds() | Устарело. Начиная с JDK версии 1.1, заменено на getBounds(). |
int | checkImage(Image image,
int width,
int height,
ImageObserver observer) | Возвращает статус создания экранного представления указанного изображения. |
int | checkImage(Image image,
ImageObserver observer) | Возвращает статус создания экранного представления указанного изображения. |
protected AWTEvent | coalesceEvents(AWTEvent existingEvent,
AWTEvent newEvent) | Возможная коалесценция события, которое публикуется, с существующим событием. |
boolean | contains(int x,
int y) | Проверяет, "содержит" ли этот компонент указанную точку, где |
boolean | contains(Point p) | Проверяет, "содержит" ли этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента. |
Image | createImage(int width,
int height) | Создаёт изображение для отрисовки вне экрана для использования с двойной буферизацией. |
Image | createImage(ImageProducer producer) | Создаёт изображение из указанного производителя изображений. |
VolatileImage | createVolatileImage(int width,
int height) | Создаёт летучее изображение для отрисовки вне экрана для использования с двойной буферизацией. |
VolatileImage | createVolatileImage(int width,
int height,
ImageCapabilities caps) | Создаёт летучее изображение для отрисовки вне экрана с заданными возможностями. |
void | deliverEvent(Event e) | Устарело. Начиная с JDK версии 1.1, заменено на dispatchEvent(AWTEvent e). |
void | disable() | Устарело. Начиная с JDK версии 1.1, заменено на setEnabled(boolean). |
protected void | disableEvents(long eventsToDisable) | Отключает события, определённые указанным параметром маски событий, от доставки этому компоненту. |
void | dispatchEvent(AWTEvent e) | Отправляет событие этому компоненту или одному из его подкомпонентов. |
void | doLayout() | Запрашивает у менеджера компоновки выполнить компоновку этого компонента. |
void | enable() | Устарело. Начиная с JDK версии 1.1, заменено на setEnabled(boolean). |
void | enable(boolean b) | Устарело. Начиная с JDK версии 1.1, заменено на setEnabled(boolean). |
protected void | enableEvents(long eventsToEnable) | Включает события, определённые указанным параметром маски событий, для доставки этому компоненту. |
void | enableInputMethods(boolean enable) | Включает или отключает поддержку методов ввода для этого компонента. |
protected void | firePropertyChange(String propertyName,
boolean oldValue,
boolean newValue) | Поддержка для отчётов о связанных изменениях свойств для булевых свойств. |
void | firePropertyChange(String propertyName,
byte oldValue,
byte newValue) | Сообщает о связанном изменении свойства. |
void | firePropertyChange(String propertyName,
char oldValue,
char newValue) | Сообщает о связанном изменении свойства. |
void | firePropertyChange(String propertyName,
double oldValue,
double newValue) | Сообщает о связанном изменении свойства. |
void | firePropertyChange(String propertyName,
float oldValue,
float newValue) | Сообщает о связанном изменении свойства. |
protected void | firePropertyChange(String propertyName,
int oldValue,
int newValue) | Поддержка для отчётов о связанных изменениях свойств для целочисленных свойств. |
void | firePropertyChange(String propertyName,
long oldValue,
long newValue) | Сообщает о связанном изменении свойства. |
void | firePropertyChange(String propertyName,
short oldValue,
short newValue) | Сообщает о связанном изменении свойства. |
protected void | firePropertyChange(String propertyName,
Object oldValue,
Object newValue) | Поддержка для отчётов о связанных изменениях свойств для свойств типа Object. |
AccessibleContext | getAccessibleContext() | Получает |
float | getAlignmentX() | Возвращает выравнивание по оси x. |
float | getAlignmentY() | Возвращает выравнивание по оси y. |
Color | getBackground() | Получает цвет фона этого компонента. |
int | getBaseline(int width,
int height) | Возвращает линию базовой строки. |
Component.BaselineResizeBehavior | getBaselineResizeBehavior() | Возвращает перечисление, указывающее, как изменяется базовая строка компонента при изменении размера. |
Rectangle | getBounds() | Получает границы этого компонента в виде объекта |
Rectangle | getBounds(Rectangle rv) | Хранит границы этого компонента в "возвращаемом значении" rv и возвращает rv. |
ColorModel | getColorModel() | Получает экземпляр |
Component | getComponentAt(int x,
int y) | Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов расположение (x, y), и если да, возвращает содержащий компонент. |
Component | getComponentAt(Point p) | Возвращает компонент или подкомпонент, содержащий указанную точку. |
ComponentListener[] | getComponentListeners() | Возвращает массив всех зарегистрированных слушателей событий компонента для этого компонента. |
ComponentOrientation | getComponentOrientation() | Возвращает чувствительное к языку направление, которое должно быть использовано для упорядочения элементов или текста в этом компоненте. |
Cursor | getCursor() | Получает установленный курсор в компоненте. |
|---|---|---|
DropTarget | getDropTarget() | Получает связанный с этим |
Container | getFocusCycleRootAncestor() | Возвращает контейнер, который является корнем цикла обхода фокуса для цикла обхода фокуса этого компонента. |
FocusListener[] | getFocusListeners() | Возвращает массив всех зарегистрированных слушателей фокуса для этого компонента. |
Set<AWTKeyStroke> | getFocusTraversalKeys(int id) | Возвращает набор клавиш обхода фокуса для заданной операции обхода для этого компонента. |
boolean | getFocusTraversalKeysEnabled() | Возвращает, включены ли клавиши обхода фокуса для этого компонента. |
Font | getFont() | Получает шрифт этого компонента. |
FontMetrics | getFontMetrics(Font font) | Получает метрики шрифта для указанного шрифта. |
Color | getForeground() | Получает цвет переднего плана этого компонента. |
Graphics | getGraphics() | Создаёт контекст графики для этого компонента. |
GraphicsConfiguration | getGraphicsConfiguration() | Получает связанный с этим |
int | getHeight() | Возвращает текущую высоту этого компонента. |
HierarchyBoundsListener[] | getHierarchyBoundsListeners() | Возвращает массив всех зарегистрированных слушателей границ иерархии для этого компонента. |
HierarchyListener[] | getHierarchyListeners() | Возвращает массив всех зарегистрированных слушателей иерархии для этого компонента. |
boolean | getIgnoreRepaint() | |
InputContext | getInputContext() | Получает контекст ввода, используемый этим компонентом для обработки связи с методами ввода при вводе текста в этот компонент. |
InputMethodListener[] | getInputMethodListeners() | Возвращает массив всех зарегистрированных слушателей методов ввода для этого компонента. |
InputMethodRequests | getInputMethodRequests() | Получает обработчик запросов метода ввода, который поддерживает запросы от методов ввода для этого компонента. |
KeyListener[] | getKeyListeners() | Возвращает массив всех зарегистрированных слушателей клавиш для этого компонента. |
<T extends EventListener> | getListeners(Class<T> listenerType) | Возвращает массив всех объектов, в настоящее время зарегистрированных как |
Locale | getLocale() | Получает локаль этого компонента. |
Point | getLocation() | Получает расположение этого компонента в виде точки, определяющей верхний левый угол компонента. |
Point | getLocation(Point rv) | Сохраняет начало координат x,y этого компонента в "значение возврата" rv и возвращает rv. |
Point | getLocationOnScreen() | Получает расположение этого компонента в виде точки, определяющей верхний левый угол компонента в пространстве координат экрана. |
Dimension | getMaximumSize() | Получает максимальный размер этого компонента. |
Dimension | getMinimumSize() | Получает минимальный размер этого компонента. |
MouseListener[] | getMouseListeners() | Возвращает массив всех зарегистрированных слушателей мыши для этого компонента. |
MouseMotionListener[] | getMouseMotionListeners() | Возвращает массив всех зарегистрированных слушателей перемещения мыши для этого компонента. |
Point | getMousePosition() | Возвращает положение указателя мыши в пространстве координат этого |
MouseWheelListener[] | getMouseWheelListeners() | Возвращает массив всех зарегистрированных слушателей колеса мыши для этого компонента. |
String | getName() | Получает имя компонента. |
Container | getParent() | Получает родителя этого компонента. |
Dimension | getPreferredSize() | Получает предпочтительный размер этого компонента. |
PropertyChangeListener[] | getPropertyChangeListeners() | Возвращает массив всех зарегистрированных слушателей изменений свойств для этого компонента. |
PropertyChangeListener[] | getPropertyChangeListeners(String propertyName) | Возвращает массив всех слушателей, которые были связаны с указанным свойством. |
Dimension | getSize() | Возвращает размер этого компонента в виде объекта |
Dimension | getSize(Dimension rv) | Сохраняет ширину/высоту этого компонента в "значение возврата" rv и возвращает rv. |
Toolkit | getToolkit() | Получает инструментарий этого компонента. |
Object | getTreeLock() | Получает блокирующий объект этого компонента (объект, владеющий монитором синхронизации потоков) для операций с деревом и компоновкой компонентов AWT. |
int | getWidth() | Возвращает текущую ширину этого компонента. |
int | getX() | Возвращает текущую координату x начала координат компонента. |
int | getY() | Возвращает текущую координату y начала координат компонента. |
boolean | gotFocus(Event evt,
Object what) | Устаревшее. Начиная с JDK версии 1.1, заменено на processFocusEvent(FocusEvent). |
boolean | handleEvent(Event evt) | Устаревшее. Начиная с JDK версии 1.1, заменено на processEvent(AWTEvent). |
boolean | hasFocus() | Возвращает |
void | hide() | Устаревшее. Начиная с JDK версии 1.1, заменено на setVisible(boolean). |
boolean | imageUpdate(Image img,
int infoflags,
int x,
int y,
int w,
int h) | Перерисовывает компонент, когда изображение изменилось. |
boolean | inside(int x,
int y) | Устаревшее. Начиная с JDK версии 1.1, заменено на contains(int, int). |
void | invalidate() | Отменяет отрисовку этого компонента и его предков. |
boolean | isBackgroundSet() | Возвращает, был ли цвет фона явно задан для этого компонента. |
boolean | isCursorSet() | Возвращает, был ли курсор явно задан для этого компонента. |
boolean | isDisplayable() | Определяет, отображается ли этот компонент. |
boolean | isDoubleBuffered() | Возвращает true, если этот компонент отрисовывается на изображении вне экрана ("буфере"), которое копируется на экран позже. |
boolean | isEnabled() | Определяет, включён ли этот компонент. |
boolean | isFocusable() | Возвращает, может ли этот компонент получить фокус. |
boolean | isFocusCycleRoot(Container container) | Возвращает, является ли указанный контейнер корнем цикла обхода фокуса для цикла обхода фокуса этого компонента. |
boolean | isFocusOwner() | Возвращает |
boolean | isFocusTraversable() | Устаревшее. Начиная с 1.4, заменено на isFocusable(). |
boolean | isFontSet() | Возвращает, был ли шрифт явно задан для этого компонента. |
boolean | isForegroundSet() | Возвращает, был ли цвет переднего плана явно задан для этого компонента. |
boolean | isLightweight() | Компонент лёгкого типа не имеет родственного элемента в нативном наборе инструментов. |
|---|---|---|
boolean | isMaximumSizeSet() | Возвращает true, если максимальный размер был задан не |
boolean | isMinimumSizeSet() | Возвращает, был ли |
boolean | isOpaque() | Возвращает true, если этот компонент полностью непрозрачен, по умолчанию возвращает false. |
boolean | isPreferredSizeSet() | Возвращает true, если предпочтительный размер был задан не |
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() | Выводит список этого компонента в стандартный поток вывода системы |
void | list(PrintStream out) | Выводит список этого компонента в указанный поток вывода. |
void | list(PrintStream out,
int indent) | Выводит список, начиная с указанного отступа, в указанный поток печати. |
void | list(PrintWriter out) | Выводит список в указанный объект-писатель. |
void | list(PrintWriter out,
int indent) | Выводит список, начиная с указанного отступа, в указанный объект-писатель. |
Component | locate(int x,
int y) | Устарело. Начиная с версии JDK 1.1, заменено на getComponentAt(int, int). |
Point | location() | Устарело. Начиная с версии JDK 1.1, заменено на getLocation(). |
boolean | lostFocus(Event evt,
Object what) | Устарело. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent). |
Dimension | minimumSize() | Устарело. Начиная с версии JDK 1.1, заменено на getMinimumSize(). |
boolean | mouseDown(Event evt,
int x,
int y) | Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
boolean | mouseDrag(Event evt,
int x,
int y) | Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent). |
boolean | mouseEnter(Event evt,
int x,
int y) | Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
boolean | mouseExit(Event evt,
int x,
int y) | Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
boolean | mouseMove(Event evt,
int x,
int y) | Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent). |
boolean | mouseUp(Event evt,
int x,
int y) | Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
void | move(int x,
int y) | Устарело. Начиная с версии JDK 1.1, заменено на setLocation(int, int). |
void | nextFocus() | Устарело. Начиная с версии JDK 1.1, заменено на transferFocus(). |
void | paint(Graphics g) | Отрисовывает этот компонент. |
void | paintAll(Graphics g) | Отрисовывает этот компонент и все его подкомпоненты. |
protected String | paramString() | Возвращает строку, представляющую состояние этого компонента. |
boolean | postEvent(Event e) | Устарело. Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent). |
Dimension | preferredSize() | Устарело. Начиная с версии JDK 1.1, заменено на getPreferredSize(). |
boolean | prepareImage(Image image,
int width,
int height,
ImageObserver observer) | Подготавливает изображение для рендеринга на этом компоненте с указанной шириной и высотой. |
boolean | prepareImage(Image image,
ImageObserver observer) | Подготавливает изображение для рендеринга на этом компоненте. |
void | print(Graphics g) | Выводит этот компонент. |
void | printAll(Graphics g) | Выводит этот компонент и все его подкомпоненты. |
protected void | processComponentEvent(ComponentEvent e) | Обрабатывает события компонента, происходящие на этом компоненте, распределяя их между зарегистрированными |
protected void | processEvent(AWTEvent e) | Обрабатывает события, происходящие на этом компоненте. |
protected void | processFocusEvent(FocusEvent e) | Обрабатывает события фокуса, происходящие на этом компоненте, распределяя их между зарегистрированными |
protected void | processHierarchyBoundsEvent(HierarchyEvent e) | Обрабатывает события границ иерархии, происходящие на этом компоненте, распределяя их между зарегистрированными |
protected void | processHierarchyEvent(HierarchyEvent e) | Обрабатывает события иерархии, происходящие на этом компоненте, распределяя их между зарегистрированными |
protected void | processInputMethodEvent(InputMethodEvent e) | Обрабатывает события метода ввода, происходящие на этом компоненте, распределяя их между зарегистрированными |
protected void | processKeyEvent(KeyEvent e) | Обрабатывает события клавиш, происходящие на этом компоненте, распределяя их между зарегистрированными |
protected void | processMouseEvent(MouseEvent e) | Обрабатывает события мыши, происходящие на этом компоненте, распределяя их между зарегистрированными |
protected void | processMouseMotionEvent(MouseEvent e) | Обрабатывает события перемещения мыши, происходящие на этом компоненте, распределяя их между зарегистрированными |
protected void | processMouseWheelEvent(MouseWheelEvent e) | Обрабатывает события колеса мыши, происходящие на этом компоненте, распределяя их между зарегистрированными |
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() | Делает этот |
void | removePropertyChangeListener(PropertyChangeListener listener) | Удаляет PropertyChangeListener из списка обработчиков. |
void | removePropertyChangeListener(String propertyName,
PropertyChangeListener listener) | Удаляет |
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) | Перерисовывает указанный прямоугольник этого компонента в течение |
void | requestFocus() | Запрашивает, чтобы этот компонент получил фокус ввода, и что его родительское окно стало фокусированным. |
protected boolean | requestFocus(boolean temporary) | Запрашивает, чтобы этот |
protected boolean | requestFocus(boolean temporary,
FocusEvent.Cause cause) | Запрашивает, чтобы этот |
void | requestFocus(FocusEvent.Cause cause) | Запрашивает, чтобы этот компонент получил фокус ввода по причине |
boolean | requestFocusInWindow() | Запрашивает, чтобы этот компонент получил фокус ввода, если его родительское окно уже является фокусированным. |
protected boolean | requestFocusInWindow(boolean temporary) | Запрашивает, чтобы этот |
boolean | requestFocusInWindow(FocusEvent.Cause cause) | Запрашивает, чтобы этот компонент получил фокус ввода по причине |
void | reshape(int x,
int y,
int width,
int height) | Устарело. Начиная с JDK версии 1.1, заменено на setBounds(int, int, int, int). |
void | resize(int width,
int height) | Устарело. Начиная с JDK версии 1.1, заменено на setSize(int, int). |
void | resize(Dimension d) | Устарело. Начиная с JDK версии 1.1, заменено на setSize(Dimension). |
void | revalidate() | Перепроверяет иерархию компонентов до ближайшего корня валидации. |
void | setBackground(Color c) | Устанавливает цвет фона этого компонента. |
void | setBounds(int x,
int y,
int width,
int height) | Перемещает и изменяет размер этого компонента. |
void | setBounds(Rectangle r) | Перемещает и изменяет размер этого компонента, чтобы соответствовать новой области |
void | setComponentOrientation(ComponentOrientation o) | Устанавливает языкозависимую ориентацию для упорядочения элементов или текста внутри этого компонента. |
void | setCursor(Cursor cursor) | Устанавливает изображение курсора на указанный курсор. |
void | setDropTarget(DropTarget dt) | Ассоциирует |
void | setEnabled(boolean b) | Включает или отключает этот компонент в зависимости от значения параметра |
void | setFocusable(boolean focusable) | Устанавливает состояние фокусируемости этого компонента на указанное значение. |
void | setFocusTraversalKeys(int id,
Set<? extends AWTKeyStroke> keystrokes) | Устанавливает клавиши перемещения фокуса для данной операции перемещения для этого компонента. |
void | setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled) | Устанавливает, включены ли клавиши перемещения фокуса для этого компонента. |
void | setFont(Font f) | Устанавливает шрифт этого компонента. |
void | setForeground(Color c) | Устанавливает цвет переднего плана этого компонента. |
void | setIgnoreRepaint(boolean ignoreRepaint) | Устанавливает, игнорировать ли сообщения о перерисовке, полученные от операционной системы. |
void | setLocale(Locale l) | Устанавливает локаль этого компонента. |
void | setLocation(int x,
int y) | Перемещает этот компонент в новое местоположение. |
void | setLocation(Point p) | Перемещает этот компонент в новое местоположение. |
void | setMaximumSize(Dimension maximumSize) | Устанавливает максимальный размер этого компонента на постоянное значение. |
void | setMinimumSize(Dimension minimumSize) | Устанавливает минимальный размер этого компонента на постоянное значение. |
void | setMixingCutoutShape(Shape shape) | Устанавливает форму 'смешивания-вырезания' для этого облегчённого компонента. |
void | setName(String name) | Устанавливает имя компонента на указанную строку. |
void | setPreferredSize(Dimension preferredSize) | Устанавливает предпочтительный размер этого компонента на постоянное значение. |
void | setSize(int width,
int height) | Изменяет размер этого компонента, установив ширину |
void | setSize(Dimension d) | Изменяет размер этого компонента, установив ширину |
void | setVisible(boolean b) | Отображает или скрывает этот компонент в зависимости от значения параметра |
void | show() | Устарело. Начиная с JDK версии 1.1, заменено на setVisible(boolean). |
void | show(boolean b) | Устарело. Начиная с JDK версии 1.1, заменено на setVisible(boolean). |
Dimension | size() | Устарело. Начиная с JDK версии 1.1, заменено на getSize(). |
String | toString() | Возвращает строковое представление этого компонента и его значений. |
void | transferFocus() | Передает фокус на следующий компонент, как будто этот компонент является владельцем фокуса. |
void | transferFocusBackward() | Передает фокус на предыдущий компонент, как будто этот компонент является владельцем фокуса. |
void | transferFocusUpCycle() | Передает фокус на предыдущий компонент в цикле перехода фокуса. |
void | update(Graphics g) | Обновляет этот компонент. |
void | validate() | Проверяет этот компонент. |
Методы, объявленные в классе java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait Поля
TOP_ALIGNMENT
public static final float TOP_ALIGNMENT
Постоянная для удобства использования для getAlignmentY(). Указывает выравнивание по верхнему краю компонента.
- См. также:
-
getAlignmentY(), Значения константных полей
CENTER_ALIGNMENT
public static final float CENTER_ALIGNMENT
Постоянная для удобства использования для getAlignmentY и getAlignmentX. Указывает выравнивание по центру компонента.
- См. также:
-
getAlignmentX(),getAlignmentY(), Значения константных полей
BOTTOM_ALIGNMENT
public static final float BOTTOM_ALIGNMENT
Постоянная для удобства использования для getAlignmentY. Указывает выравнивание по нижнему краю компонента.
- См. также:
-
getAlignmentY(), Значения константных полей
LEFT_ALIGNMENT
public static final float LEFT_ALIGNMENT
Постоянная для удобства использования для getAlignmentX. Указывает выравнивание по левому краю компонента.
- См. также:
-
getAlignmentX(), Значения константных полей
RIGHT_ALIGNMENT
public static final float RIGHT_ALIGNMENT
Постоянная для удобства использования для getAlignmentX. Указывает выравнивание по правому краю компонента.
- См. также:
-
getAlignmentX(), Значения константных полей
accessibleContext
protected AccessibleContext accessibleContext
AccessibleContext, связанный с этим Component.
Конструкторы
Component
protected Component()
Создает новый компонент. Класс Component можно расширить напрямую, чтобы создать легкий компонент, не использующий непрозрачное системное окно. Легкий компонент должен быть размещен в контейнере ниже в дереве компонентов (например, объектом Frame).
Методы
getName
public String getName()
Получает имя компонента.
- Возвращает:
- имя этого компонента
- С момента:
- 1.1
- См. также:
setName(java.lang.String)
setName
public void setName(String name)
Устанавливает имя компонента на указанную строку.
- Параметры:
-
name- строка, которая должна быть именем этого компонента - С момента:
- 1.1
- См. также:
getName()
getParent
public Container getParent()
Получает родителя этого компонента.
- Возвращает:
- контейнер-родитель этого компонента
- С момента:
- 1.0
setDropTarget
public void setDropTarget(DropTarget dt)
Связывает DropTarget с этим компонентом. Component будет получать отпуска только в случае, если он включён.
- Параметры:
-
dt- DropTarget - См. также:
isEnabled()
getDropTarget
public DropTarget getDropTarget()
Получает связанный с этим Component DropTarget.
- Возвращает:
- drop target
getGraphicsConfiguration
public GraphicsConfiguration getGraphicsConfiguration()
Получает связанную с этим Component GraphicsConfiguration. Если Component не назначен конкретный GraphicsConfiguration, возвращается GraphicsConfiguration верхнего контейнера объекта Component. Если Component был создан, но ещё не добавлен в Container, этот метод возвращает null.
- Возвращает:
GraphicsConfiguration, используемый этимComponentилиnull- С момента:
- 1.3
getTreeLock
public final Object getTreeLock()
Получает блокирующий объект этого компонента (объект, владеющий монитором синхронизации потоков) для операций с деревом компонентов AWT и макетом.
- Возвращает:
- блокирующий объект этого компонента
getToolkit
public Toolkit getToolkit()
Получает toolkit этого компонента. Обратите внимание, что фрейм, который содержит компонент, управляет тем, какой toolkit используется этим компонентом. Следовательно, если компонент перемещается из одного фрейма в другой, используемый им toolkit может измениться.
- Возвращает:
- toolkit этого компонента
- С момента:
- 1.0
isValid
public boolean isValid()
Определяет, является ли этот компонент допустимым. Компонент считается допустимым, когда он правильно размещён и расположен внутри родительского контейнера, а все его дочерние элементы также допустимы. Для учёта требований к размеру компонентов компоненты делают недействительными перед их первым отображением на экране. К моменту полного раскрытия родительского контейнера все его компоненты будут допустимыми.
- Возвращает:
-
true, если компонент допустим,falseв противном случае - С момента:
- 1.0
- См. также:
-
validate(),invalidate()
isDisplayable
public boolean isDisplayable()
Определяет, отображаем ли этот компонент. Компонент считается отображаемым, когда он подключён к нативному ресурсу экрана.
Компонент делается отображаемым, когда он добавляется в отображаемую иерархию вложений, или когда его иерархия вложений делается отображаемой. Иерархия вложений делается отображаемой, когда его родительское окно либо упаковано, либо сделано видимым.
Компонент делается неотображаемым, когда он удаляется из отображаемой иерархии вложений или когда его иерархия вложений делается неотображаемой. Иерархия вложений делается неотображаемой, когда его родительское окно удалено.
- Возвращает:
-
true, если компонент отображаем,falseв противном случае - С момента:
- 1.2
- См. также:
-
Container.add(Component),Window.pack(),Window.show(),Container.remove(Component),Window.dispose()
isVisible
public boolean isVisible()
Определяет, должен ли этот компонент быть видимым, когда его родитель видимый. Компоненты изначально видимые, за исключением компонентов верхнего уровня, таких как объекты Frame.
- Возвращает:
-
true, если компонент видим,falseв противном случае - С момента:
- 1.0
- См. также:
setVisible(boolean)
getMousePosition
public Point getMousePosition()
throws HeadlessException Возвращает положение курсора мыши в пространстве координат этого Component, если Component находится непосредственно под курсором мыши, в противном случае возвращает null. Если Component не отображается на экране, этот метод возвращает null, даже если курсор мыши находится над областью, где был бы отображен Component. Если Component частично или полностью закрыт другими Component или нативными окнами, этот метод возвращает ненулевое значение только в том случае, если курсор мыши находится над нескрытой частью Component.
Для Container возвращает ненулевое значение, если мышь находится над самим Container или над любым из его потомков. Используйте Container.getMousePosition(boolean), если вам нужно исключить дочерние элементы.
Иногда точные координаты мыши не важны, и важно только, находится ли определённый Component под курсором мыши. Если возвращаемое значение этого метода является null, курсор мыши не находится непосредственно над Component.
- Возвращает:
- координаты мыши относительно этого
Component, или null - Выбрасывает:
-
HeadlessException- если GraphicsEnvironment.isHeadless() возвращает true - С момента:
- 1.5
- См. также:
-
isShowing(),Container.getMousePosition(boolean)
isShowing
public boolean isShowing()
Определяет, отображается ли этот компонент на экране. Это означает, что компонент должен быть видимым, и он должен находиться в видимом контейнере, который отображается.
Примечание: иногда нет способа определить, действительно ли Component отображается пользователю. Это может произойти, когда:
- компонент был добавлен в видимую
ScrollPane, ноComponentв данный момент не находится в области просмотра прокрутки. Componentзакрыт другимComponentилиContainer.
- Возвращает:
-
true, если компонент отображается,falseв противном случае - С момента:
- 1.0
- См. также:
setVisible(boolean)
isEnabled
public boolean isEnabled()
Определяет, включен ли этот компонент. Включённый компонент может реагировать на ввод пользователя и генерировать события. Компоненты включены по умолчанию. Компонент может быть включен или выключен, вызвав его метод setEnabled.
- Возвращает:
-
true, если компонент включён,falseв противном случае - С момента:
- 1.0
- См. также:
setEnabled(boolean)
setEnabled
public void setEnabled(boolean b)
Включает или выключает этот компонент в зависимости от значения параметра b. Включённый компонент может реагировать на ввод пользователя и генерировать события. Компоненты включены по умолчанию.
Примечание: Выключение лёгкого компонента не препятствует получению им MouseEvents.
Примечание: Выключение тяжёлого контейнера предотвращает получение всех компонентов в этом контейнере любых событий ввода. Но выключение лёгкого контейнера влияет только на этот контейнер.
- Параметры:
-
b- Еслиtrue, этот компонент включён; в противном случае этот компонент выключен - С момента:
- 1.1
- См. также:
-
isEnabled(),isLightweight()
enable
@Deprecated public void enable()
setEnabled(boolean).enable
@Deprecated public void enable(boolean b)
setEnabled(boolean).Включает или выключает этот компонент.
- Параметры:
-
b-trueвключить этот компонент; в противном случаеfalse
disable
@Deprecated public void disable()
setEnabled(boolean).isDoubleBuffered
public boolean isDoubleBuffered()
Возвращает true, если этот компонент рисуется в автономном изображении ("буфер"), которое копируется на экран позже. Подклассы компонентов, которые поддерживают двойной буферизацию, должны переопределять этот метод, чтобы возвращать true, если двойная буферизация включена.
- Возвращает:
- по умолчанию false
enableInputMethods
public void enableInputMethods(boolean enable)
Включает или выключает поддержку методов ввода для этого компонента. Если поддержка методов ввода включена, а компонент также обрабатывает события клавиш, поступающие события предлагаются текущему методу ввода и будут обработаны компонентом или пересланы его слушателям только если метод ввода не потребляет их. По умолчанию поддержка методов ввода включена.
- Параметры:
-
enable- true для включения, false для выключения - С момента:
- 1.2
- См. также:
processKeyEvent(java.awt.event.KeyEvent)
setVisible
public void setVisible(boolean b)
Отображает или скрывает этот компонент в зависимости от значения параметра b.
Этот метод изменяет информацию, связанную с макетом, и поэтому делает иерархию компонентов недействительной.
- Параметры:
-
b- еслиtrue, отображает этот компонент; в противном случае скрывает этот компонент - С момента:
- 1.1
- См. также:
-
isVisible(),invalidate()
show
@Deprecated public void show()
setVisible(boolean).show
@Deprecated public void show(boolean b)
setVisible(boolean).Делает этот компонент видимым или невидимым.
- Параметры:
-
b-true, чтобы сделать этот компонент видимым; в противном случаеfalse
hide
@Deprecated public void hide()
setVisible(boolean).getForeground
public Color getForeground()
Возвращает цвет переднего плана этого компонента.
- Возвращает:
- цвет переднего плана этого компонента; если у этого компонента нет цвета переднего плана, возвращается цвет переднего плана его родителя
- С момента:
- 1.0
- См. также:
setForeground(java.awt.Color)
setForeground
public void setForeground(Color c)
Устанавливает цвет переднего плана этого компонента.
- Параметры:
-
c- цвет, который станет цветом переднего плана этого компонента; если этот параметр равенnull, то этот компонент будет наследоваться от цвета переднего плана своего родителя - С момента:
- 1.0
- См. также:
getForeground()
isForegroundSet
public boolean isForegroundSet()
Возвращает, был ли явно установлен цвет переднего плана для этого компонента. Если этот метод возвращает false, этот компонент наследует цвет переднего плана от предка.
- Возвращает:
-
true, если цвет переднего плана был явно задан для этого компонента;falseв противном случае. - С момента:
- 1.4
getBackground
public Color getBackground()
Возвращает цвет фона этого компонента.
- Возвращает:
- цвет фона этого компонента; если у этого компонента нет цвета фона, возвращается цвет фона его родителя
- С момента:
- 1.0
- См. также:
setBackground(java.awt.Color)
setBackground
public void setBackground(Color c)
Устанавливает цвет фона этого компонента.
Цвет фона влияет на каждый компонент по-разному, и части компонента, на которые влияет цвет фона, могут отличаться в зависимости от операционной системы.
- Параметры:
-
c- цвет, который станет цветом фона этого компонента; если этот параметр равенnull, то этот компонент будет наследоваться от цвета фона своего родителя - С момента:
- 1.0
- См. также:
getBackground()
isBackgroundSet
public boolean isBackgroundSet()
Возвращает, был ли явно установлен цвет фона для этого компонента. Если этот метод возвращает false, этот компонент наследует цвет фона от предка.
- Возвращает:
-
true, если цвет фона был явно задан для этого компонента;falseв противном случае. - С момента:
- 1.4
getFont
public Font getFont()
Возвращает шрифт этого компонента.
- Определяется:
-
getFontв интерфейсеMenuContainer - Возвращает:
- шрифт этого компонента; если для этого компонента не был задан шрифт, возвращается шрифт его родителя
- С момента:
- 1.0
- См. также:
setFont(java.awt.Font)
setFont
public void setFont(Font f)
Устанавливает шрифт этого компонента.
Этот метод изменяет информацию, связанную с макетом, и поэтому делает иерархию компонентов недействительной.
- Параметры:
-
f- шрифт, который станет шрифтом этого компонента; если этот параметр равенnull, то этот компонент будет наследоваться от шрифта своего родителя - С момента:
- 1.0
- См. также:
-
getFont(),invalidate()
isFontSet
public boolean isFontSet()
Возвращает, был ли явно задан шрифт для этого компонента. Если этот метод возвращает false, этот компонент наследует шрифт от предка.
- Возвращает:
-
true, если шрифт был явно задан для этого компонента;falseв противном случае. - С момента:
- 1.4
getLocale
public Locale getLocale()
Возвращает локаль этого компонента.
- Возвращает:
- локаль этого компонента; если у этого компонента нет локали, возвращается локаль его родителя
- Исключения:
-
IllegalComponentStateException- если уComponentнет собственной локали и он еще не добавлен в иерархию включения, так что локаль нельзя определить по содержащему родителю - С момента:
- 1.1
- См. также:
setLocale(java.util.Locale)
setLocale
public void setLocale(Locale l)
Устанавливает локаль этого компонента. Это связанное свойство.
Этот метод изменяет информацию, связанную с макетом, и поэтому делает иерархию компонентов недействительной.
- Параметры:
-
l- локаль, которая станет локалью этого компонента - С момента:
- 1.1
- См. также:
-
getLocale(),invalidate()
getColorModel
public ColorModel getColorModel()
Получает экземпляр ColorModel, используемый для отображения компонента на выходном устройстве.
- Возвращает:
- модель цвета, используемая этим компонентом
- С момента:
- 1.0
- См. также:
-
ColorModel,ComponentPeer.getColorModel(),Toolkit.getColorModel()
getLocation
public Point getLocation()
Возвращает расположение этого компонента в виде точки, определяющей верхний левый угол компонента. Расположение будет относиться к пространству координат родителя.
Из-за асинхронной природы обработки событий нативных событий этот метод может возвращать устаревшие значения (например, после нескольких вызовов setLocation() подряд). По этой причине рекомендуемый способ получения положения компонента - в java.awt.event.ComponentListener.componentMoved(), который вызывается после того, как операционная система закончит перемещение компонента.
- Возвращает:
- экземпляр
Point, представляющий верхний левый угол границ компонента в пространстве координат родителя компонента - С момента:
- 1.1
- См. также:
-
setLocation(int, int),getLocationOnScreen()
getLocationOnScreen
public Point getLocationOnScreen()
Возвращает расположение этого компонента в виде точки, определяющей верхний левый угол компонента в пространстве координат экрана.
- Возвращает:
- экземпляр
Point, представляющий верхний левый угол границ компонента в пространстве координат экрана - Исключения:
-
IllegalComponentStateException- если компонент не отображается на экране - См. также:
-
setLocation(int, int),getLocation()
location
@Deprecated public Point location()
getLocation().Возвращает расположение верхнего левого угла этого компонента.
- Возвращает:
- местоположение верхнего левого угла этого компонента
setLocation
public void setLocation(int x,
int y) Перемещает этот компонент в новое местоположение. Верхний левый угол нового местоположения задается x и y параметрами в пространстве координат родителя этого компонента.
Этот метод изменяет информацию, связанную с макетом, и поэтому делает иерархию компонентов недействительной.
- Параметры:
-
x- координата x верхнего левого угла нового местоположения в пространстве координат родителя -
y- координата y верхнего левого угла нового местоположения в пространстве координат родителя - С момента:
- 1.1
- См. также:
-
getLocation(),setBounds(int, int, int, int),invalidate()
move
@Deprecated
public void move(int x,
int y) setLocation(int, int).Перемещает этот компонент в новое местоположение.
- Параметры:
-
x- координата x верхнего левого угла нового местоположения в пространстве координат родителя -
y- координата y верхнего левого угла нового местоположения в пространстве координат родителя
setLocation
public void setLocation(Point p)
Перемещает этот компонент в новое местоположение. Верхний левый угол нового местоположения задается точкой p. Точка p задается в пространстве координат родителя.
Этот метод изменяет информацию, связанную с макетом, и поэтому делает иерархию компонентов недействительной.
- Параметры:
-
p- точка, определяющая верхний левый угол нового местоположения, заданная в пространстве координат родителя этого компонента - С момента:
- 1.1
- См. также:
-
getLocation(),setBounds(int, int, int, int),invalidate()
getSize
public Dimension getSize()
Возвращает размер этого компонента в виде объекта Dimension. Поле height объекта Dimension содержит высоту этого компонента, а поле width объекта Dimension содержит ширину этого компонента.
- Возвращает:
- объект
Dimension, указывающий размер этого компонента - С момента:
- 1.1
- См. также:
setSize(int, int)
size
@Deprecated public Dimension size()
getSize().Возвращает размер этого компонента в виде объекта Dimension.
- Возвращает:
- объект
Dimension, указывающий размер этого компонента
setSize
public void setSize(int width,
int height) Изменяет размер этого компонента так, чтобы его ширина была равна width, а высота - height.
Этот метод изменяет информацию, связанную с макетом, и поэтому делает иерархию компонентов недействительной.
- Параметры:
-
width- новая ширина этого компонента в пикселях -
height- новая высота этого компонента в пикселях - С момента:
- 1.1
- См. также:
-
getSize(),setBounds(int, int, int, int),invalidate()
resize
@Deprecated
public void resize(int width,
int height) setSize(int, int).Изменяет размер этого компонента.
- Параметры:
-
width- новая ширина компонента -
height- новая высота компонента
setSize
public void setSize(Dimension d)
Изменяет размер этого компонента так, чтобы его ширина была равна d.width, а высота - d.height.
Этот метод изменяет информацию, связанную с макетом, и поэтому делает иерархию компонентов недействительной.
- Параметры:
-
d- размер, определяющий новый размер этого компонента - Исключения:
-
NullPointerException- еслиdявляетсяnull - С момента:
- 1.1
- См. также:
-
setSize(int, int),setBounds(int, int, int, int),invalidate()
resize
@Deprecated public void resize(Dimension d)
setSize(Dimension).Изменяет размер этого компонента так, что его ширина равна d.width, а высота равна d.height.
- Параметры:
-
d- новый размер этого компонента
getBounds
public Rectangle getBounds()
Получает границы этого компонента в виде объекта Rectangle. Границы определяют ширину, высоту и положение этого компонента относительно родительского.
- Возвращает:
- прямоугольник, указывающий границы этого компонента
- См. также:
-
setBounds(int, int, int, int),getLocation(),getSize()
bounds
@Deprecated public Rectangle bounds()
getBounds().Возвращает прямоугольник, ограничивающий этот компонент.
- Возвращает:
- прямоугольник, ограничивающий этот компонент
setBounds
public void setBounds(int x,
int y,
int width,
int height) Перемещает и изменяет размер этого компонента. Новое положение верхнего левого угла задается значениями x и y, а новый размер - значениями width и height.
Этот метод изменяет информацию, связанную с макетом, и поэтому делает иерархию компонентов недействительной.
- Параметры:
-
x- новая координата x этого компонента -
y- новая координата y этого компонента -
width- новаяwidthэтого компонента -
height- новаяheightэтого компонента - С момента:
- 1.1
- См. также:
-
getBounds(),setLocation(int, int),setLocation(Point),setSize(int, int),setSize(Dimension),invalidate()
reshape
@Deprecated
public void reshape(int x,
int y,
int width,
int height) setBounds(int, int, int, int).Изменяет прямоугольник, ограничивающий этот компонент.
- Параметры:
-
x- координата x верхнего левого угла прямоугольника -
y- координата y верхнего левого угла прямоугольника -
width- ширина прямоугольника -
height- высота прямоугольника
setBounds
public void setBounds(Rectangle r)
Перемещает и изменяет размер этого компонента в соответствии с новым ограничивающим прямоугольником r. Новое положение компонента задается значениями r.x и r.y, а его новый размер - значениями r.width и r.height.
Этот метод изменяет информацию, связанную с макетом, и поэтому делает иерархию компонентов недействительной.
- Параметры:
-
r- новый ограничивающий прямоугольник для этого компонента - Исключения:
-
NullPointerException- еслиrявляетсяnull - С момента:
- 1.1
- См. также:
-
getBounds(),setLocation(int, int),setLocation(Point),setSize(int, int),setSize(Dimension),invalidate()
getX
public int getX()
Возвращает текущую координату x начала отсчета компонента. Этот метод предпочтительнее, чем запись component.getBounds().x или component.getLocation().x, так как он не вызывает выделения памяти.
- Возвращает:
- текущую координату x начала отсчета компонента
- С момента:
- 1.2
getY
public int getY()
Возвращает текущую координату y начала отсчета компонента. Этот метод предпочтительнее, чем запись component.getBounds().y или component.getLocation().y, так как он не вызывает выделения памяти.
- Возвращает:
- текущую координату y начала отсчета компонента
- С момента:
- 1.2
getWidth
public int getWidth()
Возвращает текущую ширину этого компонента. Этот метод предпочтительнее, чем запись component.getBounds().width или component.getSize().width, так как он не вызывает выделения памяти.
- Возвращает:
- текущую ширину этого компонента
- С момента:
- 1.2
getHeight
public int getHeight()
Возвращает текущую высоту этого компонента. Этот метод предпочтительнее, чем запись component.getBounds().height или component.getSize().height, так как он не вызывает выделения памяти.
- Возвращает:
- текущую высоту этого компонента
- С момента:
- 1.2
getBounds
public Rectangle getBounds(Rectangle rv)
Сохраняет границы этого компонента в "значении возврата" rv и возвращает rv. Если rv является null, то создается новый Rectangle. Эта версия getBounds полезна, если вызывающий код хочет избежать выделения нового объекта Rectangle в куче.
- Параметры:
-
rv- значение возврата, модифицированное до границ компонента - Возвращает:
- rv
getSize
public Dimension getSize(Dimension rv)
Сохраняет ширину/высоту этого компонента в "значении возврата" rv и возвращает rv. Если rv является null, то создается новый объект Dimension. Эта версия getSize полезна, если вызывающий код хочет избежать выделения нового объекта Dimension в куче.
- Параметры:
-
rv- значение возврата, модифицированное до размера компонента - Возвращает:
- rv
getLocation
public Point getLocation(Point rv)
Сохраняет координаты x, y начала отсчета этого компонента в "значении возврата" rv и возвращает rv. Если rv является null, то создается новый Point. Эта версия getLocation полезна, если вызывающий код хочет избежать выделения нового объекта Point в куче.
- Параметры:
-
rv- значение возврата, модифицированное до местоположения компонента - Возвращает:
- rv
isOpaque
public boolean isOpaque()
Возвращает true, если этот компонент полностью непрозрачен, по умолчанию возвращает false.
Непрозрачный компонент рисует каждый пиксель внутри своего прямоугольника. Непрозрачный компонент рисует только некоторые из своих пикселей, позволяя пикселям под ним "просвечивать". Таким образом, компонент, который не полностью рисует свои пиксели, обеспечивает некоторую степень прозрачности.
Подклассы, которые гарантируют полное заполнение своего содержимого, должны переопределять этот метод и возвращать true.
- Возвращает:
- true, если этот компонент полностью непрозрачен
- С момента:
- 1.2
- См. также:
isLightweight()
isLightweight
public boolean isLightweight()
Легковесный компонент не имеет собственного представления в инструментарии отображения. Подклассы Component и Container, за исключением определенных в этом пакете, например, Button или Scrollbar, являются легковесными. Все компоненты Swing являются легковесными.
Этот метод всегда вернет false, если этот компонент не отображаемый, потому что невозможно определить вес неотображаемого компонента.
- Возвращает:
- true, если этот компонент имеет легковесное представление; false, если он имеет собственное или нет представления
- С момента:
- 1.2
- См. также:
isDisplayable()
setPreferredSize
public void setPreferredSize(Dimension preferredSize)
Устанавливает предпочтительный размер этого компонента на постоянное значение. Последующие вызовы getPreferredSize всегда будут возвращать это значение. Установка предпочтительного размера в null восстанавливает стандартное поведение.
- Параметры:
-
preferredSize- новый предпочтительный размер или null - С:
- 1.5
- См. также:
-
getPreferredSize(),isPreferredSizeSet()
isPreferredSizeSet
public boolean isPreferredSizeSet()
Возвращает true, если предпочтительный размер был установлен на отличное от null значение, в противном случае возвращает false.
- Возвращает:
- true, если
setPreferredSizeбыл вызван со значением, отличным от null. - С:
- 1.5
getPreferredSize
public Dimension getPreferredSize()
Возвращает предпочтительный размер этого компонента.
- Возвращает:
- объект типа dimension, указывающий предпочтительный размер этого компонента
- См. также:
-
getMinimumSize(),LayoutManager
preferredSize
@Deprecated public Dimension preferredSize()
getPreferredSize().Возвращает предпочтительный размер компонента.
- Возвращает:
- предпочтительный размер компонента
setMinimumSize
public void setMinimumSize(Dimension minimumSize)
Устанавливает минимальный размер этого компонента на постоянное значение. Последующие вызовы getMinimumSize всегда будут возвращать это значение. Установка минимального размера в null восстанавливает стандартное поведение.
- Параметры:
-
minimumSize- новый минимальный размер этого компонента - С:
- 1.5
- См. также:
-
getMinimumSize(),isMinimumSizeSet()
isMinimumSizeSet
public boolean isMinimumSizeSet()
Возвращает true, если setMinimumSize был вызван со значением, отличным от null.
- Возвращает:
- true, если
setMinimumSizeбыл вызван со значением, отличным от null. - С:
- 1.5
getMinimumSize
public Dimension getMinimumSize()
Возвращает минимальный размер этого компонента.
- Возвращает:
- объект типа dimension, указывающий минимальный размер этого компонента
- См. также:
-
getPreferredSize(),LayoutManager
minimumSize
@Deprecated public Dimension minimumSize()
getMinimumSize().Возвращает минимальный размер этого компонента.
- Возвращает:
- минимальный размер этого компонента
setMaximumSize
public void setMaximumSize(Dimension maximumSize)
Устанавливает максимальный размер этого компонента на постоянное значение. Последующие вызовы getMaximumSize всегда будут возвращать это значение. Установка максимального размера в null восстанавливает стандартное поведение.
- Параметры:
-
maximumSize- объект типаDimension, содержащий желаемый максимальный допустимый размер - С:
- 1.5
- См. также:
-
getMaximumSize(),isMaximumSizeSet()
isMaximumSizeSet
public boolean isMaximumSizeSet()
Возвращает true, если максимальный размер был установлен на значение, отличное от null, в противном случае возвращает false.
- Возвращает:
- true, если
maximumSizeне равноnull, иначе false - С:
- 1.5
getMaximumSize
public Dimension getMaximumSize()
Возвращает максимальный размер этого компонента.
- Возвращает:
- объект типа dimension, указывающий максимальный размер этого компонента
- См. также:
-
getMinimumSize(),getPreferredSize(),LayoutManager
getAlignmentX
public float getAlignmentX()
Возвращает выравнивание по оси x. Это определяет, как компонент хотел бы выровняться относительно других компонентов. Значение должно быть числом от 0 до 1, где 0 соответствует выравниванию по началу, 1 — выравниванию по самому дальнему от начала положению, 0,5 — центрированию и т. д.
- Возвращает:
- горизонтальное выравнивание этого компонента
getAlignmentY
public float getAlignmentY()
Возвращает выравнивание по оси y. Это определяет, как компонент хотел бы выровняться относительно других компонентов. Значение должно быть числом от 0 до 1, где 0 соответствует выравниванию по началу, 1 — выравниванию по самому дальнему от начала положению, 0,5 — центрированию и т. д.
- Возвращает:
- вертикальное выравнивание этого компонента
getBaseline
public int getBaseline(int width,
int height) Возвращает линию базового выравнивания. Линия базового выравнивания измеряется от верхнего края компонента. Этот метод в первую очередь предназначен для LayoutManager, чтобы выровнять компоненты по линии базового выравнивания. Значение меньше 0 указывает, что у этого компонента нет разумной линии базового выравнивания и что LayoutManager не должны выравнивать этот компонент по линии базового выравнивания.
В реализации по умолчанию возвращается -1. Подклассы, поддерживающие линию базового выравнивания, должны переопределять соответствующим образом. Если возвращается значение ≥ 0, у компонента есть допустимая линия базового выравнивания для любого размера ≥ минимальному размеру, и getBaselineResizeBehavior можно использовать для определения того, как меняется линия базового выравнивания в зависимости от размера.
- Параметры:
-
width- ширина для получения линии базового выравнивания -
height- высота для получения линии базового выравнивания - Возвращает:
- линию базового выравнивания или < 0, указывающее, что нет разумной линии базового выравнивания
- Исключение:
-
IllegalArgumentException- если ширина или высота < 0 - С:
- 1.6
- См. также:
-
getBaselineResizeBehavior(),FontMetrics
getBaselineResizeBehavior
public Component.BaselineResizeBehavior getBaselineResizeBehavior()
Возвращает перечисление, указывающее, как линия базового выравнивания компонента изменяется при изменении размера. Этот метод предназначен в первую очередь для менеджеров компоновки и конструкторов графического интерфейса.
В реализации по умолчанию возвращается BaselineResizeBehavior.OTHER. Подклассы, имеющие линию базового выравнивания, должны переопределять соответствующим образом. Подклассы никогда не должны возвращать null; если линия базового выравнивания не может быть рассчитана, возвращается BaselineResizeBehavior.OTHER. Вызывающие стороны сначала запрашивают линию базового выравнивания с помощью getBaseline и, если возвращается значение ≥ 0, используют этот метод. Допустимо, что этот метод вернет значение, отличное от BaselineResizeBehavior.OTHER, даже если getBaseline вернет значение меньше 0.
- Возвращает:
- перечисление, указывающее, как меняется линия базового выравнивания при изменении размера компонента
- С:
- 1.6
- См. также:
getBaseline(int, int)
doLayout
public void doLayout()
Запрашивает менеджер компоновки выполнить компоновку этого компонента. Обычно вызывается при проверке компонента (точнее, контейнера).
- См. также:
-
validate(),LayoutManager
layout
@Deprecated public void layout()
doLayout().validate
public void validate()
Проверяет этот компонент.
Значение термина проверка определяется предками этого класса. См. Container.validate() для получения дополнительной информации.
- С:
- 1.0
- См. также:
-
invalidate(),doLayout(),LayoutManager,Container.validate()
invalidate
public void invalidate()
Делает недействительным этот компонент и его предков.
По умолчанию все предки компонента до самого верхнего контейнера иерархии помечаются как недействительные. Если система свойств
java.awt.smartInvalidate установлена в значение true, отмена инвалидации происходит на ближайшем корне валидации этого компонента. Пометка контейнера как недействительного указывает на необходимость компоновки контейнера.
Этот метод может вызываться часто, поэтому он должен работать быстро.
- С:
- 1.0
- См. также:
-
validate(),doLayout(),LayoutManager,Container.isValidateRoot()
revalidate
public void revalidate()
Проверяет иерархию компонентов до ближайшего корня валидации.
Этот метод сначала делает недействительной иерархию компонентов, начиная с этого компонента и до ближайшего корня валидации. Затем иерархия компонентов проверяется, начиная с ближайшего корня валидации.
Это удобный метод, предназначенный для того, чтобы разработчики приложений избежали ручного поиска корней валидации. По сути, он эквивалентен сначала вызову метода invalidate() для этого компонента, а затем вызову метода validate() для ближайшего корня валидации.
- С:
- 1.7
- См. также:
Container.isValidateRoot()
getGraphics
public Graphics getGraphics()
Создает контекст графики для этого компонента. Этот метод вернет null, если этот компонент в настоящее время не отображается.
- Возвращает:
- контекст графики для этого компонента или
null, если его нет - С:
- 1.0
- См. также:
paint(java.awt.Graphics)
getFontMetrics
public FontMetrics getFontMetrics(Font font)
Получает метрики шрифта для указанного шрифта. Предупреждение: поскольку метрики шрифта зависят от FontRenderContext, а этот метод не предоставляет их, он может возвращать только метрики для контекста рендеринга по умолчанию, которые могут не соответствовать контексту, используемому при рендеринге на компоненте, если используется функциональность Graphics2D. Вместо этого метрики можно получить во время рендеринга, вызвав Graphics.getFontMetrics() или API для измерения текста в классе Font.
- Параметры:
-
font- шрифт, для которого требуется получить метрики шрифта - Возвращает:
- метрики шрифта для
font - С:
- 1.0
- См. также:
-
getFont(),ComponentPeer.getFontMetrics(Font),Toolkit.getFontMetrics(Font)
setCursor
public void setCursor(Cursor cursor)
Устанавливает изображение курсора на указанный курсор. Это изображение курсора отображается, когда метод contains для этого компонента возвращает true для текущего положения курсора, и этот компонент видимый, отображаемый и активный. Установка курсора для Container приводит к отображению этого курсора во всех дочерних компонентах контейнера, за исключением тех, которые имеют не-null курсор.
Метод может не иметь визуального эффекта, если реализация Java платформы и/или системные настройки не поддерживают изменение формы курсора мыши.
- Параметры:
-
cursor- одна из констант, определённых классомCursor; если этот параметр равенnull, то этот компонент унаследует курсор от своего родителя - С:
- 1.1
- См. также:
-
isEnabled(),isShowing(),getCursor(),contains(int, int),Toolkit.createCustomCursor(java.awt.Image, java.awt.Point, java.lang.String),Cursor
getCursor
public Cursor getCursor()
Получает курсор, установленный в компоненте. Если в компоненте курсор не установлен, возвращается курсор родительского компонента. Если курсор не установлен ни в одном элементе иерархии, возвращается Cursor.DEFAULT_CURSOR.
- Возвращает:
- курсор для этого компонента
- С:
- 1.1
- См. также:
setCursor(java.awt.Cursor)
isCursorSet
public boolean isCursorSet()
Возвращает, был ли явно задан курсор для этого компонента. Если этот метод возвращает false, этот компонент наследует курсор от предка.
- Возвращает:
-
true, если курсор был явно задан для этого компонента;falseв противном случае. - С:
- 1.4
paint
public void paint(Graphics g)
Отрисовывает этот компонент.
Этот метод вызывается, когда содержимое компонента должно быть отрисовано; например, когда компонент впервые отображается или повреждён и нуждается в восстановлении. Прямоугольник обрезки в параметре Graphics задаётся областью, которая должна быть отрисована. Подклассы Component, которые переопределяют этот метод, не должны вызывать super.paint(g).
По соображениям производительности, Component с нулевой шириной или высотой не считаются нуждающимися в отрисовке при первом отображении, а также не считаются нуждающимися в восстановлении.
Примечание: Более подробную информацию о механизмах отрисовки AWT и Swing, включая информацию о написании наиболее эффективного кода отрисовки, см. в Отрисовка в AWT и Swing.
- Параметры:
-
g- контекст графики для отрисовки - С:
- 1.0
- См. также:
update(java.awt.Graphics)
update
public void update(Graphics g)
Обновляет этот компонент.
Если этот компонент не является лёгким компонентом, AWT вызывает метод update в ответ на вызов метода repaint. Можно предположить, что фон не очищается.
Метод update класса Component вызывает метод paint этого компонента для перерисовки этого компонента. Этот метод обычно переопределяется подклассами, которым необходимо выполнить дополнительные действия в ответ на вызов repaint. Подклассы класса Component, которые переопределяют этот метод, должны либо вызвать super.update(g), либо вызвать paint(g) непосредственно из своего метода update.
Начальная точка контекста графики, её координата (0, 0), - это верхний левый угол этого компонента. Область обрезки контекста графики - это прямоугольник границ этого компонента.
Примечание: Более подробную информацию о механизмах отрисовки AWT и Swing, включая информацию о написании наиболее эффективного кода отрисовки, см. в Отрисовка в AWT и Swing.
- Параметры:
-
g- указанный контекст для обновления - С:
- 1.0
- См. также:
-
paint(java.awt.Graphics),repaint()
paintAll
public void paintAll(Graphics g)
Отрисовывает этот компонент и все его дочерние компоненты.
Начальная точка контекста графики, её координата (0, 0), - это верхний левый угол этого компонента. Область обрезки контекста графики - это прямоугольник границ этого компонента.
- Параметры:
-
g- контекст графики для отрисовки - С:
- 1.0
- См. также:
paint(java.awt.Graphics)
repaint
public void repaint()
Перерисовывает этот компонент.
Если этот компонент является лёгким компонентом, этот метод вызывает метод paint этого компонента как можно скорее. В противном случае этот метод вызывает метод update этого компонента как можно скорее.
Примечание: Более подробную информацию о механизмах отрисовки AWT и Swing, включая информацию о написании наиболее эффективного кода отрисовки, см. в Отрисовка в AWT и Swing.
- С:
- 1.0
- См. также:
update(Graphics)
repaint
public void repaint(long tm)
Перерисовывает компонент. Если этот компонент является лёгким компонентом, это приводит к вызову paint в течение tm миллисекунд.
Примечание: Более подробную информацию о механизмах отрисовки AWT и Swing, включая информацию о написании наиболее эффективного кода отрисовки, см. в Отрисовка в AWT и Swing.
- Параметры:
-
tm- максимальное время в миллисекундах до обновления - С:
- 1.0
- См. также:
-
paint(java.awt.Graphics),update(Graphics)
repaint
public void repaint(int x,
int y,
int width,
int height) Перерисовывает указанный прямоугольник этого компонента.
Если этот компонент является лёгким компонентом, этот метод вызывает метод paint этого компонента как можно скорее. В противном случае этот метод вызывает метод update этого компонента как можно скорее.
Примечание: Более подробную информацию о механизмах отрисовки AWT и Swing, включая информацию о написании наиболее эффективного кода отрисовки, см. в Отрисовка в AWT и Swing.
- Параметры:
-
x- координата x -
y- координата y -
width- ширина -
height- высота - С:
- 1.0
- См. также:
update(Graphics)
repaint
public void repaint(long tm,
int x,
int y,
int width,
int height) Перерисовывает указанный прямоугольник этого компонента в течение tm миллисекунд.
Если этот компонент является лёгким компонентом, этот метод вызывает метод paint этого компонента. В противном случае этот метод вызывает метод update этого компонента.
Примечание: Более подробную информацию о механизмах отрисовки AWT и Swing, включая информацию о написании наиболее эффективного кода отрисовки, см. в Отрисовка в AWT и Swing.
- Параметры:
-
tm- максимальное время в миллисекундах до обновления -
x- координата x -
y- координата y -
width- ширина -
height- высота - С:
- 1.0
- См. также:
update(Graphics)
public void print(Graphics g)
Печатает этот компонент. Приложения должны переопределить этот метод для компонентов, которые должны выполнить специальную обработку перед печатью или должны быть напечатаны по-другому, чем они отрисованы.
По умолчанию этот метод вызывает метод paint.
Начальная точка контекста графики, её координата (0, 0), - это верхний левый угол этого компонента. Область обрезки контекста графики - это прямоугольник границ этого компонента.
- Параметры:
-
g- контекст графики для печати - С:
- 1.0
- См. также:
paint(Graphics)
printAll
public void printAll(Graphics g)
Печатает этот компонент и все его подкомпоненты.
Начальная точка контекста графики, ее (0, 0) координата, находится в верхнем левом углу этого компонента. Область обрезки контекста графики — это прямоугольник, ограничивающий этот компонент.
- Параметры:
-
g- контекст графики, который следует использовать для печати - С:
- 1.0
- См. также:
print(Graphics)
imageUpdate
public boolean imageUpdate(Image img,
int infoflags,
int x,
int y,
int w,
int h) Перерисовывает компонент, когда изображение изменилось. Этот imageUpdate метод компонента ImageObserver вызывается, когда становится доступна дополнительная информация об изображении, ранее запрошенном с помощью асинхронной процедуры, такой как метод drawImage класса Graphics. Подробнее об этом методе и его аргументах см. в определении imageUpdate.
Метод imageUpdate класса Component поэтапно отрисовывает изображение на компоненте по мере доступности дополнительных битов изображения.
Если системная переменная awt.image.incrementaldraw отсутствует или имеет значение true, изображение отрисовывается поэтапно. Если системная переменная имеет любое другое значение, то изображение не отрисовывается до тех пор, пока не будет загружено полностью.
Кроме того, если поэтапная отрисовка включена, значение системной переменной awt.image.redrawrate интерпретируется как целое число, определяющее максимальную частоту перерисовки в миллисекундах. Если системная переменная отсутствует или не может быть интерпретирована как целое число, частота перерисовки составляет 1 раз каждые 100 мс.
Интерпретация аргументов x, y, width и height зависит от значения аргумента infoflags.
- Определено в:
-
imageUpdateв интерфейсеImageObserver - Параметры:
-
img- наблюдаемое изображение -
infoflags- см.imageUpdateдля получения дополнительной информации -
x- координата x -
y- координата y -
w- ширина -
h- высота - Возвращает:
-
false, если флаги сообщают, что изображение полностью загружено;trueв противном случае. - С:
- 1.0
- См. также:
-
ImageObserver,Graphics.drawImage(Image, int, int, Color, java.awt.image.ImageObserver),Graphics.drawImage(Image, int, int, java.awt.image.ImageObserver),Graphics.drawImage(Image, int, int, int, int, Color, java.awt.image.ImageObserver),Graphics.drawImage(Image, int, int, int, int, java.awt.image.ImageObserver),ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)
createImage
public Image createImage(ImageProducer producer)
Создаёт изображение из указанного производителя изображений.
- Параметры:
-
producer- производитель изображений - Возвращает:
- созданное изображение
- С:
- 1.0
createImage
public Image createImage(int width,
int height) Создаёт отрисовываемое изображение вне области видимости для использования в буферизации двойной буферизации.
- Параметры:
-
width- заданная ширина -
height- заданная высота - Возвращает:
- отрисовываемое изображение вне области видимости, которое можно использовать для буферизации двойной буферизации. Значение
null, если компонент не отображается, илиGraphicsEnvironment.isHeadless()возвращаетtrue. - С:
- 1.0
- См. также:
-
isDisplayable(),GraphicsEnvironment.isHeadless()
createVolatileImage
public VolatileImage createVolatileImage(int width,
int height) Создаёт летучее отрисовываемое изображение вне области видимости для использования в буферизации двойной буферизации.
- Параметры:
-
width- заданная ширина -
height- заданная высота - Возвращает:
- отрисовываемое изображение вне области видимости, которое можно использовать для буферизации двойной буферизации. Значение
null, если компонент не отображается, илиGraphicsEnvironment.isHeadless()возвращаетtrue. - С:
- 1.4
- См. также:
-
VolatileImage,isDisplayable(),GraphicsEnvironment.isHeadless()
createVolatileImage
public VolatileImage createVolatileImage(int width,
int height,
ImageCapabilities caps)
throws AWTException Создаёт летучее отрисовываемое изображение вне области видимости с заданными возможностями. Содержимое этого изображения может быть потеряно в любой момент из-за проблем с операционной системой, поэтому изображение необходимо управлять через интерфейс VolatileImage.
- Параметры:
-
width- заданная ширина -
height- заданная высота -
caps- возможности изображения - Возвращает:
- объект VolatileImage, который можно использовать для управления потерями содержимого поверхности и возможностями. Значение
null, если компонент не отображается, илиGraphicsEnvironment.isHeadless()возвращаетtrue. - Исключения:
-
AWTException- если изображение с указанными возможностями не может быть создано - С:
- 1.4
- См. также:
VolatileImage
prepareImage
public boolean prepareImage(Image image,
ImageObserver observer) Подготавливает изображение для отрисовки на этом компоненте. Данные изображения загружаются асинхронно в другом потоке, и генерируется соответствующее представление изображения на экране.
- Параметры:
-
image-Image, для которого требуется подготовить экранное представление -
observer- объектImageObserver, которому нужно сообщить о подготовке изображения - Возвращает:
-
true, если изображение уже полностью подготовлено;falseв противном случае - С:
- 1.0
prepareImage
public boolean prepareImage(Image image,
int width,
int height,
ImageObserver observer) Подготавливает изображение для отрисовки на этом компоненте с указанной шириной и высотой.
Данные изображения загружаются асинхронно в другом потоке, и генерируется масштабированное экранное представление изображения.
- Параметры:
-
image- экземплярImage, для которого требуется подготовить экранное представление -
width- ширина желаемого экранного представления -
height- высота желаемого экранного представления -
observer- объектImageObserver, которому нужно сообщить о подготовке изображения - Возвращает:
-
true, если изображение уже полностью подготовлено;falseв противном случае - С:
- 1.0
- См. также:
ImageObserver
checkImage
public int checkImage(Image image,
ImageObserver observer) Возвращает состояние построения экранного представления указанного изображения.
Этот метод не вызывает загрузку изображения. Приложение должно использовать метод prepareImage для принудительной загрузки изображения.
Информация о флагах, возвращаемых этим методом, находится в обсуждении интерфейса ImageObserver.
- Параметры:
-
image- объектImage, состояние которого проверяется -
observer- объектImageObserver, которому нужно сообщить о подготовке изображения - Возвращает:
- побитовое включающее ИЛИ флагов
ImageObserver, указывающих, какая информация об изображении в настоящее время доступна - С:
- 1.0
- См. также:
-
prepareImage(Image, int, int, java.awt.image.ImageObserver),Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver),ImageObserver
checkImage
public int checkImage(Image image,
int width,
int height,
ImageObserver observer) Возвращает состояние построения экранного представления указанного изображения.
Этот метод не вызывает загрузку изображения. Приложение должно использовать метод prepareImage для принудительной загрузки изображения.
Метод checkImage класса Component вызывает метод checkImage своего пэйра для вычисления флагов. Если у этого компонента ещё нет пэйра, вместо этого вызывается метод checkImage инструментария компонента.
Информация о флагах, возвращаемых этим методом, содержится в обсуждении интерфейса ImageObserver.
- Параметры:
-
image- объектImage, состояние которого проверяется -
width- ширина масштабированной версии, состояние которой необходимо проверить -
height- высота масштабированной версии, состояние которой необходимо проверить -
observer- объектImageObserver, которому нужно сообщить о подготовке изображения - Возвращает:
- побитовое включающее ИЛИ флагов
ImageObserver, указывающих, какая информация об изображении в настоящее время доступна - С:
- 1.0
- См. также:
-
prepareImage(Image, int, int, java.awt.image.ImageObserver),Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver),ImageObserver
setIgnoreRepaint
public void setIgnoreRepaint(boolean ignoreRepaint)
Устанавливает, игнорировать ли сообщения о перерисовке, полученные от операционной системы. Это не влияет на события перерисовки, сгенерированные в программном обеспечении AWT, если они не являются непосредственным ответом на сообщение о перерисовке на уровне ОС.
Это полезно, например, при работе в полноэкранном режиме для повышения производительности или при использовании стратегии буферизации с переворачиванием страниц.
- Параметры:
-
ignoreRepaint-true, если сообщения о рисовании от операционной системы должны игнорироваться; в противном случаеfalse - С тех пор:
- 1.4
- См. также:
-
getIgnoreRepaint(),Canvas.createBufferStrategy(int),Window.createBufferStrategy(int),BufferStrategy,GraphicsDevice.setFullScreenWindow(java.awt.Window)
getIgnoreRepaint
public boolean getIgnoreRepaint()
- Возвращает:
- игнорировать ли сообщения о рисовании, полученные от операционной системы.
- С тех пор:
- 1.4
- См. также:
setIgnoreRepaint(boolean)
contains
public boolean contains(int x,
int y) Проверяет, "содержит ли" этот компонент указанную точку, где x и y определены как относительные к системе координат этого компонента.
- Параметры:
-
x- координата x точки -
y- координата y точки - Возвращает:
-
true, если точка находится внутри компонента; в противном случаеfalse - С тех пор:
- 1.1
- См. также:
getComponentAt(int, int)
inside
@Deprecated
public boolean inside(int x,
int y) Проверяет, находится ли точка внутри этого компонента.
- Параметры:
-
x- координата x точки -
y- координата y точки - Возвращает:
-
true, если точка находится внутри компонента; в противном случаеfalse
contains
public boolean contains(Point p)
Проверяет, "содержит ли" этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента.
- Параметры:
-
p- точка - Возвращает:
-
true, если точка находится внутри компонента; в противном случаеfalse - Исключение:
-
NullPointerException- еслиpявляетсяnull - С тех пор:
- 1.1
- См. также:
getComponentAt(Point)
getComponentAt
public Component getComponentAt(int x,
int y) Определяет, содержит ли этот компонент или один из его непосредственных дочерних компонентов указанное расположение (x, y), и если да, возвращает содержащий компонент. Этот метод проверяет только один уровень вглубь. Если точка (x, y) находится внутри дочернего компонента, который сам имеет дочерние компоненты, он не продолжает поиск по дереву дочерних компонентов.
Метод locate класса Component просто возвращает сам компонент, если расположение (x, y) находится внутри его области, и null в противном случае.
- Параметры:
-
x- координата x -
y- координата y - Возвращает:
- компонент или подкомпонент, содержащий расположение (x, y);
null, если расположение находится вне этого компонента - С тех пор:
- 1.0
- См. также:
contains(int, int)
locate
@Deprecated
public Component locate(int x,
int y) Возвращает компонент, занимающий указанное положение (этот компонент или непосредственный дочерний компонент, или null, если ни один из первых двух не занимает это место).
- Параметры:
-
x- координата x для поиска компонентов -
y- координата y для поиска компонентов - Возвращает:
- компонент в указанном месте или
null
getComponentAt
public Component getComponentAt(Point p)
Возвращает компонент или подкомпонент, содержащий указанную точку.
- Параметры:
-
p- точка - Возвращает:
- компонент в указанном месте или
null - С тех пор:
- 1.1
- См. также:
contains(int, int)
deliverEvent
@Deprecated public void deliverEvent(Event e)
dispatchEvent(AWTEvent e).- Параметры:
-
e- событие для доставки
dispatchEvent
public final void dispatchEvent(AWTEvent e)
Распространяет событие в этот компонент или один из его подкомпонентов. Вызывает processEvent перед возвратом для событий стиля 1.1, которые были включены для Component.
- Параметры:
-
e- событие
postEvent
@Deprecated public boolean postEvent(Event e)
Описание скопировано из интерфейса: MenuContainer
Отправляет событие слушателям.
- Определено в:
-
postEventв интерфейсеMenuContainer - Параметры:
-
e- событие для отправки - Возвращает:
- результаты отправки события
addComponentListener
public void addComponentListener(ComponentListener l)
Добавляет указанного слушателя компонентов для получения событий компонентов от этого компонента. Если слушатель l является null, исключение не генерируется, и никаких действий не выполняется.
См. Вопросы потоков AWT для получения подробной информации о модели потоков AWT.
- Параметры:
-
l- слушатель компонентов - С тех пор:
- 1.1
- См. также:
-
ComponentEvent,ComponentListener,removeComponentListener(java.awt.event.ComponentListener),getComponentListeners()
removeComponentListener
public void removeComponentListener(ComponentListener l)
Удаляет указанного слушателя компонентов, чтобы он больше не получал события компонентов от этого компонента. Этот метод не выполняет никакой функции и не генерирует исключение, если слушатель, указанный в аргументе, ранее не был добавлен к этому компоненту. Если слушатель l является null, исключение не генерируется, и никаких действий не выполняется.
См. Вопросы потоков AWT для получения подробной информации о модели потоков AWT.
- Параметры:
-
l- слушатель компонентов - С тех пор:
- 1.1
- См. также:
-
ComponentEvent,ComponentListener,addComponentListener(java.awt.event.ComponentListener),getComponentListeners()
getComponentListeners
public ComponentListener[] getComponentListeners()
Возвращает массив всех слушателей компонентов, зарегистрированных в этом компоненте.
- Возвращает:
- всех слушателей компонентов этого компонента или пустой массив, если слушатели компонентов не зарегистрированы
- С тех пор:
- 1.4
- См. также:
-
addComponentListener(java.awt.event.ComponentListener),removeComponentListener(java.awt.event.ComponentListener)
addFocusListener
public void addFocusListener(FocusListener l)
Добавляет указанного слушателя фокуса для получения событий фокуса от этого компонента, когда этот компонент получает фокус ввода. Если слушатель l является null, исключение не генерируется, и никаких действий не выполняется.
См. Вопросы потоков AWT для получения подробной информации о модели потоков AWT.
- Параметры:
-
l- слушатель фокуса - С тех пор:
- 1.1
- См. также:
-
FocusEvent,FocusListener,removeFocusListener(java.awt.event.FocusListener),getFocusListeners()
removeFocusListener
public void removeFocusListener(FocusListener l)
Удаляет указанного слушателя фокуса, чтобы он больше не получал события фокуса от этого компонента. Этот метод не выполняет никакой функции и не генерирует исключение, если слушатель, указанный в аргументе, ранее не был добавлен к этому компоненту. Если слушатель l является null, исключение не генерируется, и никаких действий не выполняется.
См. Вопросы потоков AWT для получения подробной информации о модели потоков AWT.
- Параметры:
-
l- слушатель фокуса - С тех пор:
- 1.1
- См. также:
-
FocusEvent,FocusListener,addFocusListener(java.awt.event.FocusListener),getFocusListeners()
getFocusListeners
public FocusListener[] getFocusListeners()
Возвращает массив всех слушателей фокуса, зарегистрированных в этом компоненте.
- Возвращает:
- все слушатели событий этого компонента или пустой массив, если слушатели событий компонента в данный момент не зарегистрированы
- С тех пор:
- 1.4
- См. также:
-
addFocusListener(java.awt.event.FocusListener),removeFocusListener(java.awt.event.FocusListener)
addHierarchyListener
public void addHierarchyListener(HierarchyListener l)
Добавляет указанного слушателя иерархии для получения событий изменения иерархии от этого компонента, когда изменяется иерархия, к которой принадлежит этот контейнер. Если слушатель l равен null, исключение не выбрасывается, и никаких действий не выполняется.
См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.
- Параметры:
-
l— слушатель иерархии - С тех пор:
- 1.3
- См. также:
-
HierarchyEvent,HierarchyListener,removeHierarchyListener(java.awt.event.HierarchyListener),getHierarchyListeners()
removeHierarchyListener
public void removeHierarchyListener(HierarchyListener l)
Удаляет указанного слушателя иерархии, чтобы он больше не получал события изменения иерархии от этого компонента. Этот метод не выполняет никаких функций и не выбрасывает исключение, если слушатель, указанный в аргументе, ранее не был добавлен к этому компоненту. Если слушатель l равен null, исключение не выбрасывается, и никаких действий не выполняется.
См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.
- Параметры:
-
l— слушатель иерархии - С тех пор:
- 1.3
- См. также:
-
HierarchyEvent,HierarchyListener,addHierarchyListener(java.awt.event.HierarchyListener),getHierarchyListeners()
getHierarchyListeners
public HierarchyListener[] getHierarchyListeners()
Возвращает массив всех зарегистрированных слушателей иерархии для этого компонента.
- Возвращает:
- все слушатели иерархии этого компонента или пустой массив, если в данный момент не зарегистрированы никакие слушатели иерархии
- С тех пор:
- 1.4
- См. также:
-
addHierarchyListener(java.awt.event.HierarchyListener),removeHierarchyListener(java.awt.event.HierarchyListener)
addHierarchyBoundsListener
public void addHierarchyBoundsListener(HierarchyBoundsListener l)
Добавляет указанного слушателя границ иерархии для получения событий границ иерархии от этого компонента, когда изменяется иерархия, к которой принадлежит этот контейнер. Если слушатель l равен null, исключение не выбрасывается, и никаких действий не выполняется.
См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.
- Параметры:
-
l— слушатель границ иерархии - С тех пор:
- 1.3
- См. также:
-
HierarchyEvent,HierarchyBoundsListener,removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener),getHierarchyBoundsListeners()
removeHierarchyBoundsListener
public void removeHierarchyBoundsListener(HierarchyBoundsListener l)
Удаляет указанного слушателя границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента. Этот метод не выполняет никаких функций и не выбрасывает исключение, если слушатель, указанный в аргументе, ранее не был добавлен к этому компоненту. Если слушатель l равен null, исключение не выбрасывается, и никаких действий не выполняется.
См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.
- Параметры:
-
l— слушатель границ иерархии - С тех пор:
- 1.3
- См. также:
-
HierarchyEvent,HierarchyBoundsListener,addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener),getHierarchyBoundsListeners()
getHierarchyBoundsListeners
public HierarchyBoundsListener[] getHierarchyBoundsListeners()
Возвращает массив всех зарегистрированных слушателей границ иерархии для этого компонента.
- Возвращает:
- все слушатели границ иерархии этого компонента или пустой массив, если в данный момент не зарегистрированы никакие слушатели границ иерархии
- С тех пор:
- 1.4
- См. также:
-
addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener),removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener)
addKeyListener
public void addKeyListener(KeyListener l)
Добавляет указанного слушателя нажатия клавиш для получения событий нажатия клавиш от этого компонента. Если l равно null, исключение не выбрасывается, и никаких действий не выполняется.
См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.
- Параметры:
-
l— слушатель нажатия клавиш. - С тех пор:
- 1.1
- См. также:
-
KeyEvent,KeyListener,removeKeyListener(java.awt.event.KeyListener),getKeyListeners()
removeKeyListener
public void removeKeyListener(KeyListener l)
Удаляет указанного слушателя нажатия клавиш, чтобы он больше не получал события нажатия клавиш от этого компонента. Этот метод не выполняет никаких функций и не выбрасывает исключение, если слушатель, указанный в аргументе, ранее не был добавлен к этому компоненту. Если слушатель l равен null, исключение не выбрасывается, и никаких действий не выполняется.
См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.
- Параметры:
-
l— слушатель нажатия клавиш - С тех пор:
- 1.1
- См. также:
-
KeyEvent,KeyListener,addKeyListener(java.awt.event.KeyListener),getKeyListeners()
getKeyListeners
public KeyListener[] getKeyListeners()
Возвращает массив всех зарегистрированных слушателей нажатия клавиш для этого компонента.
- Возвращает:
- все слушатели нажатия клавиш этого компонента или пустой массив, если в данный момент не зарегистрированы никакие слушатели нажатия клавиш
- С тех пор:
- 1.4
- См. также:
-
addKeyListener(java.awt.event.KeyListener),removeKeyListener(java.awt.event.KeyListener)
addMouseListener
public void addMouseListener(MouseListener l)
Добавляет указанного слушателя мыши для получения событий мыши от этого компонента. Если слушатель l равен null, исключение не выбрасывается, и никаких действий не выполняется.
См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.
- Параметры:
-
l— слушатель мыши - С тех пор:
- 1.1
- См. также:
-
MouseEvent,MouseListener,removeMouseListener(java.awt.event.MouseListener),getMouseListeners()
removeMouseListener
public void removeMouseListener(MouseListener l)
Удаляет указанного слушателя мыши, чтобы он больше не получал события мыши от этого компонента. Этот метод не выполняет никаких функций и не выбрасывает исключение, если слушатель, указанный в аргументе, ранее не был добавлен к этому компоненту. Если слушатель l равен null, исключение не выбрасывается, и никаких действий не выполняется.
См. Вопросы многопоточности AWT для получения подробной информации о модели многопоточности AWT.
- Параметры:
-
l— слушатель мыши - С тех пор:
- 1.1
- См. также:
-
MouseEvent,MouseListener,addMouseListener(java.awt.event.MouseListener),getMouseListeners()
getMouseListeners
public MouseListener[] getMouseListeners()
Возвращает массив всех зарегистрированных слушателей мыши для этого компонента.
- Возвращает:
- все слушатели мыши этого компонента или пустой массив, если в данный момент не зарегистрированы никакие слушатели мыши
- С тех пор:
- 1.4
- См. также:
-
addMouseListener(java.awt.event.MouseListener),removeMouseListener(java.awt.event.MouseListener)
addMouseMotionListener
public void addMouseMotionListener(MouseMotionListener l)
Добавляет указанный слушатель движений мыши для получения событий движения мыши от этого компонента. Если listener l равен null, исключение не выбрасывается, и действие не выполняется.
См. Проблемы потоков AWT для получения подробной информации о модели потоков AWT.
- Параметры:
-
l- слушатель движений мыши - С:
- 1.1
- См. также:
-
MouseEvent,MouseMotionListener,removeMouseMotionListener(java.awt.event.MouseMotionListener),getMouseMotionListeners()
removeMouseMotionListener
public void removeMouseMotionListener(MouseMotionListener l)
Удаляет указанный слушатель движений мыши, чтобы он больше не получал события движения мыши от этого компонента. Этот метод не выполняет никаких функций и не выбрасывает исключение, если слушатель, указанный в аргументе, ранее не был добавлен к этому компоненту. Если listener l равен null, исключение не выбрасывается, и действие не выполняется.
См. Проблемы потоков AWT для получения подробной информации о модели потоков AWT.
- Параметры:
-
l- слушатель движений мыши - С:
- 1.1
- См. также:
-
MouseEvent,MouseMotionListener,addMouseMotionListener(java.awt.event.MouseMotionListener),getMouseMotionListeners()
getMouseMotionListeners
public MouseMotionListener[] getMouseMotionListeners()
Возвращает массив всех зарегистрированных слушателей движений мыши на этом компоненте.
- Возвращает:
- все слушатели движений мыши этого компонента или пустой массив, если слушатели движений мыши не зарегистрированы
- С:
- 1.4
- См. также:
-
addMouseMotionListener(java.awt.event.MouseMotionListener),removeMouseMotionListener(java.awt.event.MouseMotionListener)
addMouseWheelListener
public void addMouseWheelListener(MouseWheelListener l)
Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента. Контейнеры также получают события колесика мыши от подкомпонентов.
Информация о том, как рассылаются события колесика мыши, приведена в описании класса MouseWheelEvent.
Если l равно null, исключение не выбрасывается, и действие не выполняется.
См. Проблемы потоков AWT для получения подробной информации о модели потоков AWT.
- Параметры:
-
l- слушатель колесика мыши - С:
- 1.4
- См. также:
-
MouseWheelEvent,MouseWheelListener,removeMouseWheelListener(java.awt.event.MouseWheelListener),getMouseWheelListeners()
removeMouseWheelListener
public void removeMouseWheelListener(MouseWheelListener l)
Удаляет указанный слушатель колесика мыши, чтобы он больше не получал события колесика мыши от этого компонента. Этот метод не выполняет никаких функций и не выбрасывает исключение, если слушатель, указанный в аргументе, ранее не был добавлен к этому компоненту. Если l равно null, исключение не выбрасывается, и действие не выполняется.
См. Проблемы потоков AWT для получения подробной информации о модели потоков AWT.
- Параметры:
-
l- слушатель колесика мыши. - С:
- 1.4
- См. также:
-
MouseWheelEvent,MouseWheelListener,addMouseWheelListener(java.awt.event.MouseWheelListener),getMouseWheelListeners()
getMouseWheelListeners
public MouseWheelListener[] getMouseWheelListeners()
Возвращает массив всех зарегистрированных слушателей колесика мыши на этом компоненте.
- Возвращает:
- все слушатели колесика мыши этого компонента или пустой массив, если слушатели колесика мыши не зарегистрированы
- С:
- 1.4
- См. также:
-
addMouseWheelListener(java.awt.event.MouseWheelListener),removeMouseWheelListener(java.awt.event.MouseWheelListener)
addInputMethodListener
public void addInputMethodListener(InputMethodListener l)
Добавляет указанный слушатель обработки ввода для получения событий обработки ввода от этого компонента. Компонент будет получать события обработки ввода от обработчиков ввода только в том случае, если он также переопределяет getInputMethodRequests, чтобы вернуть экземпляр InputMethodRequests. Если listener l равен null, исключение не выбрасывается, и действие не выполняется.
См. Проблемы потоков AWT для получения подробной информации о модели потоков AWT.
- Параметры:
-
l- слушатель обработки ввода - С:
- 1.2
- См. также:
-
InputMethodEvent,InputMethodListener,removeInputMethodListener(java.awt.event.InputMethodListener),getInputMethodListeners(),getInputMethodRequests()
removeInputMethodListener
public void removeInputMethodListener(InputMethodListener l)
Удаляет указанный слушатель обработки ввода, чтобы он больше не получал события обработки ввода от этого компонента. Этот метод не выполняет никаких функций и не выбрасывает исключение, если слушатель, указанный в аргументе, ранее не был добавлен к этому компоненту. Если listener l равен null, исключение не выбрасывается, и действие не выполняется.
См. Проблемы потоков AWT для получения подробной информации о модели потоков AWT.
- Параметры:
-
l- слушатель обработки ввода - С:
- 1.2
- См. также:
-
InputMethodEvent,InputMethodListener,addInputMethodListener(java.awt.event.InputMethodListener),getInputMethodListeners()
getInputMethodListeners
public InputMethodListener[] getInputMethodListeners()
Возвращает массив всех зарегистрированных слушателей обработки ввода на этом компоненте.
- Возвращает:
- все слушатели обработки ввода этого компонента или пустой массив, если слушатели обработки ввода не зарегистрированы
- С:
- 1.4
- См. также:
-
addInputMethodListener(java.awt.event.InputMethodListener),removeInputMethodListener(java.awt.event.InputMethodListener)
getListeners
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
Возвращает массив всех объектов, которые в данный момент зарегистрированы как слушатели на этом компоненте. Слушатели регистрируются с помощью метода addFooListener.
Вы можете указать аргумент listenerType с помощью литерала класса, например, FooListener.class. Например, вы можете запросить слушателей мыши для Component c с помощью следующего кода:
MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));Если такие слушатели не существуют, этот метод возвращает пустой массив.
- Типы параметров:
-
T- тип слушателей - Параметры:
-
listenerType- тип запрашиваемых слушателей; этот параметр должен указать интерфейс, унаследованный отjava.util.EventListener - Возвращает:
- массив всех объектов, зарегистрированных как слушатели на этом компоненте, или пустой массив, если такие слушатели не были добавлены
- Исключения:
-
ClassCastException- еслиlistenerTypeне указывает класс или интерфейс, реализующийjava.util.EventListener -
NullPointerException- еслиlistenerTypeравенnull - С:
- 1.3
- См. также:
-
getComponentListeners(),getFocusListeners(),getHierarchyListeners(),getHierarchyBoundsListeners(),getKeyListeners(),getMouseListeners(),getMouseMotionListeners(),getMouseWheelListeners(),getInputMethodListeners(),getPropertyChangeListeners()
getInputMethodRequests
public InputMethodRequests getInputMethodRequests()
Возвращает обработчик запросов обработки ввода, который поддерживает запросы от обработчиков ввода для этого компонента. Компонент, поддерживающий ввод текста на месте, должен переопределить этот метод, чтобы вернуть экземпляр InputMethodRequests. В то же время, он также должен обрабатывать события обработки ввода.
- Возвращает:
- обработчик запросов обработки ввода для этого компонента, по умолчанию
null - С:
- 1.2
- См. также:
addInputMethodListener(java.awt.event.InputMethodListener)
getInputContext
public InputContext getInputContext()
Получает контекст ввода, используемый этим компонентом для обработки взаимодействия со способами ввода текста при вводе в этом компоненте. По умолчанию возвращается контекст ввода родительского компонента. Компоненты могут переопределить это, чтобы вернуть частный контекст ввода.
- Возвращает:
- контекст ввода, используемый этим компонентом;
nullесли контекст определить невозможно - С:
- 1.2
enableEvents
protected final void enableEvents(long eventsToEnable)
Включает события, определённые параметром маски событий, для доставки в этот компонент.
Типы событий автоматически включаются при добавлении слушателя данного типа события в компонент.
Этот метод необходимо вызывать только подклассам Component, которые хотят, чтобы указанные типы событий доставлялись в processEvent независимо от того, зарегистрирован ли слушатель или нет.
- Параметры:
-
eventsToEnable- маска событий, определяющая типы событий - С:
- 1.1
- См. также:
-
processEvent(java.awt.AWTEvent),disableEvents(long),AWTEvent
disableEvents
protected final void disableEvents(long eventsToDisable)
Отключает события, определённые параметром маски событий, от доставки в этот компонент.
- Параметры:
-
eventsToDisable- маска событий, определяющая типы событий - С:
- 1.1
- См. также:
enableEvents(long)
coalesceEvents
protected AWTEvent coalesceEvents(AWTEvent existingEvent,
AWTEvent newEvent) Возможная коалесценция события, которое публикуется, с существующим событием. Этот метод вызывается EventQueue.postEvent, если в очереди обнаружено событие с тем же идентификатором, что и событие, которое должно быть опубликовано (оба события должны иметь этот компонент в качестве своего источника). Этот метод либо возвращает коалесцированное событие, которое заменяет существующее событие (и новое событие затем отбрасывается), либо null, чтобы указать, что объединение не должно выполняться (добавить второе событие в конец очереди). Любой из параметров события может быть изменён и возвращён, поскольку другой отбрасывается, если не возвращается null.
Эта реализация coalesceEvents объединяет два типа событий: события перемещения (и перетаскивания) мыши и события рисования (и обновления). Для событий перемещения мыши всегда возвращается последнее событие, что приводит к отбрасыванию промежуточных перемещений. Для событий рисования новое событие объединяется в сложное RepaintArea в привязке. Новое AWTEvent всегда возвращается.
- Параметры:
-
existingEvent- событие, уже находящееся вEventQueue -
newEvent- событие, публикуемое вEventQueue - Возвращает:
- коалесцированное событие или
null, указывающее, что объединение не выполнялось
processEvent
protected void processEvent(AWTEvent e)
Обрабатывает события, происходящие в этом компоненте. По умолчанию этот метод вызывает соответствующий process<event type>Event метод для данного класса события.
Обратите внимание, что если параметр события null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие - С:
- 1.1
- См. также:
-
processComponentEvent(java.awt.event.ComponentEvent),processFocusEvent(java.awt.event.FocusEvent),processKeyEvent(java.awt.event.KeyEvent),processMouseEvent(java.awt.event.MouseEvent),processMouseMotionEvent(java.awt.event.MouseEvent),processInputMethodEvent(java.awt.event.InputMethodEvent),processHierarchyEvent(java.awt.event.HierarchyEvent),processMouseWheelEvent(java.awt.event.MouseWheelEvent)
processComponentEvent
protected void processComponentEvent(ComponentEvent e)
Обрабатывает события компонента, происходящие в этом компоненте, направив их любому зарегистрированному ComponentListener объекту.
Этот метод не вызывается, если события компонента не включены для этого компонента. События компонента включены, когда происходит одно из следующего:
ComponentListenerобъект зарегистрирован черезaddComponentListener.- События компонента включены через
enableEvents.
Обратите внимание, что если параметр события null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие компонента - С:
- 1.1
- См. также:
-
ComponentEvent,ComponentListener,addComponentListener(java.awt.event.ComponentListener),enableEvents(long)
processFocusEvent
protected void processFocusEvent(FocusEvent e)
Обрабатывает события фокуса, происходящие в этом компоненте, направив их любому зарегистрированному FocusListener объекту.
Этот метод не вызывается, если события фокуса не включены для этого компонента. События фокуса включены, когда происходит одно из следующего:
FocusListenerобъект зарегистрирован черезaddFocusListener.- События фокуса включены через
enableEvents.
Если события фокуса включены для Component, текущее KeyboardFocusManager определяет, следует ли направлять событие фокуса зарегистрированным FocusListener объектам. Если события необходимо отправить, KeyboardFocusManager вызывает Component's dispatchEvent метод, что приводит к вызову Component's processFocusEvent метода.
Если события фокуса включены для Component, вызов Component's dispatchEvent метода с FocusEvent в качестве аргумента приведет к вызову Component's processFocusEvent метода независимо от текущего KeyboardFocusManager.
Обратите внимание, что если параметр события null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие фокуса - С:
- 1.1
- См. также:
-
FocusEvent,FocusListener,KeyboardFocusManager,addFocusListener(java.awt.event.FocusListener),enableEvents(long),dispatchEvent(java.awt.AWTEvent)
processKeyEvent
protected void processKeyEvent(KeyEvent e)
Обрабатывает события нажатия клавиш, происходящие в этом компоненте, отправив их всем зарегистрированным KeyListener объектам.
Этот метод не вызывается, если события нажатия клавиш не включены для этого компонента. События нажатия клавиш включаются, когда происходит одно из следующего:
KeyListenerобъект зарегистрирован черезaddKeyListener.- События нажатия клавиш включены через
enableEvents.
Если события нажатия клавиш включены для Component, текущее KeyboardFocusManager определяет, следует ли отправлять событие нажатия клавиш зарегистрированным KeyListener объектам. DefaultKeyboardFocusManager не будет отправлять события нажатия клавиш в Component, который не является владельцем фокуса или не отображается.
Начиная с J2SE 1.4, события KeyEvent перенаправляются владельцу фокуса. Подробнее см. Спецификацию фокуса.
Вызов Component's dispatchEvent метода с KeyEvent в качестве аргумента приведет к вызову Component's processKeyEvent метода независимо от текущего KeyboardFocusManager, пока компонент отображается, имеет фокус и активирован, и события нажатия клавиш включены в нем.
Если параметр события null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие нажатия клавиши - С:
- 1.1
- См. также:
-
KeyEvent,KeyListener,KeyboardFocusManager,DefaultKeyboardFocusManager,processEvent(java.awt.AWTEvent),dispatchEvent(java.awt.AWTEvent),addKeyListener(java.awt.event.KeyListener),enableEvents(long),isShowing()
processMouseEvent
protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, происходящие в этом компоненте, отправив их любому зарегистрированному MouseListener объекту.
Этот метод не вызывается, если события мыши не включены для этого компонента. События мыши включаются, когда происходит одно из следующего:
MouseListenerобъект зарегистрирован черезaddMouseListener.- События мыши включены через
enableEvents.
Обратите внимание, что если параметр события null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие мыши - С:
- 1.1
- См. также:
-
MouseEvent,MouseListener,addMouseListener(java.awt.event.MouseListener),enableEvents(long)
processMouseMotionEvent
protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события движения мыши, происходящие в этом компоненте, путем их отправки всем зарегистрированным объектам MouseMotionListener.
Этот метод не вызывается, если события движения мыши не включены для этого компонента. События движения мыши включаются, когда происходит одно из следующих событий:
- Объект
MouseMotionListenerрегистрируется черезaddMouseMotionListener. - События движения мыши включаются через
enableEvents.
Обратите внимание, что если параметр события является null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие движения мыши - С версии:
- 1.1
- См. также:
-
MouseEvent,MouseMotionListener,addMouseMotionListener(java.awt.event.MouseMotionListener),enableEvents(long)
processMouseWheelEvent
protected void processMouseWheelEvent(MouseWheelEvent e)
Обрабатывает события колеса мыши, происходящие в этом компоненте, путем их отправки всем зарегистрированным объектам MouseWheelListener.
Этот метод не вызывается, если события колеса мыши не включены для этого компонента. События колеса мыши включаются, когда происходит одно из следующих событий:
- Объект
MouseWheelListenerрегистрируется черезaddMouseWheelListener. - События колеса мыши включаются через
enableEvents.
Для получения информации о том, как отправляются события колеса мыши, см. описание класса для MouseWheelEvent.
Обратите внимание, что если параметр события является null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие колеса мыши - С версии:
- 1.4
- См. также:
-
MouseWheelEvent,MouseWheelListener,addMouseWheelListener(java.awt.event.MouseWheelListener),enableEvents(long)
processInputMethodEvent
protected void processInputMethodEvent(InputMethodEvent e)
Обрабатывает события метода ввода, происходящие в этом компоненте, путем их отправки всем зарегистрированным объектам InputMethodListener.
Этот метод не вызывается, если события метода ввода не включены для этого компонента. События метода ввода включаются, когда происходит одно из следующих событий:
- Объект
InputMethodListenerрегистрируется черезaddInputMethodListener. - События метода ввода включаются через
enableEvents.
Обратите внимание, что если параметр события является null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие метода ввода - С версии:
- 1.2
- См. также:
-
InputMethodEvent,InputMethodListener,addInputMethodListener(java.awt.event.InputMethodListener),enableEvents(long)
processHierarchyEvent
protected void processHierarchyEvent(HierarchyEvent e)
Обрабатывает события иерархии, происходящие в этом компоненте, путем их отправки всем зарегистрированным объектам HierarchyListener.
Этот метод не вызывается, если события иерархии не включены для этого компонента. События иерархии включаются, когда происходит одно из следующих событий:
- Объект
HierarchyListenerрегистрируется черезaddHierarchyListener. - События иерархии включаются через
enableEvents.
Обратите внимание, что если параметр события является null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие иерархии - С версии:
- 1.3
- См. также:
-
HierarchyEvent,HierarchyListener,addHierarchyListener(java.awt.event.HierarchyListener),enableEvents(long)
processHierarchyBoundsEvent
protected void processHierarchyBoundsEvent(HierarchyEvent e)
Обрабатывает события границ иерархии, происходящие в этом компоненте, путем их отправки всем зарегистрированным объектам HierarchyBoundsListener.
Этот метод не вызывается, если события границ иерархии не включены для этого компонента. События границ иерархии включаются, когда происходит одно из следующих событий:
- Объект
HierarchyBoundsListenerрегистрируется черезaddHierarchyBoundsListener. - События границ иерархии включаются через
enableEvents.
Обратите внимание, что если параметр события является null, поведение не определено и может привести к исключению.
- Параметры:
-
e- событие иерархии - С версии:
- 1.3
- См. также:
-
HierarchyEvent,HierarchyBoundsListener,addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener),enableEvents(long)
handleEvent
@Deprecated public boolean handleEvent(Event evt)
- Параметры:
-
evt- событие для обработки - Возвращает:
-
trueесли событие было обработано,falseв противном случае
mouseDown
@Deprecated
public boolean mouseDown(Event evt,
int x,
int y) - Параметры:
-
evt- событие для обработки -
x- координата x -
y- координата y - Возвращает:
false
mouseDrag
@Deprecated
public boolean mouseDrag(Event evt,
int x,
int y) - Параметры:
-
evt- событие для обработки -
x- координата x -
y- координата y - Возвращает:
false
mouseUp
@Deprecated
public boolean mouseUp(Event evt,
int x,
int y) - Параметры:
-
evt- событие для обработки -
x- координата x -
y- координата y - Возвращает:
false
mouseMove
@Deprecated
public boolean mouseMove(Event evt,
int x,
int y) - Параметры:
-
evt- событие для обработки -
x- координата x -
y- координата y - Возвращает:
false
mouseEnter
@Deprecated
public boolean mouseEnter(Event evt,
int x,
int y) - Параметры:
-
evt- событие для обработки -
x- координата x -
y- координата y - Возвращает:
false
mouseExit
@Deprecated
public boolean mouseExit(Event evt,
int x,
int y) - Параметры:
-
evt- событие для обработки -
x- координата x -
y- координата y - Возвращает:
false
keyDown
@Deprecated
public boolean keyDown(Event evt,
int key) - Параметры:
-
evt- событие для обработки -
key- нажатая клавиша - Возвращает:
false
keyUp
@Deprecated
public boolean keyUp(Event evt,
int key) - Параметры:
-
evt- событие для обработки -
key- нажатая клавиша - Возвращает:
false
action
@Deprecated
public boolean action(Event evt,
Object what) - Параметры:
-
evt- событие для обработки -
what- объект, над которым выполняется действие - Возвращает:
false
addNotify
public void addNotify()
Делает этот Component отображаемым, подключив его к собственному ресурсу экрана. Этот метод вызывается внутренне инструментарием и не должен вызываться напрямую программами.
Этот метод изменяет информацию, связанную с макетом, и, следовательно, делает недействительной иерархию компонентов.
- С версии:
- 1.0
- См. также:
-
isDisplayable(),removeNotify(),invalidate()
removeNotify
public void removeNotify()
Делает этот Component неотображаемым, уничтожая его собственный ресурс экрана.
Этот метод вызывается инструментарием внутренне и не должен вызываться напрямую программами. Код, переопределяющий этот метод, должен вызывать super.removeNotify в качестве первой строки переопределяемого метода.
- С версии:
- 1.0
- См. также:
-
isDisplayable(),addNotify()
gotFocus
@Deprecated
public boolean gotFocus(Event evt,
Object what) - Параметры:
-
evt- событие для обработки -
what- объект, получивший фокус - Возвращает:
false
lostFocus
@Deprecated
public boolean lostFocus(Event evt,
Object what) - Параметры:
-
evt- событие для обработки -
what- объект, получивший фокус - Возвращает:
false
isFocusTraversable
@Deprecated public boolean isFocusTraversable()
isFocusable().Возвращает, может ли данный Component стать владельцем фокуса.
- Возвращает:
-
true, если данныйComponentфокусируемый;falseв противном случае - С:
- 1.1
- См. также:
setFocusable(boolean)
isFocusable
public boolean isFocusable()
Возвращает, может ли данный компонент получить фокус.
- Возвращает:
-
true, если данный компонент фокусируемый;falseв противном случае. - С:
- 1.4
- См. также:
setFocusable(boolean)
setFocusable
public void setFocusable(boolean focusable)
Устанавливает состояние фокусируемости данного компонента в указанное значение. Это значение переопределяет стандартную фокусируемость компонента.
- Параметры:
-
focusable- указывает, является ли этот компонент фокусируемым - С:
- 1.4
- См. также:
isFocusable()
setFocusTraversalKeys
public void setFocusTraversalKeys(int id,
Set<? extends AWTKeyStroke> keystrokes) Устанавливает клавиши перехода фокуса для заданной операции перехода для данного компонента.
Значения по умолчанию для клавиш перехода фокуса для компонента зависят от реализации. Sun рекомендует, чтобы все реализации для определённой платформы использовали одинаковые значения по умолчанию. Рекомендации для Windows и Unix приведены ниже. Эти рекомендации используются в реализациях Sun AWT.
| Идентификатор | Значение | Значение по умолчанию |
|---|---|---|
| KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS | Нормальный прямой переход фокуса с клавиатуры | TAB при KEY_PRESSED, CTRL-TAB при KEY_PRESSED |
| KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS | Нормальный обратный переход фокуса с клавиатуры | SHIFT-TAB при KEY_PRESSED, CTRL-SHIFT-TAB при KEY_PRESSED |
| KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS | Переход на предыдущий цикл перехода фокуса | нет |
Используя API AWTKeyStroke, код приложения может указать, на каком из двух конкретных событий KeyEvents, KEY_PRESSED или KEY_RELEASED, произойдёт операция перехода фокуса. Однако независимо от того, какое событие KeyEvent указано, все события KeyEvents, связанные с клавишей перехода фокуса, включая связанное событие KEY_TYPED, будут потреблены и не будут переданы ни одному компоненту. Ошибкой во время выполнения является указание события KEY_TYPED как отображаемого на операцию перехода фокуса или отображение того же события на несколько операций перехода фокуса по умолчанию.
Если для Set указано значение null, этот компонент наследует Set от своего родителя. Если все предки этого компонента имеют null для Set, то используется набор значений по умолчанию текущего KeyboardFocusManager.
Этот метод может выбросить ClassCastException, если какой-либо Object в keystrokes не является AWTKeyStroke.
- Параметры:
-
id- одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS -
keystrokes- набор AWTKeyStroke для указанной операции - Исключения:
-
IllegalArgumentException- если id не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или если keystrokes содержит null, или если какой-либо keystroke представляет событие KEY_TYPED, или если какой-либо keystroke уже отображается на другую операцию перехода фокуса для данного компонента - С:
- 1.4
- См. также:
-
getFocusTraversalKeys(int),KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
getFocusTraversalKeys
public Set<AWTKeyStroke> getFocusTraversalKeys(int id)
Возвращает набор клавиш перехода фокуса для заданной операции перехода для данного компонента. (См. setFocusTraversalKeys для полного описания каждой клавиши.)
Если набор клавиш перехода фокуса не был явно определён для этого компонента, возвращается набор клавиш перехода фокуса родительского компонента. Если набор клавиш перехода фокуса не был явно определён ни для одного из предков этого компонента, возвращается набор значений по умолчанию текущего KeyboardFocusManager.
- Параметры:
-
id- одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS - Возвращает:
- набор AWTKeyStrokes для указанной операции. Набор будет неизменяемым и может быть пустым. null никогда не будет возвращён.
- Исключения:
-
IllegalArgumentException- если id не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS - С:
- 1.4
- См. также:
-
setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>),KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
areFocusTraversalKeysSet
public boolean areFocusTraversalKeysSet(int id)
Возвращает, был ли набор клавиш перехода фокуса для заданной операции перехода фокуса явно определён для этого компонента. Если этот метод возвращает false, этот компонент наследует набор от предка или от текущего KeyboardFocusManager.
- Параметры:
-
id- одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS - Возвращает:
-
true, если набор клавиш перехода фокуса для данной операции перехода фокуса был явно определён для этого компонента;falseв противном случае. - Исключения:
-
IllegalArgumentException- если id не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS или KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS - С:
- 1.4
setFocusTraversalKeysEnabled
public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
Устанавливает, включены ли клавиши перехода фокуса для данного компонента. Компоненты, для которых клавиши перехода фокуса отключены, получают события клавиш для перехода фокуса. Компоненты, для которых клавиши перехода фокуса включены, не видят эти события; вместо этого события автоматически преобразуются в операции перехода.
- Параметры:
-
focusTraversalKeysEnabled- включены ли клавиши перехода фокуса для данного компонента - С:
- 1.4
- См. также:
-
getFocusTraversalKeysEnabled(),setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>),getFocusTraversalKeys(int)
getFocusTraversalKeysEnabled
public boolean getFocusTraversalKeysEnabled()
Возвращает, включены ли клавиши перехода фокуса для этого компонента. Компоненты, для которых клавиши перехода фокуса отключены, получают события клавиш для перехода фокуса. Компоненты, для которых клавиши перехода фокуса включены, не видят эти события; вместо этого события автоматически преобразуются в операции перехода.
- Возвращает:
- включены ли клавиши перехода фокуса для этого компонента
- С:
- 1.4
- См. также:
-
setFocusTraversalKeysEnabled(boolean),setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>),getFocusTraversalKeys(int)
requestFocus
public void requestFocus()
Запрашивает, чтобы этот компонент получил фокус ввода, и чтобы его верхнеуровневый предок стал фокусированным окном. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением верхнего уровня окна) должны быть видимыми для обработки запроса. Будут приложены все усилия для удовлетворения запроса; однако в некоторых случаях это может быть невозможно. Разработчики никогда не должны предполагать, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED. Если этот запрос отклоняется, потому что окно верхнего уровня этого компонента не может стать фокусированным окном, запрос будет запомнен и будет выполнен, когда окно позже будет фокусировано пользователем.
Этот метод не может использоваться для установки владельца фокуса на любой компонент. Используйте KeyboardFocusManager.clearGlobalFocusOwner() вместо этого.
Поскольку поведение фокуса этого метода зависит от платформы, разработчикам настоятельно рекомендуется использовать requestFocusInWindow, когда это возможно.
Примечание: не все изменения фокуса происходят при вызове этого метода. Таким образом, компонент может получить фокус, не вызывая этот или другие методы requestFocus класса Component.
- С:
- 1.0
- См. также:
-
requestFocusInWindow(),FocusEvent,addFocusListener(java.awt.event.FocusListener),isFocusable(),isDisplayable(),KeyboardFocusManager.clearGlobalFocusOwner()
requestFocus
public void requestFocus(FocusEvent.Cause cause)
Запрос на получение фокуса ввода для этого компонента, а также на то, чтобы родительский компонент высшего уровня стал фокусированным окном. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением окна верхнего уровня) должны быть видимыми, чтобы запрос был удовлетворен. Будут предприняты все усилия для выполнения запроса; однако в некоторых случаях это может оказаться невозможным. Разработчики никогда не должны полагаться на то, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED.
Эффект запроса фокуса также может зависеть от предоставленного значения причины. Если запрос успешен, сгенерированное в результате событие {FocusEvent} получит значение причины, указанное в качестве аргумента метода. Если запрос отклонен, потому что окно верхнего уровня этого компонента не может стать фокусированным окном, запрос будет сохранен и выполнен, когда окно позже получит фокус от пользователя.
Этот метод нельзя использовать для установки владельца фокуса в значение «ни один компонент». Используйте KeyboardFocusManager.clearGlobalFocusOwner() вместо этого.
Поскольку поведение фокуса этого метода зависит от платформы, разработчикам настоятельно рекомендуется использовать requestFocusInWindow(FocusEvent.Cause), когда это возможно.
Примечание: не все переходы фокуса происходят в результате вызова этого метода. Таким образом, компонент может получить фокус без вызова этого или любого другого requestFocus метода класса Component.
- Параметры:
-
cause- причина запроса фокуса - С:
- 9
- См. также:
-
FocusEvent,FocusEvent.Cause,requestFocusInWindow(FocusEvent.Cause),FocusEvent,addFocusListener(java.awt.event.FocusListener),isFocusable(),isDisplayable(),KeyboardFocusManager.clearGlobalFocusOwner()
requestFocus
protected boolean requestFocus(boolean temporary)
Запрос на получение фокуса ввода для этого Component, а также на то, чтобы родительский компонент высшего уровня этого Component стал фокусированным Window. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением окна верхнего уровня) должны быть видимыми, чтобы запрос был удовлетворён. Будут предприняты все усилия для выполнения запроса; однако в некоторых случаях это может оказаться невозможным. Разработчики никогда не должны полагаться на то, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED. Если запрос отклонен, потому что окно верхнего уровня этого компонента не может стать фокусированным окном, запрос будет сохранён и выполнен, когда окно позже получит фокус от пользователя.
Этот метод возвращает логическое значение. Если возвращается false, запрос гарантированно провалится. Если возвращается true, запрос будет выполнен, если он не будет отклонен или не произойдёт чрезвычайное событие, такое как удаление соседа компонента, до того, как запрос будет удовлетворён системой окон. Опять же, хотя возвращаемое значение true указывает, что запрос, вероятно, будет выполнен, разработчики никогда не должны полагаться на то, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED.
Этот метод нельзя использовать для установки владельца фокуса в значение «ни один компонент». Используйте KeyboardFocusManager.clearGlobalFocusOwner вместо этого.
Поскольку поведение фокуса этого метода зависит от платформы, разработчикам настоятельно рекомендуется использовать requestFocusInWindow, когда это возможно.
Будут предприняты все усилия для обеспечения того, что события {FocusEvent}, сгенерированные в результате этого запроса, будут иметь указанное временное значение. Однако, поскольку указание произвольного временного состояния может быть нереализуемым на всех системах окон, корректное поведение этого метода гарантировано только для лёгких Component. Этот метод не предназначен для общего использования, но существует в качестве крючка для лёгких библиотек компонентов, таких как Swing.
Примечание: не все переходы фокуса происходят в результате вызова этого метода. Таким образом, компонент может получить фокус без вызова этого или любого другого requestFocus метода класса Component.
- Параметры:
-
temporary- true, если изменение фокуса временное, например, когда окно теряет фокус; для получения дополнительной информации о временных изменениях фокуса см. Спецификацию фокуса - Возвращает:
-
false, если запрос на изменение фокуса гарантированно провалится;true, если он, вероятно, выполнится - С:
- 1.4
- См. также:
-
FocusEvent,addFocusListener(java.awt.event.FocusListener),isFocusable(),isDisplayable(),KeyboardFocusManager.clearGlobalFocusOwner()
requestFocus
protected boolean requestFocus(boolean temporary,
FocusEvent.Cause cause) Запрос на получение фокуса ввода для этого Component, а также на то, чтобы родительский компонент высшего уровня этого Component стал фокусированным Window. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением окна верхнего уровня) должны быть видимыми, чтобы запрос был удовлетворён. Будут предприняты все усилия для выполнения запроса; однако в некоторых случаях это может оказаться невозможным. Разработчики никогда не должны полагаться на то, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED. Если запрос отклонен, потому что окно верхнего уровня этого компонента не может стать фокусированным окном, запрос будет сохранён и выполнен, когда окно позже получит фокус от пользователя.
Этот метод возвращает логическое значение. Если возвращается false, запрос гарантированно провалится. Если возвращается true, запрос будет выполнен, если он не будет отклонен или не произойдёт чрезвычайное событие, такое как удаление соседа компонента, до того, как запрос будет удовлетворён системой окон. Опять же, хотя возвращаемое значение true указывает, что запрос, вероятно, будет выполнен, разработчики никогда не должны полагаться на то, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED.
Эффект запроса фокуса также может зависеть от предоставленного значения причины. Если запрос успешен, сгенерированное событие {FocusEvent} получит значение причины, указанное в качестве аргумента метода.
Этот метод нельзя использовать для установки владельца фокуса в значение «ни один компонент». Используйте KeyboardFocusManager.clearGlobalFocusOwner вместо этого.
Поскольку поведение фокуса этого метода зависит от платформы, разработчикам настоятельно рекомендуется использовать requestFocusInWindow, когда это возможно.
Будут предприняты все усилия для обеспечения того, что события {FocusEvent}, сгенерированные в результате этого запроса, будут иметь указанное временное значение. Однако, поскольку указание произвольного временного состояния может быть нереализуемым на всех системах окон, корректное поведение этого метода гарантировано только для лёгких Component. Этот метод не предназначен для общего использования, но существует в качестве крючка для лёгких библиотек компонентов, таких как Swing.
Примечание: не все переходы фокуса происходят в результате вызова этого метода. Таким образом, компонент может получить фокус без вызова этого или любого другого requestFocus метода класса Component.
- Параметры:
-
temporary- true, если изменение фокуса временное, например, когда окно теряет фокус; для получения дополнительной информации о временных изменениях фокуса см. Спецификацию фокуса -
cause- причина запроса фокуса - Возвращает:
-
false, если запрос на изменение фокуса гарантированно провалится;true, если он, вероятно, выполнится - С:
- 9
- См. также:
-
FocusEvent,FocusEvent.Cause,addFocusListener(java.awt.event.FocusListener),isFocusable(),isDisplayable(),KeyboardFocusManager.clearGlobalFocusOwner()
requestFocusInWindow
public boolean requestFocusInWindow()
Запрос на получение фокуса ввода для этого компонента, если родительский компонент высшего уровня этого компонента уже является фокусированным окном. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением окна верхнего уровня) должны быть видимыми, чтобы запрос был удовлетворён. Будут предприняты все усилия для выполнения запроса; однако в некоторых случаях это может оказаться невозможным. Разработчики никогда не должны полагаться на то, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED.
Этот метод возвращает логическое значение. Если возвращается false, запрос гарантированно провалится. Если возвращается true, запрос будет выполнен, если он не будет отклонен или не произойдёт чрезвычайное событие, такое как удаление соседа компонента, до того, как запрос будет удовлетворён системой окон. Опять же, хотя возвращаемое значение true указывает, что запрос, вероятно, будет выполнен, разработчики никогда не должны полагаться на то, что этот компонент является владельцем фокуса, пока этот компонент не получит событие FOCUS_GAINED.
Этот метод нельзя использовать для установки владельца фокуса в значение «ни один компонент». Используйте KeyboardFocusManager.clearGlobalFocusOwner() вместо этого.
Поведение фокуса этого метода может быть реализовано единообразно на всех платформах, поэтому разработчикам настоятельно рекомендуется использовать этот метод вместо requestFocus, когда это возможно. Код, который полагается на requestFocus, может демонстрировать различное поведение фокуса на разных платформах.
Примечание: не все переходы фокуса происходят в результате вызова этого метода. Таким образом, компонент может получить фокус без вызова этого или любого другого requestFocus метода класса Component.
- Возвращает:
-
false, если запрос на изменение фокуса гарантированно не удастся;true, если он, вероятно, успешно выполнится - С момента:
- 1.4
- См. также:
-
requestFocus(),FocusEvent,addFocusListener(java.awt.event.FocusListener),isFocusable(),isDisplayable(),KeyboardFocusManager.clearGlobalFocusOwner()
requestFocusInWindow
public boolean requestFocusInWindow(FocusEvent.Cause cause)
Запрашивает, чтобы данное Компонент получил фокус ввода по причине cause, если верхнеуровневый предок данного Компонента уже является фокусированным окном. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением верхнеуровневого окна) должны быть видимыми для того, чтобы запрос был удовлетворён. Будет предпринято всё возможное для удовлетворения запроса; однако в некоторых случаях это может быть невозможно. Разработчики никогда не должны предполагать, что этот Компонент является владельцем фокуса до тех пор, пока этот Компонент не получит событие FOCUS_GAINED.
Этот метод возвращает булево значение. Если возвращается false, запрос гарантированно не удастся. Если возвращается true, запрос будет успешным, если он не будет заблокирован или не произойдёт какое-то исключительное событие, например, удаление объекта-вида Компонента, прежде чем запрос может быть удовлетворён родной системой окон. Опять же, хотя возвращаемое значение true указывает на то, что запрос, вероятно, будет успешным, разработчики никогда не должны предполагать, что этот Компонент является владельцем фокуса, пока он не получит событие FOCUS_GAINED.
Эффект запроса фокуса также может зависеть от значения переданного параметра причины. Если этот запрос будет выполнен успешно, событие FocusEvent, сгенерированное в результате, получит значение причины, указанное в качестве аргумента метода.
Этот метод нельзя использовать для установки владельца фокуса в значение "никакой компонент". Используйте KeyboardFocusManager.clearGlobalFocusOwner() вместо этого.
Поведение фокуса этого метода может быть реализовано единообразно на всех платформах, поэтому разработчикам настоятельно рекомендуется использовать этот метод вместо requestFocus(FocusEvent.Cause), когда это возможно. Код, который полагается на requestFocus(FocusEvent.Cause), может демонстрировать разное поведение фокуса на разных платформах.
Примечание: Не все переходы фокуса происходят в результате вызова этого метода. Таким образом, компонент может получить фокус, не вызвав этот или любой другой requestFocus метод класса Component.
- Параметры:
-
cause- причина запроса фокуса - Возвращает:
-
false, если запрос на изменение фокуса гарантированно не удастся;true, если он, вероятно, успешно выполнится - С момента:
- 9
- См. также:
-
requestFocus(FocusEvent.Cause),FocusEvent,FocusEvent.Cause,FocusEvent,addFocusListener(java.awt.event.FocusListener),isFocusable(),isDisplayable(),KeyboardFocusManager.clearGlobalFocusOwner()
requestFocusInWindow
protected boolean requestFocusInWindow(boolean temporary)
Запрашивает, чтобы данный Component получил фокус ввода, если верхнеуровневый предок данного Component уже является фокусированным Window. Этот компонент должен быть отображаемым, фокусируемым, видимым, и все его предки (за исключением верхнеуровневого окна) должны быть видимыми для того, чтобы запрос был удовлетворён. Будет предпринято всё возможное для удовлетворения запроса; однако в некоторых случаях это может быть невозможно. Разработчики никогда не должны предполагать, что этот компонент является владельцем фокуса до тех пор, пока он не получит событие FOCUS_GAINED.
Этот метод возвращает булево значение. Если возвращается false, запрос гарантированно не удастся. Если возвращается true, запрос будет успешным, если он не будет заблокирован или не произойдёт какое-то исключительное событие, например, удаление объекта-вида компонента, прежде чем запрос может быть удовлетворён родной системой окон. Опять же, хотя возвращаемое значение true указывает на то, что запрос, вероятно, будет успешным, разработчики никогда не должны предполагать, что этот компонент является владельцем фокуса, пока он не получит событие FOCUS_GAINED.
Этот метод нельзя использовать для установки владельца фокуса в значение "никакой компонент". Используйте KeyboardFocusManager.clearGlobalFocusOwner вместо этого.
Поведение фокуса этого метода может быть реализовано единообразно на всех платформах, поэтому разработчикам настоятельно рекомендуется использовать этот метод вместо requestFocus, когда это возможно. Код, который полагается на requestFocus, может демонстрировать разное поведение фокуса на разных платформах.
Будет предпринято всё возможное для того, чтобы события FocusEvent, сгенерированные в результате этого запроса, имели указанное временное значение. Однако, поскольку спецификация произвольного временного состояния может быть не реализуема на всех родных системах окон, корректное поведение этого метода гарантируется только для лёгких компонентов. Этот метод не предназначен для общего использования, а служит в качестве крючка для библиотек лёгких компонентов, таких как Swing.
Примечание: Не все переходы фокуса происходят в результате вызова этого метода. Таким образом, компонент может получить фокус, не вызвав этот или любой другой requestFocus метод класса Component.
- Параметры:
-
temporary- true, если изменение фокуса временное, например, когда окно теряет фокус; для получения дополнительной информации о временных изменениях фокуса см. Спецификацию фокуса - Возвращает:
-
false, если запрос на изменение фокуса гарантированно не удастся;true, если он, вероятно, успешно выполнится - С момента:
- 1.4
- См. также:
-
requestFocus(),FocusEvent,addFocusListener(java.awt.event.FocusListener),isFocusable(),isDisplayable(),KeyboardFocusManager.clearGlobalFocusOwner()
getFocusCycleRootAncestor
public Container getFocusCycleRootAncestor()
Возвращает Контейнер, который является корнем цикла прохождения фокуса для данного Компонента. Каждый цикл прохождения фокуса имеет только один корень цикла прохождения фокуса, и каждый Компонент, который не является Контейнером, принадлежит только одному циклу прохождения фокуса. Контейнеры, которые являются корнями циклов прохождения фокуса, принадлежат двум циклам: одному, укоренённому в самом Контейнере, и одному, укоренённому в ближайшем предке Контейнера, являющемся корнем цикла прохождения фокуса. Для таких Контейнеров этот метод вернёт ближайшего предка Контейнера, являющегося корнем цикла прохождения фокуса.
- Возвращает:
- ближайший предок данного Компонента, являющийся корнем цикла прохождения фокуса
- С момента:
- 1.4
- См. также:
Container.isFocusCycleRoot()
isFocusCycleRoot
public boolean isFocusCycleRoot(Container container)
Возвращает, является ли указанный Контейнер корнем цикла прохождения фокуса для данного Компонента. Каждый цикл прохождения фокуса имеет только один корень цикла прохождения фокуса, и каждый Компонент, который не является Контейнером, принадлежит только одному циклу прохождения фокуса.
- Параметры:
-
container- Контейнер, подлежащий проверке - Возвращает:
-
true, если указанный Контейнер является корнем цикла прохождения фокуса для данного Компонента;falseв противном случае - С момента:
- 1.4
- См. также:
Container.isFocusCycleRoot()
transferFocus
public void transferFocus()
Передаёт фокус следующему компоненту, как если бы данный Компонент был владельцем фокуса.
- С момента:
- 1.1
- См. также:
requestFocus()
nextFocus
@Deprecated public void nextFocus()
transferFocusBackward
public void transferFocusBackward()
Передаёт фокус предыдущему компоненту, как если бы данный Компонент был владельцем фокуса.
- С момента:
- 1.4
- См. также:
requestFocus()
transferFocusUpCycle
public void transferFocusUpCycle()
Передаёт фокус на один уровень выше по циклу прохождения фокуса. Как правило, владелец фокуса устанавливается в корень цикла прохождения фокуса данного Компонента, а текущий корень цикла прохождения фокуса устанавливается в корень цикла прохождения фокуса нового владельца фокуса. Однако, если корень цикла прохождения фокуса данного Компонента является окном, то владелец фокуса устанавливается в компонент по умолчанию для корня цикла прохождения фокуса, а текущий корень цикла прохождения фокуса остаётся неизменным.
- С момента:
- 1.4
- См. также:
-
requestFocus(),Container.isFocusCycleRoot(),Container.setFocusCycleRoot(boolean)
hasFocus
public boolean hasFocus()
Возвращает true, если этот Component является владельцем фокуса. Этот метод устарел и заменён на isFocusOwner().
- Возвращает:
-
true, если этотComponentявляется владельцем фокуса;falseв противном случае - С момента:
- 1.2
isFocusOwner
public boolean isFocusOwner()
Возвращает true, если этот Component является владельцем фокуса.
- Возвращает:
-
true, если этотComponentявляется владельцем фокуса;falseв противном случае - С момента:
- 1.4
add
public void add(PopupMenu popup)
Добавляет указанное всплывающее меню к компоненту.
- Параметры:
-
popup- всплывающее меню, которое нужно добавить к компоненту. - Исключения:
-
NullPointerException- еслиpopupявляетсяnull - С момента:
- 1.1
- См. также:
remove(MenuComponent)
remove
public void remove(MenuComponent popup)
Удаляет указанное всплывающее меню из компонента.
- Указано в:
-
removeв интерфейсеMenuContainer - Параметры:
-
popup- всплывающее меню, которое нужно удалить - С версии:
- 1.1
- См. также:
add(PopupMenu)
paramString
protected String paramString()
Возвращает строку, представляющую состояние этого компонента. Этот метод предназначен только для целей отладки, и содержание и формат возвращаемой строки могут варьироваться в зависимости от реализации. Возвращаемая строка может быть пустой, но не может быть null.
- Возвращает:
- строковое представление состояния этого компонента
- С версии:
- 1.0
toString
public String toString()
Возвращает строковое представление этого компонента и его значений.
- Переопределяет:
-
toStringв классеObject - Возвращает:
- строковое представление этого компонента
- С версии:
- 1.0
list
public void list()
Выводит список этого компонента в стандартный поток вывода системы System.out.
- С версии:
- 1.0
- См. также:
System.out
list
public void list(PrintStream out)
Выводит список этого компонента в указанный выходной поток.
- Параметры:
-
out- поток вывода - Исключения:
-
NullPointerException- еслиoutявляетсяnull - С версии:
- 1.0
list
public void list(PrintStream out,
int indent) Выводит список, начиная с указанного отступа, в указанный поток вывода.
- Параметры:
-
out- поток вывода -
indent- количество пробелов для отступа - Исключения:
-
NullPointerException- еслиoutявляетсяnull - С версии:
- 1.0
- См. также:
PrintStream.println(java.lang.Object)
list
public void list(PrintWriter out)
Выводит список в указанный объект print writer.
- Параметры:
-
out- объект print writer для вывода - Исключения:
-
NullPointerException- еслиoutявляетсяnull - С версии:
- 1.1
list
public void list(PrintWriter out,
int indent) Выводит список, начиная с указанного отступа, в указанный объект print writer.
- Параметры:
-
out- объект print writer для вывода -
indent- количество пробелов для отступа - Исключения:
-
NullPointerException- еслиoutявляетсяnull - С версии:
- 1.1
- См. также:
PrintStream.println(java.lang.Object)
addPropertyChangeListener
public void addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener в список прослушивателей. Прослушиватель регистрируется для всех связанных свойств этого класса, включая следующие:
- шрифт этого компонента ("font")
- цвет фона этого компонента ("background")
- цвет переднего плана этого компонента ("foreground")
- возможность получения фокуса этим компонентом ("focusable")
- состояние включения клавиш перехода фокуса этого компонента ("focusTraversalKeysEnabled")
- набор клавиш прямого перехода фокуса этого компонента ("forwardFocusTraversalKeys")
- набор клавиш обратного перехода фокуса этого компонента ("backwardFocusTraversalKeys")
- набор клавиш циклического перехода фокуса вверх этого компонента ("upCycleFocusTraversalKeys")
- предпочтительный размер этого компонента ("preferredSize")
- минимальный размер этого компонента ("minimumSize")
- максимальный размер этого компонента ("maximumSize")
- имя этого компонента ("name")
Component наследует связанное свойство, то событие не будет вызвано в ответ на изменение унаследованного свойства.
Если listener является null, исключение не вызывается и никаких действий не выполняется.
- Параметры:
-
listener- прослушиватель изменений свойств, который нужно добавить - См. также:
-
removePropertyChangeListener(java.beans.PropertyChangeListener),getPropertyChangeListeners(),addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)
removePropertyChangeListener
public void removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка прослушивателей. Этот метод должен использоваться для удаления PropertyChangeListeners, которые были зарегистрированы для всех связанных свойств этого класса.
Если listener имеет значение null, исключение не вызывается и никаких действий не выполняется.
- Параметры:
-
listener- прослушиватель изменений свойств, который нужно удалить - См. также:
-
addPropertyChangeListener(java.beans.PropertyChangeListener),getPropertyChangeListeners(),removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
getPropertyChangeListeners
public PropertyChangeListener[] getPropertyChangeListeners()
Возвращает массив всех прослушивателей изменений свойств, зарегистрированных в этом компоненте.
- Возвращает:
- все
PropertyChangeListenerэтого компонента или пустой массив, если прослушиватели изменений свойств в настоящее время не зарегистрированы - С версии:
- 1.4
- См. также:
-
addPropertyChangeListener(java.beans.PropertyChangeListener),removePropertyChangeListener(java.beans.PropertyChangeListener),getPropertyChangeListeners(java.lang.String),PropertyChangeSupport.getPropertyChangeListeners()
addPropertyChangeListener
public void addPropertyChangeListener(String propertyName,
PropertyChangeListener listener) Добавляет PropertyChangeListener в список прослушивателей для определенного свойства. Указанное свойство может быть определено пользователем или одним из следующих:
- шрифт этого компонента ("font")
- цвет фона этого компонента ("background")
- цвет переднего плана этого компонента ("foreground")
- возможность получения фокуса этим компонентом ("focusable")
- состояние включения клавиш перехода фокуса этого компонента ("focusTraversalKeysEnabled")
- набор клавиш прямого перехода фокуса этого компонента ("forwardFocusTraversalKeys")
- набор клавиш обратного перехода фокуса этого компонента ("backwardFocusTraversalKeys")
- набор клавиш циклического перехода фокуса вверх этого компонента ("upCycleFocusTraversalKeys")
Component наследует связанное свойство, то событие не будет вызвано в ответ на изменение унаследованного свойства.
Если propertyName или listener является null, исключение не вызывается и никаких действий не предпринимается.
- Параметры:
-
propertyName- одно из имен свойств, перечисленных выше -
listener- прослушиватель изменений свойств, который нужно добавить - См. также:
-
removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener),getPropertyChangeListeners(java.lang.String),addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)
removePropertyChangeListener
public void removePropertyChangeListener(String propertyName,
PropertyChangeListener listener) Удаляет PropertyChangeListener из списка прослушивателей для определенного свойства. Этот метод должен использоваться для удаления PropertyChangeListener, которые были зарегистрированы для определенного связанного свойства.
Если propertyName или listener является null, исключение не вызывается и никаких действий не предпринимается.
- Параметры:
-
propertyName- допустимое имя свойства -
listener- прослушиватель изменений свойств, который нужно удалить - См. также:
-
addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener),getPropertyChangeListeners(java.lang.String),removePropertyChangeListener(java.beans.PropertyChangeListener)
getPropertyChangeListeners
public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Возвращает массив всех прослушивателей, которые были связаны с указанным свойством.
- Параметры:
-
propertyName- имя свойства - Возвращает:
- все
PropertyChangeListener, связанные с указанным именем свойства; если такие прослушиватели не были добавлены или еслиpropertyNameявляетсяnull, возвращается пустой массив - С версии:
- 1.4
- См. также:
-
addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener),removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener),getPropertyChangeListeners()
firePropertyChange
protected void firePropertyChange(String propertyName,
Object oldValue,
Object newValue) Поддержка уведомления об изменениях связанных свойств для свойств типа Object. Этот метод может вызываться при изменении связанного свойства, и он отправит соответствующее событие PropertyChangeEvent всем зарегистрированным прослушивателям PropertyChangeListeners.
- Параметры:
-
propertyName- свойство, значение которого изменилось -
oldValue- предыдущее значение свойства -
newValue- новое значение свойства
firePropertyChange
protected void firePropertyChange(String propertyName,
boolean oldValue,
boolean newValue) Поддержка уведомления об изменениях связанных свойств для булевых свойств. Этот метод может вызываться при изменении связанного свойства, и он отправит соответствующее событие PropertyChangeEvent всем зарегистрированным прослушивателям PropertyChangeListeners.
- Параметры:
-
propertyName- свойство, значение которого изменилось -
oldValue- предыдущее значение свойства -
newValue- новое значение свойства - С версии:
- 1.4
firePropertyChange
protected void firePropertyChange(String propertyName,
int oldValue,
int newValue) Поддержка отчёта об изменениях связанных свойств для целочисленных свойств. Этот метод может быть вызван, когда связанное свойство изменилось, и он отправит соответствующее событие PropertyChangeEvent всем зарегистрированным слушателям PropertyChangeListeners.
- Параметры:
-
propertyName- свойство, значение которого изменилось -
oldValue- предыдущее значение свойства -
newValue- новое значение свойства - С тех пор:
- 1.4
firePropertyChange
public void firePropertyChange(String propertyName,
byte oldValue,
byte newValue) Сообщает об изменении связанного свойства.
- Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (в виде байта) -
newValue- новое значение свойства (в виде байта) - С тех пор:
- 1.5
- См. также:
firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
firePropertyChange
public void firePropertyChange(String propertyName,
char oldValue,
char newValue) Сообщает об изменении связанного свойства.
- Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (в виде символа) -
newValue- новое значение свойства (в виде символа) - С тех пор:
- 1.5
- См. также:
firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
firePropertyChange
public void firePropertyChange(String propertyName,
short oldValue,
short newValue) Сообщает об изменении связанного свойства.
- Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (в виде короткого целого) -
newValue- новое значение свойства (в виде короткого целого) - С тех пор:
- 1.5
- См. также:
firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
firePropertyChange
public void firePropertyChange(String propertyName,
long oldValue,
long newValue) Сообщает об изменении связанного свойства.
- Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (в виде длинного целого) -
newValue- новое значение свойства (в виде длинного целого) - С тех пор:
- 1.5
- См. также:
firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
firePropertyChange
public void firePropertyChange(String propertyName,
float oldValue,
float newValue) Сообщает об изменении связанного свойства.
- Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (в виде числа с плавающей точкой) -
newValue- новое значение свойства (в виде числа с плавающей точкой) - С тех пор:
- 1.5
- См. также:
firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
firePropertyChange
public void firePropertyChange(String propertyName,
double oldValue,
double newValue) Сообщает об изменении связанного свойства.
- Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (в виде двойной точности) -
newValue- новое значение свойства (в виде двойной точности) - С тех пор:
- 1.5
- См. также:
firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
setComponentOrientation
public void setComponentOrientation(ComponentOrientation o)
Устанавливает чувствительное к языку направление, которое должно использоваться для упорядочивания элементов или текста внутри этого компонента. Чувствительные к языку LayoutManager и Component подклассы будут использовать это свойство, чтобы определить, как организовывать и отрисовывать компоненты.
Во время создания ориентация компонента устанавливается в ComponentOrientation.UNKNOWN, указывая, что она не была явно задана. Направление UNKNOWN ведет себя так же, как ComponentOrientation.LEFT_TO_RIGHT.
Для установки ориентации отдельного компонента используйте этот метод. Для установки ориентации всей иерархии компонентов используйте applyComponentOrientation.
Этот метод изменяет информацию, связанную с макетом, поэтому делает недействительной иерархию компонентов.
- Параметры:
-
o- задаваемое направление - См. также:
-
ComponentOrientation,invalidate()
getComponentOrientation
public ComponentOrientation getComponentOrientation()
Возвращает чувствительное к языку направление, которое должно использоваться для упорядочивания элементов или текста внутри этого компонента. LayoutManager и Component подклассы, которые хотят учитывать направление, должны вызвать этот метод для получения направления компонента перед выполнением макета или отрисовки.
- Возвращает:
- направление для упорядочения элементов или текста
- См. также:
ComponentOrientation
applyComponentOrientation
public void applyComponentOrientation(ComponentOrientation orientation)
Устанавливает свойство ComponentOrientation этого компонента и всех компонентов, содержащихся в нём.
Этот метод изменяет информацию, связанную с макетом, и поэтому делает недействительной иерархию компонентов.
- Параметры:
-
orientation- новое направление компонента для этого компонента и содержащихся в нём компонентов. - Исключения:
-
NullPointerException- еслиorientationравно null. - С тех пор:
- 1.4
- См. также:
-
setComponentOrientation(java.awt.ComponentOrientation),getComponentOrientation(),invalidate()
getAccessibleContext
public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим Component. Метод, реализованный в этом базовом классе, возвращает null. Классы, расширяющие Component, должны переопределить этот метод для возврата AccessibleContext, связанного с подклассом.
- Возвращает:
AccessibleContextэтогоComponent- С тех пор:
- 1.3
setMixingCutoutShape
public void setMixingCutoutShape(Shape shape)
Устанавливает форму 'вырезки смешивания' для этого лёгкого компонента. Этот метод используется исключительно для целей функции смешивания тяжёлых/лёгких компонентов и не окажет никакого влияния, если применён к тяжёлому компоненту. По умолчанию лёгкий компонент обрабатывается как непрозрачный прямоугольник для целей функции смешивания тяжёлых/лёгких компонентов. Этот метод позволяет разработчикам устанавливать произвольную форму, которая будет вырезана из тяжёлых компонентов, расположенных под лёгким компонентом в порядке z.
Аргумент shape может принимать следующие значения:
-
null- возвращает форму вырезки по умолчанию (прямоугольник, равныйgetBounds()компонента) -
пустая-форма - ничего не вырезает из тяжёлых компонентов. Это делает этот лёгкий компонент фактически прозрачным. Обратите внимание, что потомки лёгкого компонента всё ещё влияют на формы тяжёлых компонентов. Примером пустой-формы является
new Rectangle(). - непустая-форма - заданная форма будет вырезана из тяжёлых компонентов.
Наиболее распространённый пример, когда нужна форма 'вырезки смешивания', - компонент стеклянной панели. Метод JRootPane.setGlassPane(java.awt.Component) автоматически устанавливает пустую-форму как форму 'вырезки смешивания' для данного компонента стеклянной панели. Если разработчику нужен какой-либо другой вид формы 'вырезки смешивания' для стеклянной панели (что случается редко), это необходимо изменить вручную после установки стеклянной панели в основной панели.
- Параметры:
-
shape- новая форма 'вырезки смешивания' - С тех пор:
- 9
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/Component.html