QHeaderView#

The QHeaderView class provides a header row or header column for item views. More…

Synopsis#

Properties#

cascadingSectionResizes - Whether interactive resizing will be cascaded to the following sections once the section being resized by the user has reached its minimum size
defaultAlignment - The default alignment of the text in each header section
defaultSectionSize - The default size of the header sections before resizing
firstSectionMovable - Whether the first column can be moved by the user
highlightSections - Whether the sections containing selected items are highlighted
maximumSectionSize - The maximum size of the header sections
minimumSectionSize - The minimum size of the header sections
showSortIndicator - Whether the sort indicator is shown
sortIndicatorClearable - Whether the sort indicator can be cleared by clicking on a section multiple times
stretchLastSection - Whether the last visible section in the header takes up all the available space

Functions#

def cascadingSectionResizes ()
def count ()
def defaultAlignment ()
def defaultSectionSize ()
def hiddenSectionCount ()
def hideSection (logicalIndex)
def highlightSections ()
def initialize ()
def initializeSections ()
def initializeSections (start, end)
def isFirstSectionMovable ()
def isSectionHidden (logicalIndex)
def isSortIndicatorClearable ()
def isSortIndicatorShown ()
def length ()
def logicalIndex (visualIndex)
def logicalIndexAt (pos)
def logicalIndexAt (position)
def logicalIndexAt (x, y)
def maximumSectionSize ()
def minimumSectionSize ()
def moveSection (from, to)
def offset ()
def orientation ()
def resetDefaultSectionSize ()
def resizeContentsPrecision ()
def resizeSection (logicalIndex, size)
def resizeSections (mode)
def restoreState (state)
def saveState ()
def sectionPosition (logicalIndex)
def sectionResizeMode (logicalIndex)
def sectionSize (logicalIndex)
def sectionSizeHint (logicalIndex)
def sectionViewportPosition (logicalIndex)
def sectionsClickable ()
def sectionsHidden ()
def sectionsMovable ()
def sectionsMoved ()
def setCascadingSectionResizes (enable)
def setDefaultAlignment (alignment)
def setDefaultSectionSize (size)
def setFirstSectionMovable (movable)
def setHighlightSections (highlight)
def setMaximumSectionSize (size)
def setMinimumSectionSize (size)
def setResizeContentsPrecision (precision)
def setSectionHidden (logicalIndex, hide)
def setSectionResizeMode (mode)
def setSectionResizeMode (logicalIndex, mode)
def setSectionsClickable (clickable)
def setSectionsMovable (movable)
def setSortIndicator (logicalIndex, order)
def setSortIndicatorClearable (clearable)
def setSortIndicatorShown (show)
def setStretchLastSection (stretch)
def showSection (logicalIndex)
def sortIndicatorOrder ()
def sortIndicatorSection ()
def stretchLastSection ()
def stretchSectionCount ()
def swapSections (first, second)
def visualIndex (logicalIndex)
def visualIndexAt (position)

Virtual functions#

def initStyleOption (option)
def initStyleOptionForIndex (option, logicalIndex)
def paintSection (painter, rect, logicalIndex)
def sectionSizeFromContents (logicalIndex)

Slots#

def headerDataChanged (orientation, logicalFirst, logicalLast)
def resizeSections ()
def sectionsAboutToBeRemoved (parent, logicalFirst, logicalLast)
def sectionsInserted (parent, logicalFirst, logicalLast)
def setOffset (offset)
def setOffsetToLastSection ()
def setOffsetToSectionPosition (visualIndex)
def updateSection (logicalIndex)

Signals#

def geometriesChanged ()
def sectionClicked (logicalIndex)
def sectionCountChanged (oldCount, newCount)
def sectionDoubleClicked (logicalIndex)
def sectionEntered (logicalIndex)
def sectionHandleDoubleClicked (logicalIndex)
def sectionMoved (logicalIndex, oldVisualIndex, newVisualIndex)
def sectionPressed (logicalIndex)
def sectionResized (logicalIndex, oldSize, newSize)
def sortIndicatorChanged (logicalIndex, order)
def sortIndicatorClearableChanged (clearable)

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

A QHeaderView displays the headers used in item views such as the QTableView and QTreeView classes. It takes the place of Qt3’s QHeader class previously used for the same purpose, but uses the Qt’s model/view architecture for consistency with the item view classes.

