Unigine::Widget Class

// implement the Remove event handler
void remove_event_handler(const Ptr<Widget> & widget)
{
	Log::message("\Handling Remove event\n");
}


//////////////////////////////////////////////////////////////////////////////
//  1. Multiple subscriptions can be linked to an instance of the EventConnections 
//  class that you can use later to remove all these subscriptions at once
//////////////////////////////////////////////////////////////////////////////

// create an instance of the EventConnections class
EventConnections remove_event_connections;

// link to this instance when subscribing to an event (subscription to various events can be linked)
publisher->getEventRemove().connect(remove_event_connections, remove_event_handler);

// other subscriptions are also linked to this EventConnections instance 
// (e.g. you can subscribe using lambdas)
publisher->getEventRemove().connect(remove_event_connections, [](const Ptr<Widget> & widget) { 
		Log::message("\Handling Remove event (lambda).\n");
	}
);

// ...

// later all of these linked subscriptions can be removed with a single line
remove_event_connections.disconnectAll();

//////////////////////////////////////////////////////////////////////////////
//  2. You can subscribe and unsubscribe via an instance of the EventConnection 
//  class. And toggle this particular connection off and on, when necessary.
//////////////////////////////////////////////////////////////////////////////

// create an instance of the EventConnection class
EventConnection remove_event_connection;

// subscribe to the Remove event with a handler function keeping the connection
publisher->getEventRemove().connect(remove_event_connection, remove_event_handler);

// ...

// you can temporarily disable a particular event connection to perform certain actions
remove_event_connection.setEnabled(false);

// ... actions to be performed

// and enable it back when necessary
remove_event_connection.setEnabled(true);

// ...

// remove subscription to the Remove event via the connection
remove_event_connection.disconnect();

//////////////////////////////////////////////////////////////////////////////
//  3. You can add EventConnection/EventConnections instance as a member of the
//  class that handles the event. In this case all linked subscriptions will be 
//  automatically removed when class destructor is called
//////////////////////////////////////////////////////////////////////////////

// Class handling the event
class SomeClass
{
public:
	// instance of the EventConnections class as a class member
	EventConnections e_connections;

	// A Remove event handler implemented as a class member
	void event_handler(const Ptr<Widget> & widget)
	{
		Log::message("\Handling Remove event\n");
		// ...
	}
};

SomeClass *sc = new SomeClass();

// ...

// specify a class instance in case a handler method belongs to some class
publisher->getEventRemove().connect(sc->e_connections, sc, &SomeClass::event_handler);

// ...

// handler class instance is deleted with all its subscriptions removed automatically
delete sc;

//////////////////////////////////////////////////////////////////////////////
//  4. You can subscribe and unsubscribe via the handler function directly
//////////////////////////////////////////////////////////////////////////////

// subscribe to the Remove event with a handler function
publisher->getEventRemove().connect(remove_event_handler);


// remove subscription to the Remove event later by the handler function
publisher->getEventRemove().disconnect(remove_event_handler);


//////////////////////////////////////////////////////////////////////////////
//   5. Subscribe to an event saving an ID and unsubscribe later by this ID
//////////////////////////////////////////////////////////////////////////////

// define a connection ID to be used to unsubscribe later
EventConnectionId remove_handler_id;

// subscribe to the Remove event with a lambda handler function and keeping connection ID
remove_handler_id = publisher->getEventRemove().connect([](const Ptr<Widget> & widget) { 
		Log::message("\Handling Remove event (lambda).\n");
	}
);

// remove the subscription later using the ID
publisher->getEventRemove().disconnect(remove_handler_id);


//////////////////////////////////////////////////////////////////////////////
//   6. Ignoring all Remove events when necessary
//////////////////////////////////////////////////////////////////////////////

// you can temporarily disable the event to perform certain actions without triggering it
publisher->getEventRemove().setEnabled(false);

// ... actions to be performed

// and enable it back when necessary
publisher->getEventRemove().setEnabled(true);

// implement the DragDrop event handler
void dragdrop_event_handler(const Ptr<Widget> & widget,  const Ptr<Widget> & target_widget)
{
	Log::message("\Handling DragDrop event\n");
}


