QSessionManager Class

멤버 함수 문서

bool QSessionManager::allowsErrorInteraction()

오류 상호작용이 허용된 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

이는 allowsInteraction()와 유사하지만, 애플리케이션이 발생한 오류에 대해 사용자에게 알릴 수 있도록 합니다. 세션 관리자는 오류 상호작용 요청에 더 높은 우선순위를 부여할 수 있으며, 이는 오류 상호작용이 허용될 가능성이 더 높다는 것을 의미합니다. 그러나 세션 관리자가 상호작용을 허용할 것이라는 보장은 여전히 없습니다.

allowsInteraction(), release() 및 cancel()도 참조하십시오 .

bool QSessionManager::allowsInteraction()

세션 관리자에게 사용자와 상호작용할 수 있는 권한을 요청합니다. 상호작용이 허용되면 true를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

이 메커니즘의 목적은 시스템 종료 중에 사용자 상호작용을 동기화할 수 있도록 하는 데 있습니다. 고급 세션 관리자는 모든 애플리케이션에 동시에 데이터 저장을 요청할 수 있으며, 그 결과 시스템 종료 속도가 훨씬 빨라집니다.

상호작용이 완료되면 release() 호출을 통해 사용자 상호작용 세마포어를 해제할 것을 강력히 권장합니다. 이렇게 하면, 해당 애플리케이션이 데이터를 저장하느라 바쁜 동안에도 다른 애플리케이션들이 사용자와 상호작용할 기회를 얻을 수 있습니다. (세마포어는 애플리케이션이 종료될 때 암시적으로 해제됩니다.)

사용자가 상호작용 단계 중에 종료 프로세스를 취소하기로 결정한 경우, cancel()를 호출하여 세션 관리자에게 이 사실을 알려야 합니다.

다음은 애플리케이션의 QGuiApplication::commitDataRequest() 함수가 구현될 수 있는 예시입니다:

MyMainWidget::MyMainWidget(QWidget*parent)
    : QWidget(parent)
{
    connect(qApp, &QGuiApplication::commitDataRequest,
           this, &MyMainWidget::commitData);
}

void MyMainWidget::commitData(QSessionManager& manager)
{
    if (manager.allowsInteraction()) {
        int ret = QMessageBox::warning(
                    mainWindow,
                    tr("My Application"),
                    tr("문서에 변경 사항을 저장하시겠습니까?"),
                    QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);

        switch (ret) {
        case QMessageBox::Save:
            manager.release();
            if (!saveDocument())
                manager.cancel();
            break;
        case QMessageBox::Discard:
            break;
        case QMessageBox::취소:
        default:
            manager.cancel();
        }
    } else {
        // 상호작용 권한을 얻지 못했으므로,
        // 대신 적절한 조치를 취합니다
    }
}

데이터를 저장하는 과정에서 애플리케이션 내에서 오류가 발생한 경우, 대신 allowsErrorInteraction()을 사용해 볼 수 있습니다.

QGuiApplication::commitDataRequest(), release(), cancel()도 참조하십시오 .

void QSessionManager::cancel()

세션 관리자에게 종료 프로세스를 취소하도록 지시합니다. 애플리케이션은 사용자에게 먼저 확인하지 않고 이 함수를 호출해서는 안 됩니다.

allowsInteraction() 및 allowsErrorInteraction()도 참조하십시오 .

QStringList QSessionManager::discardCommand() const

현재 설정된 discard 명령을 반환합니다.

setDiscardCommand(), restartCommand() 및 setRestartCommand()도 참조하십시오 .

bool QSessionManager::isPhase2() const

세션 관리자가 현재 두 번째 세션 관리 단계를 수행 중이면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

requestPhase2()도 참조하십시오 .

void QSessionManager::release()

상호작용 단계가 끝난 후 세션 관리자의 상호작용 세마포어를 해제합니다.

allowsInteraction() 및 allowsErrorInteraction()도 참조하십시오 .

void QSessionManager::requestPhase2()

