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 ’은 모델의 열이 되며, 그렇지 않은 경우 행이 됩니다.

다음 예제에서는 두 개의 열을 가진 모델 ` myModel `을 가정합니다. 첫 번째 열에는 그룹 구성원의 이름이, 두 번째 열에는 그들의 나이가 들어 있습니다. 첫 번째 열은 ` QLineEdit `의 ` nameLineEdit`에 매핑되고, 두 번째 열은 ` QSpinBox `의 ` ageSpinBox`에 매핑됩니다:

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

참고:

• widget 가 이미 섹션에 매핑되어 있는 경우, 기존 매핑은 새로운 매핑으로 대체됩니다.
• 섹션과 위젯 간의 매핑은 일대일(one-to-one)로만 허용됩니다. 단일 섹션을 여러 위젯에 매핑하거나, 단일 위젯을 여러 섹션에 매핑하는 것은 불가능합니다.

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)

방향(orientation)이 가로(기본값)인 경우 현재 인덱스를 ` 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()도 참조하십시오 .