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 이 이미 섹션에 매핑되어 있는 경우 이전 매핑이 새 매핑으로 대체됩니다.
• 섹션과 위젯 간에는 일대일 매핑만 허용됩니다. 단일 섹션을 여러 위젯에 매핑하거나 단일 위젯을 여러 섹션에 매핑할 수 없습니다.

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 을 반환하고, 그렇지 않으면 거짓을 반환합니다.

참고: 데이터베이스 모델의 경우 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()도 참조하세요 .