Класс Canvas

java.lang.Object

java.awt.Component

java.awt.Canvas

Все реализуемые интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible

public class Canvas extends Component implements Accessible

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

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

С версии:

1.0

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`Canvas.AccessibleAWTCanvas`	Этот класс реализует поддержку специальных возможностей для класса `Canvas`.

Вложенные классы/интерфейсы, объявленные в классе Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

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

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

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

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

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

Конструктор	Описание
`Canvas()`	Создаёт новый Canvas.
`Canvas(GraphicsConfiguration config)`	Создаёт новый Canvas с заданным объектом GraphicsConfiguration.

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

Модификатор и тип	Метод	Описание
`void`	`addNotify()`	Создаёт peer-объект холста.
`void`	`createBufferStrategy(int numBuffers)`	Создаёт новую стратегию многобуферизации для этого компонента.
`void`	`createBufferStrategy(int numBuffers, BufferCapabilities caps)`	Создаёт новую стратегию многобуферизации для этого компонента с необходимыми возможностями буферов.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим Canvas.
`BufferStrategy`	`getBufferStrategy()`	Возвращает `BufferStrategy`, используемый этим компонентом.
`void`	`paint(Graphics g)`	Рисует этот холст.
`void`	`update(Graphics g)`	Обновляет этот холст.

Методы, объявленные в классе Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate

