QTableView Class

멤버 함수 설명서

[explicit] QTableView::QTableView(QWidget *parent = nullptr)

데이터를 표현하기 위해 parent 를 사용하는 테이블 뷰를 생성합니다.

QAbstractItemModel도 참조하십시오 .

[virtual noexcept] QTableView::~QTableView()

테이블 뷰를 제거합니다.

void QTableView::clearSpans()

테이블 뷰에서 모든 행 및 열 스팬을 제거합니다.

setSpan()도 참조하십시오 .

int QTableView::columnAt(int x) const

콘텐츠 좌표계에서 주어진 x 좌표 x 가 위치한 열을 반환합니다.

rowAt()함수도 참조하십시오 .

[protected slot] void QTableView::columnCountChanged(int oldCount, int newCount)

이 슬롯은 열이 추가되거나 삭제될 때마다 호출됩니다. 이전 열 수는 ` oldCount`로 지정되며, 새로운 열 수는 ` newCount`로 지정됩니다.

[protected slot] void QTableView::columnMoved(int column, int oldIndex, int newIndex)

이 슬롯은 테이블 뷰에서 지정된 ‘ column ’의 인덱스를 변경하기 위해 호출됩니다. 기존 인덱스는 ` oldIndex`로, 새로운 인덱스는 ` newIndex`로 지정됩니다.

rowMoved()도 참조하십시오 .

[protected slot] void QTableView::columnResized(int column, int oldWidth, int newWidth)

이 슬롯은 지정된 column 의 너비를 변경하기 위해 호출됩니다. 기존 너비는 oldWidth 로 지정되며, 새로운 너비는 newWidth 로 지정됩니다.

rowResized()도 참조하십시오 .

int QTableView::columnSpan(int row, int column) const

(row, column) 위치에 있는 테이블 요소의 열 스팬을 반환합니다. 기본값은 1입니다.

setSpan() 및 rowSpan()도 참조하십시오 .

int QTableView::columnViewportPosition(int column) const

지정된 ` column`의 콘텐츠 좌표계에서 x 좌표를 반환합니다.

int QTableView::columnWidth(int column) const

지정된 column 의 너비를 반환합니다.

setColumnWidth(), resizeColumnToContents(), rowHeight()도 참조하십시오 .

[override virtual protected] void QTableView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous)를 재구현합니다.

[override virtual protected] void QTableView::dropEvent(QDropEvent *event)

QAbstractItemView::dropEvent(QDropEvent *event)를 재구현합니다.

[slot] void QTableView::hideColumn(int column)

주어진 column 를 숨기십시오.

showColumn() 및 hideRow()도 참조하십시오 .

[slot] void QTableView::hideRow(int row)

주어진 row 를 숨기세요.

showRow() 및 hideColumn()도 참조하십시오 .

QHeaderView *QTableView::horizontalHeader() const

테이블 뷰의 가로 방향 헤더를 반환합니다.

setHorizontalHeader(), verticalHeader() 및 QAbstractItemModel::headerData()도 참조하십시오 .

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

QAbstractItemView::horizontalOffset() const를 재구현합니다.

테이블 뷰 내 항목들의 수평 오프셋을 반환합니다.

테이블 뷰는 수평 헤더 섹션의 위치를 사용하여 뷰 내 열의 위치를 결정한다는 점에 유의하십시오.

verticalOffset()도 참조하십시오 .

[override virtual] QModelIndex QTableView::indexAt(const QPoint &pos) const

QAbstractItemView::indexAt(const QPoint &point) const를 재구현합니다.

콘텐츠 좌표계에서 위치 pos 에 있는 테이블 항목에 해당하는 모델 항목의 인덱스 위치를 반환합니다.

[override virtual protected] void QTableView::initViewItemOption(QStyleOptionViewItem *option) const

QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const를 재구현합니다.

bool QTableView::isColumnHidden(int column) const

지정된 ` column `이 숨겨져 있으면 ` true `을 반환하고, 그렇지 않으면 ` false`을 반환합니다.

