QTableWidget Class

멤버 함수 문서

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

지정된 ` parent`를 사용하여 새로운 테이블 뷰를 생성합니다.

QTableWidget::QTableWidget(int rows, int columns, QWidget *parent = nullptr)

지정된 ` rows ` 및 ` columns`과, 지정된 ` parent`을 사용하여 새로운 테이블 뷰를 생성합니다.

[virtual noexcept] QTableWidget::~QTableWidget()

QTableWidget 를 삭제합니다.

[signal] void QTableWidget::cellActivated(int row, int column)

row 및 column 로 지정된 셀이 활성화되면 이 신호가 전송됩니다.

[signal] void QTableWidget::cellChanged(int row, int column)

row 와 column 로 지정된 셀에 있는 항목의 데이터가 변경될 때마다 이 신호가 발생합니다.

[signal] void QTableWidget::cellClicked(int row, int column)

이 신호는 테이블의 셀을 클릭할 때마다 발생합니다. 지정된 ` row ` 및 ` column `는 클릭된 셀을 나타냅니다.

[signal] void QTableWidget::cellDoubleClicked(int row, int column)

이 신호는 테이블의 셀을 더블 클릭할 때마다 발생합니다. 지정된 ` row ` 및 ` column `는 더블 클릭된 셀을 가리킵니다.

[signal] void QTableWidget::cellEntered(int row, int column)

이 신호는 마우스 커서가 셀에 진입할 때 발생합니다. 해당 셀은 ` row ` 및 ` column`로 지정됩니다.

이 신호는 mouseTracking이 켜져 있거나, 항목 안으로 이동하는 중에 마우스 버튼이 눌렸을 때만 발생합니다.

[signal] void QTableWidget::cellPressed(int row, int column)

이 신호는 테이블의 셀을 누를 때마다 발생합니다. 지정된 row 및 column 은 누른 셀을 나타냅니다.

QWidget *QTableWidget::cellWidget(int row, int column) const

지정된 ` row ` 및 ` column`에 있는 셀에 표시된 위젯을 반환합니다.

참조: setCellWidget().

[slot] void QTableWidget::clear()

뷰에 있는 모든 항목을 제거합니다. 이 경우 선택된 항목과 헤더도 모두 제거됩니다. 헤더를 제거하지 않으려면 ` QTableWidget::clearContents()`를 사용하십시오. 테이블의 크기는 그대로 유지됩니다.

[slot] void QTableWidget::clearContents()

헤더에 포함되지 않은 모든 항목을 뷰에서 제거합니다. 이 작업으로 선택된 항목도 모두 제거됩니다. 테이블의 크기는 그대로 유지됩니다.

void QTableWidget::closePersistentEditor(QTableWidgetItem *item)

item 의 상주 편집기를 닫습니다.

openPersistentEditor() 및 isPersistentEditorOpen()도 참조하십시오 .

int QTableWidget::column(const QTableWidgetItem *item) const

item 에 해당하는 열을 반환합니다.

int QTableWidget::columnCount() const

열의 개수를 반환합니다.

setColumnCount()도 참조하십시오 .

[signal] void QTableWidget::currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn)

이 신호는 현재 셀이 변경될 때마다 발생합니다. previousRow 및 previousColumn 로 지정된 셀은 이전에 포커스가 맞춰져 있던 셀이며, currentRow 및 currentColumn 로 지정된 셀은 새로운 현재 셀입니다.

int QTableWidget::currentColumn() const

현재 항목의 열을 반환합니다.

currentRow() 및 setCurrentCell()도 참조하십시오 .

QTableWidgetItem *QTableWidget::currentItem() const

현재 항목을 반환합니다.

setCurrentItem()도 참조하십시오 .

[signal] void QTableWidget::currentItemChanged(QTableWidgetItem *current, QTableWidgetItem *previous)

이 신호는 현재 항목이 변경될 때마다 발생합니다. ‘ previous ’ 항목은 이전에 포커스가 있던 항목이며, ‘ current ’는 새로운 현재 항목입니다.

int QTableWidget::currentRow() const

현재 항목의 행을 반환합니다.

currentColumn() 및 setCurrentCell()도 참조하십시오 .

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

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

[virtual protected] bool QTableWidget::dropMimeData(int row, int column, const QMimeData *data, Qt::DropAction action)

지정된 row 및 column 내에서 지정된 action 으로 종료된 드래그 앤 드롭 작업에서 제공된 data 를 처리합니다. 모델이 데이터와 작업을 처리할 수 있는 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

supportedDropActions() 및 supportedDragActions도 참조하십시오 .

