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()も参照してください 。