이 페이지에서

QAbstractState Class

QAbstractState 클래스는 QStateMachine 의 상태들에 대한 기본 클래스입니다. 더 보기...

헤더: #include <QAbstractState>
CMake: find_package(Qt6 REQUIRED COMPONENTS StateMachine)
target_link_libraries(mytarget PRIVATE Qt6::StateMachine)
qmake: QT += statemachine
상속: QObject
상속받는 항목:

QFinalState, QHistoryState 및 QState

속성

공개 함수

virtual ~QAbstractState()
bool active() const
QBindable<bool> bindableActive()
QStateMachine *machine() const
QState *parentState() const

신호

void activeChanged(bool active)
void entered()
void exited()

보호된 함수

QAbstractState(QState *parent = nullptr)
virtual void onEntry(QEvent *event) = 0
virtual void onExit(QEvent *event) = 0

재구현된 보호된 함수

virtual bool event(QEvent *e) override

상세 설명

QAbstractState 클래스는 QStateMachine 의 일부인 상태들의 추상 기본 클래스입니다. 이 클래스는 모든 상태 객체가 공통으로 갖는 인터페이스를 정의합니다. QAbstractState는 Qt State Machine 프레임워크의 일부입니다.

entered() 신호는 해당 상태로 진입했을 때 발생합니다. exited() 신호는 해당 상태에서 빠져나왔을 때 발생합니다.

parentState() 함수는 해당 상태의 부모 상태를 반환합니다. machine() 함수는 해당 상태가 속한 상태 머신을 반환합니다.

서브클래스 생성

onEntry() 함수는 상태에 진입할 때 호출됩니다. 상태에 진입할 때 사용자 정의 처리를 수행하려면 이 함수를 재구현하십시오.

onExit() 함수는 상태에서 빠져나올 때 호출됩니다. 이 함수를 재구현하여 상태에서 빠져나올 때 사용자 정의 처리를 수행할 수 있습니다.

속성 문서

[bindable read-only] active : bool

참고: 이 속성은 QProperty 바인딩을 지원합니다.

이 속성은 해당 상태의 활성 상태를 유지합니다. 상태는 entered() 신호와 exited() 신호 사이에서 활성 상태를 유지합니다.

액세스 함수:

bool active() const

알림 신호:

void activeChanged(bool active)

멤버 함수 문서

[protected] QAbstractState::QAbstractState(QState *parent = nullptr)

지정된 ‘ parent ’ 상태를 사용하여 새로운 상태를 생성합니다.

[virtual noexcept] QAbstractState::~QAbstractState()

이 상태를 제거합니다.

bool QAbstractState::active() const

이 상태가 활성화되어 있는지 여부를 반환합니다.

참고: active 속성에 대한게터 함수입니다.

activeChanged(bool), entered(), exited()도 참조하십시오 .

[signal] void QAbstractState::activeChanged(bool active)

이 신호는 ` active `를 인자로 사용하여 활성 속성이 변경될 때 발생합니다.

참고: active 속성에 대한알림 신호입니다.

QAbstractState::active, entered() 및 exited()도 참조하십시오 .

[private signal] void QAbstractState::entered()

이 신호는 해당 상태로 진입했을 때( onEntry()가 호출된 후) 발신됩니다.

참고: 이 신호는 비공개 신호입니다. 신호 연결에서 사용할 수는 있지만, 사용자가 직접 발생시킬 수는 없습니다.

[override virtual protected] bool QAbstractState::event(QEvent *e)

QObject::event(QEvent *e)를 재구현합니다.

[private signal] void QAbstractState::exited()

이 신호는 상태가 종료되었을 때( onExit()가 호출된 후) 발신됩니다.

참고: 이 신호는 비공개 신호입니다. 신호 연결에서 사용할 수는 있지만, 사용자가 직접 발생시킬 수는 없습니다.

QStateMachine *QAbstractState::machine() const

이 상태가 속해 있는 상태 머신을 반환하거나, 해당 상태가 어떤 상태 머신에도 속하지 않는 경우 ` nullptr `를 반환합니다.

[pure virtual protected] void QAbstractState::onEntry(QEvent *event)

이 함수는 해당 상태에 진입할 때 호출됩니다. 전달된 ` event `는 해당 상태에 진입하게 된 원인을 나타냅니다. 상태에 진입할 때 사용자 정의 처리를 수행하려면 이 함수를 재구현하십시오.

[pure virtual protected] void QAbstractState::onExit(QEvent *event)

이 함수는 상태에서 빠져나올 때 호출됩니다. 전달된 ` event `는 상태에서 빠져나오게 된 원인입니다. 상태에서 빠져나올 때 사용자 정의 처리를 수행하려면 이 함수를 재구현하십시오.

QState *QAbstractState::parentState() const

이 상태의 상위 상태를 반환하며, 해당 상태에 상위 상태가 없는 경우 ` nullptr `를 반환합니다.

© 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.