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 を想定します。1つ目の列にはグループのメンバーの名前が、2つ目の列にはそれぞれの年齢が含まれています。1つ目の列はQLineEdit のnameLineEdit にマッピングされ、2つ目の列はQSpinBox のageSpinBox にマッピングされます：

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

注：

• widget がすでにセクションにマッピングされている場合、古いマッピングは新しいマッピングに置き換えられます。
• セクションとウィジェット間のマッピングは、一対一のみ許可されます。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()も参照してください 。