Tizen Native API  5.0
Dali::PropertyNotification Class Reference

This is used to issue a notification upon a condition of the property being met. More...

Inheritance diagram for Dali::PropertyNotification:
Dali::BaseHandle

Public Types

enum  NotifyMode
 Enumeration for description of how to check condition. More...

Public Member Functions

 PropertyNotification ()
 Creates an uninitialized PropertyNotification; this can be initialized with PropertyNotification::New().
 ~PropertyNotification ()
 Destructor.
 PropertyNotification (const PropertyNotification &handle)
 This copy constructor is required for (smart) pointer semantics.
PropertyNotificationoperator= (const PropertyNotification &rhs)
 This assignment operator is required for (smart) pointer semantics.
PropertyCondition GetCondition ()
 Gets the condition of this notification.
const PropertyConditionGetCondition () const
 Gets the condition of this notification.
Dali::Handle GetTarget () const
 Gets the target handle that this notification is observing.
Property::Index GetTargetProperty () const
 Gets the target handle's property index that this notification is observing.
void SetNotifyMode (NotifyMode mode)
 Sets the Notification mode.
NotifyMode GetNotifyMode ()
 Retrieves the current Notification mode.
bool GetNotifyResult () const
 Gets the result of the last condition check that caused a signal emit, useful when using NotifyOnChanged mode and need to know what it changed to.
PropertyNotifySignalTypeNotifySignal ()
 Connects to this signal to be notified when the notification has occurred.

Static Public Member Functions

static PropertyNotification DownCast (BaseHandle handle)
 Downcasts a handle to PropertyNotification handle.

Detailed Description

This is used to issue a notification upon a condition of the property being met.

For example checking if Actor::POSITION_X > 100.0.

Since:
2.4, DALi version 1.0.0
See also:
Dali::PropertyCondition

Member Enumeration Documentation

Enumeration for description of how to check condition.

Since:
2.4, DALi version 1.0.0
Enumerator:
Disabled 

Don't notify, regardless of result of Condition.

Since:
2.4, DALi version 1.0.0
NotifyOnTrue 

Notify whenever condition changes from false to true.

Since:
2.4, DALi version 1.0.0
NotifyOnFalse 

Notify whenever condition changes from true to false.

Since:
2.4, DALi version 1.0.0
NotifyOnChanged 

Notify whenever condition changes (false to true, and true to false)

Since:
2.4, DALi version 1.0.0

Constructor & Destructor Documentation

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

Calling member functions with an uninitialized Dali::Object is not allowed.

Since:
2.4, DALi version 1.0.0

Destructor.

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

Since:
2.4, DALi version 1.0.0

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

Since:
2.4, DALi version 1.0.0
Parameters:
[in]handleA reference to the copied handle

Member Function Documentation

Downcasts a handle to PropertyNotification handle.

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

Since:
2.4, DALi version 1.0.0
Parameters:
[in]handleto An object
Returns:
handle to a PropertyNotification object or an uninitialized handle

Gets the condition of this notification.

Since:
2.4, DALi version 1.0.0
Returns:
The condition is returned

Gets the condition of this notification.

Since:
2.4, DALi version 1.0.0
Returns:
The condition is returned

Retrieves the current Notification mode.

Since:
2.4, DALi version 1.0.0
Returns:
Notification mode

Gets the result of the last condition check that caused a signal emit, useful when using NotifyOnChanged mode and need to know what it changed to.

Since:
2.4, DALi version 1.0.0
Returns:
whether condition result that triggered last emit was true or false

Gets the target handle that this notification is observing.

Since:
2.4, DALi version 1.0.0
Returns:
The target handle

Gets the target handle's property index that this notification is observing.

Since:
2.4, DALi version 1.0.0
Returns:
The target property

Connects to this signal to be notified when the notification has occurred.

Since:
2.4, DALi version 1.0.0
Returns:
A signal object to Connect() with
PropertyNotification& Dali::PropertyNotification::operator= ( const PropertyNotification rhs)

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

Since:
2.4, DALi version 1.0.0
Parameters:
[in]rhsA reference to the copied handle
Returns:
A reference to this

Sets the Notification mode.

This determines how the property notification should respond to the result of a condition.

Since:
2.4, DALi version 1.0.0
Parameters:
[in]modeNotification mode (Default is PropertyNotification::NotifyOnTrue)