NAP
Public Member Functions | List of all members
GUIAppEventHandler Class Reference

#include <guiappeventhandler.h>

Public Member Functions

 GUIAppEventHandler (App &app)
 
virtual void start () override
 
virtual void process () override
 
virtual void shutdown () override
 
bool setTouchGeneratesMouseEvents (bool value)
 
- Public Member Functions inherited from AppEventHandler
 AppEventHandler (BaseApp &app)
 
virtual ~AppEventHandler ()=default
 
 AppEventHandler (AppEventHandler &)=delete
 
AppEventHandleroperator= (const AppEventHandler &)=delete
 
 AppEventHandler (AppEventHandler &&)=delete
 
AppEventHandleroperator= (AppEventHandler &&)=delete
 
template<typename T >
T & getApp ()
 

Additional Inherited Members

- Protected Attributes inherited from AppEventHandler
BaseAppmApp
 

Description

Application event handler that is designed to work with applications that host a graphical user interface. This class checks if the user is interacting with a GUI element, if so, no input events are forwarded to the application. By default touch input generates mouse events. Call setTouchGeneratesMouseEvents(false) to decouple this behavior. When decoupled, touch events (instead of mouse events) are forwarded to the GUI.

Inheritance diagram for GUIAppEventHandler:
[legend]
Collaboration diagram for GUIAppEventHandler:
[legend]

Constructor & Destructor Documentation

◆ GUIAppEventHandler()

GUIAppEventHandler ( App app)

Member Function Documentation

◆ process()

virtual void process ( )
overridevirtual

This call polls the various SDL messages and filters them based on GUI activity. If a GUI element is actively used the events are not forwarded to the running app.

Reimplemented from AppEventHandler.

◆ setTouchGeneratesMouseEvents()

bool setTouchGeneratesMouseEvents ( bool  value)

Tells the input system if touch input also generates mouse events, next to touch events. On most systems touch input is coupled to mouse input. This is controlled on an operating system level. This call tries to explicitly tell the input system to couple or decouple both events. When decoupled, touch events (instead of mouse events) are forwarded to the GUI.

Parameters
valueif touch input generates mouse events.
Returns
if the system accepted the hint.

◆ shutdown()

virtual void shutdown ( )
overridevirtual

This call deletes the input converter

Reimplemented from AppEventHandler.

◆ start()

virtual void start ( )
overridevirtual

This call creates the SDL Input Converter.

Reimplemented from AppEventHandler.