Модификатор и тип	Метод	Описание
`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`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей для указанного свойства.
`void`	`applyComponentOrientation(ComponentOrientation orientation)`	Устанавливает свойство `ComponentOrientation` этого компонента и всех содержащихся в нем компонентов.
`boolean`	`areFocusTraversalKeysSet(int id)`	Возвращает, был ли набор клавиш перехода фокуса для указанной операции перехода явно задан для этого компонента.
`Rectangle`	`bounds()`	Устарело. Начиная с JDK версии 1.1 заменено на `getBounds()`.
`int`	`checkImage(Image image, int width, int height, ImageObserver observer)`	Возвращает состояние создания экранного представления указанного изображения.
`int`	`checkImage(Image image, ImageObserver observer)`	Возвращает состояние создания экранного представления указанного изображения.
`protected AWTEvent`	`coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)`	При возможности объединяет публикуемое событие с существующим событием.
`boolean`	`contains(int x, int y)`	Проверяет, «содержит» ли этот компонент указанную точку, координаты которой `x` и `y` заданы относительно системы координат этого компонента.
`boolean`	`contains(Point p)`	Проверяет, «содержит» ли этот компонент указанную точку, координаты x и y которой заданы относительно системы координат этого компонента.
`Image`	`createImage(int width, int height)`	Создает рисуемое изображение вне экрана для двойной буферизации.
`Image`	`createImage(ImageProducer producer)`	Создает изображение из указанного источника изображений.
`VolatileImage`	`createVolatileImage(int width, int height)`	Создает изменяемое рисуемое изображение вне экрана для двойной буферизации.
`VolatileImage`	`createVolatileImage(int width, int height, ImageCapabilities caps)`	Создает изменяемое рисуемое изображение вне экрана с указанными возможностями.
`void`	`deliverEvent(Event e)`	Устарело. Начиная с JDK версии 1.1 заменено на `dispatchEvent(AWTEvent e)`.
`void`	`disable()`	Устарело. Начиная с JDK версии 1.1 заменено на `setEnabled(boolean)`.
`protected final void`	`disableEvents(long eventsToDisable)`	Запрещает доставку этому компоненту событий, заданных параметром маски событий.
`final void`	`dispatchEvent(AWTEvent e)`	Передает событие этому компоненту или одному из его подкомпонентов.
`void`	`doLayout()`	Предлагает менеджеру компоновки выполнить компоновку этого компонента.
`void`	`enable()`	Устарело. Начиная с JDK версии 1.1 заменено на `setEnabled(boolean)`.
`void`	`enable(boolean b)`	Устарело. Начиная с JDK версии 1.1 заменено на `setEnabled(boolean)`.
`protected final void`	`enableEvents(long eventsToEnable)`	Разрешает доставку этому компоненту событий, заданных параметром маски событий.
`void`	`enableInputMethods(boolean enable)`	Включает или отключает поддержку методов ввода для этого компонента.
`protected void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)`	Поддержка оповещения об изменениях привязанных свойств логического типа.
`void`	`firePropertyChange(String propertyName, byte oldValue, byte newValue)`	Оповещает об изменении привязанного свойства.
`void`	`firePropertyChange(String propertyName, char oldValue, char newValue)`	Оповещает об изменении привязанного свойства.
`void`	`firePropertyChange(String propertyName, double oldValue, double newValue)`	Оповещает об изменении привязанного свойства.
`void`	`firePropertyChange(String propertyName, float oldValue, float newValue)`	Оповещает об изменении привязанного свойства.
`protected void`	`firePropertyChange(String propertyName, int oldValue, int newValue)`	Поддержка оповещения об изменениях привязанных свойств целочисленного типа.
`void`	`firePropertyChange(String propertyName, long oldValue, long newValue)`	Оповещает об изменении привязанного свойства.
`void`	`firePropertyChange(String propertyName, short oldValue, short newValue)`	Оповещает об изменении привязанного свойства.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддержка оповещения об изменениях привязанных свойств типа Object.
`float`	`getAlignmentX()`	Возвращает выравнивание по оси x.
`float`	`getAlignmentY()`	Возвращает выравнивание по оси y.
`Color`	`getBackground()`	Возвращает цвет фона этого компонента.
`int`	`getBaseline(int width, int height)`	Возвращает базовую линию.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior()`	Возвращает перечисление, указывающее, как изменяется базовая линия компонента при изменении его размера.
`Rectangle`	`getBounds()`	Возвращает границы этого компонента в виде объекта `Rectangle`.
`Rectangle`	`getBounds(Rectangle rv)`	Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
`ColorModel`	`getColorModel()`	Возвращает экземпляр `ColorModel`, используемый для отображения компонента на устройстве вывода.
`Component`	`getComponentAt(int x, int y)`	Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов точку с координатами (x, y), и, если содержит, возвращает содержащий ее компонент.
`Component`	`getComponentAt(Point p)`	Возвращает компонент или подкомпонент, содержащий указанную точку.
`ComponentListener[]`	`getComponentListeners()`	Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
`ComponentOrientation`	`getComponentOrientation()`	Получает зависящую от языка ориентацию, используемую для упорядочения элементов или текста в этом компоненте.
`Cursor`	`getCursor()`	Возвращает курсор, установленный для компонента.
`DropTarget`	`getDropTarget()`	Возвращает `DropTarget`, связанный с `Component`.
`Container`	`getFocusCycleRootAncestor()`	Возвращает контейнер, являющийся корнем цикла обхода фокуса для этого компонента.
`FocusListener[]`	`getFocusListeners()`	Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
`Set<AWTKeyStroke>`	`getFocusTraversalKeys(int id)`	Возвращает набор клавиш перехода фокуса для указанной операции обхода фокуса этого компонента.
`boolean`	`getFocusTraversalKeysEnabled()`	Возвращает, включены ли клавиши перехода фокуса для этого компонента.
`Font`	`getFont()`	Возвращает шрифт этого компонента.
`FontMetrics`	`getFontMetrics(Font font)`	Возвращает метрики указанного шрифта.
`Color`	`getForeground()`	Возвращает цвет переднего плана этого компонента.
`Graphics`	`getGraphics()`	Создает графический контекст для этого компонента.
`GraphicsConfiguration`	`getGraphicsConfiguration()`	Возвращает `GraphicsConfiguration`, связанный с `Component`.
`int`	`getHeight()`	Возвращает текущую высоту этого компонента.
`HierarchyBoundsListener[]`	`getHierarchyBoundsListeners()`	Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
`HierarchyListener[]`	`getHierarchyListeners()`	Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
`boolean`	`getIgnoreRepaint()`	Возвращает, следует ли игнорировать сообщения о перерисовке, полученные от операционной системы.
`InputContext`	`getInputContext()`	Возвращает контекст ввода, используемый этим компонентом для обработки взаимодействия с методами ввода при вводе текста в компонент.
`InputMethodListener[]`	`getInputMethodListeners()`	Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
`InputMethodRequests`	`getInputMethodRequests()`	Возвращает обработчик запросов методов ввода, поддерживающий запросы методов ввода для этого компонента.
`KeyListener[]`	`getKeyListeners()`	Возвращает массив всех слушателей клавиатуры, зарегистрированных для этого компонента.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, зарегистрированных в данный момент как `FooListener`s для этого `Component`.
`Locale`	`getLocale()`	Возвращает локаль этого компонента.

`Point`	`getLocation()`	Возвращает местоположение этого компонента в виде точки, задающей его верхний левый угол.
`Point`	`getLocation(Point rv)`	Сохраняет координаты начала координат x и y этого компонента в «возвращаемое значение» rv и возвращает rv.
`Point`	`getLocationOnScreen()`	Возвращает местоположение этого компонента в виде точки, задающей его верхний левый угол в системе координат экрана.
`Dimension`	`getMaximumSize()`	Возвращает максимальный размер этого компонента.
`Dimension`	`getMinimumSize()`	Возвращает минимальный размер этого компонента.
`MouseListener[]`	`getMouseListeners()`	Возвращает массив всех прослушивателей событий мыши, зарегистрированных для этого компонента.
`MouseMotionListener[]`	`getMouseMotionListeners()`	Возвращает массив всех прослушивателей перемещения мыши, зарегистрированных для этого компонента.
`Point`	`getMousePosition()`	Возвращает положение указателя мыши в системе координат этого `Component`, если `Component` находится непосредственно под указателем мыши; в противном случае возвращает `null`.
`MouseWheelListener[]`	`getMouseWheelListeners()`	Возвращает массив всех прослушивателей колеса мыши, зарегистрированных для этого компонента.
`String`	`getName()`	Возвращает имя компонента.
`Container`	`getParent()`	Возвращает родительский элемент этого компонента.
`Dimension`	`getPreferredSize()`	Возвращает предпочтительный размер этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех прослушивателей изменений свойств, зарегистрированных для этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)`	Возвращает массив всех прослушивателей, связанных с указанным свойством.
`Dimension`	`getSize()`	Возвращает размер этого компонента в виде объекта `Dimension`.
`Dimension`	`getSize(Dimension rv)`	Сохраняет ширину и высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
`Toolkit`	`getToolkit()`	Возвращает инструментарий этого компонента.
`final Object`	`getTreeLock()`	Возвращает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потоков) для операций с деревом компонентов AWT и компоновкой.
`int`	`getWidth()`	Возвращает текущую ширину этого компонента.
`int`	`getX()`	Возвращает текущую координату x начала координат компонента.
`int`	`getY()`	Возвращает текущую координату y начала координат компонента.
`boolean`	`gotFocus(Event evt, Object what)`	Устарело. Начиная с JDK версии 1.1 заменено на processFocusEvent(FocusEvent).
`boolean`	`handleEvent(Event evt)`	Устарело. Начиная с JDK версии 1.1 заменено на processEvent(AWTEvent).
`boolean`	`hasFocus()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`void`	`hide()`	Устарело. Начиная с JDK версии 1.1 заменено на `setVisible(boolean)`.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int w, int h)`	Перерисовывает компонент при изменении изображения.
`boolean`	`inside(int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на contains(int, int).
`void`	`invalidate()`	Признаёт этот компонент и его предков недействительными.
`boolean`	`isBackgroundSet()`	Возвращает значение, указывающее, был ли цвет фона явно задан для этого компонента.
`boolean`	`isCursorSet()`	Возвращает значение, указывающее, был ли курсор явно задан для этого компонента.
`boolean`	`isDisplayable()`	Определяет, доступен ли этот компонент для отображения.
`boolean`	`isDoubleBuffered()`	Возвращает true, если этот компонент рисуется во внеэкранное изображение («буфер»), которое позже копируется на экран.
`boolean`	`isEnabled()`	Определяет, включён ли этот компонент.
`boolean`	`isFocusable()`	Возвращает значение, указывающее, может ли этот компонент получать фокус.
`boolean`	`isFocusCycleRoot(Container container)`	Возвращает значение, указывающее, является ли указанный контейнер корнем цикла перемещения фокуса для этого компонента.
`boolean`	`isFocusOwner()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`boolean`	`isFocusTraversable()`	Устарело. Начиная с версии 1.4 заменено на `isFocusable()`.
`boolean`	`isFontSet()`	Возвращает значение, указывающее, был ли шрифт явно задан для этого компонента.
`boolean`	`isForegroundSet()`	Возвращает значение, указывающее, был ли цвет переднего плана явно задан для этого компонента.
`boolean`	`isLightweight()`	Лёгкий компонент не имеет собственного системного партнёра инструментария.
`boolean`	`isMaximumSizeSet()`	Возвращает true, если максимальный размер задан значением, отличным от `null`; в противном случае возвращает false.
`boolean`	`isMinimumSizeSet()`	Возвращает значение, указывающее, вызывался ли `setMinimumSize` с ненулевым значением.
`boolean`	`isOpaque()`	Возвращает true, если этот компонент полностью непрозрачен; по умолчанию возвращает false.
`boolean`	`isPreferredSizeSet()`	Возвращает true, если предпочтительный размер задан значением, отличным от `null`; в противном случае возвращает false.
`boolean`	`isShowing()`	Определяет, отображается ли этот компонент на экране.
`boolean`	`isValid()`	Определяет, является ли этот компонент действительным.
`boolean`	`isVisible()`	Определяет, должен ли этот компонент быть видимым, когда видим его родительский элемент.
`boolean`	`keyDown(Event evt, int key)`	Устарело. Начиная с JDK версии 1.1 заменено на processKeyEvent(KeyEvent).
`boolean`	`keyUp(Event evt, int key)`	Устарело. Начиная с JDK версии 1.1 заменено на processKeyEvent(KeyEvent).
`void`	`layout()`	Устарело. Начиная с JDK версии 1.1 заменено на `doLayout()`.
`void`	`list()`	Выводит описание этого компонента в стандартный поток вывода системы `System.out`.
`void`	`list(PrintStream out)`	Выводит описание этого компонента в указанный поток вывода.
`void`	`list(PrintStream out, int indent)`	Выводит список с указанным отступом в указанный поток печати.
`void`	`list(PrintWriter out)`	Выводит описание в указанный объект записи печати.
`void`	`list(PrintWriter out, int indent)`	Выводит список с указанным отступом в указанный объект записи печати.
`Component`	`locate(int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на getComponentAt(int, int).
`Point`	`location()`	Устарело. Начиная с JDK версии 1.1 заменено на `getLocation()`.
`boolean`	`lostFocus(Event evt, Object what)`	Устарело. Начиная с JDK версии 1.1 заменено на processFocusEvent(FocusEvent).
`Dimension`	`minimumSize()`	Устарело. Начиная с JDK версии 1.1 заменено на `getMinimumSize()`.
`boolean`	`mouseDown(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseDrag(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseEnter(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseExit(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseMove(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseUp(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
`void`	`move(int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на `setLocation(int, int)`.
`void`	`nextFocus()`	Устарело. Начиная с JDK версии 1.1 заменено на transferFocus().
`void`	`paintAll(Graphics g)`	Рисует этот компонент и все его дочерние компоненты.
`protected String`	`paramString()`	Возвращает строку, представляющую состояние этого компонента.
`boolean`	`postEvent(Event e)`	Устарело. Начиная с JDK версии 1.1 заменено на dispatchEvent(AWTEvent).
`Dimension`	`preferredSize()`	Устарело. Начиная с JDK версии 1.1 заменено на `getPreferredSize()`.
`boolean`	`prepareImage(Image image, int width, int height, ImageObserver observer)`	Подготавливает изображение для отображения в этом компоненте с указанными шириной и высотой.

`boolean`	`prepareImage(Image image, ImageObserver observer)`	Подготавливает изображение для отображения в этом компоненте.
`void`	`print(Graphics g)`	Печатает этот компонент.
`void`	`printAll(Graphics g)`	Печатает этот компонент и все его подкомпоненты.
`protected void`	`processComponentEvent(ComponentEvent e)`	Обрабатывает события компонента, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам `ComponentListener`.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события, возникающие в этом компоненте.
`protected void`	`processFocusEvent(FocusEvent e)`	Обрабатывает события фокуса, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам `FocusListener`.
`protected void`	`processHierarchyBoundsEvent(HierarchyEvent e)`	Обрабатывает события изменения границ иерархии, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам `HierarchyBoundsListener`.
`protected void`	`processHierarchyEvent(HierarchyEvent e)`	Обрабатывает события иерархии, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам `HierarchyListener`.
`protected void`	`processInputMethodEvent(InputMethodEvent e)`	Обрабатывает события метода ввода, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам `InputMethodListener`.
`protected void`	`processKeyEvent(KeyEvent e)`	Обрабатывает события клавиатуры, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам `KeyListener`.
`protected void`	`processMouseEvent(MouseEvent e)`	Обрабатывает события мыши, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам `MouseListener`.
`protected void`	`processMouseMotionEvent(MouseEvent e)`	Обрабатывает события перемещения мыши, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам `MouseMotionListener`.
`protected void`	`processMouseWheelEvent(MouseWheelEvent e)`	Обрабатывает события прокрутки колеса мыши, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам `MouseWheelListener`.
`void`	`remove(MenuComponent popup)`	Удаляет указанное всплывающее меню из компонента.
`void`	`removeComponentListener(ComponentListener l)`	Удаляет указанный прослушиватель компонента, чтобы он больше не получал события компонента от этого компонента.
`void`	`removeFocusListener(FocusListener l)`	Удаляет указанный прослушиватель фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`removeHierarchyBoundsListener(HierarchyBoundsListener l)`	Удаляет указанный прослушиватель границ иерархии, чтобы он больше не получал события изменения границ иерархии от этого компонента.
`void`	`removeHierarchyListener(HierarchyListener l)`	Удаляет указанный прослушиватель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
`void`	`removeInputMethodListener(InputMethodListener l)`	Удаляет указанный прослушиватель метода ввода, чтобы он больше не получал события метода ввода от этого компонента.
`void`	`removeKeyListener(KeyListener l)`	Удаляет указанный прослушиватель клавиатуры, чтобы он больше не получал события клавиатуры от этого компонента.
`void`	`removeMouseListener(MouseListener l)`	Удаляет указанный прослушиватель мыши, чтобы он больше не получал события мыши от этого компонента.
`void`	`removeMouseMotionListener(MouseMotionListener l)`	Удаляет указанный прослушиватель перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента.
`void`	`removeMouseWheelListener(MouseWheelListener l)`	Удаляет указанный прослушиватель колеса мыши, чтобы он больше не получал события колеса мыши от этого компонента.
`void`	`removeNotify()`	Делает этот `Component` недоступным для отображения, уничтожая его собственный экранный ресурс.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка прослушивателей.
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Удаляет `PropertyChangeListener` из списка прослушивателей для определённого свойства.
`void`	`repaint()`	Перерисовывает этот компонент.
`void`	`repaint(int x, int y, int width, int height)`	Перерисовывает указанный прямоугольник этого компонента.
`void`	`repaint(long tm)`	Перерисовывает компонент.
`void`	`repaint(long tm, int x, int y, int width, int height)`	Перерисовывает указанный прямоугольник этого компонента в течение `tm` миллисекунд.
`void`	`requestFocus()`	Запрашивает передачу фокуса ввода этому компоненту и фокуса окну — его предку верхнего уровня.
`protected boolean`	`requestFocus(boolean temporary)`	Запрашивает передачу фокуса ввода этому `Component` и фокуса `Window` — его предку верхнего уровня (`Component`).
`protected boolean`	`requestFocus(boolean temporary, FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому `Component` и фокуса `Window` — его предку верхнего уровня (`Component`).
`void`	`requestFocus(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому компоненту и фокуса окну — его предку верхнего уровня.
`boolean`	`requestFocusInWindow()`	Запрашивает передачу фокуса ввода этому компоненту, если его предок верхнего уровня уже является окном с фокусом.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Запрашивает передачу фокуса ввода этому `Component`, если его предок верхнего уровня уже является `Window` с фокусом (`Component`).
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому компоненту, если его предок верхнего уровня уже является окном с фокусом.
`void`	`reshape(int x, int y, int width, int height)`	Устарело. Начиная с JDK версии 1.1 заменено на `setBounds(int, int, int, int)`.
`void`	`resize(int width, int height)`	Устарело. Начиная с JDK версии 1.1 заменено на `setSize(int, int)`.
`void`	`resize(Dimension d)`	Устарело. Начиная с JDK версии 1.1 заменено на `setSize(Dimension)`.
`void`	`revalidate()`	Повторно проверяет иерархию компонентов до ближайшего корня проверки.
`void`	`setBackground(Color c)`	Задаёт цвет фона этого компонента.
`void`	`setBounds(int x, int y, int width, int height)`	Перемещает этот компонент и изменяет его размер.
`void`	`setBounds(Rectangle r)`	Перемещает этот компонент и изменяет его размер в соответствии с новым ограничивающим прямоугольником `r`.
`void`	`setComponentOrientation(ComponentOrientation o)`	Задаёт языковую ориентацию, используемую для расположения элементов или текста в этом компоненте.
`void`	`setCursor(Cursor cursor)`	Задаёт указанную форму курсора.
`void`	`setDropTarget(DropTarget dt)`	Связывает `DropTarget` с этим компонентом.
`void`	`setEnabled(boolean b)`	Включает или отключает этот компонент в зависимости от значения параметра `b`.
`void`	`setFocusable(boolean focusable)`	Задаёт возможность получения фокуса этим компонентом в соответствии с указанным значением.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Задаёт клавиши перехода фокуса для указанной операции перехода для этого компонента.
`void`	`setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)`	Задаёт, включены ли клавиши перехода фокуса для этого компонента.
`void`	`setFont(Font f)`	Задаёт шрифт этого компонента.
`void`	`setForeground(Color c)`	Задаёт цвет переднего плана этого компонента.
`void`	`setIgnoreRepaint(boolean ignoreRepaint)`	Задаёт, следует ли игнорировать сообщения о рисовании, полученные от операционной системы.
`void`	`setLocale(Locale l)`	Задаёт локаль этого компонента.
`void`	`setLocation(int x, int y)`	Перемещает этот компонент в новое место.
`void`	`setLocation(Point p)`	Перемещает этот компонент в новое место.
`void`	`setMaximumSize(Dimension maximumSize)`	Задаёт постоянное максимальное значение размера этого компонента.
`void`	`setMinimumSize(Dimension minimumSize)`	Задаёт постоянное минимальное значение размера этого компонента.
`void`	`setMixingCutoutShape(Shape shape)`	Задаёт форму «выреза для смешивания» для этого лёгкого компонента.
`void`	`setName(String name)`	Задаёт имя компонента указанной строкой.
`void`	`setPreferredSize(Dimension preferredSize)`	Задаёт постоянное значение предпочтительного размера этого компонента.
`void`	`setSize(int width, int height)`	Изменяет размер этого компонента так, чтобы его ширина составляла `width`, а высота — `height`.
`void`	`setSize(Dimension d)`	Изменяет размер этого компонента так, чтобы его ширина составляла `d.width`, а высота — `d.height`.
`void`	`setVisible(boolean b)`	Показывает или скрывает этот компонент в зависимости от значения параметра `b`.
`void`	`show()`	Устарело. Начиная с JDK версии 1.1 заменено на `setVisible(boolean)`.
`void`	`show(boolean b)`	Устарело. Начиная с JDK версии 1.1 заменено на `setVisible(boolean)`.
`Dimension`	`size()`	Устарело. Начиная с JDK версии 1.1 заменено на `getSize()`.
`String`	`toString()`	Возвращает строковое представление этого компонента и его значений.
`void`	`transferFocus()`	Передаёт фокус следующему компоненту, как если бы этот компонент владел фокусом.
`void`	`transferFocusBackward()`	Передаёт фокус предыдущему компоненту, как если бы этот компонент владел фокусом.
`void`	`transferFocusUpCycle()`	Передаёт фокус на один цикл обхода фокуса вверх.
`void`	`validate()`	Проверяет этот компонент.

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

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

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

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

Canvas

public Canvas()

Создает новый Canvas.

Canvas

public Canvas(GraphicsConfiguration config)

Создает новый Canvas с заданным объектом GraphicsConfiguration. Если передано значение null, будет использоваться GraphicsConfiguration по умолчанию.

Параметры:

config — ссылка на объект GraphicsConfiguration или null

См. также:

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

addNotify

public void addNotify()

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

Переопределяет:

addNotify в классе Component

См. также:

paint

public void paint(Graphics g)

Рисует этот холст.

Большинство приложений, подклассифицирующих Canvas, должны переопределить этот метод для выполнения полезных операций (обычно для пользовательской отрисовки холста). По умолчанию холст просто очищается. Приложениям, переопределяющим этот метод, не требуется вызывать super.paint(g).

Переопределяет:

paint в классе Component

Параметры:

g — заданный контекст Graphics

См. также:

update

public void update(Graphics g)

Обновляет этот холст.

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

Переопределяет:

update в классе Component

Параметры:

g — заданный контекст Graphics

См. также:

createBufferStrategy

public void createBufferStrategy(int numBuffers)

Создает новую стратегию многобуферизации для этого компонента. Многобуферизация полезна для повышения производительности отрисовки. Этот метод пытается создать наилучшую доступную стратегию с заданным количеством буферов. Он всегда создает BufferStrategy с таким количеством буферов. Сначала выполняется попытка использовать стратегию перелистывания страниц, затем — стратегию копирования с использованием ускоренных буферов. Наконец, используется неускоренная стратегия копирования.

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

Параметры:

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

Исключения:

IllegalArgumentException — если numBuffers меньше 1.

IllegalStateException — если компонент не отображается

Начиная с:

1.4

См. также:

createBufferStrategy

public void createBufferStrategy(int numBuffers, BufferCapabilities caps) throws AWTException

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

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

Параметры:

numBuffers — количество создаваемых буферов

caps — требуемые возможности для создания стратегии буферизации; не может быть null

Исключения:

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

IllegalArgumentException — если numBuffers меньше 1 или caps равно null

Начиная с:

1.4

См. также:

getBufferStrategy

public BufferStrategy getBufferStrategy()

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

Возвращает:

стратегию буферизации, используемую этим компонентом

Начиная с:

1.4

См. также:

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим Canvas. Для холстов AccessibleContext имеет вид AccessibleAWTCanvas. При необходимости создается новый экземпляр AccessibleAWTCanvas.

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleAWTCanvas, служащий AccessibleContext этого Canvas
Начиная с:: 1.3

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