The QHeaderView class is one of the Model/View Classes and is part of Qt’s model/view framework .

The header gets the data for each section from the model using the QAbstractItemModel::headerData() function. You can set the data by using QAbstractItemModel::setHeaderData().

Each header has an orientation() and a number of sections, given by the count() function. A section refers to a part of the header - either a row or a column, depending on the orientation.

Sections can be moved and resized using moveSection() and resizeSection() ; they can also be hidden and shown with hideSection() and showSection() .

Each section of a header is described by a section ID, specified by its section(), and can be located at a particular visualIndex() in the header. A section can have a sort indicator set with setSortIndicator() ; this indicates whether the items in the associated item view will be sorted in the order given by the section.

For a horizontal header the section is equivalent to a column in the model, and for a vertical header the section is equivalent to a row in the model.

Moving Header Sections#

A header can be fixed in place, or made movable with setSectionsMovable() . It can be made clickable with setSectionsClickable() , and has resizing behavior in accordance with setSectionResizeMode() .

Note

Double-clicking on a header to resize a section only applies for visible rows.

A header will emit sectionMoved() if the user moves a section, sectionResized() if the user resizes a section, and sectionClicked() as well as sectionHandleDoubleClicked() in response to mouse clicks. A header will also emit sectionCountChanged() .

You can identify a section using the logicalIndex() and logicalIndexAt() functions, or by its index position, using the visualIndex() and visualIndexAt() functions. The visual index will change if a section is moved, but the logical index will not change.

Appearance#

QTableWidget and QTableView create default headers. If you want the headers to be visible, you can use setVisible() .

Not all ItemDataRoles will have an effect on a QHeaderView . If you need to draw other roles, you can subclass QHeaderView and reimplement paintEvent() . QHeaderView respects the following item data roles, unless they are in conflict with the style (which can happen for styles that follow the desktop theme):

TextAlignmentRole, DisplayRole, FontRole, DecorationRole, ForegroundRole, and BackgroundRole.

Note

Each header renders the data for each section itself, and does not rely on a delegate. As a result, calling a header’s setItemDelegate() function will have no effect.

class PySide6.QtWidgets.QHeaderView(orientation[, parent=None])#

Parameters:

orientation – Orientation
parent – PySide6.QtWidgets.QWidget

Creates a new generic header with the given orientation and parent.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.QtWidgets.QHeaderView.cascadingSectionResizes: bool#

This property holds whether interactive resizing will be cascaded to the following sections once the section being resized by the user has reached its minimum size.

This property only affects sections that have Interactive as their resize mode.

The default value is false.

See also

setSectionResizeMode()

Access functions:

cascadingSectionResizes ()
setCascadingSectionResizes (enable)

property PᅟySide6.QtWidgets.QHeaderView.defaultAlignment: Combination of Qt.AlignmentFlag#

This property holds the default alignment of the text in each header section.

Access functions:

defaultAlignment ()
setDefaultAlignment (alignment)

property PᅟySide6.QtWidgets.QHeaderView.defaultSectionSize: int#

This property holds the default size of the header sections before resizing..

This property only affects sections that have Interactive or Fixed as their resize mode.

By default, the value of this property is style dependent. Thus, when the style changes, this property updates from it. Calling setDefaultSectionSize() stops the updates, calling resetDefaultSectionSize() will restore default behavior.

See also

setSectionResizeMode() minimumSectionSize

Access functions:

defaultSectionSize ()
setDefaultSectionSize (size)
resetDefaultSectionSize ()

property PᅟySide6.QtWidgets.QHeaderView.firstSectionMovable: bool#

This property holds Whether the first column can be moved by the user.

This property controls whether the first column can be moved by the user. In a QTreeView , the first column holds the tree structure and is therefore non-movable by default, even after setSectionsMovable (true).

It can be made movable again, for instance in the case of flat lists without a tree structure, by calling this method. In such a scenario, it is recommended to call setRootIsDecorated (false) as well.

treeView->setRootIsDecorated(false);
treeView->header()->setFirstSectionMovable(true);

Setting it to true has no effect unless setSectionsMovable (true) is called as well.

See also

setSectionsMovable()

Access functions:

isFirstSectionMovable ()
setFirstSectionMovable (movable)

property PᅟySide6.QtWidgets.QHeaderView.highlightSections: bool#