isRowHidden()도 참조하십시오 .

[override virtual protected] bool QTableView::isIndexHidden(const QModelIndex &index) const

QAbstractItemView::isIndexHidden(const QModelIndex &index) const를 재구현합니다.

bool QTableView::isRowHidden(int row) const

지정된 ` row `가 숨겨져 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

isColumnHidden()도 참조하십시오 .

[override virtual protected] QModelIndex QTableView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)를 재구현합니다.

modifiers 에서 제공하는 정보를 사용하여, 주어진 cursorAction 에 따라 커서를 이동합니다.

QAbstractItemView::CursorAction도 참조하십시오 .

[override virtual protected] void QTableView::paintEvent(QPaintEvent *event)

QAbstractScrollArea::paintEvent(QPaintEvent *event)를 재구현합니다.

지정된 페인트 이벤트 event 를 수신하면 테이블을 그립니다.

[slot] void QTableView::resizeColumnToContents(int column)

주어진 ` column `의 크기를, 열 내 각 항목을 렌더링하는 데 사용되는 델리게이트의 크기 힌트에 따라 조정합니다.

resizeColumnsToContents(), sizeHintForColumn(), QHeaderView::resizeContentsPrecision()도 참조하십시오 .

[slot] void QTableView::resizeColumnsToContents()

열에 있는 각 항목을 렌더링하는 데 사용되는 델리게이트의 크기 힌트를 기반으로 모든 열의 크기를 조정합니다.

resizeColumnToContents(), sizeHintForColumn() 및 QHeaderView::resizeContentsPrecision()도 참조하십시오 .

[slot] void QTableView::resizeRowToContents(int row)

행 내의 각 항목을 렌더링하는 데 사용되는 델리게이트의 크기 힌트를 기반으로, 지정된 ` row `의 크기를 조정합니다.

resizeRowsToContents(), sizeHintForRow() 및 QHeaderView::resizeContentsPrecision()도 참조하십시오 .

[slot] void QTableView::resizeRowsToContents()

행 내의 각 항목을 렌더링하는 데 사용되는 델리게이트의 크기 힌트를 기반으로 모든 행의 크기를 조정합니다.

resizeRowToContents(), sizeHintForRow() 및 QHeaderView::resizeContentsPrecision()도 참조하십시오 .

int QTableView::rowAt(int y) const

contents 좌표계에서 주어진 y 좌표 y 가 위치한 행을 반환합니다.

참조: columnAt().

[protected slot] void QTableView::rowCountChanged(int oldCount, int newCount)

이 슬롯은 행이 추가되거나 삭제될 때마다 호출됩니다. 이전 행 수는 ` oldCount`로 지정되며, 새로운 행 수는 ` newCount`로 지정됩니다.

int QTableView::rowHeight(int row) const

지정된 row 의 높이를 반환합니다.

setRowHeight(), resizeRowToContents(), columnWidth()도 참조하십시오 .

[protected slot] void QTableView::rowMoved(int row, int oldIndex, int newIndex)

이 슬롯은 테이블 뷰에서 지정된 row 의 인덱스를 변경하기 위해 호출됩니다. 기존 인덱스는 oldIndex 로, 새로운 인덱스는 newIndex 로 지정됩니다.

columnMoved()도 참조하십시오 .

[protected slot] void QTableView::rowResized(int row, int oldHeight, int newHeight)

이 슬롯은 주어진 row 의 높이를 변경하기 위해 호출됩니다. 이전 높이는 oldHeight 로 지정되며, 새로운 높이는 newHeight 로 지정됩니다.

columnResized()도 참조하십시오 .

int QTableView::rowSpan(int row, int column) const

(row, column) 위치에 있는 테이블 요소의 행 스팬을 반환합니다. 기본값은 1입니다.

setSpan() 및 columnSpan()도 참조하십시오 .

int QTableView::rowViewportPosition(int row) const

주어진 ` row`의 콘텐츠 좌표계에서 y 좌표를 반환합니다.

