QDataWidgetMapper Class

メンバー関数ドキュメント

[explicit] QDataWidgetMapper::QDataWidgetMapper(QObject *parent = nullptr)

親オブジェクトparent を持つ新しいQDataWidgetMapperを構築します。デフォルトでは、方向は水平で、サブミットポリシーはAutoSubmit です。

setOrientation() およびsetSubmitPolicy()も参照してください 。

[virtual noexcept] QDataWidgetMapper::~QDataWidgetMapper()

オブジェクトを破壊する。

void QDataWidgetMapper::addMapping(QWidget *widget, int section)

モデルからwidget とsection の間のマッピングを追加します。section は、水平方向（デフォルト）であればモデルの列であり、そうでなければ行です。

次の例では、2つの列を持つモデルmyModel を想定します：最初の列はグループの人々の名前を含み、2番目の列は彼らの年齢を含みます。最初の列はQLineEdit nameLineEdit にマップされ、2番目の列はQSpinBox ageSpinBox にマップされる：

QDataWidgetMapper *mapper = new QDataWidgetMapper;
mapper->setModel(myModel);
mapper->addMapping(nameLineEdit, 0);
mapper->addMapping(ageSpinBox, 1);

注意事項

• widget がすでにセクションにマッピングされている場合、古いマッピングは新しいマッピングに置き換えられます。
• セクションとウィジェットのマッピングは1対1のみ可能です。1つのセクションを複数のウィジェットにマッピングすることや、1つのウィジェットを複数のセクションにマッピングすることはできません。

removeMapping(),mappedSection(),clearMapping()も参照のこと 。

void QDataWidgetMapper::addMapping(QWidget *widget, int section, const QByteArray &propertyName)

基本的には addMapping() と同じですが、propertyName を指定して使用するプロパティを指定する可能性が追加されています。

addMapping()も参照 。

void QDataWidgetMapper::clearMapping()

すべてのマッピングをクリアする。

addMapping() およびremoveMapping()も参照 。

[signal] void QDataWidgetMapper::currentIndexChanged(int index)

このシグナルは、現在のインデックスが変更され、すべてのウィジェットに新しいデータが入力された後に発行されます。index は、新しい現在のインデックスです。

currentIndex() およびsetCurrentIndex()も参照してください 。

QAbstractItemDelegate *QDataWidgetMapper::itemDelegate() const

現在のアイテムデリゲートを返します。

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

QByteArray QDataWidgetMapper::mappedPropertyName(QWidget *widget) const

指定されたwidget にデータをマッピングする際に使用されるプロパティの名前を返します。

mappedSection()、addMapping() およびremoveMapping()も参照 。

int QDataWidgetMapper::mappedSection(QWidget *widget) const

widget がマップされているセクションを返すか、ウィジェットがマップされていない場合は -1 を返す。

addMapping() およびremoveMapping()も参照 。

QWidget *QDataWidgetMapper::mappedWidgetAt(int section) const

section にマップされたウィジェット、またはそのセクションにウィジェットがマップされていない場合は 0 を返す。

addMapping() およびremoveMapping()も参照 。

QAbstractItemModel *QDataWidgetMapper::model() const

現在のモデルを返します。

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

void QDataWidgetMapper::removeMapping(QWidget *widget)

与えられたwidget のマッピングを削除します。

addMapping() およびclearMapping()も参照 。

[slot] void QDataWidgetMapper::revert()

すべてのウィジェットをモデルの現在のデータで再投入します。未提出の変更はすべて失われます。

submit() およびsetSubmitPolicy()も参照してください 。

QModelIndex QDataWidgetMapper::rootIndex() const

現在のルートインデックスを返す。

setRootIndex()も参照 。

[slot] void QDataWidgetMapper::setCurrentModelIndex(const QModelIndex &index)

現在のインデックスを、横向き（デフォルト）の場合はindex の行に、そうでない場合はindex の列に設定する。

setCurrentIndex() を内部的に呼び出す。selection modelこの便宜スロットは、他のビューのシグナルcurrentRowChanged() またはcurrentColumnChanged() に接続することができます。

次の例は、myTableView という名前のQTableView の選択が変更されるたびに、すべてのウィジェットを新しいデータで更新する方法を示しています：

QDataWidgetMapper *mapper = new QDataWidgetMapper;
connect(myTableView->selectionModel(), &QItemSelectionModel::currentRowChanged,
        mapper, &QDataWidgetMapper::setCurrentModelIndex);

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

void QDataWidgetMapper::setItemDelegate(QAbstractItemDelegate *delegate)

アイテムデリゲートをdelegate に設定します。このデリゲートは、QAbstractItemDelegate::setEditorData() とQAbstractItemDelegate::setModelData() を使用して、モデルからウィジェットに、ウィジェットからモデルにデータを書き込むために使用されます。

QDataWidgetMapper はdelegate の所有権を持ちません。

デリゲートはまた、QAbstractItemDelegate::commitData() とQAbstractItemDelegate::closeEditor() を使用して、データを適用するタイミングとエディタを変更するタイミングを決定します。

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

void QDataWidgetMapper::setModel(QAbstractItemModel *model)

現在のモデルをmodel に設定します。別のモデルが設定されていた場合、その古いモデルへのマッピングはすべてクリアされます。

model()も参照のこと 。

void QDataWidgetMapper::setRootIndex(const QModelIndex &index)

ルート項目をindex に設定します。 これは、ツリーの枝を表示するために使用できます。最上部の枝を表示するには、無効なモデル・インデックスを渡します。

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

[slot] bool QDataWidgetMapper::submit()

マッピングされたウィジェットのすべての変更をモデルにサブミットします。

マッピングされたすべてのセクションに対して、アイテムデリゲートはウィジェットから現在の値を読み込み、モデルに設定します。最後に、モデルのsubmit() メソッドが呼び出されます。

すべての値が送信された場合はtrue を返し、そうでない場合は false を返します。

注: データベースモデルの場合、QSqlQueryModel::lastError() は最後のエラーを取得するために使用できます。

revert() およびsetSubmitPolicy()も参照ください 。

[slot] void QDataWidgetMapper::toFirst()

ウィジェットの向きが水平（デフォルト）の場合はモデルの最初の行のデータを、そうでない場合は最初の列のデータを入力します。

これはsetCurrentIndex(0) を呼び出すのと同じです。

toLast() およびsetCurrentIndex()も参照 。

[slot] void QDataWidgetMapper::toLast()

モデルの向きが水平（デフォルト）の場合は最後の行のデータを、そうでない場合は最後の列のデータをウィジェットに入力します。

内部的にsetCurrentIndex() を呼び出します。

toFirst() およびsetCurrentIndex()も参照してください 。

[slot] void QDataWidgetMapper::toNext()

オリエンテーションが水平（デフォルト）の場合、モデルの次の行のデータをウィジェットに入力し、そうでない場合、次の列のデータをウィジェットに入力します。

内部的にsetCurrentIndex() を呼び出します。モデルに次の行がない場合は何もしません。

toPrevious() およびsetCurrentIndex()も参照してください 。

[slot] void QDataWidgetMapper::toPrevious()

オリエンテーションが水平（デフォルト）の場合はモデルの前の行のデータを、そうでない場合は前の列のデータをウィジェットに入力します。

内部的にsetCurrentIndex() を呼び出します。モデルに前の行がない場合は何もしません。

toNext() およびsetCurrentIndex()も参照してください 。