QHeaderView Class

メンバ関数のドキュメント

[explicit] QHeaderView::QHeaderView(Qt::Orientation orientation, QWidget *parent = nullptr)

指定されたorientation およびparent を用いて、新しい汎用ヘッダーを作成します。

[virtual noexcept] QHeaderView::~QHeaderView()

ヘッダーを削除します。

int QHeaderView::count() const

ヘッダー内のセクション数を返します。

sectionCountChanged() およびlength()も参照してください 。

[override virtual protected] void QHeaderView::currentChanged(const QModelIndex &current, const QModelIndex &old)

QAbstractItemView::currentChanged （const QModelIndex &current, const QModelIndex &previous）を再実装します。

[override virtual protected] bool QHeaderView::event(QEvent *e)

QAbstractItemView::event(QEvent *event) を再実装します。

[signal] void QHeaderView::geometriesChanged()

このシグナルは、ヘッダーのジオメトリが変更されたときに発信されます。

[slot] void QHeaderView::headerDataChanged(Qt::Orientation orientation, int logicalFirst, int logicalLast)

指定されたorientation （logicalFirst からlogicalLast までを含む）を使用して、変更されたヘッダーセクションを更新します。

int QHeaderView::hiddenSectionCount() const

ヘッダー内で非表示にされているセクションの数を返します。

setSectionHidden() およびisSectionHidden()も参照してください 。

void QHeaderView::hideSection(int logicalIndex)

logicalIndex で指定されたセクションを非表示にします。

showSection()、isSectionHidden()、hiddenSectionCount()、およびsetSectionHidden()も参照してください 。

[override virtual protected] int QHeaderView::horizontalOffset() const

QAbstractItemView::horizontalOffset() const を再実装します。

ヘッダーの水平方向のオフセットを返します。垂直方向のヘッダーの場合は 0 になります。

offset()も参照してください 。

[virtual protected] void QHeaderView::initStyleOption(QStyleOptionHeader *option) const

option を、QHeaderView の値を用いて初期化します。この方法は、サブクラスがQStyleOptionHeader が必要であるものの、すべての情報を自分で入力したくない場合に役立ちます。

QStyleOption::initFrom() およびinitStyleOptionForIndex()も参照してください 。

[virtual protected, since 6.0] void QHeaderView::initStyleOptionForIndex(QStyleOptionHeader *option, int logicalIndex) const

指定されたlogicalIndex から、スタイルoption を初期化します。この関数は、initStyleOption が呼び出された後、paintSection のデフォルト実装によって呼び出されます。

この関数は Qt 6.0 で導入されました。

paintSection() およびinitStyleOption()も参照してください 。

bool QHeaderView::isSectionHidden(int logicalIndex) const

logicalIndex で指定されたセクションがユーザーに対して明示的に非表示にされている場合はtrue を返し、そうでない場合はfalse を返します。

hideSection()、showSection()、setSectionHidden()、およびhiddenSectionCount()も参照してください 。

int QHeaderView::length() const

ヘッダーの向きに沿った長さを返します。

sizeHint()、setSectionResizeMode()、およびoffset()も参照してください 。

int QHeaderView::logicalIndex(int visualIndex) const

指定されたvisualIndex の位置にあるセクションのlogicalIndexを返します。visualIndex が0未満の場合、またはvisualIndex がQHeaderView::count()以上である場合は-1を返します。

なお、visualIndex は非表示のセクションの影響を受けないことに注意してください。

visualIndex() およびsectionPosition()も参照してください 。

int QHeaderView::logicalIndexAt(const QPoint &pos) const

pos で指定された位置にあるセクションの論理インデックスを返します。ヘッダーが水平方向にある場合は x 座標が、それ以外の場合は y 座標が、論理インデックスの特定に使用されます。

sectionPosition()も参照してください 。

int QHeaderView::logicalIndexAt(int position) const

ビューポート内で、指定されたposition をカバーするセクションを返します。

visualIndexAt() およびisSectionHidden()も参照してください 。