[override virtual protected] void QTableView::scrollContentsBy(int dx, int dy)

QAbstractScrollArea::scrollContentsBy(int dx, int dy)를 재구현합니다.

테이블 뷰의 내용을 (dx, dy)만큼 스크롤합니다.

[override virtual] void QTableView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint)를 재구현합니다.

주어진 index 가 테이블 뷰에 표시되도록 보장하며, 필요한 경우 스크롤을 수행합니다.

[slot] void QTableView::selectColumn(int column)

현재 SelectionMode 및 SelectionBehavior에서 열 선택을 허용하는 경우, 테이블 뷰에서 지정된 column 를 선택합니다.

selectRow()도 참조하십시오 .

[slot] void QTableView::selectRow(int row)

현재 SelectionMode 및 SelectionBehavior에서 행 선택이 허용되는 경우, 테이블 뷰에서 지정된 row 를 선택합니다.

selectColumn()도 참조하십시오 .

[override virtual protected] QModelIndexList QTableView::selectedIndexes() const

QAbstractItemView::selectedIndexes() const를 재구현합니다.

[override virtual protected] void QTableView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)를 재구현합니다.

void QTableView::setColumnHidden(int column, bool hide)

hide 가 true인 경우, 지정된 column 가 숨겨지며, 그렇지 않은 경우 표시됩니다.

isColumnHidden() 및 setRowHidden()도 참조하십시오 .

void QTableView::setColumnWidth(int column, int width)

지정된 ` column `의 너비를 ` width`로 설정합니다.

columnWidth()도 참조하십시오 .

void QTableView::setHorizontalHeader(QHeaderView *header)

수평 헤더에 사용할 위젯을 header 로 설정합니다.

horizontalHeader() 및 setVerticalHeader()도 참조하십시오 .

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

QAbstractItemView::setModel(QAbstractItemModel *model)을 재구현합니다.

[override virtual] void QTableView::setRootIndex(const QModelIndex &index)

QAbstractItemView::setRootIndex(const QModelIndex &index)를 재구현합니다.

void QTableView::setRowHeight(int row, int height)

지정된 ` row `의 높이를 ` height`로 설정합니다.

rowHeight()도 참조하십시오 .

void QTableView::setRowHidden(int row, bool hide)

hide 가 true인 경우 row 는 숨겨지고, 그렇지 않은 경우 표시됩니다.

isRowHidden() 및 setColumnHidden()도 참조하십시오 .

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

다음 함수를 재구현합니다: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

지정된 rect 범위 내에서, 지정된 선택 플래그 flags 에 따라 항목을 선택합니다.

[override virtual] void QTableView::setSelectionModel(QItemSelectionModel *selectionModel)

QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)을 재구현합니다.

void QTableView::setSortingEnabled(bool enable)

enable 가 true인 경우, 테이블에 대한 정렬을 활성화하고 현재 정렬 섹션 및 순서를 사용하여 sortByColumn() 호출을 즉시 트리거합니다.

isSortingEnabled()도 참조하십시오 .

void QTableView::setSpan(int row, int column, int rowSpanCount, int columnSpanCount)

(row, column)에 있는 테이블 요소의 범위를 (rowSpanCount, columnSpanCount)로 지정된 행과 열의 수로 설정합니다.

rowSpan() 및 columnSpan()도 참조하십시오 .

void QTableView::setVerticalHeader(QHeaderView *header)

수직 헤더에 사용할 위젯을 header 로 설정합니다.

verticalHeader() 및 setHorizontalHeader()도 참조하십시오 .

[slot] void QTableView::showColumn(int column)

주어진 column 를 보여주세요.

hideColumn() 및 showRow()도 참조하십시오 .

[slot] void QTableView::showRow(int row)

주어진 row 를 보여주세요.

hideRow() 및 showColumn()도 참조하십시오 .

[override virtual protected] int QTableView::sizeHintForColumn(int column) const

QAbstractItemView::sizeHintForColumn(int column) const를 재구현합니다.

