Класс CellRendererPane

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.CellRendererPane

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

public class CellRendererPane extends Container implements Accessible

Этот класс вставляется между рендерерами ячеек и компонентами, которые их используют. Он просто существует, чтобы предотвратить вызовы методов repaint() и invalidate(), которые в противном случае распространялись бы вверх по дереву, когда рендерер настраивался. Он используется реализациями JTable, JTree и JList. Например, вот как CellRendererPane используется в коде, который рисует каждую строку в JList:

   cellRendererPane = new CellRendererPane();
   ...
   Component rendererComponent = renderer.getListCellRendererComponent();
   renderer.configureListCellRenderer(dataModel.getElementAt(row), row);
   cellRendererPane.paintComponent(g, rendererComponent, this, x, y, w, h);

Компонент-рендерер должен переопределить isShowing() и безусловно возвращать true, чтобы работать корректно, поскольку Swing ничего не делает для компонентов с isShowing false.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans добавлена в пакет java.beans. См. XMLEncoder.

С:: 1.2

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`CellRendererPane.AccessibleCellRendererPane`	Этот класс реализует поддержку доступности для класса `CellRendererPane`.

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип	Поле	Описание
`protected AccessibleContext`	`accessibleContext`	`AccessibleContext` связанный с этим `CellRendererPan`

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

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

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

Конструктор	Описание
`CellRendererPane()`	Создаёт объект CellRendererPane.

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

Модификатор и тип	Метод	Описание
`protected void`	`addImpl(Component x, Object constraints, int index)`	Если указанный компонент уже является потомком этого, то мы ничего не делаем - порядок отображения не имеет значения для компонентов рендереров ячеек (CellRendererPane ничем не рисует).
`AccessibleContext`	`getAccessibleContext()`	Получает AccessibleContext, связанный с этим CellRendererPane.
`void`	`invalidate()`	Переопределено для предотвращения распространения invalidate вверх по дереву, когда конфигурируется дочерний компонент-рендерер ячейки.
`void`	`paint(Graphics g)`	Не должно вызываться.
`void`	`paintComponent(Graphics g, Component c, Container p, int x, int y, int w, int h)`	Вызывает this.paintComponent(g, c, p, x, y, w, h, false).
`void`	`paintComponent(Graphics g, Component c, Container p, int x, int y, int w, int h, boolean shouldValidate)`	Рисует компонент-рендерер ячейки c на графическом объекте g.
`void`	`paintComponent(Graphics g, Component c, Container p, Rectangle r)`	Вызывает this.paintComponent(g, c, p, r.x, r.y, r.width, r.height), где `r` является входным параметром `Rectangle`.
`void`	`update(Graphics g)`	Не должно вызываться.

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

add, add, add, add, add, addContainerListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, isValidateRoot, layout, list, list, locate, minimumSize, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, 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, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

Подробное описание полей

accessibleContext

protected AccessibleContext accessibleContext

AccessibleContext связанный с этим CellRendererPan

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

CellRendererPane

public CellRendererPane()

Создаёт объект CellRendererPane.

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

invalidate

public void invalidate()

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

Overrides:

invalidate в классе Container

См. также:

paint

public void paint(Graphics g)

Не должно вызываться.

Overrides:

paint в классе Container

Параметры:

g - указанное окно Graphics

См. также:

update

public void update(Graphics g)

Не должно вызываться.

Overrides:

update в классе Container

Параметры:

g - указанное окно Graphics

См. также:

addImpl

protected void addImpl(Component x, Object constraints, int index)

Если указанный компонент уже является дочерним элементом этого, то мы ничего не делаем — порядок стека не имеет значения для компонентов рендеринга ячеек (CellRendererPane в любом случае не рисует).

Overrides:

addImpl в классе Container

Параметры:

x - добавляемый компонент

constraints - объект, определяющий ограничения макета для этого компонента

index - позиция в списке контейнера, в которой следует вставить компонент, где -1 означает добавление в конец

См. также:

paintComponent

public void paintComponent(Graphics g, Component c, Container p, int x, int y, int w, int h, boolean shouldValidate)

Отрисовка компонента рендеринга ячейки c на объекте graphics g. Перед отрисовкой компонента он переродительтся в этот (если это необходимо), его размеры устанавливаются на w,h, а объект graphics (эффективно) перемещается в x,y. Если это JComponent, временное отключение буферизации двойного буфера. После отрисовки компонента его размеры сбрасываются до -w, -h, 0, 0, чтобы, если это последний нарисованный компонент рендеринга ячейки, он не начал потреблять ввод. Контейнер p — это компонент, на котором мы фактически рисуем, обычно он равен this.getParent(). Если shouldValidate истинно, компонент c будет проверен перед отрисовкой.

Параметры:: g - объект Graphics для отрисовки; c - компонент Component для отрисовки; p - компонент Container для отрисовки; x - целое число, определяющее левую границу области отрисовки в пикселях, измеряемых от левого края контекста graphics; y - целое число, определяющее верхнюю границу области отрисовки в пикселях, измеряемых вниз от верхней границы контекста graphics; w - целое число, определяющее ширину области отрисовки в пикселях; h - целое число, определяющее высоту области отрисовки в пикселях; shouldValidate - если истинно, компонент c будет проверен перед отрисовкой

paintComponent

public void paintComponent(Graphics g, Component c, Container p, int x, int y, int w, int h)

Вызывает this.paintComponent(g, c, p, x, y, w, h, false).

Параметры:: g - объект Graphics для отрисовки; c - компонент Component для отрисовки; p - компонент Container для отрисовки; x - целое число, определяющее левую границу области отрисовки в пикселях, измеряемых от левого края контекста graphics; y - целое число, определяющее верхнюю границу области отрисовки в пикселях, измеряемых вниз от верхней границы контекста graphics; w - целое число, определяющее ширину области отрисовки в пикселях; h - целое число, определяющее высоту области отрисовки в пикселях

paintComponent

public void paintComponent(Graphics g, Component c, Container p, Rectangle r)

Вызывает this.paintComponent(g, c, p, r.x, r.y, r.width, r.height), где r — входной параметр Rectangle.

Параметры:: g - объект Graphics для отрисовки; c - компонент Component для отрисовки; p - компонент Container для отрисовки; r - область Rectangle для отрисовки

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Возвращает:: AccessibleCellRendererPane, который служит AccessibleContext для этого CellRendererPane

© 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/javax/swing/CellRendererPane.html