애플리케이션에 대한 두 번째 세션 관리 단계를 요청합니다. 그러면 애플리케이션은 ` QGuiApplication::commitDataRequest()` 또는 ` QApplication::saveStateRequest()` 함수에서 즉시 반환될 수 있으며, 다른 애플리케이션의 대부분 또는 전부가 세션 관리를 완료하면 해당 함수들이 다시 호출됩니다.

이 두 단계는 다른 애플리케이션의 창에 대한 정보를 저장해야 하므로, 해당 애플리케이션들이 각자의 세션 관리 작업을 완료할 때까지 기다려야 하는 X11 창 관리자와 같은 애플리케이션에 유용합니다.

isPhase2()도 참조하십시오 .

QStringList QSessionManager::restartCommand() const

현재 설정된 재시작 명령을 반환합니다.

setRestartCommand() 및 restartHint()도 참조하십시오 .

QSessionManager::RestartHint QSessionManager::restartHint() const

애플리케이션의 현재 재시작 힌트를 반환합니다. 기본값은 ` RestartIfRunning`입니다.

setRestartHint()도 참조하십시오 .

QString QSessionManager::sessionId() const

현재 세션의 식별자를 반환합니다.

애플리케이션이 이전 세션에서 복원된 경우, 이 식별자는 이전 세션에서 사용되었던 것과 동일합니다.

sessionKey() 및 QGuiApplication::sessionId()도 참조하십시오 .

QString QSessionManager::sessionKey() const

현재 세션의 세션 키를 반환합니다.

애플리케이션이 이전 세션에서 복원된 경우, 이 키는 이전 세션이 종료되었을 때와 동일합니다.

세션 키는 commitData() 또는 saveState()가 호출될 때마다 변경됩니다.

sessionId() 및 QGuiApplication::sessionKey()도 참조하십시오 .

void QSessionManager::setDiscardCommand(const QStringList &command)

discard 명령을 지정된 command 로 설정합니다.

discardCommand() 및 setRestartCommand()도 참조하십시오 .

void QSessionManager::setManagerProperty(const QString &name, const QStringList &value)

애플리케이션의 식별 정보 및 상태 레코드에 대한 저수준 쓰기 액세스 권한은 세션 관리자에 저장됩니다.

name 라는 속성의 값은 문자열 목록 value 로 설정되어 있습니다.

void QSessionManager::setManagerProperty(const QString &name, const QString &value)

세션 관리자에는 애플리케이션의 식별 및 상태 레코드에 대한 저수준 쓰기 액세스 권한이 저장됩니다.

name 라는 속성의 값은 문자열 value 로 설정되어 있습니다.

void QSessionManager::setRestartCommand(const QStringList &command)

세션 관리자가 세션을 복원할 수 있는 경우, 애플리케이션을 복원하기 위해 ` command ` 명령을 실행합니다. 이 명령의 기본값은

appname -session id

-session 옵션은 필수입니다. 그렇지 않으면 QGuiApplication 가 세션이 복원되었는지, 현재 세션 식별자가 무엇인지 파악할 수 없습니다. 자세한 내용은 QGuiApplication::isSessionRestored() 및 QGuiApplication::sessionId()을 참조하십시오.

애플리케이션이 매우 단순한 경우, 전체 애플리케이션 상태를 추가 명령줄 옵션에 저장할 수도 있습니다. 하지만 명령줄은 대개 수백 바이트로 제한되기 때문에 이는 일반적으로 매우 좋지 않은 방법입니다. 대신, 이 목적을 위해 QSettings, 임시 파일 또는 데이터베이스를 사용하십시오. sessionId()를 사용하여 데이터에 고유 식별자를 지정하면, 향후 세션에서 애플리케이션을 복원할 수 있습니다.

restartCommand(), setDiscardCommand(), setRestartHint()도 참조하십시오 .

void QSessionManager::setRestartHint(QSessionManager::RestartHint hint)

애플리케이션의 재시작 힌트를 hint 로 설정합니다. 애플리케이션 시작 시, 힌트는 RestartIfRunning 로 설정됩니다.

대부분의 세션 관리자는 애플리케이션 시작 직후 체크포인트를 수행하므로, ` QGuiApplication::saveStateRequest()`에서 재시작 힌트를 설정하는 것이 좋습니다.

restartHint()도 참조하십시오 .