lxgui
Public Member Functions | List of all members
lxgui::gui::event_emitter Class Reference

Generates events and keep tracks of registered callbacks. More...

#include <gui_event_emitter.hpp>

Public Member Functions

 event_emitter ()=default
 Default constructor. More...
 
 event_emitter (const event_emitter &)=delete
 
 event_emitter (event_emitter &&)=delete
 
event_emitteroperator= (const event_emitter &)=delete
 
event_emitteroperator= (event_emitter &&)=delete
 
utils::connection register_event (const std::string &event_name, event_handler_function callback)
 Registers a callback to an event. More...
 
void fire_event (const std::string &event_name, event_data data=event_data{})
 Emmit a new event. More...
 

Detailed Description

Generates events and keep tracks of registered callbacks.

Definition at line 23 of file gui_event_emitter.hpp.

Constructor & Destructor Documentation

◆ event_emitter() [1/3]

lxgui::gui::event_emitter::event_emitter ( )
default

Default constructor.

◆ event_emitter() [2/3]

lxgui::gui::event_emitter::event_emitter ( const event_emitter )
delete

◆ event_emitter() [3/3]

lxgui::gui::event_emitter::event_emitter ( event_emitter &&  )
delete

Member Function Documentation

◆ fire_event()

void lxgui::gui::event_emitter::fire_event ( const std::string &  event_name,
event_data  data = event_data{} 
)

Emmit a new event.

Parameters
event_nameThe ID of the event which has occurred
dataThe payload of the event

Definition at line 10 of file gui_event_emitter.cpp.

◆ operator=() [1/2]

event_emitter& lxgui::gui::event_emitter::operator= ( const event_emitter )
delete

◆ operator=() [2/2]

event_emitter& lxgui::gui::event_emitter::operator= ( event_emitter &&  )
delete

◆ register_event()

utils::connection lxgui::gui::event_emitter::register_event ( const std::string &  event_name,
event_handler_function  callback 
)

Registers a callback to an event.

Parameters
event_nameThe name of the event to listen to
callbackThe function to execute when the event is triggered
Returns
A object representing the connection between this emitter and the callback.
Note
To avoid dangling references, the caller should store the returned connection object, and use it to terminate the connection when the owner of the callback is destroyed. This can be done automatically if using the event_receiver helper class.
See also
fire_event

Definition at line 6 of file gui_event_emitter.cpp.


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