Класс JTableHeader

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.table.JTableHeader

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

public class JTableHeader
extends JComponent
implements TableColumnModelListener, Accessible

Этот объект управляет заголовком JTable.

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

См. также:: JTable, Сериализованная форма

Вложенные классы

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

Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

Поля

Модификатор и тип	Поле	Описание
`protected TableColumnModel`	`columnModel`	Заголовок таблицы.
`protected TableColumn`	`draggedColumn`	Индекс перетаскиваемого столбца.
`protected int`	`draggedDistance`	Расстояние, на которое столбец был перетащен от первоначальной позиции.
`protected boolean`	`reorderingAllowed`	Если true, пользователь может переупорядочивать столбцы; по умолчанию true.
`protected boolean`	`resizingAllowed`	Если true, пользователь может изменять размер столбцов; по умолчанию true.
`protected TableColumn`	`resizingColumn`	Индекс изменяемого столбца.
`protected JTable`	`table`	Таблица, для которой этот объект является заголовком; по умолчанию `null`.
`protected boolean`	`updateTableInRealTime`	Устарело, начиная с Java 2 platform v1.3.

Поля, объявленные в классе javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

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

Конструкторы

Конструктор	Описание
`JTableHeader()`	Создаёт `JTableHeader` с параметрами по умолчанию `TableColumnModel`.
`JTableHeader(TableColumnModel cm)`	Создаёт `JTableHeader`, инициализированный `cm` в качестве модели столбцов.

Методы

Модификатор и тип	Метод	Описание
`void`	`columnAdded(TableColumnModelEvent e)`	Вызывается при добавлении столбца в модель столбцов таблицы.
`int`	`columnAtPoint(Point point)`	Возвращает индекс столбца, в котором `point` находится, или -1, если он находится за пределами границ.
`void`	`columnMarginChanged(ChangeEvent e)`	Вызывается при перемещении столбца из-за изменения отступа.
`void`	`columnMoved(TableColumnModelEvent e)`	Вызывается при изменении расположения столбца.
`void`	`columnRemoved(TableColumnModelEvent e)`	Вызывается при удалении столбца из модели столбцов таблицы.
`void`	`columnSelectionChanged(ListSelectionEvent e)`	Вызывается при изменении модели выделения `TableColumnModel`.
`protected TableColumnModel`	`createDefaultColumnModel()`	Возвращает объект модели столбцов по умолчанию, который является `DefaultTableColumnModel`.
`protected TableCellRenderer`	`createDefaultRenderer()`	Возвращает рендерер по умолчанию, который используется, если рендерер заголовка не определён `TableColumn`.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим JTableHeader.
`TableColumnModel`	`getColumnModel()`	Возвращает `TableColumnModel`, содержащий всю информацию о столбцах этого заголовка таблицы.
`TableCellRenderer`	`getDefaultRenderer()`	Возвращает рендерер по умолчанию, используемый, если `headerRenderer` не определён `TableColumn`.
`TableColumn`	`getDraggedColumn()`	Возвращает перетаскиваемый столбец, только если перетаскивание выполняется, в противном случае возвращает `null`.
`int`	`getDraggedDistance()`	Возвращает горизонтальное расстояние столбца от его исходного положения, только если выполняется перетаскивание.
`Rectangle`	`getHeaderRect(int column)`	Возвращает прямоугольник, содержащий плитку заголовка в `column`.
`Dimension`	`getPreferredSize()`	Возвращает предпочтительный размер заголовка таблицы.
`boolean`	`getReorderingAllowed()`	Возвращает true, если пользователь может переупорядочивать столбцы перетаскиванием их заголовков, в противном случае false.
`boolean`	`getResizingAllowed()`	Возвращает true, если пользователь может изменять размер столбцов перетаскиванием между их заголовками, в противном случае false.
`TableColumn`	`getResizingColumn()`	Возвращает столбец, изменяемый по размеру.
`JTable`	`getTable()`	Возвращает таблицу, связанную с этим заголовком.
`String`	`getToolTipText(MouseEvent event)`	Разрешает использовать подсказки рендерера, если текст задан.
`TableHeaderUI`	`getUI()`	Возвращает объект внешнего вида и ощущения (L&F), который отрисовывает этот компонент.
`String`	`getUIClassID()`	Возвращает суффикс, используемый для создания имени класса внешнего вида и ощущения (L&F), используемого для отрисовки этого компонента.
`boolean`	`getUpdateTableInRealTime()`	Устарело начиная с платформы Java 2 v1.3.
`protected void`	`initializeLocalVars()`	Инициализирует локальные переменные и свойства значениями по умолчанию.
`protected String`	`paramString()`	Возвращает строковое представление этого `JTableHeader`.
`void`	`resizeAndRepaint()`	Изменяет размер заголовка и помечает его как требующий отображения.
`void`	`setColumnModel(TableColumnModel columnModel)`	Устанавливает модель столбцов для этой таблицы на `newModel` и регистрируется для уведомлений о событиях от новой модели столбцов.
`void`	`setDefaultRenderer(TableCellRenderer defaultRenderer)`	Устанавливает рендерер по умолчанию, который используется, если `headerRenderer` не определён `TableColumn`.
`void`	`setDraggedColumn(TableColumn aColumn)`	Устанавливает `draggedColumn` заголовка на `aColumn`.
`void`	`setDraggedDistance(int distance)`	Устанавливает `draggedDistance` заголовка на `distance`.
`void`	`setReorderingAllowed(boolean reorderingAllowed)`	Устанавливает, разрешено ли пользователю перетаскивать заголовки столбцов для изменения порядка столбцов.
`void`	`setResizingAllowed(boolean resizingAllowed)`	Устанавливает, разрешено ли пользователю изменять размер столбцов перетаскиванием между заголовками.
`void`	`setResizingColumn(TableColumn aColumn)`	Устанавливает `resizingColumn` заголовка на `aColumn`.
`void`	`setTable(JTable table)`	Устанавливает таблицу, связанную с этим заголовком.
`void`	`setUI(TableHeaderUI ui)`	Устанавливает объект внешнего вида и ощущения (L&F), который отрисовывает этот компонент.
`void`	`setUpdateTableInRealTime(boolean flag)`	Устарело начиная с платформы Java 2 v1.3.
`void`	`updateUI()`	Уведомление от `UIManager` о том, что внешний вид и ощущения (L&F) изменились.