void QTableWidget::editItem(QTableWidgetItem *item)

item 파일이 편집 가능한 경우, 해당 파일의 편집을 시작합니다.

[override virtual protected] bool QTableWidget::event(QEvent *e)

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

QList<QTableWidgetItem *> QTableWidget::findItems(const QString &text, Qt::MatchFlags flags) const

지정된 ` flags`를 사용하여 ` text `와 일치하는 항목을 찾습니다.

QTableWidgetItem *QTableWidget::horizontalHeaderItem(int column) const

column 에 해당하는 열의 가로 헤더 항목을 반환합니다(설정된 경우). 그렇지 않은 경우 nullptr 를 반환합니다.

setHorizontalHeaderItem()도 참조하십시오 .

QModelIndex QTableWidget::indexFromItem(const QTableWidgetItem *item) const

주어진 item 와 연관된 QModelIndex 를 반환합니다.

[slot] void QTableWidget::insertColumn(int column)

column 에 있는 테이블에 빈 열을 삽입합니다.

[slot] void QTableWidget::insertRow(int row)

row 에 있는 테이블에 빈 행을 삽입합니다.

bool QTableWidget::isPersistentEditorOpen(QTableWidgetItem *item) const

항목 item 에 대해 영구 편집기가 열려 있는지 여부를 반환합니다.

openPersistentEditor() 및 closePersistentEditor()도 참조하십시오 .

QTableWidgetItem *QTableWidget::item(int row, int column) const

지정된 row 및 column 에 해당하는 항목을 반환합니다(해당 값이 설정된 경우). 그렇지 않은 경우 nullptr 를 반환합니다.

setItem()도 참조하십시오 .

[signal] void QTableWidget::itemActivated(QTableWidgetItem *item)

이 신호는 지정된 item 가 활성화된 경우 발신됩니다.

QTableWidgetItem *QTableWidget::itemAt(const QPoint &point) const

지정된 point 에 있는 항목에 대한 포인터를 반환하거나, point 가 테이블 위젯의 항목에 포함되지 않은 경우 nullptr 를 반환합니다.

item()도 참조하십시오 .

QTableWidgetItem *QTableWidget::itemAt(int ax, int ay) const

테이블 위젯의 좌표계에서 QPoint(ax, ay)에 해당하는 위치의 항목을 반환하거나, 지정된 점이 테이블 위젯의 항목 범위에 포함되지 않는 경우 nullptr 를 반환합니다.

item()도 참조하십시오 .

[signal] void QTableWidget::itemChanged(QTableWidgetItem *item)

item 의 데이터가 변경될 때마다 이 신호가 발생합니다.

[signal] void QTableWidget::itemClicked(QTableWidgetItem *item)

테이블 내의 항목을 클릭할 때마다 이 신호가 발생합니다. 지정된 ` item `는 클릭된 항목을 나타냅니다.

[signal] void QTableWidget::itemDoubleClicked(QTableWidgetItem *item)

테이블의 항목을 더블 클릭할 때마다 이 신호가 발생합니다. 지정된 ` item `는 더블 클릭된 항목입니다.

[signal] void QTableWidget::itemEntered(QTableWidgetItem *item)

이 신호는 마우스 커서가 항목에 진입할 때 발생합니다. ` item `는 진입한 항목을 나타냅니다.

이 신호는 mouseTracking이 켜져 있거나, 항목으로 이동하는 도중에 마우스 버튼이 눌렸을 때만 발생합니다.

QTableWidgetItem *QTableWidget::itemFromIndex(const QModelIndex &index) const

주어진 ` index`와 연관된 ` QTableWidgetItem `에 대한 포인터를 반환합니다.

[signal] void QTableWidget::itemPressed(QTableWidgetItem *item)

이 신호는 테이블의 항목이 눌릴 때마다 발생합니다. 지정된 ` item `는 눌린 항목을 나타냅니다.

const QTableWidgetItem *QTableWidget::itemPrototype() const

테이블에서 사용하는 항목 프로토타입을 반환합니다.

setItemPrototype()도 참조하십시오 .

[signal] void QTableWidget::itemSelectionChanged()

이 신호는 선택 항목이 변경될 때마다 발생합니다.

selectedItems() 및 QTableWidgetItem::isSelected()도 참조하십시오 .

QList<QTableWidgetItem *> QTableWidget::items(const QMimeData *data) const

data 객체에 포함된 항목들에 대한 포인터 목록을 반환합니다. 해당 객체가 동일한 프로세스 내의 QTreeWidget 에 의해 생성되지 않은 경우, 목록은 비어 있습니다.