This property holds whether the sections containing selected items are highlighted.

By default, this property is false.

Access functions:

highlightSections ()
setHighlightSections (highlight)

property PᅟySide6.QtWidgets.QHeaderView.maximumSectionSize: int#

This property holds the maximum size of the header sections..

The maximum section size is the largest section size allowed. The default value for this property is 1048575, which is also the largest possible size for a section. Setting maximum to -1 will reset the value to the largest section size.

With exception of stretch this property is honored by all resize modes

See also

setSectionResizeMode() defaultSectionSize

Access functions:

maximumSectionSize ()
setMaximumSectionSize (size)

property PᅟySide6.QtWidgets.QHeaderView.minimumSectionSize: int#

This property holds the minimum size of the header sections..

The minimum section size is the smallest section size allowed. If the minimum section size is set to -1, QHeaderView will use the font metrics size.

This property is honored by all resize modes .

See also

setSectionResizeMode() defaultSectionSize

Access functions:

minimumSectionSize ()
setMinimumSectionSize (size)

property PᅟySide6.QtWidgets.QHeaderView.showSortIndicator: bool#

This property holds whether the sort indicator is shown.

By default, this property is false.

See also

setSectionsClickable()

Access functions:

isSortIndicatorShown ()
setSortIndicatorShown (show)

property PᅟySide6.QtWidgets.QHeaderView.sortIndicatorClearable: bool#

This property holds Whether the sort indicator can be cleared by clicking on a section multiple times.

This property controls whether the user is able to remove the sorting indicator on a given section by clicking on the section multiple times. Normally, clicking on a section will simply change the sorting order for that section. By setting this property to true, the sorting indicator will be cleared after alternating to ascending and descending; this will typically restore the original sorting of a model.

Setting this property to true has no effect unless sectionsClickable() is also true (which is the default for certain views, for instance QTableView , or is automatically set when making a view sortable, for instance by calling setSortingEnabled ).

Access functions:

isSortIndicatorClearable ()
setSortIndicatorClearable (clearable)
Signal sortIndicatorClearableChanged (clearable)

property PᅟySide6.QtWidgets.QHeaderView.stretchLastSection: bool#

This property holds whether the last visible section in the header takes up all the available space.

The default value is false.

Note

The horizontal headers provided by QTreeView are configured with this property set to true, ensuring that the view does not waste any of the space assigned to it for its header. If this value is set to true, this property will override the resize mode set on the last section in the header.

See also

setSectionResizeMode()

Access functions:

stretchLastSection ()
setStretchLastSection (stretch)

PySide6.QtWidgets.QHeaderView.ResizeMode#

The resize mode specifies the behavior of the header sections. It can be set on the entire header view or on individual sections using setSectionResizeMode() .

Constant

Description

QHeaderView.Interactive

The user can resize the section. The section can also be resized programmatically using resizeSection() . The section size defaults to defaultSectionSize . (See also cascadingSectionResizes .)

QHeaderView.Fixed

The user cannot resize the section. The section can only be resized programmatically using resizeSection() . The section size defaults to defaultSectionSize .

QHeaderView.Stretch

QHeaderView will automatically resize the section to fill the available space. The size cannot be changed by the user or programmatically.

QHeaderView.ResizeToContents

QHeaderView will automatically resize the section to its optimal size based on the contents of the entire column or row. The size cannot be changed by the user or programmatically. (This value was introduced in 4.2)

Constant	Description
QHeaderView.Interactive	The user can resize the section. The section can also be resized programmatically using `resizeSection()` . The section size defaults to `defaultSectionSize` . (See also `cascadingSectionResizes` .)
QHeaderView.Fixed	The user cannot resize the section. The section can only be resized programmatically using `resizeSection()` . The section size defaults to `defaultSectionSize` .
QHeaderView.Stretch	`QHeaderView` will automatically resize the section to fill the available space. The size cannot be changed by the user or programmatically.
QHeaderView.ResizeToContents	`QHeaderView` will automatically resize the section to its optimal size based on the contents of the entire column or row. The size cannot be changed by the user or programmatically. (This value was introduced in 4.2)

The following values are obsolete:

Constant

Description

QHeaderView.Custom

Use Fixed instead.

See also

setSectionResizeMode() stretchLastSection minimumSectionSize

