Класс 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(GraphicsConfiguration config)`	Создаёт новый холст, задавая объект GraphicsConfiguration.

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

Модификатор и тип	Метод	Описание
`void`	`addNotify()`	Создаёт виджет холста.
`void`	`createBufferStrategy(int numBuffers)`	Создаёт новую стратегию многобуферизации для этого компонента.
`void`	`createBufferStrategy(int numBuffers, BufferCapabilities caps)`	Создаёт новую стратегию многобуферизации для этого компонента с требуемыми возможностями буфера.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим холстом.
`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)

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

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

Параметры:

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()

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

Возвращает:

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

С:

1.4

См. также:

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

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