Convenience interface implementing ITouchActionHandler with an implementation that forwards any ITouchActionHandler-related calls to a previously registered ITouchActionHandler. More...

#include <ITouchInputHandling.h>

Inheritance diagram for ITouchInputHandling:

Public Member Functions
	ITouchInputHandling ()

	~ITouchInputHandling () override=default

void	RegisterHandler (ITouchActionHandler *touchHandler)
	Register a touch input handler. More...

void	UnregisterHandler ()
	Unregister the previously registered touch handler. More...

Protected Member Functions
void	OnTouchAbort () override
	A touch action has been aborted. More...

bool	OnSingleTouchStart (float x, float y) override
	A single touch has started. More...

bool	OnSingleTouchHold (float x, float y) override
	A single touch has been held down for a certain amount of time. More...

bool	OnSingleTouchMove (float x, float y, float offsetX, float offsetY, float velocityX, float velocityY) override
	A single touch has moved. More...

bool	OnSingleTouchEnd (float x, float y) override
	A single touch has been lifted. More...

bool	OnMultiTouchDown (float x, float y, int32_t pointer) override
	An additional touch has been performed. More...

bool	OnMultiTouchHold (float x, float y, int32_t pointers=2) override
	Multiple simultaneous touches have been held down for a certain amount of time. More...

bool	OnMultiTouchMove (float x, float y, float offsetX, float offsetY, float velocityX, float velocityY, int32_t pointer) override
	A touch has moved. More...

bool	OnMultiTouchUp (float x, float y, int32_t pointer) override
	A touch has been lifted (but there are still active touches) More...

bool	OnTouchGestureStart (float x, float y) override
	A pan gesture with a single touch has been started. More...

bool	OnTouchGesturePan (float x, float y, float offsetX, float offsetY, float velocityX, float velocityY) override
	A pan gesture with a single touch is in progress. More...

bool	OnTouchGestureEnd (float x, float y, float offsetX, float offsetY, float velocityX, float velocityY) override
	A pan gesture with a single touch has ended. More...

void	OnTap (float x, float y, int32_t pointers=1) override
	A tap with a one or more touches has been performed. More...

void	OnLongPress (float x, float y, int32_t pointers=1) override
	One or more touches have been held down for a certain amount of time. More...

void	OnSwipe (TouchMoveDirection direction, float xDown, float yDown, float xUp, float yUp, float velocityX, float velocityY, int32_t pointers=1) override
	One or more touches has been moved quickly in a single direction in a short time. More...

void	OnZoomPinch (float centerX, float centerY, float zoomFactor) override
	Two simultaneous touches have been held down and moved to perform a zooming/pinching gesture. More...

void	OnRotate (float centerX, float centerY, float angle) override
	Two simultaneous touches have been held down and moved to perform a rotating gesture. More...

Protected Member Functions inherited from ITouchActionHandler
virtual	~ITouchActionHandler ()=default

Detailed Description

Convenience interface implementing ITouchActionHandler with an implementation that forwards any ITouchActionHandler-related calls to a previously registered ITouchActionHandler.

See also: ITouchActionHandler

Constructor & Destructor Documentation

◆ ITouchInputHandling()

ITouchInputHandling::ITouchInputHandling ( )

inline

◆ ~ITouchInputHandling()

ITouchInputHandling::~ITouchInputHandling ( )

overridedefault

Member Function Documentation

◆ OnLongPress()

void ITouchInputHandling::OnLongPress	(	float	x,
		float	y,
		int32_t	pointers = `1`
	)

overrideprotectedvirtual

One or more touches have been held down for a certain amount of time.

Parameters

x	The x coordinate (with sub-pixel) of the touch
y	The y coordinate (with sub-pixel) of the touch
pointers	The number of pointers involved (default 1)

Returns: True if the event was handled otherwise false

See also: OnSingleTouchHold

Reimplemented from ITouchActionHandler.

◆ OnMultiTouchDown()

bool ITouchInputHandling::OnMultiTouchDown	(	float	x,
		float	y,
		int32_t	pointer
	)

overrideprotectedvirtual

An additional touch has been performed.

Parameters

x	The x coordinate (with sub-pixel) of the touch
y	The y coordinate (with sub-pixel) of the touch
pointer	The pointer that has performed the touch

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ OnMultiTouchHold()

bool ITouchInputHandling::OnMultiTouchHold	(	float	x,
		float	y,
		int32_t	pointers = `2`
	)