int QHeaderView::logicalIndexAt(int x, int y) const

指定された座標にあるセクションの論理インデックスを返します。ヘッダーが水平方向の場合は `x ` が使用され、それ以外の場合は `y ` を使用して論理インデックスが求められます。

[override virtual protected] void QHeaderView::mouseDoubleClickEvent(QMouseEvent *e)

QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event) を再実装します。

[override virtual protected] void QHeaderView::mouseMoveEvent(QMouseEvent *e)

QAbstractItemView::mouseMoveEvent(QMouseEvent *event) を再実装します。

[override virtual protected] void QHeaderView::mousePressEvent(QMouseEvent *e)

QAbstractItemView::mousePressEvent(QMouseEvent *event) を再実装します。

[override virtual protected] void QHeaderView::mouseReleaseEvent(QMouseEvent *e)

QAbstractItemView::mouseReleaseEvent(QMouseEvent *event) を再実装します。

void QHeaderView::moveSection(int from, int to)

視覚インデックスfrom にあるセクションを、視覚インデックスto に移動させます。

sectionsMoved()も参照してください 。

int QHeaderView::offset() const

ヘッダーのオフセットを返します。これは、ヘッダーの左端（縦方向のヘッダーの場合は最上部）にある、画面上に表示されているピクセルです。

setOffset()も参照してください 。

Qt::Orientation QHeaderView::orientation() const

ヘッダーの向きを返します。

Qt::Orientationも参照してください 。

[override virtual protected] void QHeaderView::paintEvent(QPaintEvent *e)

QAbstractScrollArea::paintEvent(QPaintEvent *event) を再実装します。

[virtual protected] void QHeaderView::paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const

指定されたlogicalIndex で指定されたセクションを、指定されたpainter およびrect を使用して描画します。

通常、この関数を呼び出す必要はありません。

[override virtual] void QHeaderView::reset()

QAbstractItemView::reset() を再実装します。

int QHeaderView::resizeContentsPrecision() const

`QHeaderView ` が `ResizeToContents` に対してどの程度の精度で計算を行うかを返します。

setResizeContentsPrecision() およびsetSectionResizeMode()も参照してください 。

void QHeaderView::resizeSection(int logicalIndex, int size)

logicalIndex で指定されたセクションのサイズを、size ピクセル単位で変更します。size パラメータの値は 0 以上でなければなりません。ただし、size を 0 に設定することは推奨されません。その場合は、代わりにhideSection を使用してください。

sectionResized()、sectionSize()、およびhideSection()も参照してください 。

[protected slot] void QHeaderView::resizeSections()

サイズヒントに基づいてセクションのサイズを変更します。通常、この関数を呼び出す必要はありません。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        headerView, qOverload<>(&QHeaderView::resizeSections));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        headerView, [receiver = headerView]() { receiver->resizeSections(); });

void QHeaderView::resizeSections(QHeaderView::ResizeMode mode)

現在のリサイズモードを無視し、指定されたmode に従ってセクションのサイズを変更します。

sectionResized()も参照してください 。

bool QHeaderView::restoreState(const QByteArray &state)

このヘッダービューのstate を復元します。この関数は、状態が復元された場合はtrue を返し、そうでない場合はfalseを返します。

saveState()も参照してください 。

QByteArray QHeaderView::saveState() const

このヘッダービューの現在の状態を保存します。

保存した状態を復元するには、戻り値をrestoreState()に渡してください。

restoreState()も参照してください 。

[signal] void QHeaderView::sectionClicked(int logicalIndex)

このシグナルは、セクションがクリックされたときに発火します。セクションの論理インデックスは、logicalIndex で指定されます。

なお、sectionPressed シグナルも同様に発火することに注意してください。

setSectionsClickable() およびsectionPressed()も参照してください 。

[signal] void QHeaderView::sectionCountChanged(int oldCount, int newCount)

