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

public Canvas(GraphicsConfiguration config)

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

Параметры:: config - ссылка на объект GraphicsConfiguration или null
См. также:: GraphicsConfiguration, Component.getGraphicsConfiguration()

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

addNotify

public void addNotify()

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

Переопределяет:: addNotify в классе Component
См. также:: 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()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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