Constant	Description
QHeaderView.Custom	Use Fixed instead.

PySide6.QtWidgets.QHeaderView.cascadingSectionResizes()#

Return type:: bool

See also

setCascadingSectionResizes()

Getter of property cascadingSectionResizes .

PySide6.QtWidgets.QHeaderView.count()#

Return type:: int

Returns the number of sections in the header.

See also

sectionCountChanged() length()

PySide6.QtWidgets.QHeaderView.defaultAlignment()#

Return type:: Combination of Qt.AlignmentFlag

See also

setDefaultAlignment()

Getter of property defaultAlignment .

PySide6.QtWidgets.QHeaderView.defaultSectionSize()#

Return type:: int

See also

setDefaultSectionSize()

Getter of property defaultSectionSize .

PySide6.QtWidgets.QHeaderView.geometriesChanged()#

This signal is emitted when the header’s geometries have changed.

PySide6.QtWidgets.QHeaderView.headerDataChanged(orientation, logicalFirst, logicalLast)#

Parameters:

orientation – Orientation
logicalFirst – int
logicalLast – int

Updates the changed header sections with the given orientation, from logicalFirst to logicalLast inclusive.

PySide6.QtWidgets.QHeaderView.hiddenSectionCount()#

Return type:: int

Returns the number of sections in the header that has been hidden.

See also

setSectionHidden() isSectionHidden()

PySide6.QtWidgets.QHeaderView.hideSection(logicalIndex)#

Parameters:: logicalIndex – int

Hides the section specified by logicalIndex.

See also

showSection() isSectionHidden() hiddenSectionCount() setSectionHidden()

PySide6.QtWidgets.QHeaderView.highlightSections()#

Return type:: bool

See also

setHighlightSections()

Getter of property highlightSections .

PySide6.QtWidgets.QHeaderView.initStyleOption(option)#

Parameters:: option – PySide6.QtWidgets.QStyleOptionHeader

Initialize option with the values from this QHeaderView . This method is useful for subclasses when they need a QStyleOptionHeader , but do not want to fill in all the information themselves.

See also

initFrom() initStyleOptionForIndex()

PySide6.QtWidgets.QHeaderView.initStyleOptionForIndex(option, logicalIndex)#

Parameters:

option – PySide6.QtWidgets.QStyleOptionHeader
logicalIndex – int

Initializes the style option from the specified logicalIndex. This function is called by the default implementation of paintSection after initStyleOption has been called.

See also

paintSection() initStyleOption()

PySide6.QtWidgets.QHeaderView.initialize()#

PySide6.QtWidgets.QHeaderView.initializeSections()#

PySide6.QtWidgets.QHeaderView.initializeSections(start, end)

Parameters:

start – int
end – int

PySide6.QtWidgets.QHeaderView.isFirstSectionMovable()#

Return type:: bool

Getter of property firstSectionMovable .

PySide6.QtWidgets.QHeaderView.isSectionHidden(logicalIndex)#

Parameters:: logicalIndex – int
Return type:: bool

Returns true if the section specified by logicalIndex is explicitly hidden from the user; otherwise returns false.

See also

hideSection() showSection() setSectionHidden() hiddenSectionCount()

PySide6.QtWidgets.QHeaderView.isSortIndicatorClearable()#

Return type:: bool

Getter of property sortIndicatorClearable .

PySide6.QtWidgets.QHeaderView.isSortIndicatorShown()#

Return type:: bool

Getter of property showSortIndicator .

PySide6.QtWidgets.QHeaderView.length()#

Return type:: int

Returns the length along the orientation of the header.

See also

sizeHint() setSectionResizeMode() offset()

PySide6.QtWidgets.QHeaderView.logicalIndex(visualIndex)#

Parameters:: visualIndex – int
Return type:: int

Returns the logicalIndex for the section at the given visualIndex position, or -1 if visualIndex < 0 or visualIndex >= count() .

Note that the visualIndex is not affected by hidden sections.

See also

visualIndex() sectionPosition()

PySide6.QtWidgets.QHeaderView.logicalIndexAt(pos)#

Parameters:: pos – PySide6.QtCore.QPoint
Return type:: int

Returns the logical index of the section at the position given in pos. If the header is horizontal the x-coordinate will be used, otherwise the y-coordinate will be used to find the logical index.

See also

sectionPosition()