このシグナルは、セクションの数に変化があった場合、つまりセクションが追加または削除された場合に発行されます。元のセクション数は `oldCount` で指定され、新しいセクション数は `newCount` で指定されます。

count()、length()、およびheaderDataChanged()も参照してください 。

[signal] void QHeaderView::sectionDoubleClicked(int logicalIndex)

このシグナルは、セクションがダブルクリックされたときに発生します。セクションの論理インデックスは、logicalIndex で指定されます。

setSectionsClickable()も参照してください 。

[signal] void QHeaderView::sectionEntered(int logicalIndex)

このシグナルは、カーソルがセクション上を移動し、マウスの左ボタンが押されたときに発生します。セクションの論理インデックスは、logicalIndex で指定されます。

setSectionsClickable() およびsectionPressed()も参照してください 。

[signal] void QHeaderView::sectionHandleDoubleClicked(int logicalIndex)

このシグナルは、セクションがダブルクリックされたときに発生します。セクションの論理インデックスは、logicalIndex で指定されます。

setSectionsClickable()も参照してください 。

[signal] void QHeaderView::sectionMoved(int logicalIndex, int oldVisualIndex, int newVisualIndex)

このシグナルは、セクションが移動されたときに発火します。セクションの論理インデックスは `logicalIndex` で指定され、以前のインデックスは `oldVisualIndex` で、新しいインデックス位置は `newVisualIndex` で指定されます。

moveSection()も参照してください 。

int QHeaderView::sectionPosition(int logicalIndex) const

指定されたlogicalIndex のセクション位置を返します。セクションが非表示の場合は-1を返します。位置は、最初に表示される項目の左上隅から、logicalIndex が設定された項目の左上隅までの距離（ピクセル単位）で測定されます。水平ヘッダーの場合はx軸に沿って、垂直ヘッダーの場合はy軸に沿って測定されます。

sectionViewportPosition()も参照してください 。

[signal] void QHeaderView::sectionPressed(int logicalIndex)

このシグナルは、セクションが押されたときに発せられます。セクションの論理インデックスは、logicalIndex で指定されます。

setSectionsClickable()も参照してください 。

QHeaderView::ResizeMode QHeaderView::sectionResizeMode(int logicalIndex) const

指定されたlogicalIndex で指定されたセクションに適用されるリサイズモードを返します。

setSectionResizeMode()も参照してください 。

[signal] void QHeaderView::sectionResized(int logicalIndex, int oldSize, int newSize)

このシグナルは、セクションのサイズが変更されたときに発生します。セクションの論理番号は `logicalIndex` で指定され、以前のサイズは `oldSize` で、新しいサイズは `newSize` で指定されます。

resizeSection()も参照してください 。

int QHeaderView::sectionSize(int logicalIndex) const

指定されたlogicalIndex の幅（縦方向のヘッダーの場合は高さ）を返します。

length()、setSectionResizeMode()、およびdefaultSectionSize()も参照してください 。

[virtual protected] QSize QHeaderView::sectionSizeFromContents(int logicalIndex) const

指定されたlogicalIndex で指定されたセクションの内容のサイズを返します。

defaultSectionSize()も参照してください 。

int QHeaderView::sectionSizeHint(int logicalIndex) const

logicalIndex で指定されたセクションに対して、適切なサイズヒントを返します。

Qt::SizeHintRole

sizeHint()、defaultSectionSize()、minimumSectionSize()、およびmaximumSectionSize()も参照してください 。

int QHeaderView::sectionViewportPosition(int logicalIndex) const

指定されたlogicalIndex のセクションビューポートの位置を返します。

セクションが非表示の場合、戻り値は未定義となります。

sectionPosition() およびisSectionHidden()も参照してください 。

[protected slot] void QHeaderView::sectionsAboutToBeRemoved(const QModelIndex &parent, int logicalFirst, int logicalLast)

このスロットは、parent からセクションが削除された際に呼び出されます。logicalFirst およびlogicalLast は、セクションが削除された箇所を示します。

削除されたセクションが 1 つだけの場合は、logicalFirst とlogicalLast は同じ値になります。