지정된 column 의 너비에 대한 크기 힌트를 반환하거나, 모델이 없는 경우 -1을 반환합니다.

주어진 열의 너비를 고정 값으로 설정해야 하는 경우, 테이블의 가로 헤더에서 QHeaderView::resizeSection()을 호출하십시오.

서브클래스에서 이 함수를 재구현하는 경우, 반환하는 값은 resizeColumnToContents() 또는 QHeaderView::resizeSections()이 호출될 때 사용된다는 점에 유의하십시오. 가로 헤더나 항목 델리게이트 중 하나에서 더 넓은 열 너비가 필요한 경우, 더 넓은 너비가 대신 사용됩니다.

QWidget::sizeHint, horizontalHeader() 및 QHeaderView::resizeContentsPrecision()도 참조하십시오 .

[override virtual protected] int QTableView::sizeHintForRow(int row) const

QAbstractItemView::sizeHintForRow(int row) const를 재구현합니다.

주어진 row 의 높이에 대한 크기 힌트를 반환하거나, 모델이 없는 경우 -1을 반환합니다.

주어진 행의 높이를 고정된 값으로 설정해야 하는 경우, 테이블의 수직 헤더에서 QHeaderView::resizeSection()를 호출하십시오.

서브클래스에서 이 함수를 재구현하는 경우, 반환하는 값은 resizeRowToContents()이 호출될 때만 사용된다는 점에 유의하십시오. 이 경우, 세로 헤더나 항목 델리게이트 중 하나에서 더 큰 행 높이가 필요한 경우, 대신 해당 너비가 사용됩니다.

QWidget::sizeHint, verticalHeader() 및 QHeaderView::resizeContentsPrecision()도 참조하십시오 .

[slot] void QTableView::sortByColumn(int column, Qt::SortOrder order)

지정된 ` column ` 및 ` order`의 값을 기준으로 모델을 정렬합니다.

column -1일 수 있으며, 이 경우 정렬 표시기가 표시되지 않고 모델은 정렬되지 않은 원래 순서로 돌아갑니다. 모든 모델이 이 기능을 지원하는 것은 아니며, 이 경우 프로그램이 중단될 수도 있습니다.

sortingEnabled도 참조하십시오 .

[override virtual protected] void QTableView::timerEvent(QTimerEvent *event)

QAbstractItemView::timerEvent(QTimerEvent *event)를 재구현합니다.

[override virtual protected] void QTableView::updateGeometries()

QAbstractItemView::updateGeometries()를 재구현합니다.

QHeaderView *QTableView::verticalHeader() const

테이블 뷰의 세로 방향 헤더를 반환합니다.

setVerticalHeader(), horizontalHeader() 및 QAbstractItemModel::headerData()도 참조하십시오 .

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

QAbstractItemView::verticalOffset() const를 재구현합니다.

테이블 뷰 내 항목들의 수직 오프셋을 반환합니다.

테이블 뷰는 수직 헤더 섹션의 위치를 사용하여 뷰 내 행의 위치를 결정한다는 점에 유의하십시오.

horizontalOffset()도 참조하십시오 .

[override virtual protected] QSize QTableView::viewportSizeHint() const

QAbstractItemView::viewportSizeHint() const를 재구현합니다.

[override virtual] QRect QTableView::visualRect(const QModelIndex &index) const

QAbstractItemView::visualRect(const QModelIndex &index) const를 재구현합니다.

주어진 index 가 뷰포트에서 차지하는 직사각형을 반환합니다. 인덱스가 뷰에서 숨겨져 있는 경우 null QRect 을 반환합니다.

[override virtual protected] QRegion QTableView::visualRegionForSelection(const QItemSelection &selection) const

QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const를 재구현합니다.

주어진 selection 내 항목들의 뷰포트에서 사각형을 반환합니다.

4.7 버전부터 반환되는 영역에는 뷰포트와 교차하거나 뷰포트에 포함된 사각형만 포함됩니다.