Класс 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 в пакете java.beans появилась поддержка длительного хранения всех JavaBeans. См. XMLEncoder.

С версии:: 1.2

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

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

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

Container.AccessibleAWTContainer

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

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

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

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

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

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе 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)`	Не должен вызываться.

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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 вверх по дереву при настройке дочернего компонента средства визуализации ячеек.

Переопределяет:

invalidate в классе Container

См. также:

paint

public void paint(Graphics g)

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

Переопределяет:

paint в классе Container

Параметры:

g — указанное графическое окно

См. также:

update

public void update(Graphics g)

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

Переопределяет:

update в классе Container

Параметры:

g — указанное графическое окно

См. также:

addImpl

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

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

Переопределяет:

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

Параметры:: g — объект Graphics, на котором выполняется рисование; c — Component для рисования; p — компонент Container, на котором фактически выполняется рисование; x — целое число, задающее левую границу области рисования в пикселях относительно левого края графического контекста; y — целое число, задающее верхнюю границу области рисования в пикселях относительно верхнего края графического контекста; w — целое число, задающее ширину области рисования в пикселях; h — целое число, задающее высоту области рисования в пикселях; shouldValidate — если имеет значение true, компонент 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 — целое число, задающее левую границу области рисования в пикселях относительно левого края графического контекста; y — целое число, задающее верхнюю границу области рисования в пикселях относительно верхнего края графического контекста; 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.

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

© 1993, 2025, 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/25/docs/api/java.desktop/javax/swing/CellRendererPane.html