QStateMachine Class

QPushButton button;

QStateMachine machine;
QState *s1 = new QState();
s1->assignProperty(&button, "text", "Click me");

QFinalState *s2 = new QFinalState();
s1->addTransition(&button, &QPushButton::clicked, s2);

machine.addState(s1);
machine.addState(s2);
machine.setInitialState(s1);
machine.start();

멤버 함수 설명서

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

주어진 parent 을 사용하여 새로운 상태 머신을 생성합니다.

[virtual noexcept] QStateMachine::~QStateMachine()

이 상태 머신을 파괴합니다.

void QStateMachine::addDefaultAnimation(QAbstractAnimation *animation)

모든 전환 시 고려될 기본 animation 을 추가합니다.

void QStateMachine::addState(QAbstractState *state)

지정된 state 를 이 상태 머신에 추가합니다. 해당 상태는 최상위 상태가 되며, 상태 머신이 해당 상태에 대한 소유권을 갖게 됩니다.

해당 상태가 이미 다른 머신에 속해 있는 경우, 먼저 기존 머신에서 제거된 후 이 머신에 추가됩니다.

removeState() 및 setInitialState()도 참조하십시오 .

bool QStateMachine::cancelDelayedEvent(int id)

주어진 ` id`로 식별되는 지연 이벤트를 취소합니다. `id`는 ` postDelayedEvent()` 호출에서 반환된 값이어야 합니다. 이벤트가 성공적으로 취소되면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

참고: 이 함수는 스레드 안전합니다.

postDelayedEvent()도 참조하십시오 .

void QStateMachine::clearError()

상태 머신의 오류 문자열과 오류 코드를 지웁니다.

QSet<QAbstractState *> QStateMachine::configuration() const

이 상태 기계가 현재 속해 있는 상태(병렬 상태 및 최종 상태 포함)의 최대 일관 집합을 반환합니다. 상태 s 가 구성(configuration)에 포함되어 있다면, s 의 부모 상태도 항상 c에 포함됩니다. 단, 상태 기계 자체는 구성의 명시적인 구성원이 아니라는 점에 유의하십시오.

QList<QAbstractAnimation *> QStateMachine::defaultAnimations() const

모든 전환에 적용될 수 있는 기본 애니메이션 목록을 반환합니다.

QStateMachine::Error QStateMachine::error() const

상태 머신에서 발생한 가장 최근 오류의 오류 코드를 반환합니다.

QString QStateMachine::errorString() const

상태 기계에서 발생한 가장 최근 오류의 오류 문자열을 반환합니다.

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

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

[override virtual] bool QStateMachine::eventFilter(QObject *watched, QEvent *event)

QObject::eventFilter(QObject *watched, QEvent *event)를 재구현합니다.

QState::RestorePolicy QStateMachine::globalRestorePolicy() const

상태 머신의 복원 정책을 반환합니다.

setGlobalRestorePolicy()도 참조하십시오 .

bool QStateMachine::isAnimated() const

이 상태 머신에서 애니메이션이 활성화되어 있는지 여부를 반환합니다.

[override virtual protected] void QStateMachine::onEntry(QEvent *event)

QState::onEntry(QEvent *event)를 재구현합니다.

이 함수는 start()을 호출하여 상태 머신을 시작합니다.

[override virtual protected] void QStateMachine::onExit(QEvent *event)

QState::onExit(QEvent *event)를 재구현합니다.

이 함수는 stop()를 호출하여 상태 머신을 중지한 후, stopped() 신호를 발생시킵니다.

int QStateMachine::postDelayedEvent(QEvent *event, int delay)

지정된 event 를 이 상태 머신에서 처리하도록 게시하며, 지정된 delay (밀리초 단위)만큼 지연시킵니다. 지연된 이벤트와 연관된 식별자를 반환하며, 이벤트를 게시할 수 없는 경우 -1을 반환합니다.

이 함수는 즉시 반환됩니다. 지연 시간이 만료되면 이벤트는 처리를 위해 상태 머신의 이벤트 큐에 추가됩니다. 상태 머신은 이벤트에 대한 소유권을 가져가며, 처리가 완료되면 해당 이벤트를 삭제합니다.