Методы, объявленные в классе javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

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

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

Поля

table

protected JTable table

Таблица, для которой этот объект является заголовком; значение по умолчанию — null.

columnModel

protected TableColumnModel columnModel

Модель столбцов заголовка таблицы.

reorderingAllowed

protected boolean reorderingAllowed

Если true, переупорядочивание столбцов разрешено пользователем; значение по умолчанию — true.

resizingAllowed

protected boolean resizingAllowed

Если true, изменение размера столбцов разрешено пользователем; значение по умолчанию — true.

updateTableInRealTime

protected boolean updateTableInRealTime

Устарело начиная с платформы Java 2 v1.3. Перерисовка в реальном времени в ответ на перетаскивание или изменение размера столбцов теперь выполняется безусловно.

resizingColumn

protected transient TableColumn resizingColumn

Индекс столбца, изменяемого по размеру. null если изменение размера не выполняется.

draggedColumn

protected transient TableColumn draggedColumn

Индекс перетаскиваемого столбца. null если перетаскивание не выполняется.

draggedDistance

protected transient int draggedDistance

Расстояние, на которое столбец был перетащен от исходного положения.

Конструкторы

JTableHeader

public JTableHeader()

Создаёт JTableHeader с моделью столбцов по умолчанию.

См. также:: createDefaultColumnModel()

JTableHeader

public JTableHeader(TableColumnModel cm)

Создаёт JTableHeader, который инициализирован cm в качестве модели столбцов. Если cm равно null, этот метод инициализирует заголовок таблицы с моделью столбцов по умолчанию.

Параметры:: cm - модель столбцов таблицы
См. также:: createDefaultColumnModel()

Методы

setTable

@BeanProperty(description="The table associated with this header.")
public void setTable(JTable table)

Устанавливает таблицу, связанную с этим заголовком.

Параметры:: table - новая таблица

getTable

public JTable getTable()

Возвращает таблицу, связанную с этим заголовком.

Возвращает:: свойство table

setReorderingAllowed

@BeanProperty(description="Whether the user can drag column headers to reorder columns.")
public void setReorderingAllowed(boolean reorderingAllowed)

Устанавливает, можно ли пользователю перетаскивать заголовки столбцов для изменения порядка столбцов.

Параметры:: reorderingAllowed - true, если представление таблицы должно разрешать перестановку; в противном случае false
См. также:: getReorderingAllowed()

getReorderingAllowed

public boolean getReorderingAllowed()

Возвращает true, если пользователю разрешено переупорядочивать столбцы, перетаскивая их заголовки, в противном случае false. По умолчанию true. Вы можете переупорядочивать столбцы программно независимо от этого параметра.

Возвращает:: свойство reorderingAllowed
См. также:: setReorderingAllowed(boolean)

setResizingAllowed

@BeanProperty(description="Whether the user can resize columns by dragging between headers.")
public void setResizingAllowed(boolean resizingAllowed)

Устанавливает, можно ли пользователю изменять размер столбцов, перетаскивая между заголовками.

Параметры:: resizingAllowed - true, если представление таблицы должно разрешать изменение размера
См. также:: getResizingAllowed()

getResizingAllowed

public boolean getResizingAllowed()

Возвращает true, если пользователю разрешено изменять размер столбцов, перетаскивая между их заголовками, в противном случае false. По умолчанию true. Вы можете изменять размер столбцов программно независимо от этого параметра.

Возвращает:: свойство resizingAllowed
См. также:: setResizingAllowed(boolean)

getDraggedColumn

public TableColumn getDraggedColumn()

Возвращает перетаскиваемый столбец, только если перетаскивание происходит, в противном случае возвращает null.

