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)

再実装： (const QModelIndex &current, const QModelIndex &previous)：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)

再リンプルメント: (QMouseEvent *event)QAbstractItemView::mousePressEvent(QMouseEvent *event).

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

再リンプルメント: (QMouseEvent *event)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 以上の値でなければならない。しかし、ゼロに等しいサイズは推奨されない。そのような場合には、代わりに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()も参照して ください。