상태 머신이 실행 중일 때만 이벤트를 게시할 수 있습니다.

참고: 이 함수는 스레드 안전합니다.

cancelDelayedEvent() 및 postEvent()도 참조하십시오 .

int QStateMachine::postDelayedEvent(QEvent *event, std::chrono::milliseconds delay)

지정된 event 를 이 상태 머신에서 처리하도록 게시하며, 지정된 delay (밀리초 단위)만큼 지연시킵니다. 지연된 이벤트와 연관된 식별자를 반환하며, 이벤트를 게시할 수 없는 경우에는 -1을 반환합니다.

이 함수는 즉시 반환됩니다. 지연 시간이 만료되면 이벤트는 처리를 위해 상태 머신의 이벤트 큐에 추가됩니다. 상태 머신은 이벤트에 대한 소유권을 가져가며, 처리가 완료되면 해당 이벤트를 삭제합니다.

상태 머신이 실행 중일 때만 이벤트를 게시할 수 있습니다.

참고: 이 함수는 스레드 안전합니다.

cancelDelayedEvent() 및 postEvent()도 참조하십시오 .

void QStateMachine::postEvent(QEvent *event, QStateMachine::EventPriority priority = NormalPriority)

지정된 priority 의 지정된 event 를 이 상태 머신에서 처리할 수 있도록 게시합니다.

이 함수는 즉시 반환됩니다. 이벤트는 상태 머신의 이벤트 큐에 추가됩니다. 이벤트는 게시된 순서대로 처리됩니다. 상태 머신은 이벤트의 소유권을 인수하며, 처리가 완료되면 해당 이벤트를 삭제합니다.

이벤트는 상태 머신이 실행 중이거나 시작 중인 경우에만 게시할 수 있습니다.

참고: 이 함수는 스레드 안전합니다.

postDelayedEvent()도 참조하십시오 .

void QStateMachine::removeDefaultAnimation(QAbstractAnimation *animation)

기본 애니메이션 목록에서 ‘ animation ’을 제거합니다.

void QStateMachine::removeState(QAbstractState *state)

지정된 state 를 이 상태 머신에서 제거합니다. 상태 머신은 해당 상태에 대한 소유권을 해제합니다.

addState()도 참조하십시오 .

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

이 신호는 ` running `를 인수로 사용하여 실행 중인 속성이 변경될 때 발생합니다.

QStateMachine::running도 참조하십시오 .

void QStateMachine::setAnimated(bool enabled)

이 상태 머신에서 애니메이션이 ‘ enabled ’인지 여부를 설정합니다.

isAnimated()도 참조하십시오 .

void QStateMachine::setGlobalRestorePolicy(QState::RestorePolicy restorePolicy)

상태 머신의 복원 정책을 ‘ restorePolicy ’로 설정합니다. 기본 복원 정책은 ‘ QState::DontRestoreProperties ’입니다.

참조: globalRestorePolicy()

[slot] void QStateMachine::start()

이 상태 머신을 시작합니다. 상태 머신은 구성을 초기화하고 초기 상태로 전환합니다. 최상위 최종 상태(QFinalState)에 진입하면, 상태 머신은 finished() 신호를 발생시킵니다.

관련 항목: started(), finished(), stop(), initialState() 및 setRunning().

[private signal] void QStateMachine::started()

이 신호는 상태 머신이 초기 상태(QStateMachine::initialState)에 진입했을 때 발신됩니다.

QStateMachine::finished() 및 QStateMachine::start()도 참조하십시오 .

[slot] void QStateMachine::stop()

이 상태 머신을 중지합니다. 상태 머신은 이벤트 처리를 중지한 후 stopped() 신호를 발신합니다.

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

[private signal] void QStateMachine::stopped()

이 신호는 상태 머신이 정지했을 때 전송됩니다.

QStateMachine::stop() 및 QStateMachine::finished()도 참조하십시오 .