QSqlQueryModel Class

멤버 함수 문서

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

지정된 parent 을 사용하여 빈 QSqlQueryModel을 생성합니다.

[virtual noexcept] QSqlQueryModel::~QSqlQueryModel()

객체를 삭제하고 할당된 리소스를 모두 해제합니다.

clear()도 참조하십시오 .

[override virtual] bool QSqlQueryModel::canFetchMore(const QModelIndex &parent = QModelIndex()) const

QAbstractItemModel::canFetchMore(const QModelIndex &parent) const를 재구현합니다.

데이터베이스에서 더 많은 행을 읽을 수 있는 경우 true 을 반환합니다. 이는 쿼리의 크기를 반환하지 않는 데이터베이스에만 영향을 미칩니다( QSqlDriver::hasFeature() 참조).

parent 항상 유효하지 않은 QModelIndex 이어야 합니다.

fetchMore()도 참조하십시오 .

[virtual] void QSqlQueryModel::clear()

모델을 지우고 확보된 리소스를 모두 해제합니다.

[override virtual] int QSqlQueryModel::columnCount(const QModelIndex &index = QModelIndex()) const

QAbstractItemModel::columnCount(const QModelIndex &parent) const를 재구현합니다.

[override virtual] QVariant QSqlQueryModel::data(const QModelIndex &item, int role = Qt::DisplayRole) const

QAbstractItemModel::data(const QModelIndex &index, int role) const를 재구현합니다.

지정된 item 및 role 에 대한 값을 반환합니다.

item 가 범위를 벗어났거나 오류가 발생한 경우, 유효하지 않은 QVariant 가 반환됩니다.

lastError()도 참조하십시오 .

[override virtual] void QSqlQueryModel::fetchMore(const QModelIndex &parent = QModelIndex())

QAbstractItemModel::fetchMore(const QModelIndex &parent)를 재구현합니다.

데이터베이스에서 더 많은 행을 가져옵니다. 이 함수는 쿼리의 크기를 반환하지 않는 데이터베이스에만 영향을 미칩니다( QSqlDriver::hasFeature() 참조).

전체 결과 집합을 강제로 가져오려면 다음을 사용할 수 있습니다:

while (myModel->canFetchMore())
    myModel->fetchMore();

parent 항상 유효하지 않은 QModelIndex 이어야 합니다.

canFetchMore()도 참조하십시오 .

[override virtual] QVariant QSqlQueryModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const를 재구현합니다.

지정된 orientation 를 가진 헤더의 section 에서 주어진 role 에 대한 헤더 데이터를 반환합니다.

setHeaderData()도 참조하십시오 .

[virtual protected] QModelIndex QSqlQueryModel::indexInQuery(const QModelIndex &item) const

모델에서 지정된 ` item `에 해당하는 데이터베이스 결과 집합 내 값의 인덱스를 반환합니다.

열이나 행이 삽입, 삭제 또는 재배치되지 않은 경우 반환 값은 ` item `와 동일합니다.

item 가 범위를 벗어났거나 item 가 결과 집합 내의 값을 가리키지 않는 경우, 유효하지 않은 모델 인덱스를 반환합니다.

QSqlTableModel::indexInQuery(), insertColumns(), removeColumns()도 참조하십시오 .

[override virtual] bool QSqlQueryModel::insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())

QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent)를 재구현합니다.

column 위치에 count 열을 모델에 삽입합니다. 모델은 부모-자식 관계를 지원하지 않으므로, parent 매개변수는 항상 유효하지 않은 QModelIndex 값이어야 합니다.

column 가 유효한 범위 내에 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

기본적으로 삽입된 열은 비어 있습니다. 데이터로 채우려면 data()을 재구현하고 삽입된 각 열을 개별적으로 처리하십시오:

QVariant MyModel::data(const QModelIndex &item, int role) const
{
    if (item.column() == m_specialColumnNo) {
        // handle column separately
    }
    return QSqlQueryModel::data(item, role);
}

removeColumns()도 참조하십시오 .

QSqlError QSqlQueryModel::lastError() const

데이터베이스에서 발생한 가장 최근 오류에 대한 정보를 반환합니다.

setLastError() 및 query()도 참조하십시오 .

const QSqlQuery &QSqlQueryModel::query() const

이 모델과 연관된 const QSqlQuery 객체에 대한 참조를 반환합니다.

setQuery()도 참조하십시오 .

[virtual protected] void QSqlQueryModel::queryChange()

이 가상 함수는 쿼리가 변경될 때마다 호출됩니다. 기본 구현은 아무 작업도 수행하지 않습니다.

query()는 새로운 쿼리를 반환합니다.

query() 및 setQuery()도 참조하십시오 .