bool QHeaderView::sectionsClickable() const

sectionsClickable を返します。

関連項目： setSectionsClickable()。

bool QHeaderView::sectionsHidden() const

ヘッダー内のセクションが非表示になっている場合は `true ` を返し、そうでない場合は `false` を返します。

setSectionHidden()も参照してください 。

[protected slot] void QHeaderView::sectionsInserted(const QModelIndex &parent, int logicalFirst, int logicalLast)

このスロットは、parent にセクションが挿入された際に呼び出されます。logicalFirst およびlogicalLast のインデックスは、新しいセクションが挿入された位置を示します。

セクションが1つだけ挿入された場合、logicalFirst とlogicalLast は同じ値になります。

bool QHeaderView::sectionsMovable() const

sectionsMovable を返します。

関連項目： setSectionsMovable()。

bool QHeaderView::sectionsMoved() const

ヘッダー内のセクションが移動された場合は `true ` を返し、そうでない場合は `false` を返します。

moveSection()も参照してください 。

[override virtual] void QHeaderView::setModel(QAbstractItemModel *model)

QAbstractItemView::setModel(QAbstractItemModel *model) を再実装します。

[slot] void QHeaderView::setOffset(int offset)

ヘッダーのオフセットをoffset に設定します。

offset() およびlength()も参照してください 。

[slot] void QHeaderView::setOffsetToLastSection()

最後のセクションが表示されるようにオフセットを設定します。

setOffset()、sectionPosition()、およびsetOffsetToSectionPosition()も参照してください 。

[slot] void QHeaderView::setOffsetToSectionPosition(int visualSectionNumber)

指定されたvisualSectionNumber におけるセクションの先頭までのオフセットを設定します。visualSectionNumber は、hiddenSectionsを考慮しない場合の実際に表示されるセクションです。これは、必ずしもvisualIndex()の結果と同じとは限りません。

setOffset() およびsectionPosition()も参照してください 。

void QHeaderView::setResizeContentsPrecision(int precision)

ResizeToContents が使用される際、QHeaderView がサイズをどの程度正確に計算するかを設定します。値を小さくすると、精度は低下しますが自動リサイズが高速に行われ、値を大きくすると精度は高くなりますが、処理に時間がかかる場合があります。

precision で指定する数値は、推奨サイズを計算する際に考慮すべきセクションの数を示します。

デフォルト値は 1000 であり、これは自動リサイズが設定された水平カラムが、自動リサイズを行う際の計算において最大 1000 行を対象とすることを意味します。

特別な値「0」は、表示領域のみを対象とすることを意味します。特別な値「-1」は、すべての要素を対象とすることを意味します。

この値は、QTableView::sizeHintForColumn()、QTableView::sizeHintForRow()、およびQTreeView::sizeHintForColumn() で使用されます。これらの関数を再実装すると、この関数の効果が無効になる場合があります。

resizeContentsPrecision()、setSectionResizeMode()、resizeSections()、QTableView::sizeHintForColumn()、QTableView::sizeHintForRow()、およびQTreeView::sizeHintForColumn()も参照してください 。

void QHeaderView::setSectionHidden(int logicalIndex, bool hide)

hide が true の場合、logicalIndex で指定されたセクションは非表示になります。そうでない場合は、そのセクションが表示されます。

isSectionHidden() およびhiddenSectionCount()も参照してください 。

void QHeaderView::setSectionResizeMode(QHeaderView::ResizeMode mode)

ヘッダーのサイズ変更に関する制約を、指定されたmode で記述されている内容に設定します。

sectionResizeMode()、length()、およびsectionResized()も参照してください 。

void QHeaderView::setSectionResizeMode(int logicalIndex, QHeaderView::ResizeMode mode)

ヘッダー内の `logicalIndex ` で指定されたセクションのサイズ変更に関する制約を、指定された `mode` で記述されたものに変更します。この関数が呼び出される時点で、論理インデックスが存在している必要があります。

