QScxmlStateMachine Class

멤버 함수 문서

[invokable] QStringList QScxmlStateMachine::activeStateNames(bool compress = true) const

활성 상태의 모든 상태 이름 목록을 반환합니다.

상태가 활성 상태일 때, 정의상 그 상태의 모든 상위 상태도 활성 상태입니다. ` compress `가 ` true `(기본값)일 경우, 상위 상태는 필터링되어 리프 상태만 반환됩니다. ` false`일 경우, 활성 상태의 전체 목록이 반환됩니다.

[invokable] void QScxmlStateMachine::cancelDelayedEvent(const QString &sendId)

지정된 sendId 를 사용하여 지연된 이벤트를 취소합니다.

scxmlEventSpec 로 지정된 이벤트에서 functor 까지, 주어진 type 에 대한 연결을 생성합니다. 여기서 는 펑터이거나 선택적 context 객체의 멤버 함수일 수 있습니다.

수신자의 functor 는 QScxmlEvent 를 매개변수로 받아야 합니다.

SCXML 문서의 이벤트 사양과 달리, 여기서의 ` scxmlEventSpec `에는 공백을 사용할 수 없습니다. 서로 다른 접두사를 가진 여러 이벤트에 연결하려면 ` connectToEvent()`를 여러 번 호출해야 합니다.

연결에 대한 핸들을 반환하며, 이 핸들은 나중에 연결을 끊는 데 사용할 수 있습니다.

QMetaObject::Connection QScxmlStateMachine::connectToEvent(const QString &scxmlEventSpec, const QObject *receiver, const char *method, Qt::ConnectionType type = Qt::AutoConnection)

scxmlEventSpec 로 지정된 이벤트의 지정된 type 를 receiver 객체 내의 method 에 연결합니다. 수신자의 method 는 매개변수로 QScxmlEvent 을 받을 수 있습니다. 예:

void mySlot(const QScxmlEvent &event);

SCXML 문서의 이벤트 사양과 달리, 여기서는 scxmlEventSpec 에 공백을 사용할 수 없습니다. 서로 다른 접두사를 가진 여러 이벤트에 연결하려면 connectToEvent()를 여러 번 호출해야 합니다.

연결에 대한 핸들을 반환하며, 이 핸들은 나중에 연결을 끊는 데 사용할 수 있습니다.

scxmlStateName 로 지정된 상태에서 functor 로, 주어진 type 의 연결을 생성합니다. 여기서 는 펑터이거나 선택적 context 객체의 멤버 함수일 수 있습니다.

수신자의 functor 는 연결된 상태가 활성 상태가 되었는지 비활성 상태가 되었는지를 나타내는 부울(boolean) 인자를 받아야 합니다.

연결에 대한 핸들을 반환하며, 이 핸들은 나중에 연결을 끊는 데 사용할 수 있습니다.

QMetaObject::Connection QScxmlStateMachine::connectToState(const QString &scxmlStateName, const QObject *receiver, const char *method, Qt::ConnectionType type = Qt::AutoConnection)

scxmlStateName 로 식별되는 상태에서 receiver 객체 내의 method 로, 지정된 type 에 대한 연결을 생성합니다. 수신자의 method 는 연결된 상태가 활성 상태가 되었는지 비활성 상태가 되었는지를 나타내는 부울형 인수를 받을 수 있습니다. 예를 들어:

void mySlot(bool active);

연결에 대한 핸들을 반환하며, 이 핸들은 나중에 연결을 끊는 데 사용할 수 있습니다.

QScxmlDataModel *QScxmlStateMachine::dataModel() const

상태 머신이 사용하는 데이터 모델을 반환합니다.

참조: ` setDataModel()` 함수.

[signal] void QScxmlStateMachine::finished()

이 신호는 상태 머신이 최상위 최종 상태에 도달했을 때 발생합니다.

running도 참조하십시오 .

[static] QScxmlStateMachine *QScxmlStateMachine::fromData(QIODevice *data, const QString &fileName = QString())

data 로 지정된 QIODevice 파일을 읽어와 상태 머신을 생성합니다.

이 메서드는 항상 상태 머신을 반환합니다. SCXML 파일인 fileName 을 읽는 도중 오류가 발생하면 상태 머신을 시작할 수 없습니다. 오류 정보는 parseErrors() 메서드를 호출하여 확인할 수 있습니다.

parseErrors()도 참조하십시오 .

[static] QScxmlStateMachine *QScxmlStateMachine::fromFile(const QString &fileName)

fileName 로 지정된 SCXML 파일로부터 상태 머신을 생성합니다.

이 메서드는 항상 상태 머신을 반환합니다. SCXML 파일을 읽는 동안 오류가 발생하면 상태 머신을 시작할 수 없습니다. 오류는 parseErrors() 메서드를 호출하여 확인할 수 있습니다.