//////////////////////////////////////////////////////////////////////////////
//  1. Multiple subscriptions can be linked to an instance of the EventConnections 
//  class that you can use later to remove all these subscriptions at once
//////////////////////////////////////////////////////////////////////////////

// create an instance of the EventConnections class
EventConnections dragdrop_event_connections;

// link to this instance when subscribing to an event (subscription to various events can be linked)
publisher->getEventDragDrop().connect(dragdrop_event_connections, dragdrop_event_handler);

// other subscriptions are also linked to this EventConnections instance 
// (e.g. you can subscribe using lambdas)
publisher->getEventDragDrop().connect(dragdrop_event_connections, [](const Ptr<Widget> & widget,  const Ptr<Widget> & target_widget) { 
		Log::message("\Handling DragDrop event (lambda).\n");
	}
);

// ...

// later all of these linked subscriptions can be removed with a single line
dragdrop_event_connections.disconnectAll();

//////////////////////////////////////////////////////////////////////////////
//  2. You can subscribe and unsubscribe via an instance of the EventConnection 
//  class. And toggle this particular connection off and on, when necessary.
//////////////////////////////////////////////////////////////////////////////

// create an instance of the EventConnection class
EventConnection dragdrop_event_connection;

// subscribe to the DragDrop event with a handler function keeping the connection
publisher->getEventDragDrop().connect(dragdrop_event_connection, dragdrop_event_handler);

// ...

// you can temporarily disable a particular event connection to perform certain actions
dragdrop_event_connection.setEnabled(false);

// ... actions to be performed

// and enable it back when necessary
dragdrop_event_connection.setEnabled(true);

// ...

// remove subscription to the DragDrop event via the connection
dragdrop_event_connection.disconnect();

//////////////////////////////////////////////////////////////////////////////
//  3. You can add EventConnection/EventConnections instance as a member of the
//  class that handles the event. In this case all linked subscriptions will be 
//  automatically removed when class destructor is called
//////////////////////////////////////////////////////////////////////////////

// Class handling the event
class SomeClass
{
public:
	// instance of the EventConnections class as a class member
	EventConnections e_connections;

	// A DragDrop event handler implemented as a class member
	void event_handler(const Ptr<Widget> & widget,  const Ptr<Widget> & target_widget)
	{
		Log::message("\Handling DragDrop event\n");
		// ...
	}
};

SomeClass *sc = new SomeClass();

// ...

// specify a class instance in case a handler method belongs to some class
publisher->getEventDragDrop().connect(sc->e_connections, sc, &SomeClass::event_handler);

// ...

// handler class instance is deleted with all its subscriptions removed automatically
delete sc;

//////////////////////////////////////////////////////////////////////////////
//  4. You can subscribe and unsubscribe via the handler function directly
//////////////////////////////////////////////////////////////////////////////

// subscribe to the DragDrop event with a handler function
publisher->getEventDragDrop().connect(dragdrop_event_handler);


// remove subscription to the DragDrop event later by the handler function
publisher->getEventDragDrop().disconnect(dragdrop_event_handler);


//////////////////////////////////////////////////////////////////////////////
//   5. Subscribe to an event saving an ID and unsubscribe later by this ID
//////////////////////////////////////////////////////////////////////////////

// define a connection ID to be used to unsubscribe later
EventConnectionId dragdrop_handler_id;

// subscribe to the DragDrop event with a lambda handler function and keeping connection ID
dragdrop_handler_id = publisher->getEventDragDrop().connect([](const Ptr<Widget> & widget,  const Ptr<Widget> & target_widget) { 
		Log::message("\Handling DragDrop event (lambda).\n");
	}
);

// remove the subscription later using the ID
publisher->getEventDragDrop().disconnect(dragdrop_handler_id);


//////////////////////////////////////////////////////////////////////////////
//   6. Ignoring all DragDrop events when necessary
//////////////////////////////////////////////////////////////////////////////

// you can temporarily disable the event to perform certain actions without triggering it
publisher->getEventDragDrop().setEnabled(false);

// ... actions to be performed