Возвращает:: перетаскиваемый столбец, если перетаскивание происходит, в противном случае возвращает null
См. также:: getDraggedDistance()

getDraggedDistance

public int getDraggedDistance()

Возвращает горизонтальное расстояние столбца от его исходного положения, только если перетаскивание происходит. В противном случае возвращаемое значение не имеет смысла.

Возвращает:: горизонтальное расстояние столбца от его исходного положения, если перетаскивание происходит, в противном случае возвращаемое значение не имеет смысла
См. также:: getDraggedColumn()

getResizingColumn

public TableColumn getResizingColumn()

Возвращает столбец, который изменяется в размерах. Если ни один столбец не изменяется в размерах, метод возвращает null.

Возвращает:: столбец, который изменяется в размерах, если изменение размера происходит, в противном случае возвращает null

setUpdateTableInRealTime

public void setUpdateTableInRealTime(boolean flag)

Устарело начиная с Java 2 platform v1.3. Перерисовка в реальном времени в ответ на перетаскивание или изменение размера столбцов теперь происходит безусловно.

Параметры:: flag - true, если tableView должен обновлять тело таблицы в реальном времени

getUpdateTableInRealTime

public boolean getUpdateTableInRealTime()

Возвращает:: true, если таблица обновляется в реальном времени

setDefaultRenderer

public void setDefaultRenderer(TableCellRenderer defaultRenderer)

Устанавливает по умолчанию рендерер, который используется, когда headerRenderer не определен TableColumn.

Параметры:: defaultRenderer - рендерер по умолчанию
Since:: 1.3

getDefaultRenderer

public TableCellRenderer getDefaultRenderer()

Возвращает рендерер по умолчанию, который используется, когда headerRenderer не определен TableColumn.

Возвращает:: рендерер по умолчанию
Since:: 1.3

columnAtPoint

public int columnAtPoint(Point point)

Возвращает индекс столбца, в котором point находится, или -1, если он находится вне границ.

Параметры:: point - если эта point находится внутри столбца, будет возвращен индекс этого столбца; в противном случае она находится вне границ и возвращается -1
Возвращает:: индекс столбца, в котором point находится, или -1, если он находится вне границ

getHeaderRect

public Rectangle getHeaderRect(int column)

Возвращает прямоугольник, содержащий плитку заголовка в column. Когда column параметр находится вне границ, этот метод использует те же соглашения, что и метод JTable getCellRect.

Параметры:: column - индекс столбца
Возвращает:: прямоугольник, содержащий плитку заголовка в column
См. также:: JTable.getCellRect(int, int, boolean)

getToolTipText

public String getToolTipText(MouseEvent event)

Позволяет использовать подсказки рендерера, если текст задан.

Overrides:: getToolTipText в классе JComponent
Параметры:: event - расположение события определяет соответствующий рендерер и, следовательно, соответствующую подсказку
Возвращает:: подсказку для этого компонента

getPreferredSize

public Dimension getPreferredSize()

Возвращает предпочтительный размер заголовка таблицы. Это размер, необходимый для отображения заголовка и запрашиваемый для области просмотра. Возвращаемый Dimension width всегда будет рассчитываться базовым TableHeaderUI, независимо от указанной ширины JComponent.setPreferredSize(java.awt.Dimension)

Overrides:: getPreferredSize в классе JComponent
Возвращает:: размер
См. также:: JComponent.setPreferredSize(java.awt.Dimension), ComponentUI

getUI

public TableHeaderUI getUI()

Возвращает объект темы внешнего вида (L&F), который отображает этот компонент.

Overrides:: getUI в классе JComponent
Возвращает:: объект TableHeaderUI , который отображает этот компонент

setUI

public void setUI(TableHeaderUI ui)

Устанавливает объект темы внешнего вида (L&F), который отображает этот компонент.

Параметры:: ui - объект темы внешнего вида (L&F)
См. также:: UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

Уведомление от UIManager о том, что внешний вид (L&F) изменился. Заменяет текущий объект UI последней версией из UIManager.

Overrides:: updateUI в классе JComponent
См. также:: JComponent.updateUI()

getUIClassID

public String getUIClassID()

Возвращает суффикс, используемый для построения имени класса темы внешнего вида (L&F), используемого для отображения этого компонента.

Overrides:: getUIClassID в классе JComponent
Возвращает:: строка "TableHeaderUI"
См. также:: JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setColumnModel

@BeanProperty(description="The object governing the way columns appear in the view.")
public void setColumnModel(TableColumnModel columnModel)

Устанавливает модель столбцов для этой таблицы в newModel и регистрируется для уведомлений о событиях от новой модели столбцов.

Параметры:: columnModel - новый источник данных для этой таблицы
Исключения:: IllegalArgumentException - если newModel является null
См. также:: getColumnModel()

getColumnModel

public TableColumnModel getColumnModel()

Возвращает TableColumnModel, который содержит всю информацию о столбцах этого заголовка таблицы.

Возвращает:: свойство columnModel
См. также:: setColumnModel(javax.swing.table.TableColumnModel)