PySide6.QtWidgets.QHeaderView.logicalIndexAt(position)

Parameters:: position – int
Return type:: int

Returns the section that covers the given position in the viewport.

See also

visualIndexAt() isSectionHidden()

PySide6.QtWidgets.QHeaderView.logicalIndexAt(x, y)

Parameters:

x – int
y – int

Return type:

int

Returns the logical index of the section at the given coordinate. If the header is horizontal x will be used, otherwise y will be used to find the logical index.

PySide6.QtWidgets.QHeaderView.maximumSectionSize()#

Return type:: int

See also

setMaximumSectionSize()

Getter of property maximumSectionSize .

PySide6.QtWidgets.QHeaderView.minimumSectionSize()#

Return type:: int

See also

setMinimumSectionSize()

Getter of property minimumSectionSize .

PySide6.QtWidgets.QHeaderView.moveSection(from, to)#

Parameters:

from – int
to – int

Moves the section at visual index from to occupy visual index to.

See also

sectionsMoved()

PySide6.QtWidgets.QHeaderView.offset()#

Return type:: int

Returns the offset of the header: this is the header’s left-most (or top-most for vertical headers) visible pixel.

See also

setOffset()

PySide6.QtWidgets.QHeaderView.orientation()#

Return type:: Orientation

Returns the orientation of the header.

See also

Orientation

PySide6.QtWidgets.QHeaderView.paintSection(painter, rect, logicalIndex)#

Parameters:

painter – PySide6.QtGui.QPainter
rect – PySide6.QtCore.QRect
logicalIndex – int

Paints the section specified by the given logicalIndex, using the given painter and rect.

Normally, you do not have to call this function.

PySide6.QtWidgets.QHeaderView.resetDefaultSectionSize()#

Reset function of property defaultSectionSize .

PySide6.QtWidgets.QHeaderView.resizeContentsPrecision()#

Return type:: int

Returns how precise QHeaderView will calculate on ResizeToContents .

See also

setResizeContentsPrecision() setSectionResizeMode()

PySide6.QtWidgets.QHeaderView.resizeSection(logicalIndex, size)#

Parameters:

logicalIndex – int
size – int

Resizes the section specified by logicalIndex to size measured in pixels. The size parameter must be a value larger or equal to zero. A size equal to zero is however not recommended. In that situation hideSection should be used instead.

See also

sectionResized() sectionSize() hideSection()

PySide6.QtWidgets.QHeaderView.resizeSections()#

Resizes the sections according to their size hints. Normally, you do not have to call this function.

PySide6.QtWidgets.QHeaderView.resizeSections(mode)

Parameters:: mode – ResizeMode

Resizes the sections according to the given mode, ignoring the current resize mode.

See also

sectionResized()

PySide6.QtWidgets.QHeaderView.restoreState(state)#

Parameters:: state – PySide6.QtCore.QByteArray
Return type:: bool

Restores the state of this header view. This function returns true if the state was restored; otherwise returns false.

See also

saveState()

PySide6.QtWidgets.QHeaderView.saveState()#

Return type:: PySide6.QtCore.QByteArray

Saves the current state of this header view.

To restore the saved state, pass the return value to restoreState() .

See also

restoreState()

PySide6.QtWidgets.QHeaderView.sectionClicked(logicalIndex)#

Parameters:: logicalIndex – int

This signal is emitted when a section is clicked. The section’s logical index is specified by logicalIndex.

Note that the sectionPressed signal will also be emitted.

See also

setSectionsClickable() sectionPressed()

PySide6.QtWidgets.QHeaderView.sectionCountChanged(oldCount, newCount)#

Parameters:

oldCount – int
newCount – int

This signal is emitted when the number of sections changes, i.e., when sections are added or deleted. The original count is specified by oldCount, and the new count by newCount.

See also

count() length() headerDataChanged()

PySide6.QtWidgets.QHeaderView.sectionDoubleClicked(logicalIndex)#

Parameters:: logicalIndex – int

This signal is emitted when a section is double-clicked. The section’s logical index is specified by logicalIndex.

See also

setSectionsClickable()

PySide6.QtWidgets.QHeaderView.sectionEntered(logicalIndex)#

Parameters:: logicalIndex – int

This signal is emitted when the cursor moves over the section and the left mouse button is pressed. The section’s logical index is specified by logicalIndex.

