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

tablewidget アイテムのリストを記述するために使用できる 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 のビジュアル行を返します。