Класс 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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

Конструктор	Описание
`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

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

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

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

Canvas

public Canvas()

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

Canvas

public Canvas(GraphicsConfiguration config)

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

Параметры:

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

См. также:

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

addNotify

public void addNotify()

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/Canvas.html