parseErrors()도 참조하십시오 .

[slot] bool QScxmlStateMachine::init()

상태 머신을 초기화합니다.

상태 머신 초기화는 ` QScxmlDataModel::setup()`를 호출하고, ` <data> ` 요소의 초기값을 설정하며, ` <scxml> ` 태그 내의 ` <script> ` 태그를 실행하는 과정으로 구성됩니다. 초기 데이터 값은 ` initialValues ` 속성에서 가져옵니다.

구문 분석 오류가 발생하거나 초기화 단계 중 하나라도 실패하면 false 를 반환합니다. 그 외의 경우에는 true 를 반환합니다.

[invokable] bool QScxmlStateMachine::isActive(const QString &scxmlStateName) const

scxmlStateName 로 지정된 상태가 활성 상태인 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

[protected] bool QScxmlStateMachine::isActive(int stateIndex) const

ID가 stateIndex 인 상태가 활성화되어 있으면 true 를 반환합니다.

이 메서드는 SCXML 상태 머신의 컴파일된 표현에 대한 인터페이스의 일부입니다. 이 메서드는 내부적으로만 사용되어야 하며, SCXML 문서에서 컴파일된 상태 머신에 의해서만 사용되어야 합니다.

[invokable] bool QScxmlStateMachine::isDispatchableTarget(const QString &target) const

이 상태 머신에서 target 으로 전송되는 메시지를 발송할 수 있는 경우 ` true `을 반환합니다.

유효한 대상은 다음과 같습니다:

• #_parent 현재 상태 기계가 <invoke>
• #_internal 현재 상태 머신의 경우
• #_scxml_sessionid sessionid 는 이 상태 머신이 를 사용하여 시작한 현재 상태 머신의 세션 ID입니다
• #_servicename, 여기서 servicename 는 이 상태 기계가 <invoke> 로 시작한 서비스의 ID 또는 이름입니다

bool QScxmlStateMachine::isRunning() const

상태 머신이 실행 중이면 ` true `를 반환하고, 그렇지 않으면 ` false `를 반환합니다.

setRunning() 및 runningChanged()도 참조하십시오 .

[signal] void QScxmlStateMachine::log(const QString &label, const QString &msg)

SCXML에서 ` <log> ` 태그가 사용된 경우 이 신호가 발생합니다. ` label `는 ` <log> ` 태그의 ` label ` 속성 값입니다. ` msg `는 ` <log> ` 태그의 ` expr ` 속성 평가 결과 값입니다. ` expr ` 속성이 없는 경우, 빈 문자열이 반환됩니다.

[static] template <typename Functor> std::function<void (bool)> QScxmlStateMachine::onEntry(Functor functor)

부울(boolean) 인자를 받아, 해당 인자가 참( true)일 경우 지정된 함수 functor 를 호출하는 펑크터(functor)를 반환합니다. 지정된 함수 functor 는 어떠한 인자도 받아서는 안 됩니다.

이는 상태에 진입했을 때만 실행되어야 하는 ` connectToState()` 핸들러를 래핑하는 데 유용합니다.

[static] std::function<void (bool)> QScxmlStateMachine::onEntry(const QObject *receiver, const char *method)

부울(boolean) 인자를 받아, 해당 인자가 ` true `이고 ` receiver `가 아직 삭제되지 않은 경우, ` QMetaObject::invokeMethod()`을 사용하여 ` receiver `에서 지정된 ` method `를 호출하는 펑터를 반환합니다.

지정된 method 는 어떠한 인수도 받아서는 안 됩니다. method 는 SIGNAL() 나 SLOT() 로 둘러싸이지 않은 단순한 메서드 이름입니다.

이는 상태에 진입했을 때만 실행되어야 하는 connectToState()에 대한 핸들러를 래핑하는 데 유용합니다.

[static] template <typename PointerToMemberFunction> std::function<void (bool)> QScxmlStateMachine::onEntry(const typename QtPrivate::FunctionPointer<PointerToMemberFunction>::Object *receiver, PointerToMemberFunction method)

부울(boolean) 인자를 받아, 해당 인자가 참( true )이고 해당 함수 객체( receiver )가 아직 삭제되지 않은 경우, receiver 에 대해 주어진 method 를 호출하는 펑크터(functor)를 반환합니다. 주어진 method 는 어떠한 인자도 받아서는 안 됩니다.

이는 상태에 진입했을 때만 실행되어야 하는 connectToState() 핸들러를 래핑하는 데 유용합니다.

[static] template <typename Functor> std::function<void (bool)> QScxmlStateMachine::onExit(Functor functor)

