Класс Canvas

java.lang.Object
- java.awt.Component
- - java.awt.Canvas

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

public class Canvas
extends Component
implements Accessible

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

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

С момента:: JDK1.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, getPeer, 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, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, 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.

Параметры:: config - ссылка на объект GraphicsConfiguration.
См. также:: GraphicsConfiguration

Детали методов

addNotify

public void addNotify()

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

Переопределяет:: addNotify в классе Component
См. также:: Toolkit.createCanvas(java.awt.Canvas), Component.getToolkit()

paint

public void paint(Graphics g)

Отображает этот холст.

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

Переопределяет:: paint в классе Component
Параметры:: g - указанный контекст Graphics
См. также:: update(Graphics), Component.paint(Graphics)

update

public void update(Graphics g)

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

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

Переопределяет:: update в классе Component
Параметры:: g - указанный контекст Graphics
См. также:: paint(Graphics), Component.update(Graphics)

createBufferStrategy

public void createBufferStrategy(int numBuffers)

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

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

Параметры:: numBuffers - количество буферов для создания, включая передний буфер
Исключения:: IllegalArgumentException - если numBuffers меньше 1.; IllegalStateException - если компонент недоступен для отображения
С момента:: 1.4
См. также:: Component.isDisplayable(), getBufferStrategy()

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, если стратегия буферизации ещё не была создана или была удалена.

Возвращает:: стратегию буферизации, используемую этим компонентом
С момента:: 1.4
См. также:: createBufferStrategy(int)

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

© 1993, 2020, 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.