overrideprotectedvirtual

Multiple simultaneous touches have been held down for a certain amount of time.

Parameters

x	The x coordinate (with sub-pixel) of the touch
y	The y coordinate (with sub-pixel) of the touch
pointers	The number of pointers involved (default 2)

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ OnMultiTouchMove()

bool ITouchInputHandling::OnMultiTouchMove	(	float	x,
		float	y,
		float	offsetX,
		float	offsetY,
		float	velocityX,
		float	velocityY,
		int32_t	pointer
	)

overrideprotectedvirtual

A touch has moved.

Parameters

x	The x coordinate (with sub-pixel) of the current touch
y	The y coordinate (with sub-pixel) of the current touch
offsetX	The covered distance on the x axis (with sub-pixel)
offsetX	The covered distance on the y axis (with sub-pixel)
velocityX	The velocity of the gesture in x direction (pixels/second)
velocityX	The velocity of the gesture in y direction (pixels/second)
pointer	The pointer that has performed the touch

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ OnMultiTouchUp()

bool ITouchInputHandling::OnMultiTouchUp	(	float	x,
		float	y,
		int32_t	pointer
	)

overrideprotectedvirtual

A touch has been lifted (but there are still active touches)

Parameters

x	The x coordinate (with sub-pixel) of the touch
y	The y coordinate (with sub-pixel) of the touch
pointer	The pointer that has performed the touch

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ OnRotate()

void ITouchInputHandling::OnRotate	(	float	centerX,
		float	centerY,
		float	angle
	)

overrideprotectedvirtual

Two simultaneous touches have been held down and moved to perform a rotating gesture.

Parameters

centerX	The x coordinate (with sub-pixel) of the center of the two touches
centerY	The y coordinate (with sub-pixel) of the center of the two touches
angle	The clockwise angle in degrees of the rotation

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ OnSingleTouchEnd()

bool ITouchInputHandling::OnSingleTouchEnd	(	float	x,
		float	y
	)

overrideprotectedvirtual

A single touch has been lifted.

Parameters

x	The x coordinate (with sub-pixel) of the touch
y	The y coordinate (with sub-pixel) of the touch

Returns: True if the event was handled otherwise false

See also: OnSingleTap

Reimplemented from ITouchActionHandler.

◆ OnSingleTouchHold()

bool ITouchInputHandling::OnSingleTouchHold	(	float	x,
		float	y
	)

overrideprotectedvirtual

A single touch has been held down for a certain amount of time.

Parameters

x	The x coordinate (with sub-pixel) of the touch
y	The y coordinate (with sub-pixel) of the touch

Returns: True if the event was handled otherwise false

See also: OnSingleLongPress

Reimplemented from ITouchActionHandler.

◆ OnSingleTouchMove()

bool ITouchInputHandling::OnSingleTouchMove	(	float	x,
		float	y,
		float	offsetX,
		float	offsetY,
		float	velocityX,
		float	velocityY
	)

overrideprotectedvirtual

A single touch has moved.

Parameters

x	The x coordinate (with sub-pixel) of the current touch
y	The y coordinate (with sub-pixel) of the current touch
offsetX	The covered distance on the x axis (with sub-pixel)
offsetX	The covered distance on the y axis (with sub-pixel)
velocityX	The velocity of the gesture in x direction (pixels/second)
velocityX	The velocity of the gesture in y direction (pixels/second)

Returns: True if the event was handled otherwise false

See also: OnTouchGesturePan

Reimplemented from ITouchActionHandler.

◆ OnSingleTouchStart()

bool ITouchInputHandling::OnSingleTouchStart	(	float	x,
		float	y
	)

overrideprotectedvirtual

A single touch has started.

Parameters

x	The x coordinate (with sub-pixel) of the touch
y	The y coordinate (with sub-pixel) of the touch

Returns: True if the event was handled otherwise false

See also: OnSingleTap

Reimplemented from ITouchActionHandler.

◆ OnSwipe()

void ITouchInputHandling::OnSwipe	(	TouchMoveDirection	direction,
		float	xDown,
		float	yDown,
		float	xUp,
		float	yUp,
		float	velocityX,
		float	velocityY,
		int32_t	pointers = `1`
	)

overrideprotectedvirtual

One or more touches has been moved quickly in a single direction in a short time.

Parameters

