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 으로 지정됩니다.

이 신호는 마우스 트래킹이 켜져 있거나 항목으로 이동하는 동안 마우스 버튼을 눌렀을 때만 발생합니다.

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

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

주어진 row 및 column 에서 주어진 action 로 끝나는 드래그 앤 드롭 작업으로 제공된 data 을 처리합니다. 데이터와 동작을 모델에서 처리할 수 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

supportedDropActions()도 참조하세요 .

void QTableWidget::editItem(QTableWidgetItem *item)

편집 가능한 경우 item 편집을 시작합니다.

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

다시 구현합니다: QAbstractItemView::event(QEvent * 이벤트).

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 은 입력된 항목입니다.

이 신호는 마우스 트래킹이 켜져 있거나 항목으로 이동하는 동안 마우스 버튼을 눌렀을 때만 발생합니다.

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)

주어진 row 및 column 의 셀에 지정된 widget 을 표시하도록 설정하고 위젯의 소유권을 테이블로 전달합니다.

셀 위젯 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 으로 설정합니다.

표 위젯은 새 표 항목을 만들어야 할 때 항목 프로토타입 복제 기능을 사용합니다. 예를 들어 사용자가 빈 셀에서 편집하는 경우입니다. 이 기능은 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 를참조하세요 .

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 의 시각적 행을 반환합니다.