See also

setSectionsClickable() sectionPressed()

PySide6.QtWidgets.QHeaderView.sectionHandleDoubleClicked(logicalIndex)#

Parameters:: logicalIndex – int

This signal is emitted when a section is double-clicked. The section’s logical index is specified by logicalIndex.

See also

setSectionsClickable()

PySide6.QtWidgets.QHeaderView.sectionMoved(logicalIndex, oldVisualIndex, newVisualIndex)#

Parameters:

logicalIndex – int
oldVisualIndex – int
newVisualIndex – int

This signal is emitted when a section is moved. The section’s logical index is specified by logicalIndex, the old index by oldVisualIndex, and the new index position by newVisualIndex.

See also

moveSection()

PySide6.QtWidgets.QHeaderView.sectionPosition(logicalIndex)#

Parameters:: logicalIndex – int
Return type:: int

Returns the section position of the given logicalIndex, or -1 if the section is hidden. The position is measured in pixels from the first visible item’s top-left corner to the top-left corner of the item with logicalIndex. The measurement is along the x-axis for horizontal headers and along the y-axis for vertical headers.

See also

sectionViewportPosition()

PySide6.QtWidgets.QHeaderView.sectionPressed(logicalIndex)#

Parameters:: logicalIndex – int

This signal is emitted when a section is pressed. The section’s logical index is specified by logicalIndex.

See also

setSectionsClickable()

PySide6.QtWidgets.QHeaderView.sectionResizeMode(logicalIndex)#

Parameters:: logicalIndex – int
Return type:: ResizeMode

Returns the resize mode that applies to the section specified by the given logicalIndex.

See also

setSectionResizeMode()

PySide6.QtWidgets.QHeaderView.sectionResized(logicalIndex, oldSize, newSize)#

Parameters:

logicalIndex – int
oldSize – int
newSize – int

This signal is emitted when a section is resized. The section’s logical number is specified by logicalIndex, the old size by oldSize, and the new size by newSize.

See also

resizeSection()

PySide6.QtWidgets.QHeaderView.sectionSize(logicalIndex)#

Parameters:: logicalIndex – int
Return type:: int

Returns the width (or height for vertical headers) of the given logicalIndex.

See also

length() setSectionResizeMode() defaultSectionSize()

PySide6.QtWidgets.QHeaderView.sectionSizeFromContents(logicalIndex)#

Parameters:: logicalIndex – int
Return type:: PySide6.QtCore.QSize

Returns the size of the contents of the section specified by the given logicalIndex.

See also

defaultSectionSize()

PySide6.QtWidgets.QHeaderView.sectionSizeHint(logicalIndex)#

Parameters:: logicalIndex – int
Return type:: int

Returns a suitable size hint for the section specified by logicalIndex.

Qt::SizeHintRole

See also

sizeHint() defaultSectionSize() minimumSectionSize() maximumSectionSize()

PySide6.QtWidgets.QHeaderView.sectionViewportPosition(logicalIndex)#

Parameters:: logicalIndex – int
Return type:: int

Returns the section viewport position of the given logicalIndex.

If the section is hidden, the return value is undefined.

See also

sectionPosition() isSectionHidden()

PySide6.QtWidgets.QHeaderView.sectionsAboutToBeRemoved(parent, logicalFirst, logicalLast)#

Parameters:

parent – PySide6.QtCore.QModelIndex
logicalFirst – int
logicalLast – int

This slot is called when sections are removed from the parent. logicalFirst and logicalLast signify where the sections were removed.

If only one section is removed, logicalFirst and logicalLast will be the same.

PySide6.QtWidgets.QHeaderView.sectionsClickable()#

Return type:: bool

Returns true if the header is clickable; otherwise returns false. A clickable header could be set up to allow the user to change the representation of the data in the view related to the header.

See also

setSectionsClickable()

PySide6.QtWidgets.QHeaderView.sectionsHidden()#

Return type:: bool

Returns true if sections in the header has been hidden; otherwise returns false;

See also

setSectionHidden()

PySide6.QtWidgets.QHeaderView.sectionsInserted(parent, logicalFirst, logicalLast)#

Parameters:

parent – PySide6.QtCore.QModelIndex
logicalFirst – int
logicalLast – int

This slot is called when sections are inserted into the parent. logicalFirst and logicalLast indices signify where the new sections were inserted.

