Класс 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 - указанное графическое окно

См. также:

update

public void update(Graphics g)

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

Overrides:

update в классе Container

Параметры:

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

См. также:

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 на объекте графики 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 создается при необходимости.

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/CellRendererPane.html