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

이 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

주어진 ` 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 이상이어야 합니다. 단, 크기를 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 는 섹션이 제거된 위치를 나타냅니다.

단 하나의 섹션만 제거된 경우, logicalFirst 와 logicalLast 는 동일합니다.

bool QHeaderView::sectionsClickable() const

secectionsClickable를 반환합니다.

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

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()도 참조하십시오 .