関連項目: setStretchLastSection() およびresizeContentsPrecision()。

void QHeaderView::setSectionsClickable(bool clickable)

sectionsClickable をclickable に設定します。

sectionsClickable()も参照してください 。

void QHeaderView::setSectionsMovable(bool movable)

sectionsMovable をmovable に設定します。

sectionsMovable()も参照してください 。

[override virtual protected] void QHeaderView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags) を再実装します。

指定されたflags に従って、指定されたrect 内の項目を選択します。

基底クラスの実装では何も行われません。

void QHeaderView::setSortIndicator(int logicalIndex, Qt::SortOrder order)

指定されたlogicalIndex で指定されたセクションのソートインジケータを、order で指定された方向に設定し、ソートインジケータが表示されていた他のすべてのセクションからそれを削除します。

logicalIndex 引数として -1 を指定した場合、ソートインジケータは表示されず、モデルは元のソートされていない順序に戻ります。なお、すべてのモデルがこの機能をサポートしているわけではなく、この場合にクラッシュする可能性もある点に注意してください。

sortIndicatorSection() およびsortIndicatorOrder()も参照してください 。

[override virtual] void QHeaderView::setVisible(bool v)

プロパティ `QWidget::visible` のアクセス関数を再実装します。

void QHeaderView::showSection(int logicalIndex)

logicalIndex で指定されたセクションを表示します。

hideSection()、isSectionHidden()、hiddenSectionCount()、およびsetSectionHidden()も参照してください 。

[override virtual] QSize QHeaderView::sizeHint() const

QAbstractScrollArea::sizeHint() const を再実装します。

このヘッダーに適したサイズヒントを返します。

sectionSizeHint()も参照してください 。

[signal] void QHeaderView::sortIndicatorChanged(int logicalIndex, Qt::SortOrder order)

このシグナルは、ソートインジケータを含むセクション、または指定された順序が変更されたときに発せられます。セクションの論理インデックスは `logicalIndex ` で指定され、ソート順は `order` で指定されます。

setSortIndicator()も参照してください 。

Qt::SortOrder QHeaderView::sortIndicatorOrder() const

ソートインジケータの順序を返します。ソートインジケータが設定されているセクションがない場合、この関数の戻り値は未定義となります。

setSortIndicator() およびsortIndicatorSection()も参照してください 。

int QHeaderView::sortIndicatorSection() const

ソートインジケータが設定されているセクションの論理インデックスを返します。デフォルトでは、これはセクション 0 です。

setSortIndicator()、sortIndicatorOrder()、およびsetSortIndicatorShown()も参照してください 。

int QHeaderView::stretchSectionCount() const

「stretch」リサイズモードに設定されているセクションの数を返します。ビューでは、ビューのジオメトリが変更された際に、ヘッダービューがセクションのサイズを変更する必要があるかどうかを確認するためにこれを使用できます。

stretchLastSectionも参照してください 。

void QHeaderView::swapSections(int first, int second)

視覚インデックスfirst のセクションと、視覚インデックスsecond のセクションを入れ替えます。

moveSection()も参照してください 。

[override virtual protected] int QHeaderView::verticalOffset() const

再実装：QAbstractItemView::verticalOffset() const。

ヘッダーの垂直方向のオフセットを返します。水平方向のヘッダーの場合は 0 になります。

offset()も参照してください 。

[override virtual protected] bool QHeaderView::viewportEvent(QEvent *e)

QAbstractItemView::viewportEvent(QEvent *event) を再実装しています。

int QHeaderView::visualIndex(int logicalIndex) const

指定されたlogicalIndex で示されるセクションのビジュアルインデックスの位置を返します。それ以外の場合は-1を返します。

非表示のセクションでも、ビジュアルインデックスは有効です。

logicalIndex()も参照してください 。

int QHeaderView::visualIndexAt(int position) const

ビューポート内で、指定されたposition を覆うセクションのビジュアルインデックスを返します。

logicalIndexAt()も参照してください 。