[virtual protected] QMimeData *QTableWidget::mimeData(const QList<QTableWidgetItem *> &items) const

지정된 items 에 대한 직렬화된 설명을 포함하는 객체를 반환합니다. 항목을 설명하는 데 사용되는 형식은 mimeTypes() 함수에서 가져옵니다.

항목 목록이 비어 있는 경우, 직렬화된 빈 목록 대신 nullptr 가 반환됩니다.

[virtual protected] QStringList QTableWidget::mimeTypes() const

테이블 위젯 항목 목록을 설명하는 데 사용할 수 있는 MIME 유형 목록을 반환합니다.

mimeData()도 참조하십시오 .

void QTableWidget::openPersistentEditor(QTableWidgetItem *item)

지정된 item 에 대한 편집기를 엽니다. 편집이 끝난 후에도 편집기는 계속 열려 있습니다.

closePersistentEditor() 및 isPersistentEditorOpen()도 참조하십시오 .

void QTableWidget::removeCellWidget(int row, int column)

row 및 column 로 지정된 셀에 설정된 위젯을 제거합니다.

[slot] void QTableWidget::removeColumn(int column)

테이블에서 ‘ column ’ 열과 해당 열의 모든 항목을 제거합니다.

[slot] void QTableWidget::removeRow(int row)

테이블에서 행 ‘ row ’과 해당 행의 모든 항목을 제거합니다.

int QTableWidget::row(const QTableWidgetItem *item) const

item 에 해당하는 행을 반환합니다.

int QTableWidget::rowCount() const

행의 개수를 반환합니다.

참조: ` setRowCount()` 함수.