If only one section is inserted, logicalFirst and logicalLast will be the same.

PySide6.QtWidgets.QHeaderView.sectionsMovable()#

Return type:: bool

Returns true if the header can be moved by the user; otherwise returns false.

By default, sections are movable in QTreeView (except for the first one), and not movable in QTableView .

See also

setSectionsMovable()

PySide6.QtWidgets.QHeaderView.sectionsMoved()#

Return type:: bool

Returns true if sections in the header has been moved; otherwise returns false;

See also

moveSection()

PySide6.QtWidgets.QHeaderView.setCascadingSectionResizes(enable)#

Parameters:: enable – bool

See also

cascadingSectionResizes()

Setter of property cascadingSectionResizes .

PySide6.QtWidgets.QHeaderView.setDefaultAlignment(alignment)#

Parameters:: alignment – Combination of Qt.AlignmentFlag

See also

defaultAlignment()

Setter of property defaultAlignment .

PySide6.QtWidgets.QHeaderView.setDefaultSectionSize(size)#

Parameters:: size – int

See also

defaultSectionSize()

Setter of property defaultSectionSize .

PySide6.QtWidgets.QHeaderView.setFirstSectionMovable(movable)#

Parameters:: movable – bool

See also

isFirstSectionMovable()

Setter of property firstSectionMovable .

PySide6.QtWidgets.QHeaderView.setHighlightSections(highlight)#

Parameters:: highlight – bool

See also

highlightSections()

Setter of property highlightSections .

PySide6.QtWidgets.QHeaderView.setMaximumSectionSize(size)#

Parameters:: size – int

See also

maximumSectionSize()

Setter of property maximumSectionSize .

PySide6.QtWidgets.QHeaderView.setMinimumSectionSize(size)#

Parameters:: size – int

See also

minimumSectionSize()

Setter of property minimumSectionSize .

PySide6.QtWidgets.QHeaderView.setOffset(offset)#

Parameters:: offset – int

Sets the header’s offset to offset.

See also

offset() length()

PySide6.QtWidgets.QHeaderView.setOffsetToLastSection()#

Sets the offset to make the last section visible.

See also

setOffset() sectionPosition() setOffsetToSectionPosition()

PySide6.QtWidgets.QHeaderView.setOffsetToSectionPosition(visualIndex)#

Parameters:: visualIndex – int

Sets the offset to the start of the section at the given visualSectionNumber. visualSectionNumber is the actual visible section when hiddenSections are not considered. That is not always the same as visualIndex() .

See also

setOffset() sectionPosition()

PySide6.QtWidgets.QHeaderView.setResizeContentsPrecision(precision)#

Parameters:: precision – int

Sets how precise QHeaderView should calculate the size when ResizeToContents is used. A low value will provide a less accurate but fast auto resize while a higher value will provide a more accurate resize that however can be slow.

The number precision specifies how many sections that should be consider when calculating the preferred size.

The default value is 1000 meaning that a horizontal column with auto-resize will look at maximum 1000 rows on calculating when doing an auto resize.

Special value 0 means that it will look at only the visible area. Special value -1 will imply looking at all elements.

This value is used in sizeHintForColumn() , sizeHintForRow() and sizeHintForColumn() . Reimplementing these functions can make this function not having an effect.

See also

resizeContentsPrecision() setSectionResizeMode() resizeSections() sizeHintForColumn() sizeHintForRow() sizeHintForColumn()

PySide6.QtWidgets.QHeaderView.setSectionHidden(logicalIndex, hide)#

Parameters:

logicalIndex – int
hide – bool

If hide is true the section specified by logicalIndex is hidden; otherwise the section is shown.

See also

isSectionHidden() hiddenSectionCount()

PySide6.QtWidgets.QHeaderView.setSectionResizeMode(mode)#

Parameters:: mode – ResizeMode

Sets the constraints on how the header can be resized to those described by the given mode.

See also

sectionResizeMode() length() sectionResized()

PySide6.QtWidgets.QHeaderView.setSectionResizeMode(logicalIndex, mode)

Parameters:

logicalIndex – int
mode – ResizeMode

Sets the constraints on how the section specified by logicalIndex in the header can be resized to those described by the given mode. The logical index should exist at the time this function is called.

Note

