Класс 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()`	Создаёт виджет холста.
`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

См. также:

Component.getToolkit()

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)

Создаёт новую стратегию многобуферного отображения для этого компонента. Многобуферное отображение полезно для повышения производительности отрисовки. Этот метод пытается создать лучшую доступную стратегию с указанным количеством буферов. Он всегда создаст стратегию с указанным количеством буферов. Сначала используется стратегия переключения страниц, затем стратегия 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 null

С:

1.4

См. также:

getBufferStrategy()

getBufferStrategy

public BufferStrategy getBufferStrategy()

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

Возвращает:

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

С:

1.4

См. также:

createBufferStrategy(int)

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/Canvas.html