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 * 이벤트).

[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 위치에 있는 섹션의 논리 인덱스를 반환하거나 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 * 이벤트).

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

다시 구현합니다: QAbstractItemView::mouseMoveEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QAbstractItemView::mousePressEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QAbstractItemView::mouseReleaseEvent(QMouseEvent * 이벤트).

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 * 이벤트).

[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

ResizeToContents 에서 얼마나 정확한 QHeaderView 을 계산할 수 있는지 반환합니다.

setResizeContentsPrecision() 및 setSectionResizeMode()도 참조하세요 .

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

logicalIndex 에 지정된 섹션의 크기를 픽셀 단위로 측정한 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 는 섹션이 제거된 위치를 나타냅니다.

섹션이 하나만 제거된 경우 logicalFirst 및 logicalLast 은 동일합니다.

bool QHeaderView::sectionsClickable() const

섹션 클릭 가능을 반환합니다.

setSectionsClickable()도 참조하세요 .

bool QHeaderView::sectionsHidden() const

헤더의 섹션이 숨겨져 있으면 true 을 반환하고, 그렇지 않으면 false를 반환합니다;

setSectionHidden()도 참조하세요 .

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

이 슬롯은 섹션이 parent 에 삽입될 때 호출됩니다. logicalFirst 과 logicalLast 인덱스는 새 섹션이 삽입된 위치를 나타냅니다.

섹션이 하나만 삽입된 경우 logicalFirst 및 logicalLast 은 동일합니다.

bool QHeaderView::sectionsMovable() const

섹션Movable을 반환합니다.

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 은 숨겨진 섹션을 고려하지 않을 때 실제로 표시되는 섹션입니다. 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 이 참이면 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 에 따라 지정된 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

모드 스트레치 크기 조정으로 설정된 섹션의 수를 반환합니다. 뷰에서 뷰의 지오메트리가 변경될 때 머리글 뷰에서 섹션의 크기를 조정해야 하는지 확인하는 데 사용할 수 있습니다.

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 * 이벤트).

int QHeaderView::visualIndex(int logicalIndex) const

지정된 logicalIndex 으로 지정된 섹션의 시각적 인덱스 위치를 반환하거나 그렇지 않으면 -1을 반환합니다.

숨겨진 섹션에는 여전히 유효한 시각적 인덱스가 있습니다.

logicalIndex()도 참조하세요 .

int QHeaderView::visualIndexAt(int position) const

뷰포트에서 지정된 position 을 포함하는 섹션의 시각적 인덱스를 반환합니다.

logicalIndexAt()도 참조하세요 .