This setting will be ignored for the last section if the stretchLastSection property is set to true. This is the default for the horizontal headers provided by QTreeView .

PySide6.QtWidgets.QHeaderView.setSectionsClickable(clickable)#

Parameters:: clickable – bool

If clickable is true, the header will respond to single clicks.

See also

sectionsClickable() sectionClicked() sectionPressed() setSortIndicatorShown()

PySide6.QtWidgets.QHeaderView.setSectionsMovable(movable)#

Parameters:: movable – bool

If movable is true, the header sections may be moved by the user; otherwise they are fixed in place.

When used in combination with QTreeView , the first column is not movable (since it contains the tree structure), by default. You can make it movable with setFirstSectionMovable (true).

See also

sectionsMovable() sectionMoved() setFirstSectionMovable()

PySide6.QtWidgets.QHeaderView.setSortIndicator(logicalIndex, order)#

Parameters:

logicalIndex – int
order – SortOrder

Sets the sort indicator for the section specified by the given logicalIndex in the direction specified by order, and removes the sort indicator from any other section that was showing it.

logicalIndex may be -1, in which case no sort indicator will be shown and the model will return to its natural, unsorted order. Note that not all models support this and may even crash in this case.

See also

sortIndicatorSection() sortIndicatorOrder()

PySide6.QtWidgets.QHeaderView.setSortIndicatorClearable(clearable)#

Parameters:: clearable – bool

See also

isSortIndicatorClearable()

Setter of property sortIndicatorClearable .

PySide6.QtWidgets.QHeaderView.setSortIndicatorShown(show)#

Parameters:: show – bool

See also

isSortIndicatorShown()

Setter of property showSortIndicator .

PySide6.QtWidgets.QHeaderView.setStretchLastSection(stretch)#

Parameters:: stretch – bool

See also

stretchLastSection()

Setter of property stretchLastSection .

PySide6.QtWidgets.QHeaderView.showSection(logicalIndex)#

Parameters:: logicalIndex – int

Shows the section specified by logicalIndex.

See also

hideSection() isSectionHidden() hiddenSectionCount() setSectionHidden()

PySide6.QtWidgets.QHeaderView.sortIndicatorChanged(logicalIndex, order)#

Parameters:

logicalIndex – int
order – SortOrder

This signal is emitted when the section containing the sort indicator or the order indicated is changed. The section’s logical index is specified by logicalIndex and the sort order is specified by order.

See also

setSortIndicator()

PySide6.QtWidgets.QHeaderView.sortIndicatorClearableChanged(clearable)#

Parameters:: clearable – bool

Notification signal of property sortIndicatorClearable .

PySide6.QtWidgets.QHeaderView.sortIndicatorOrder()#

Return type:: SortOrder

Returns the order for the sort indicator. If no section has a sort indicator the return value of this function is undefined.

See also

setSortIndicator() sortIndicatorSection()

PySide6.QtWidgets.QHeaderView.sortIndicatorSection()#

Return type:: int

Returns the logical index of the section that has a sort indicator. By default this is section 0.

See also

setSortIndicator() sortIndicatorOrder() setSortIndicatorShown()

PySide6.QtWidgets.QHeaderView.stretchLastSection()#

Return type:: bool

See also

setStretchLastSection()

Getter of property stretchLastSection .

PySide6.QtWidgets.QHeaderView.stretchSectionCount()#

Return type:: int

Returns the number of sections that are set to resize mode stretch. In views, this can be used to see if the headerview needs to resize the sections when the view’s geometry changes.

See also

stretchLastSection

PySide6.QtWidgets.QHeaderView.swapSections(first, second)#

Parameters:

first – int
second – int

Swaps the section at visual index first with the section at visual index second.

See also

moveSection()

PySide6.QtWidgets.QHeaderView.updateSection(logicalIndex)#

Parameters:: logicalIndex – int

PySide6.QtWidgets.QHeaderView.visualIndex(logicalIndex)#

Parameters:: logicalIndex – int
Return type:: int

Returns the visual index position of the section specified by the given logicalIndex, or -1 otherwise.

Hidden sections still have valid visual indexes.

See also

logicalIndex()

PySide6.QtWidgets.QHeaderView.visualIndexAt(position)#

Parameters:: position – int
Return type:: int

Returns the visual index of the section that covers the given position in the viewport.

See also

logicalIndexAt()