// and enable it back when necessary
publisher->getEventDragDrop().setEnabled(true);

// implement the DragMove event handler
void dragmove_event_handler(const Ptr<Widget> & widget,  const Ptr<Widget> & underlying_widget)
{
	Log::message("\Handling DragMove event\n");
}


//////////////////////////////////////////////////////////////////////////////
//  1. Multiple subscriptions can be linked to an instance of the EventConnections 
//  class that you can use later to remove all these subscriptions at once
//////////////////////////////////////////////////////////////////////////////

// create an instance of the EventConnections class
EventConnections dragmove_event_connections;

// link to this instance when subscribing to an event (subscription to various events can be linked)
publisher->getEventDragMove().connect(dragmove_event_connections, dragmove_event_handler);

// other subscriptions are also linked to this EventConnections instance 
// (e.g. you can subscribe using lambdas)
publisher->getEventDragMove().connect(dragmove_event_connections, [](const Ptr<Widget> & widget,  const Ptr<Widget> & underlying_widget) { 
		Log::message("\Handling DragMove event (lambda).\n");
	}
);

// ...

// later all of these linked subscriptions can be removed with a single line
dragmove_event_connections.disconnectAll();

//////////////////////////////////////////////////////////////////////////////
//  2. You can subscribe and unsubscribe via an instance of the EventConnection 
//  class. And toggle this particular connection off and on, when necessary.
//////////////////////////////////////////////////////////////////////////////

// create an instance of the EventConnection class
EventConnection dragmove_event_connection;

// subscribe to the DragMove event with a handler function keeping the connection
publisher->getEventDragMove().connect(dragmove_event_connection, dragmove_event_handler);

// ...

// you can temporarily disable a particular event connection to perform certain actions
dragmove_event_connection.setEnabled(false);

// ... actions to be performed

// and enable it back when necessary
dragmove_event_connection.setEnabled(true);

// ...

// remove subscription to the DragMove event via the connection
dragmove_event_connection.disconnect();

//////////////////////////////////////////////////////////////////////////////
//  3. You can add EventConnection/EventConnections instance as a member of the
//  class that handles the event. In this case all linked subscriptions will be 
//  automatically removed when class destructor is called
//////////////////////////////////////////////////////////////////////////////

// Class handling the event
class SomeClass
{
public:
	// instance of the EventConnections class as a class member
	EventConnections e_connections;

	// A DragMove event handler implemented as a class member
	void event_handler(const Ptr<Widget> & widget,  const Ptr<Widget> & underlying_widget)
	{
		Log::message("\Handling DragMove event\n");
		// ...
	}
};

SomeClass *sc = new SomeClass();

// ...

// specify a class instance in case a handler method belongs to some class
publisher->getEventDragMove().connect(sc->e_connections, sc, &SomeClass::event_handler);

// ...

// handler class instance is deleted with all its subscriptions removed automatically
delete sc;

//////////////////////////////////////////////////////////////////////////////
//  4. You can subscribe and unsubscribe via the handler function directly
//////////////////////////////////////////////////////////////////////////////

// subscribe to the DragMove event with a handler function
publisher->getEventDragMove().connect(dragmove_event_handler);


// remove subscription to the DragMove event later by the handler function
publisher->getEventDragMove().disconnect(dragmove_event_handler);


//////////////////////////////////////////////////////////////////////////////
//   5. Subscribe to an event saving an ID and unsubscribe later by this ID
//////////////////////////////////////////////////////////////////////////////

// define a connection ID to be used to unsubscribe later
EventConnectionId dragmove_handler_id;

// subscribe to the DragMove event with a lambda handler function and keeping connection ID
dragmove_handler_id = publisher->getEventDragMove().connect([](const Ptr<Widget> & widget,  const Ptr<Widget> & underlying_widget) { 
		Log::message("\Handling DragMove event (lambda).\n");
	}
);

// remove the subscription later using the ID
publisher->getEventDragMove().disconnect(dragmove_handler_id);


//////////////////////////////////////////////////////////////////////////////
//   6. Ignoring all DragMove events when necessary
//////////////////////////////////////////////////////////////////////////////

