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)

与えられたaction で終了したドラッグ＆ドロップ操作によって与えられたdata を、与えられたrow とcolumn で処理します。データとアクションがモデルで処理できる場合はtrue を返し、そうでない場合はfalse を返します。

supportedDropActions()も参照してください 。

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)

与えられた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 のビジュアル行を返します。