QSqlRecord QSqlQueryModel::record(int row) const

현재 쿼리의 필드에 대한 정보가 포함된 레코드를 반환합니다. ` row `가 유효한 행의 인덱스인 경우, 해당 행의 값으로 레코드가 채워집니다.

모델이 초기화되지 않은 경우, 빈 레코드가 반환됩니다.

QSqlRecord::isEmpty()도 참조하십시오 .

QSqlRecord QSqlQueryModel::record() const

현재 쿼리의 필드에 대한 정보가 포함된 빈 레코드를 반환합니다.

모델이 초기화되지 않은 경우, 빈 레코드가 반환됩니다.

QSqlRecord::isEmpty()도 참조하십시오 .

[since 6.9] void QSqlQueryModel::refresh()

현재 쿼리를 다시 실행하여 동일한 데이터베이스 연결에서 데이터를 가져옵니다.

이 함수는 Qt 6.9에서 도입되었습니다.

setQuery(QSqlQuery &&query) 및 QSqlQuery::boundValue()도 참조하십시오 .

[override virtual] bool QSqlQueryModel::removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())

QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent)를 재구현합니다.

column 위치부터 시작하여 모델에서 count 열을 제거합니다. 모델이 부모-자식 관계를 지원하지 않으므로, parent 매개변수는 항상 유효하지 않은 QModelIndex 값이어야 합니다.

열을 제거하면 사실상 해당 열이 숨겨집니다. 이는 기본이 되는 QSqlQuery 에는 영향을 미치지 않습니다.

열이 제거된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

[override virtual] QHash<int, QByteArray> QSqlQueryModel::roleNames() const

QAbstractItemModel::roleNames() const를 재구현합니다.

모델의 역할 이름을 반환합니다.

Qt는 QSqlQueryModel 에 대해 단 하나의 역할만 정의합니다:

[override virtual] int QSqlQueryModel::rowCount(const QModelIndex &parent = QModelIndex()) const

QAbstractItemModel::rowCount(const QModelIndex &parent) const를 재구현합니다.

데이터베이스가 쿼리의 크기를 반환하는 기능을 지원하는 경우( QSqlDriver::hasFeature() 참조), 현재 쿼리의 행 수가 반환됩니다. 그렇지 않은 경우, 클라이언트에 현재 캐시된 행 수를 반환합니다.

parent 항상 유효하지 않은 QModelIndex 이어야 합니다.

canFetchMore() 및 QSqlDriver::hasFeature()도 참조하십시오 .

[override virtual] bool QSqlQueryModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

QAbstractItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role)를 재구현합니다.

지정된 role 의 가로 방향 헤더 캡션을 value 로 설정합니다. 이 메서드는 모델이 뷰(예: QTableView)에 데이터를 표시하는 데 사용되는 경우에 유용합니다.

orientation 가 Qt::Horizontal 이고, section 가 유효한 섹션을 가리키는 경우 true 를 반환하며, 그렇지 않으면 false를 반환합니다.

이 함수는 모델이 읽기 전용이므로 데이터베이스 내의 값을 수정하는 데 사용할 수 없다는 점에 유의하십시오.

headerData() 및 data()도 참조하십시오 .

[protected] void QSqlQueryModel::setLastError(const QSqlError &error)

파생 클래스가 데이터베이스에서 발생한 마지막 오류의 값을 ` error`로 설정할 수 있도록 하는 보호된 함수입니다.

lastError()도 참조하십시오 .

[since 6.2] void QSqlQueryModel::setQuery(QSqlQuery &&query)

모델을 초기화하고 데이터 공급자를 지정된 ` query`로 설정합니다. 쿼리는 활성 상태여야 하며 `isForwardOnly()`가 아니어야 합니다.

lastError쿼리 설정 시 오류가 발생한 경우, ()를 사용하여 상세한 정보를 가져올 수 있습니다.

이 함수는 Qt 6.2에서 도입되었습니다.

query(), QSqlQuery::isActive(), QSqlQuery::setForwardOnly() 및 lastError()도 참조하십시오 .

void QSqlQueryModel::setQuery(const QString &query, const QSqlDatabase &db = QSqlDatabase())

지정된 데이터베이스 연결 db 에 대해 query 쿼리를 실행합니다. 데이터베이스가 지정되지 않았거나(또는 유효하지 않은 데이터베이스가 지정된 경우) 기본 연결이 사용됩니다.

lastError쿼리 설정 시 오류가 발생한 경우, ()를 사용하여 자세한 정보를 확인할 수 있습니다.

예시:

QSqlQueryModel model;
model.setQuery("select * from MyTable");
if (model.lastError().isValid())
    qDebug() << model.lastError();

query(), queryChange(), lastError()도 참조하십시오 .