QScxmlEvent#

The QScxmlEvent class is an event for a Qt SCXML state machine. More

Synopsis#

Properties#

  • data - The data included by the sender

  • delay - In milliseconds after which the event is to be delivered after processing the <send> element

  • errorEvent - Whether the event represents an error

  • errorMessage - An error message for an error event, or an empty QString

  • eventType - The type of the event

  • invokeId - The ID of the invoked state machine if the event is generated by one

  • name - The name of the event

  • origin - The URI that points to the origin of an SCXML event

  • originType - The origin type of an SCXML event

  • scxmlType - Event type

  • sendId - The ID of the event

Functions#

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

SCXML events drive transitions. Most events are generated by using the <raise> and <send> elements in the application. The state machine automatically generates some mandatory events, such as errors.

For more information, see SCXML Specification - 5.10.1 The Internal Structure of Events . For more information about how the Qt SCXML API differs from the specification, see SCXML Compliance .

class PySide6.QtScxml.QScxmlEvent#

PySide6.QtScxml.QScxmlEvent(other)

Parameters:

otherPySide6.QtScxml.QScxmlEvent

Creates a new external SCXML event.

Constructs a copy of other.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.QtScxml.QScxmlEvent.data: object#

This property holds the data included by the sender..

When <param> elements are used in the <send> element, the data will contain a QVariantMap where the key is the name attribute, and the value is taken from the expr attribute or the location attribute.

When a <content> element is used, the data will contain a single item with either the value of the expr attribute of the <content> element or the child data of the <content> element.

Access functions:
property PᅟySide6.QtScxml.QScxmlEvent.delay: int#

This property holds The delay in milliseconds after which the event is to be delivered after processing the <send> element..

Access functions:
property PᅟySide6.QtScxml.QScxmlEvent.errorEvent: bool#

This property holds Whether the event represents an error..

Access functions:
property PᅟySide6.QtScxml.QScxmlEvent.errorMessage: str#

This property holds An error message for an error event, or an empty QString..

Access functions:
property PᅟySide6.QtScxml.QScxmlEvent.eventType: EventType#

This property holds the type of the event..

Access functions:
property PᅟySide6.QtScxml.QScxmlEvent.invokeId: str#

This property holds the ID of the invoked state machine if the event is generated by one..

Access functions:
property PᅟySide6.QtScxml.QScxmlEvent.name: str#

This property holds the name of the event..

If the event is generated inside the SCXML document, this property holds the value of the event attribute specified inside the <raise> or <send> element.

If the event is created in the C++ code and submitted to the QScxmlStateMachine , the value of this property is matched against the value of the event attribute specified inside the <transition> element in the SCXML document.

Access functions:
property PᅟySide6.QtScxml.QScxmlEvent.origin: str#

This property holds the URI that points to the origin of an SCXML event..

The origin is equivalent to the target attribute of the <send> element.

Access functions:
property PᅟySide6.QtScxml.QScxmlEvent.originType: str#

This property holds the origin type of an SCXML event..

The origin type is equivalent to the type attribute of the <send> element.

Access functions:
property PᅟySide6.QtScxml.QScxmlEvent.scxmlType: str#

This property holds The event type..

Access functions:
property PᅟySide6.QtScxml.QScxmlEvent.sendId: str#

This property holds the ID of the event..

The ID is used by the <cancel> element to identify the event to be canceled.

Note

The state machine generates a unique ID if the id attribute is not specified in the <send> element. The generated ID can be accessed through this property.

Access functions:
PySide6.QtScxml.QScxmlEvent.EventType#

This enum type specifies the type of an SCXML event:

Constant

Description

QScxmlEvent.PlatformEvent

An event generated internally by the state machine. For example, errors.

QScxmlEvent.InternalEvent

An event generated by a <raise> element.

QScxmlEvent.ExternalEvent

An event generated by a <send> element.

PySide6.QtScxml.QScxmlEvent.clear()#

Clears the contents of the event.

PySide6.QtScxml.QScxmlEvent.data()#
Return type:

object

Returns the data included by the sender.

See also

setData()

Getter of property data .

PySide6.QtScxml.QScxmlEvent.delay()#
Return type:

int

Returns the delay in milliseconds after which this event is to be delivered after processing the <send> element.

See also

setDelay()

Getter of property delay .

PySide6.QtScxml.QScxmlEvent.errorMessage()#
Return type:

str

If this is an error event, returns the error message. Otherwise, returns an empty QString.

Getter of property errorMessage .

PySide6.QtScxml.QScxmlEvent.eventType()#
Return type:

EventType

Returns the type of this event.

See also

setEventType() EventType

Getter of property eventType .

PySide6.QtScxml.QScxmlEvent.invokeId()#
Return type:

str

If this event is generated by an invoked state machine, returns the ID of the <invoke> element. Otherwise, returns an empty value.

See also

setInvokeId()

Getter of property invokeId .

PySide6.QtScxml.QScxmlEvent.isErrorEvent()#
Return type:

bool

Returns true when this is an error event, false otherwise.

Getter of property errorEvent .

PySide6.QtScxml.QScxmlEvent.name()#
Return type:

str

Returns the name of the event.

See also

setName()

Getter of property name .

PySide6.QtScxml.QScxmlEvent.origin()#
Return type:

str

Returns a URI that points to the origin of an SCXML event.

See also

setOrigin()

Getter of property origin .

PySide6.QtScxml.QScxmlEvent.originType()#
Return type:

str

Returns the origin type of an SCXML event.

See also

setOriginType()

Getter of property originType .

PySide6.QtScxml.QScxmlEvent.scxmlType()#
Return type:

str

Returns the event type.

Getter of property scxmlType .

PySide6.QtScxml.QScxmlEvent.sendId()#
Return type:

str

Returns the ID of the event.

See also

setSendId()

Getter of property sendId .

PySide6.QtScxml.QScxmlEvent.setData(data)#
Parameters:

data – object

Sets the payload data to data.

See also

data

Setter of property data .

PySide6.QtScxml.QScxmlEvent.setDelay(delayInMiliSecs)#
Parameters:

delayInMiliSecs – int

Sets the delay in milliseconds as the value of delayInMiliSecs.

See also

delay

Setter of property delay .

PySide6.QtScxml.QScxmlEvent.setErrorMessage(message)#
Parameters:

message – str

If this is an error event, the message is set as the error message.

See also

errorMessage()

Setter of property errorMessage .

PySide6.QtScxml.QScxmlEvent.setEventType(type)#
Parameters:

typeEventType

Sets the event type to type.

See also

eventType EventType

Setter of property eventType .

PySide6.QtScxml.QScxmlEvent.setInvokeId(invokeId)#
Parameters:

invokeId – str

Sets the ID of an invoked state machine to invokeid.

See also

invokeId

Setter of property invokeId .

PySide6.QtScxml.QScxmlEvent.setName(name)#
Parameters:

name – str

Sets the name of the event to name.

See also

name()

Setter of property name .

PySide6.QtScxml.QScxmlEvent.setOrigin(origin)#
Parameters:

origin – str

Sets the origin of an SCXML event to origin.

See also

origin

Setter of property origin .

PySide6.QtScxml.QScxmlEvent.setOriginType(originType)#
Parameters:

originType – str

Sets the origin type of an SCXML event to origintype.

See also

originType

Setter of property originType .

PySide6.QtScxml.QScxmlEvent.setSendId(sendId)#
Parameters:

sendId – str

Sets the ID sendid for this event.

See also

sendId()

Setter of property sendId .