This class emits a signal when a tap gesture occurs that meets the requirements set by the application. More...

Inheritance diagram for Dali::TapGestureDetector:

Public Types
typedef Signal< void(Actor, const TapGesture &) >	DetectedSignalType
	Signal type for detected signal.
Public Member Functions
	TapGestureDetector ()
	Creates an uninitialized TapGestureDetector; this can be initialized with TapGestureDetector::New().
	~TapGestureDetector ()
	Destructor.
	TapGestureDetector (const TapGestureDetector &handle)
	This copy constructor is required for (smart) pointer semantics.
TapGestureDetector &	operator= (const TapGestureDetector &rhs)
	This assignment operator is required for (smart) pointer semantics.
void	SetMinimumTapsRequired (unsigned int minimumTaps)
	Sets the minimum number of taps required.
void	SetMaximumTapsRequired (unsigned int maximumTaps)
	Sets the maximum number of taps required.
unsigned int	GetMinimumTapsRequired () const
	Retrieves the minimum number of taps required.
unsigned int	GetMaximumTapsRequired () const
	Retrieves the maximum number of taps required.
DetectedSignalType &	DetectedSignal ()
	This signal is emitted when the specified tap is detected on the attached actor.
Static Public Member Functions
static TapGestureDetector	New ()
	Creates an initialized TapGestureDetector.
static TapGestureDetector	New (unsigned int tapsRequired)
	Creates an initialized TapGestureDetector with the specified parameters.
static TapGestureDetector	DownCast (BaseHandle handle)
	Downcasts a handle to TapGestureDetector handle.

Detailed Description

This class emits a signal when a tap gesture occurs that meets the requirements set by the application.

See TapGestureDetector::SetMinimumTapsRequired See TapGestureDetector::SetMaximumTapsRequired

A TapGesture is a discrete gesture, which means it does not have any state information attached to it. Please see TapGesture for more information.

The application programmer can use this gesture detector as follows:

 TapGestureDetector detector = TapGestureDetector::New();
 detector.Attach(myActor);
 detector.DetectedSignal().Connect(this, &MyApplication::OnTap);

Since:: 2.4, DALi version 1.0.0

Note:: Multi-touch taps (two or more points of contact with the surface) are not currently supported. However, multiple taps (double & triple tap etc.) are supported.

Signals | Signal Name | Method | |--------------|-----------------------| | tapDetected | DetectedSignal() |

See also:: TapGesture

Member Typedef Documentation

typedef Signal< void ( Actor, const TapGesture& ) > Dali::TapGestureDetector::DetectedSignalType

Signal type for detected signal.

Since:: 2.4, DALi version 1.0.0

Constructor & Destructor Documentation

Dali::TapGestureDetector::TapGestureDetector ( )

Creates an uninitialized TapGestureDetector; this can be initialized with TapGestureDetector::New().

Calling member functions with an uninitialized TapGestureDetector handle is not allowed.

Since:: 2.4, DALi version 1.0.0

Dali::TapGestureDetector::~TapGestureDetector ( )

Destructor.

This is non-virtual since derived Handle types must not contain data or virtual methods.

Since:: 2.4, DALi version 1.0.0

Dali::TapGestureDetector::TapGestureDetector ( const TapGestureDetector & handle )

This copy constructor is required for (smart) pointer semantics.

Since:: 2.4, DALi version 1.0.0

Parameters:

[in] handle A reference to the copied handle

Member Function Documentation

DetectedSignalType& Dali::TapGestureDetector::DetectedSignal ( )

This signal is emitted when the specified tap is detected on the attached actor.

A callback of the following type may be connected:

   void YourCallbackName( Actor actor, const TapGesture& gesture );

Since:: 2.4, DALi version 1.0.0

Returns:: The signal to connect to

Precondition:: The gesture detector has been initialized.

static TapGestureDetector Dali::TapGestureDetector::DownCast ( BaseHandle handle ) [static]

Downcasts a handle to TapGestureDetector handle.

If handle points to a TapGestureDetector object, the downcast produces valid handle. If not, the returned handle is left uninitialized.

Since:: 2.4, DALi version 1.0.0

Parameters:

[in] handle Handle to an object

Returns:: Handle to a TapGestureDetector object or an uninitialized handle

Reimplemented from Dali::GestureDetector.

unsigned int Dali::TapGestureDetector::GetMaximumTapsRequired ( ) const

Retrieves the maximum number of taps required.

Since:: 2.4, DALi version 1.0.0

Returns:: The maximum taps required

Precondition:: The gesture detector has been initialized.

unsigned int Dali::TapGestureDetector::GetMinimumTapsRequired ( ) const

Retrieves the minimum number of taps required.

Since:: 2.4, DALi version 1.0.0

Returns:: The minimum taps required

Precondition:: The gesture detector has been initialized.

static TapGestureDetector Dali::TapGestureDetector::New ( ) [static]

Creates an initialized TapGestureDetector.

By default, this would create a gesture detector which requires one tap with one touch.

Since:: 2.4, DALi version 1.0.0

Returns:: A handle to a newly allocated Dali resource

Reimplemented from Dali::Handle.

static TapGestureDetector Dali::TapGestureDetector::New ( unsigned int tapsRequired ) [static]

Creates an initialized TapGestureDetector with the specified parameters.

Since:: 2.4, DALi version 1.0.0

Parameters:

[in] tapsRequired The minimum & maximum number of taps required

Returns:: A handle to a newly allocated Dali resource

TapGestureDetector& Dali::TapGestureDetector::operator= ( const TapGestureDetector & rhs )

This assignment operator is required for (smart) pointer semantics.

Since:: 2.4, DALi version 1.0.0

Parameters:

[in] rhs A reference to the copied handle

Returns:: A reference to this

void Dali::TapGestureDetector::SetMaximumTapsRequired ( unsigned int maximumTaps )

Sets the maximum number of taps required.

The tap count is the number of times a user should "tap" the screen.

Since:: 2.4, DALi version 1.0.0

Parameters:

[in] maximumTaps The maximum taps required

Precondition:: The gesture detector has been initialized.

Note:: The default is '1'.

void Dali::TapGestureDetector::SetMinimumTapsRequired ( unsigned int minimumTaps )

Sets the minimum number of taps required.

The tap count is the number of times a user should "tap" the screen.

Since:: 2.4, DALi version 1.0.0

Parameters:

[in] minimumTaps The minimum taps required

Precondition:: The gesture detector has been initialized.

Note:: The default is '1'.

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation