Isle
Loading...
Searching...
No Matches
MxActionNotificationParam Class Reference

[AI] Notification parameter class that contains information about an MxDSAction, used for inter-object notifications related to dynamic script (SI) actions. More...

#include <mxactionnotificationparam.h>

Inheritance diagram for MxActionNotificationParam:
Collaboration diagram for MxActionNotificationParam:

Public Member Functions

 MxActionNotificationParam (NotificationId p_type, MxCore *p_sender, MxDSAction *p_action, MxBool p_reallocAction)
 [AI] Constructs the action notification parameter, optionally cloning the action if requested. More...
 
 ~MxActionNotificationParam () override
 [AI] Destructor releases the action if this object owns it (realloc flag set). [AI] More...
 
MxNotificationParamClone () const override
 [AI] Creates a clone of this notification parameter with the same state. More...
 
MxDSActionGetAction ()
 [AI] Direct access to the underlying action. More...
 
- Public Member Functions inherited from MxNotificationParam
 MxNotificationParam ()
 [AI] Constructs a default notification parameter with type c_notificationType0 and no sender. More...
 
 MxNotificationParam (NotificationId p_type, MxCore *p_sender)
 [AI] Constructs a notification parameter with a specific type and sender. More...
 
virtual MxNotificationParamClone () const
 [AI] Creates a copy of this notification parameter object on the heap. More...
 
NotificationId GetNotification () const
 [AI] Retrieves the current notification type of this parameter. More...
 
MxCoreGetSender () const
 [AI] Retrieves the sender pointer associated with this notification. More...
 
void SetNotification (NotificationId p_type)
 [AI] Sets the notification type for this parameter object. More...
 
void SetSender (MxCore *p_sender)
 [AI] Sets the sender pointer for this notification parameter. More...
 
- Public Member Functions inherited from MxParam
virtual ~MxParam ()
 [AI] Virtual destructor for safe polymorphic deletion of derived parameter objects. More...
 

Protected Attributes

MxDSActionm_action
 [AI] Associated action (owned if m_realloc is true). [AI] More...
 
MxBool m_realloc
 [AI] TRUE if this object owns and should free m_action. [AI] More...
 
- Protected Attributes inherited from MxNotificationParam
NotificationId m_type
 [AI] Type of notification/event carried by this object (see NotificationId). More...
 
MxCorem_sender
 [AI] Pointer to the MxCore instance that sent or originated this notification. More...
 

Detailed Description

[AI] Notification parameter class that contains information about an MxDSAction, used for inter-object notifications related to dynamic script (SI) actions.

It can optionally own/reallocate its action. [AI]

[AI] Derived from MxNotificationParam, this class extends notifications to carry an action and "realloc" flag, typically signaling start/end/progress of script actions. It supports cloning and optional deep copy creation of the action. [AI]

Definition at line 14 of file mxactionnotificationparam.h.

Constructor & Destructor Documentation

◆ MxActionNotificationParam()

MxActionNotificationParam::MxActionNotificationParam ( NotificationId  p_type,
MxCore p_sender,
MxDSAction p_action,
MxBool  p_reallocAction 
)
inline

[AI] Constructs the action notification parameter, optionally cloning the action if requested.

[AI]

Parameters
p_typeNotification type that identifies the notification event. [AI]
p_senderThe object sending the notification. [AI]
p_actionThe MxDSAction associated with the notification. [AI]
p_reallocActionIf TRUE, clones the input action for ownership; if FALSE, just references it. [AI]

Definition at line 21 of file mxactionnotificationparam.h.

◆ ~MxActionNotificationParam()

MxActionNotificationParam::~MxActionNotificationParam ( )
inlineoverride

[AI] Destructor releases the action if this object owns it (realloc flag set). [AI]

Definition at line 41 of file mxactionnotificationparam.h.

Member Function Documentation

◆ Clone()

MxNotificationParam * MxActionNotificationParam::Clone ( ) const
inlineoverridevirtual

[AI] Creates a clone of this notification parameter with the same state.

[AI]

Returns
A new MxActionNotificationParam allocated on the heap. [AI]

Reimplemented from MxNotificationParam.

Reimplemented in MxStartActionNotificationParam, MxEndActionNotificationParam, and MxType4NotificationParam.

Definition at line 54 of file mxactionnotificationparam.h.

◆ GetAction()

MxDSAction * MxActionNotificationParam::GetAction ( )
inline

[AI] Direct access to the underlying action.

[AI]

Returns
Pointer to the contained MxDSAction (may or may not be owned). [AI]

Definition at line 61 of file mxactionnotificationparam.h.

Member Data Documentation

◆ m_action

MxDSAction* MxActionNotificationParam::m_action
protected

[AI] Associated action (owned if m_realloc is true). [AI]

Definition at line 64 of file mxactionnotificationparam.h.

◆ m_realloc

MxBool MxActionNotificationParam::m_realloc
protected

[AI] TRUE if this object owns and should free m_action. [AI]

Definition at line 65 of file mxactionnotificationparam.h.


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