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

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

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.image.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)`	Обновляет этот холст.

Методы, объявленные в классе java.awt.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

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

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

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

Canvas

public Canvas()

Создаёт новый объект Canvas.

Canvas

public Canvas(GraphicsConfiguration config)

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

Параметры:

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

См. также:

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

addNotify

public void addNotify()

Создаёт виджет (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)

Создаёт новую стратегию для многобуферной отрисовки на этом компоненте. Многобуферная отрисовка полезна для повышения производительности. Этот метод пытается создать наилучшую доступную стратегию с заданным количеством буферов. Он всегда создаёт стратегию с указанным количеством буферов. Сначала используется стратегия page-flipping, затем стратегия blitting с ускоренными буферами. В конечном счёте, используется неакселерированная стратегия blitting.

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

Параметры:

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 не соответствует требованиям

С тех пор:

1.4

См. также:

getBufferStrategy

public BufferStrategy getBufferStrategy()

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

Возвращает:

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

С тех пор:

1.4

См. также:

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleAWTCanvas, который служит AccessibleContext для этого холста
С тех пор:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Canvas.html