QScxmlEvent Class
QScxmlEvent 클래스는 Qt SCXML 상태 머신의 이벤트입니다. 더 보기...
| 헤더: | #include <QScxmlEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Scxml) target_link_libraries(mytarget PRIVATE Qt6::Scxml) |
| qmake: | QT += scxml |
공개 유형
| enum | EventType { PlatformEvent, InternalEvent, ExternalEvent } |
속성
|
|
공개 함수
| QScxmlEvent() | |
| QScxmlEvent(const QScxmlEvent &other) | |
| ~QScxmlEvent() | |
| void | clear() |
| QVariant | data() const |
| int | delay() const |
| QString | errorMessage() const |
| QScxmlEvent::EventType | eventType() const |
| QString | invokeId() const |
| bool | isErrorEvent() const |
| QString | name() const |
| QString | origin() const |
| QString | originType() const |
| QString | scxmlType() const |
| QString | sendId() const |
| void | setData(const QVariant &data) |
| void | setDelay(int delayInMiliSecs) |
| void | setErrorMessage(const QString &message) |
| void | setEventType(const QScxmlEvent::EventType &type) |
| void | setInvokeId(const QString &invokeid) |
| void | setName(const QString &name) |
| void | setOrigin(const QString &origin) |
| void | setOriginType(const QString &origintype) |
| void | setSendId(const QString &sendid) |
| QScxmlEvent & | operator=(const QScxmlEvent &other) |
상세 설명
SCXML 이벤트는 상태 전환을 유도합니다. 대부분의 이벤트는 애플리케이션 내에서 <raise> 및 <send> 요소를 사용하여 생성됩니다. 상태 머신은 오류와 같은 일부 필수 이벤트를 자동으로 생성합니다.
자세한 내용은 SCXML 사양 - 5.10.1 이벤트의 내부 구조를 참조하십시오. Qt SCXML API가 사양과 어떻게 다른지에 대한 자세한 내용은 SCXML 준수를 참조하십시오.
QScxmlStateMachine도 참조하십시오 .
멤버 유형 문서
enum QScxmlEvent::EventType
이 열거형 유형은 SCXML 이벤트의 유형을 지정합니다:
| 상수 | 값 | 설명 |
|---|---|---|
QScxmlEvent::PlatformEvent | 0 | 상태 머신에 의해 내부적으로 생성된 이벤트입니다. 예를 들어, 오류 등이 있습니다. |
QScxmlEvent::InternalEvent | 1 | <raise> 요소에 의해 생성된 이벤트입니다. |
QScxmlEvent::ExternalEvent | 2 | <send> 요소에 의해 생성된 이벤트입니다. |
속성 문서
data : QVariant
이 속성에는 발신자가 포함시킨 데이터가 저장됩니다.
<send> 요소 내에서 <param> 요소가 사용될 경우, 데이터에는 QVariantMap 가 포함되며, 이때 키는 name 속성이 되고 값은 expr 속성 또는 location 속성에서 가져옵니다.
<content> 요소가 사용될 경우, 데이터에는 <content> 요소의 expr 속성 값이나 <content> 요소의 하위 데이터 중 하나를 가진 단일 항목이 포함됩니다.
액세스 함수:
delay : int
이 속성은 ` <send> ` 요소를 처리한 후 이벤트가 전달되기까지의 지연 시간을 밀리초 단위로 저장합니다.
액세스 함수:
[read-only] errorEvent : bool
이 속성은 해당 이벤트가 오류를 나타내는지 여부를 나타냅니다.
액세스 함수:
| bool | isErrorEvent() const |
errorMessage : QString
이 속성은 오류 이벤트에 대한 오류 메시지 또는 빈 QString 를 포함합니다.
액세스 함수:
| QString | errorMessage() const |
| void | setErrorMessage(const QString &message) |
eventType : EventType
이 속성은 이벤트의 유형을 저장합니다.
액세스 함수:
| QScxmlEvent::EventType | eventType() const |
| void | setEventType(const QScxmlEvent::EventType &type) |
invokeId : QString
이 속성은 이벤트가 상태 머신에 의해 생성된 경우, 호출된 상태 머신의 ID를 저장합니다.
액세스 함수:
| QString | invokeId() const |
| void | setInvokeId(const QString &invokeid) |
name : QString
이 속성은 이벤트의 이름을 포함합니다.
이벤트가 SCXML 문서 내에서 생성된 경우, 이 속성은 <raise> 또는 <send> 요소 내에 지정된 이벤트 속성의 값을 포함합니다.
이벤트가 C++ 코드에서 생성되어 QScxmlStateMachine 로 제출된 경우, 이 속성의 값은 SCXML 문서의 <transition> 요소 내에 지정된 이벤트 속성의 값과 대조됩니다.
액세스 함수:
origin : QString
이 속성은 SCXML 이벤트의 원본을 가리키는 URI를 포함합니다.
이 'origin'은 <send> 요소의 'target' 속성과 동일합니다.
액세스 함수:
originType : QString
이 속성은 SCXML 이벤트의 원본 유형을 나타냅니다.
origin 유형은 <send> 요소의 type 속성과 동일합니다.
액세스 함수:
| QString | originType() const |
| void | setOriginType(const QString &origintype) |
[read-only] scxmlType : QString
이 속성은 이벤트 유형을 나타냅니다.
액세스 함수:
| QString | scxmlType() const |
sendId : QString
이 속성은 이벤트의 ID를 저장합니다.
이 ID는 ` <cancel> ` 요소가 취소할 이벤트를 식별하는 데 사용됩니다.
참고: ` <send> ` 요소에 `id ` 속성이 지정되지 않은 경우, 상태머신이 고유한 ID를 생성합니다. 생성된 ID는 이 속성을 통해 확인할 수 있습니다.
액세스 함수:
멤버 함수 설명서
QScxmlEvent::QScxmlEvent()
새로운 외부 SCXML 이벤트를 생성합니다.
QScxmlEvent::QScxmlEvent(const QScxmlEvent &other)
other 의 복사본을 생성합니다.
[noexcept] QScxmlEvent::~QScxmlEvent()
SCXML 이벤트를 삭제합니다.
[invokable] void QScxmlEvent::clear()
이벤트의 내용을 지웁니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
QVariant QScxmlEvent::data() const
발신자가 포함시킨 데이터를 반환합니다.
참고: data 속성에 대한게터 함수입니다.
setData()도 참조하십시오 .
int QScxmlEvent::delay() const
<send> 요소를 처리한 후 이 이벤트가 전달되기까지 걸리는 지연 시간을 밀리초 단위로 반환합니다.
참고: delay 속성에 대한게터 함수입니다.
참조 : `setDelay()`도 참조하십시오 .
QString QScxmlEvent::errorMessage() const
오류 이벤트인 경우 오류 메시지를 반환합니다. 그렇지 않은 경우 빈 ` QString`를 반환합니다.
참고: errorMessage 속성에 대한게터 함수입니다.
참조: setErrorMessage().
QScxmlEvent::EventType QScxmlEvent::eventType() const
이 이벤트의 유형을 반환합니다.
참고: eventType 속성에 대한게터 함수입니다.
setEventType() 및 QScxmlEvent::EventType도 참조하십시오 .
QString QScxmlEvent::invokeId() const
이 이벤트가 호출된 상태 머신에 의해 생성된 경우, ` <invoke> ` 요소의 ID를 반환합니다. 그렇지 않은 경우, 빈 값을 반환합니다.
참고: invokeId 속성에 대한게터 함수입니다.
참조: ` setInvokeId()`
bool QScxmlEvent::isErrorEvent() const
이것이 오류 이벤트일 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false `를 반환합니다.
참고: errorEvent 속성에 대한게터 함수입니다.
QString QScxmlEvent::name() const
이벤트의 이름을 반환합니다.
참고: 속성 name에 대한게터 함수입니다.
setName()도 참조하십시오 .
QString QScxmlEvent::origin() const
SCXML 이벤트의 원본을 가리키는 URI를 반환합니다.
참고: origin 속성에 대한게터 함수입니다.
setOrigin()도 참조하십시오 .
QString QScxmlEvent::originType() const
SCXML 이벤트의 원본 유형을 반환합니다.
참고: originType 속성에 대한게터 함수입니다.
setOriginType()도 참조하십시오 .
QString QScxmlEvent::scxmlType() const
이벤트 유형을 반환합니다.
참고: scxmlType 속성에 대한게터 함수입니다.
QString QScxmlEvent::sendId() const
이벤트의 ID를 반환합니다.
참고: sendId 속성에 대한게터 함수입니다.
setSendId()도 참조하십시오 .
void QScxmlEvent::setData(const QVariant &data)
페이로드 데이터를 ` data`로 설정합니다.
참고: data 속성에 대한세터 함수입니다.
QScxmlEvent::data도 참조하십시오 .
void QScxmlEvent::setDelay(int delayInMiliSecs)
delayInMiliSecs 의 값으로 지연 시간을 밀리초 단위로 설정합니다.
참고: delay 속성에 대한세터 함수입니다.
QScxmlEvent::delay도 참조하십시오 .
void QScxmlEvent::setErrorMessage(const QString &message)
이것이 오류 이벤트인 경우, message 가 오류 메시지로 설정됩니다.
참고: errorMessage 속성에 대한세터 함수입니다.
errorMessage()도 참조하십시오 .
void QScxmlEvent::setEventType(const QScxmlEvent::EventType &type)
이벤트 유형을 ‘ type ’로 설정합니다.
참고: eventType 속성에 대한세터 함수입니다.
QScxmlEvent::eventType 및 QScxmlEvent::EventType도 참조하십시오 .
void QScxmlEvent::setInvokeId(const QString &invokeid)
호출된 상태 머신의 ID를 ` invokeid`로 설정합니다.
참고: invokeId 속성에 대한세터 함수입니다.
QScxmlEvent::invokeId도 참조하십시오 .
void QScxmlEvent::setName(const QString &name)
이벤트의 이름을 ‘ name ’로 설정합니다.
참고: name 속성에 대한설정 함수입니다.
name()도 참조하십시오 .
void QScxmlEvent::setOrigin(const QString &origin)
SCXML 이벤트의 원점을 origin 로 설정합니다.
참고: origin 속성에 대한세터 함수입니다.
QScxmlEvent::origin도 참조하십시오 .
void QScxmlEvent::setOriginType(const QString &origintype)
SCXML 이벤트의 원점 유형을 ` origintype`로 설정합니다.
참고: 속성 originType 에 대한세터 함수입니다.
QScxmlEvent::originType도 참조하십시오 .
void QScxmlEvent::setSendId(const QString &sendid)
이 이벤트의 ID를 ‘ sendid ’로 설정합니다.
참고: sendId 속성에 대한설정 함수입니다.
sendId()도 참조하십시오 .
QScxmlEvent &QScxmlEvent::operator=(const QScxmlEvent &other)
이 SCXML 이벤트에 ` other `를 할당하고, 이 SCXML 이벤트에 대한 참조를 반환합니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