// you can temporarily disable the event to perform certain actions without triggering it
publisher->getEventDragMove().setEnabled(false);

// ... actions to be performed

// and enable it back when necessary
publisher->getEventDragMove().setEnabled(true);

// implement the Leave event handler
void leave_event_handler(const Ptr<Widget> & widget)
{
	Log::message("\Handling Leave event\n");
}


//////////////////////////////////////////////////////////////////////////////
//  1. Multiple subscriptions can be linked to an instance of the EventConnections 
//  class that you can use later to remove all these subscriptions at once
//////////////////////////////////////////////////////////////////////////////

// create an instance of the EventConnections class
EventConnections leave_event_connections;

// link to this instance when subscribing to an event (subscription to various events can be linked)
publisher->getEventLeave().connect(leave_event_connections, leave_event_handler);

// other subscriptions are also linked to this EventConnections instance 
// (e.g. you can subscribe using lambdas)
publisher->getEventLeave().connect(leave_event_connections, [](const Ptr<Widget> & widget) { 
		Log::message("\Handling Leave event (lambda).\n");
	}
);

// ...

// later all of these linked subscriptions can be removed with a single line
leave_event_connections.disconnectAll();

//////////////////////////////////////////////////////////////////////////////
//  2. You can subscribe and unsubscribe via an instance of the EventConnection 
//  class. And toggle this particular connection off and on, when necessary.
//////////////////////////////////////////////////////////////////////////////

// create an instance of the EventConnection class
EventConnection leave_event_connection;

// subscribe to the Leave event with a handler function keeping the connection
publisher->getEventLeave().connect(leave_event_connection, leave_event_handler);

// ...

// you can temporarily disable a particular event connection to perform certain actions
leave_event_connection.setEnabled(false);

// ... actions to be performed

// and enable it back when necessary
leave_event_connection.setEnabled(true);

// ...

// remove subscription to the Leave event via the connection
leave_event_connection.disconnect();

//////////////////////////////////////////////////////////////////////////////
//  3. You can add EventConnection/EventConnections instance as a member of the
//  class that handles the event. In this case all linked subscriptions will be 
//  automatically removed when class destructor is called
//////////////////////////////////////////////////////////////////////////////

// Class handling the event
class SomeClass
{
public:
	// instance of the EventConnections class as a class member
	EventConnections e_connections;

	// A Leave event handler implemented as a class member
	void event_handler(const Ptr<Widget> & widget)
	{
		Log::message("\Handling Leave event\n");
		// ...
	}
};

SomeClass *sc = new SomeClass();

// ...

// specify a class instance in case a handler method belongs to some class
publisher->getEventLeave().connect(sc->e_connections, sc, &SomeClass::event_handler);

// ...

// handler class instance is deleted with all its subscriptions removed automatically
delete sc;

//////////////////////////////////////////////////////////////////////////////
//  4. You can subscribe and unsubscribe via the handler function directly
//////////////////////////////////////////////////////////////////////////////

// subscribe to the Leave event with a handler function
publisher->getEventLeave().connect(leave_event_handler);


// remove subscription to the Leave event later by the handler function
publisher->getEventLeave().disconnect(leave_event_handler);


//////////////////////////////////////////////////////////////////////////////
//   5. Subscribe to an event saving an ID and unsubscribe later by this ID
//////////////////////////////////////////////////////////////////////////////

// define a connection ID to be used to unsubscribe later
EventConnectionId leave_handler_id;

// subscribe to the Leave event with a lambda handler function and keeping connection ID
leave_handler_id = publisher->getEventLeave().connect([](const Ptr<Widget> & widget) { 
		Log::message("\Handling Leave event (lambda).\n");
	}
);

// remove the subscription later using the ID
publisher->getEventLeave().disconnect(leave_handler_id);


//////////////////////////////////////////////////////////////////////////////
//   6. Ignoring all Leave events when necessary
//////////////////////////////////////////////////////////////////////////////

// you can temporarily disable the event to perform certain actions without triggering it
publisher->getEventLeave().setEnabled(false);

// ... actions to be performed

// and enable it back when necessary
publisher->getEventLeave().setEnabled(true);