direction	The direction (left, right, up, down) of the swipe gesture
xDown	The x coordinate (with sub-pixel) of the first touch
yDown	The y coordinate (with sub-pixel) of the first touch
xUp	The x coordinate (with sub-pixel) of the last touch
yUp	The y coordinate (with sub-pixel) of the last touch
velocityX	The velocity of the gesture in x direction (pixels/second)
velocityX	The velocity of the gesture in y direction (pixels/second)
pointers	The number of pointers involved (default 1)

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ OnTap()

void ITouchInputHandling::OnTap	(	float	x,
		float	y,
		int32_t	pointers = `1`
	)

overrideprotectedvirtual

A tap with a one or more touches has been performed.

Parameters

x	The x coordinate (with sub-pixel) of the touch
y	The y coordinate (with sub-pixel) of the touch
pointers	The number of pointers involved (default 1)

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ OnTouchAbort()

void ITouchInputHandling::OnTouchAbort ( )

overrideprotectedvirtual

A touch action has been aborted.

Reimplemented from ITouchActionHandler.

◆ OnTouchGestureEnd()

bool ITouchInputHandling::OnTouchGestureEnd	(	float	x,
		float	y,
		float	offsetX,
		float	offsetY,
		float	velocityX,
		float	velocityY
	)

overrideprotectedvirtual

A pan gesture with a single touch has ended.

Parameters

x	The x coordinate (with sub-pixel) of the current touch
y	The y coordinate (with sub-pixel) of the current touch
offsetX	The covered distance on the x axis (with sub-pixel)
offsetX	The covered distance on the y axis (with sub-pixel)
velocityX	The velocity of the gesture in x direction (pixels/second)
velocityX	The velocity of the gesture in y direction (pixels/second)

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ OnTouchGesturePan()

bool ITouchInputHandling::OnTouchGesturePan	(	float	x,
		float	y,
		float	offsetX,
		float	offsetY,
		float	velocityX,
		float	velocityY
	)

overrideprotectedvirtual

A pan gesture with a single touch is in progress.

Parameters

x	The x coordinate (with sub-pixel) of the current touch
y	The y coordinate (with sub-pixel) of the current touch
offsetX	The covered distance on the x axis (with sub-pixel)
offsetX	The covered distance on the y axis (with sub-pixel)
velocityX	The velocity of the gesture in x direction (pixels/second)
velocityX	The velocity of the gesture in y direction (pixels/second)

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ OnTouchGestureStart()

bool ITouchInputHandling::OnTouchGestureStart	(	float	x,
		float	y
	)

overrideprotectedvirtual

A pan gesture with a single touch has been started.

Parameters

x	The x coordinate (with sub-pixel) of the initial touch
y	The y coordinate (with sub-pixel) of the initial touch

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ OnZoomPinch()

void ITouchInputHandling::OnZoomPinch	(	float	centerX,
		float	centerY,
		float	zoomFactor
	)

overrideprotectedvirtual

Two simultaneous touches have been held down and moved to perform a zooming/pinching gesture.

Parameters

centerX	The x coordinate (with sub-pixel) of the center of the two touches
centerY	The y coordinate (with sub-pixel) of the center of the two touches
zoomFactor	The zoom (> 1.0) or pinch (< 1.0) factor of the two touches

Returns: True if the event was handled otherwise false

Reimplemented from ITouchActionHandler.

◆ RegisterHandler()

void ITouchInputHandling::RegisterHandler ( ITouchActionHandler * touchHandler )

Register a touch input handler.

There can only be one touch input handler.

Parameters

touchHandler An instance of a touch handler implementing the ITouchActionHandler interface

See also: UnregisterHandler

◆ UnregisterHandler()

void ITouchInputHandling::UnregisterHandler ( )

Unregister the previously registered touch handler.

See also: RegisterHandler

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

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ITouchInputHandling()

◆ ~ITouchInputHandling()

Member Function Documentation

◆ OnLongPress()

◆ OnMultiTouchDown()

◆ OnMultiTouchHold()

◆ OnMultiTouchMove()

◆ OnMultiTouchUp()

◆ OnRotate()

◆ OnSingleTouchEnd()

◆ OnSingleTouchHold()

◆ OnSingleTouchMove()

◆ OnSingleTouchStart()

◆ OnSwipe()

◆ OnTap()

◆ OnTouchAbort()

◆ OnTouchGestureEnd()

◆ OnTouchGesturePan()

◆ OnTouchGestureStart()

◆ OnZoomPinch()

◆ RegisterHandler()

◆ UnregisterHandler()