AbstractMessageType is a homogeneous message type handle to an existing message type. More...

#include <kanzi/core/message/abstract_message_type.hpp>

Public Types
using	ArgumentsType = MessageArguments
	Alias for associated message arguments class. More...

using	FunctionType = function< void(MessageArguments &)>
	Alias for compatible handler functions. More...

Public Member Functions
	AbstractMessageType ()=default
	Constructor. More...

	AbstractMessageType (string_view name)
	Constructor. More...

	AbstractMessageType (const AbstractMessageTypeDescriptor *descriptor)
	Constructor. More...

const AbstractMessageTypeDescriptor *	get () const
	Gets the AbstractMessageTypeDescriptor of the AbstractMessageType. More...

const Metaclass *	getArgumentsMetaclass () const
	Gets the metaclass of the message arguments associated with a message type. More...

PropertyTypeEditorInfoSharedPtr	getEditorInfo () const
	Gets the editor information for a message type. More...

string	getName () const
	Gets the fully qualified name of a message type in the form "Class.MessageType". More...

MessageRouting	getRouting () const
	Gets the message routing of a message type. More...

	operator bool () const

Friends
template<typename T >
class	DynamicMessageType

template<typename T >
class	MessageType

bool	operator!= (const AbstractMessageType &left, const AbstractMessageType &right)

bool	operator< (const AbstractMessageType &left, const AbstractMessageType &right)

bool	operator== (const AbstractMessageType &left, const AbstractMessageType &right)

Detailed Description

AbstractMessageType is a homogeneous message type handle to an existing message type.

You can use AbstractMessageType to operate on message types when a message type and its arguments type are unknown or irrelevant. It is usually more convenient to pass AbstractMessageType as a function argument instead of specifying the exact message type with certain message arguments. MessageType has a converting operator to AbstractMessageType. This enables you to pass MessageType directly to functions taking AbstractMessageType argument.

You can query generic non-message arguments specific message type information from an instance of an AbstractMessageType. You can also dispatch messages from a node with an instance of AbstractMessageType. To add message handlers of specific type, you must construct a DynamicMessageType.

Examples

To construct an AbstractMessageType with a fully qualified message type name:

        // Use the fully qualified name to create an AbstractMessageType object, which you can
        // use to refer to an existing message type in the Kanzi message system.
        // To see the fully qualified name for a message type in Kanzi Studio, in the Triggers
        // window hover over the name of that message type.
        AbstractMessageType messageType("ExampleNode2D.ExampleMessage");

To dispatch a message using the created AbstractMessageType:

        // Initialize the message that you want to dispatch.
        MessageArguments messageArguments;
        // Use the interface of Node to dispatch messages using AbstractMessageType.
        node->dispatchAbstractMessage(messageType, messageArguments);

Member Typedef Documentation

using kanzi::AbstractMessageType::ArgumentsType = MessageArguments

Alias for associated message arguments class.

using kanzi::AbstractMessageType::FunctionType = function<void(MessageArguments&)>

Alias for compatible handler functions.

Constructor & Destructor Documentation

kanzi::AbstractMessageType::AbstractMessageType ( )

explicitdefault

Constructor.

Creates an empty AbstractMessageType instance.

kanzi::AbstractMessageType::AbstractMessageType ( string_view name )

inlineexplicit

Constructor.

Creates an AbstractMessageType instance referring to an existing message type with the given name. If a message type with the given name does not already exist in the Kanzi message system, the created AbstractMessageType instance is empty.

Parameters

name	Fully qualified name of the message type.

kanzi::AbstractMessageType::AbstractMessageType ( const AbstractMessageTypeDescriptor * descriptor )

inlineexplicit

Constructor.

Creates an AbstractMessageType instance referring to the given descriptor. If passed descriptor is null, the created AbstractMessageType instance is empty.

Note: This constructor solves a special case, prefer to use the other overloads.

Parameters

descriptor The descriptor for the message type.

Member Function Documentation

const AbstractMessageTypeDescriptor* kanzi::AbstractMessageType::get ( ) const

inline

Gets the AbstractMessageTypeDescriptor of the AbstractMessageType.

Returns: The AbstractMessageTypeDescriptor pointer of the AbstractMessageType.

PropertyTypeEditorInfoSharedPtr kanzi::AbstractMessageType::getEditorInfo ( ) const

inline

Gets the editor information for a message type.

Returns: The editor information for the message type.

string kanzi::AbstractMessageType::getName ( ) const

inline

Gets the fully qualified name of a message type in the form "Class.MessageType".

Returns: The fully qualified name of the message type.

MessageRouting kanzi::AbstractMessageType::getRouting ( ) const

inline

Gets the message routing of a message type.

Returns: MessageRouting mode of the message type.

const Metaclass* kanzi::AbstractMessageType::getArgumentsMetaclass ( ) const

inline

Gets the metaclass of the message arguments associated with a message type.

Returns: The Metaclass pointer of the message arguments associated with the AbstractMessageType.

kanzi::AbstractMessageType::operator bool ( ) const

inlineexplicit

Friends And Related Function Documentation

template<typename T >

friend class MessageType

friend

template<typename T >

friend class DynamicMessageType

friend

bool operator==	(	const AbstractMessageType &	left,
		const AbstractMessageType &	right
	)

friend

bool operator!=	(	const AbstractMessageType &	left,
		const AbstractMessageType &	right
	)

friend

bool operator<	(	const AbstractMessageType &	left,
		const AbstractMessageType &	right
	)

friend

The documentation for this class was generated from the following file:

kanzi/core/message/abstract_message_type.hpp

Public Types

Public Member Functions

Friends

Detailed Description

Examples

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation