QHeaderView Class

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

メンバ関数ドキュメント

[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

このQHeaderView の値でoption を初期化する。このメソッドは、サブクラスが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

与えられたpainter とrect を用いて、与えられたlogicalIndex で指定されたセクションを描画する。

通常、この関数を呼び出す必要はない。

[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以上の値でなければならない。しかし、0に等しいサイズは推奨されない。そのような場合は、hideSection を代わりに使うべきである。

sectionResized()、sectionSize()、hideSection()も参照 。

[protected slot] void QHeaderView::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 この場合、ソートインジケータは表示されず、モデルはソートされていない自然な順序に戻ります。すべてのモデルがこれをサポートしているわけではなく、この場合クラッシュする可能性があることに注意してください。

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

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

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 で指定されたセクションのビジュアルインデックスの位置を返します。

非表示のセクションも有効なビジュアルインデックスを持ちます。

logicalIndex()も参照 。

int QHeaderView::visualIndexAt(int position) const

ビューポート内の指定されたposition をカバーするセクションのビジュアルインデックスを返す。

logicalIndexAt()も参照 。