부울(boolean) 인자를 받아, 해당 인자가 참( false)일 경우 지정된 ` functor `를 호출하는 펑크터를 반환합니다. 지정된 ` functor `는 어떠한 인자도 받아서는 안 됩니다.

이는 상태가 종료될 때만 실행되어야 하는 ` connectToState()` 핸들러를 래핑하는 데 유용합니다.

[static] std::function<void (bool)> QScxmlStateMachine::onExit(const QObject *receiver, const char *method)

부울형 인자를 받아, 해당 인자가 false 이고 receiver 가 아직 삭제되지 않은 경우, QMetaObject::invokeMethod()을 사용하여 receiver 에서 지정된 method 를 호출하는 펑터를 반환합니다.

지정된 method 는 어떠한 인수도 받아서는 안 됩니다. method 는 SIGNAL(...)이나 SLOT(...)으로 둘러싸이지 않은 순수한 메서드 이름입니다.

이는 상태를 벗어날 때만 실행되어야 하는 connectToState()에 대한 핸들러를 래핑하는 데 유용합니다.

[static] template <typename PointerToMemberFunction> std::function<void (bool)> QScxmlStateMachine::onExit(const typename QtPrivate::FunctionPointer<PointerToMemberFunction>::Object *receiver, PointerToMemberFunction method)

부울형 인자를 받아들이는 펑터를 반환하며, 해당 인자가 ` false `이고 ` receiver `가 아직 삭제되지 않은 경우 ` receiver `에 대해 지정된 ` method `를 호출합니다. 지정된 ` method `는 어떠한 인자도 받아서는 안 됩니다.

이는 상태를 벗어날 때만 실행되어야 하는 connectToState()에 대한 핸들러를 감싸는 데 유용합니다.

[signal] void QScxmlStateMachine::reachedStableState()

이 신호는 매크로 단계가 끝날 때 이벤트 큐가 비어 있거나 최종 상태에 도달했을 때 발생합니다.

[signal] void QScxmlStateMachine::runningChanged(bool running)

이 신호는 ` running ` 속성이 ` running `를 인수로 받아 변경될 때 발생합니다.

void QScxmlStateMachine::setDataModel(QScxmlDataModel *model)

이 상태 머신의 데이터 모델을 ` model`로 설정합니다. 상태 머신과 모델 간에는 1:1 관계가 있습니다. 모델을 한 번 설정하면 더 이상 변경할 수 없습니다. 이 메서드를 사용하여 모델을 다시 설정하려는 모든 시도는 무시됩니다.

참조: dataModel()

void QScxmlStateMachine::setRunning(bool running)

running 가 true 인 경우 상태 머신을 시작하고, 그렇지 않은 경우 중지합니다.

start(), stop(), isRunning(), runningChanged()도 참조하십시오 .

[slot] void QScxmlStateMachine::start()

이 상태 머신을 시작합니다. 최상위 최종 상태에 진입하면, 이 머신은 finished() 신호를 발생시킵니다.

runningChanged(), setRunning(), stop() 및 finished()도 참조하십시오 .

[invokable] QStringList QScxmlStateMachine::stateNames(bool compress = true) const

모든 주의 주명 목록을 가져옵니다.

compress 가 true (기본값)인 경우, 자식 상태를 포함하는 상태는 필터링되어 리프 상태 만 반환됩니다. false 인 경우, 모든 상태의 전체 목록이 반환됩니다.

반환된 목록에는 중첩된 상태 머신의 상태는 포함되지 않습니다.

[slot] void QScxmlStateMachine::stop()

이 상태 머신을 중지합니다. 이 상태 머신은 더 이상 상태 전이를 수행하지 않습니다. 이 상태 머신의 ` running ` 속성은 ` false`로 설정됩니다.

runningChanged(), start() 및 setRunning()도 참조하십시오 .

[invokable] void QScxmlStateMachine::submitEvent(QScxmlEvent *event)

event SCXML 이벤트를 이벤트의 우선순위에 따라 내부 또는 외부 이벤트 큐에 제출합니다.

지연 시간이 설정된 경우, 타임아웃이 경과한 후에 이벤트가 전달 대기열에 등록됩니다. 상태 머신은 ` event `에 대한 소유권을 확보한 후 처리가 완료되면 이를 삭제합니다.

[invokable] void QScxmlStateMachine::submitEvent(const QString &eventName)

지정된 eventName 를 이름으로 하는 외부 이벤트를 생성하고 제출하는 유틸리티 메서드입니다.

[invokable] void QScxmlStateMachine::submitEvent(const QString &eventName, const QVariant &data)

지정된 ` eventName `를 이름으로, ` data `를 페이로드 데이터로 사용하여 외부 이벤트를 생성하고 제출하는 유틸리티 메서드입니다.