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

См. также:

Component.update(Graphics)

update

public void update(Graphics g)

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

Overrides:

update в классе Container

Параметры:

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

См. также:

Component.update(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 на объекте графики 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
Overrides:: getAccessibleContext в классе Component
Возвращает:: AccessibleCellRendererPane, который служит AccessibleContext этого CellRendererPane

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