[slot] void QTableWidget::scrollToItem(const QTableWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

필요한 경우 뷰를 스크롤하여 ‘ item ’이 보이도록 합니다. ‘ hint ’ 매개변수는 작업이 완료된 후 ‘ item ’이 위치해야 할 위치를 더 정확하게 지정합니다.

QList<QTableWidgetItem *> QTableWidget::selectedItems() const

선택된 모든 항목의 목록을 반환합니다.

이 함수는 선택된 셀의 내용에 대한 포인터 목록을 반환합니다. 빈 셀을 포함한 전체 선택 범위를 가져오려면 selectedIndexes() 함수를 사용하십시오.

selectedIndexes()도 참조하십시오 .

QList<QTableWidgetSelectionRange> QTableWidget::selectedRanges() const

선택된 모든 범위의 목록을 반환합니다.

QTableWidgetSelectionRange도 참조하십시오 .

void QTableWidget::setCellWidget(int row, int column, QWidget *widget)

지정된 ` widget `를 ` row ` 및 ` column`에 있는 셀에 표시하도록 설정하며, 위젯의 소유권을 테이블에 넘깁니다.

셀 위젯 A가 셀 위젯 B로 대체되면, 셀 위젯 A는 삭제됩니다. 예를 들어, 아래 코드 예제에서는 QLineEdit 객체가 삭제됩니다.

setCellWidget(row, column, new QLineEdit);
...
setCellWidget(row, column, new QTextEdit);

cellWidget()도 참조하십시오 .

void QTableWidget::setColumnCount(int columns)

이 테이블 모델의 열 수를 ` columns`로 설정합니다. 이 값이 ` columnCount()`보다 작을 경우, 필요 없는 열의 데이터는 삭제됩니다.

columnCount() 및 setRowCount()도 참조하십시오 .

void QTableWidget::setCurrentCell(int row, int column)

현재 셀을 (row, column) 위치의 셀로 설정합니다.

현재 selection mode 에 따라 셀이 선택될 수도 있습니다.

setCurrentItem(), currentRow() 및 currentColumn()도 참조하십시오 .

void QTableWidget::setCurrentCell(int row, int column, QItemSelectionModel::SelectionFlags command)

지정된 command 를 사용하여 현재 셀을 (row, column) 위치의 셀로 설정합니다.

setCurrentItem(), currentRow() 및 currentColumn()도 참조하십시오 .

void QTableWidget::setCurrentItem(QTableWidgetItem *item)

현재 항목을 ‘ item ’로 설정합니다.

선택 모드가 ` NoSelection`가 아닌 경우, 해당 항목도 선택됩니다.

currentItem() 및 setCurrentCell()도 참조하십시오 .

void QTableWidget::setCurrentItem(QTableWidgetItem *item, QItemSelectionModel::SelectionFlags command)

지정된 command 를 사용하여 현재 항목을 item 로 설정합니다.

currentItem() 및 setCurrentCell()도 참조하십시오 .

void QTableWidget::setHorizontalHeaderItem(int column, QTableWidgetItem *item)

column 열의 가로 헤더 항목을 item 로 설정합니다. 필요한 경우, 해당 항목이 들어갈 수 있도록 열 수가 증가합니다. 이전 헤더 항목(있는 경우)은 삭제됩니다.

horizontalHeaderItem()도 참조하십시오 .

void QTableWidget::setHorizontalHeaderLabels(const QStringList &labels)

labels 를 사용하여 가로 방향 헤더 레이블을 설정합니다.

void QTableWidget::setItem(int row, int column, QTableWidgetItem *item)

지정된 row 및 column 에 대한 항목을 item 로 설정합니다.

테이블이 해당 항목의 소유권을 가져옵니다.

정렬이 활성화된 경우( sortingEnabled 참조)이고 column 가 현재 정렬 열인 경우, row 는 item 에 의해 결정된 정렬된 위치로 이동됩니다.

특정 행의 여러 항목을 설정하려는 경우(예: 루프에서 setItem()을 호출하는 경우), 작업을 수행하기 전에 정렬을 해제했다가 작업이 끝난 후 다시 활성화하는 것이 좋습니다. 이렇게 하면 같은 행의 모든 항목에 대해 동일한 row 인수를 사용할 수 있습니다(즉, setItem()이 행을 이동시키지 않습니다).

item() 및 takeItem()도 참조하십시오 .

void QTableWidget::setItemPrototype(const QTableWidgetItem *item)

테이블의 항목 프로토타입을 지정된 item 로 설정합니다.

테이블 위젯은 새로운 테이블 항목을 생성해야 할 때(예: 사용자가 빈 셀에서 편집할 때) 항목 프로토타입의 clone 함수를 사용합니다. 이는 QTableWidgetItem 의 서브클래스가 있고, QTableWidget 가 해당 서브클래스의 인스턴스를 생성하도록 보장하고자 할 때 유용합니다.

테이블은 프로토타입에 대한 소유권을 갖습니다.

itemPrototype()도 참조하십시오 .

void QTableWidget::setRangeSelected(const QTableWidgetSelectionRange &range, bool select)

select 에 따라 ‘ range ’를 선택하거나 선택을 해제합니다.

void QTableWidget::setRowCount(int rows)

이 테이블 모델의 행 수를 rows 로 설정합니다. 이 값이 rowCount()보다 작을 경우, 해당 행의 데이터는 제거됩니다.

rowCount() 및 setColumnCount()도 참조하십시오 .

void QTableWidget::setVerticalHeaderItem(int row, QTableWidgetItem *item)

row 행의 세로 헤더 항목을 item 로 설정합니다.

verticalHeaderItem()도 참조하십시오 .

void QTableWidget::setVerticalHeaderLabels(const QStringList &labels)

labels 를 사용하여 세로 방향의 헤더 레이블을 설정합니다.

void QTableWidget::sortItems(int column, Qt::SortOrder order = Qt::AscendingOrder)

column 및 order 에 따라 테이블 위젯의 모든 행을 정렬합니다.

[virtual protected] Qt::DropActions QTableWidget::supportedDropActions() const

이 뷰에서 지원하는 드롭 동작을 반환합니다.

Qt::DropActions, supportedDragActions 및 dropMimeData()도 참조하십시오 .

QTableWidgetItem *QTableWidget::takeHorizontalHeaderItem(int column)

column 에 있는 가로 헤더 항목을 삭제하지 않고 헤더에서 제거합니다.

QTableWidgetItem *QTableWidget::takeItem(int row, int column)

row 및 column 에 있는 항목을 삭제하지 않고 테이블에서 제거합니다.

QTableWidgetItem *QTableWidget::takeVerticalHeaderItem(int row)

row 에 있는 세로 방향 헤더 항목을 삭제하지 않고 헤더에서 제거합니다.

QTableWidgetItem *QTableWidget::verticalHeaderItem(int row) const

row 행에 해당하는 세로 헤더 항목을 반환합니다.

setVerticalHeaderItem()도 참조하십시오 .

int QTableWidget::visualColumn(int logicalColumn) const

지정된 ` logicalColumn`의 시각적 열을 반환합니다.

QRect QTableWidget::visualItemRect(const QTableWidgetItem *item) const

item 에서 해당 항목이 차지하는 뷰포트의 직사각형 영역을 반환합니다.

int QTableWidget::visualRow(int logicalRow) const

지정된 logicalRow 의 시각적 행을 반환합니다.