Tizen Native API  3.0

WidgetView is a class for displaying the widget image and controlling the widget. Input events that WidgetView gets are delivered to the widget. More...

Inheritance diagram for Dali::WidgetView::WidgetView:
Dali::Toolkit::Control Dali::CustomActor Dali::Actor Dali::Handle Dali::BaseHandle

Classes

struct  Property
 Enumeration for the instance of properties belonging to the WidgetView class. More...

Public Types

enum  PropertyRange
 Enumeration for the start and end property ranges for this control. More...
typedef Signal< void(WidgetView) > WidgetViewSignalType
 WidgetView signal type.

Public Member Functions

 WidgetView ()
 Creates an empty handle.
 WidgetView (const WidgetView &handle)
 Copy constructor.
WidgetViewoperator= (const WidgetView &handle)
 Assignment operator.
 ~WidgetView ()
 Destructor.
bool PauseWidget ()
 Pauses a given widget.
bool ResumeWidget ()
 Resumes a given widget.
bool CancelTouchEvent ()
 Cancels touch event procedure. If you call this function after feed the touch down event, the widget will get ON_HOLD events. If a widget gets ON_HOLD event, it will not do anything even if you feed touch up event.
void ActivateFaultedWidget ()
 Activates a widget in faulted state. A widget in faulted state MUST be activated before adding the widget.
WidgetViewSignalTypeWidgetAddedSignal ()
 This signal is emitted when the widget is added.
WidgetViewSignalTypeWidgetDeletedSignal ()
 This signal is emitted when the widget is deleted.
WidgetViewSignalTypeWidgetCreationAbortedSignal ()
 This signal is emitted when the widget creation is aborted.
WidgetViewSignalTypeWidgetContentUpdatedSignal ()
 This signal is emitted when the widget content is updated.
WidgetViewSignalTypeWidgetUpdatePeriodChangedSignal ()
 This signal is emitted when the widget update period is changed.
WidgetViewSignalTypeWidgetFaultedSignal ()
 This signal is emitted when the widget process is not running.

Static Public Member Functions

static WidgetView New (const std::string &widgetId, const std::string &contentInfo, int width, int height, float updatePeriod)
 Creates a widget view.
static WidgetView DownCast (BaseHandle handle)
 Downcasts a handle to WidgetView handle.

Detailed Description

WidgetView is a class for displaying the widget image and controlling the widget. Input events that WidgetView gets are delivered to the widget.

Signals | Signal Name | Method | |-----------------------------|----------------------------------------| | widgetAdded | WidgetAddedSignal() | | widgetDeleted | WidgetDeletedSignal() | | widgetCreationAborted | WidgetCreationAbortedSignal() | | widgetContentUpdated | WidgetContentUpdatedSignal() | | widgetUpdatePeriodChanged | WidgetUpdatePeriodChangedSignal() | | widgetFaulted | WidgetFaultedSignal() |

Since :
3.0

Member Typedef Documentation


Member Enumeration Documentation

Enumeration for the start and end property ranges for this control.

Since:
3.0, DALi version 1.0.0
Enumerator:
PROPERTY_START_INDEX 
Since:
3.0, DALi version 1.0.0
PROPERTY_END_INDEX 

Reserve property indices.

Since:
3.0, DALi version 1.0.0

Reimplemented from Dali::Toolkit::Control.


Constructor & Destructor Documentation

Creates an empty handle.

Since :
3.0

Copy constructor.

Since :
3.0
Parameters:
[in]handleThe handle to copy from

Destructor.

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

Since :
3.0

Member Function Documentation

Activates a widget in faulted state. A widget in faulted state MUST be activated before adding the widget.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer

Cancels touch event procedure. If you call this function after feed the touch down event, the widget will get ON_HOLD events. If a widget gets ON_HOLD event, it will not do anything even if you feed touch up event.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
true on success, false otherwise

Downcasts a handle to WidgetView handle.

If the BaseHandle points is a WidgetView, the downcast returns a valid handle. If not, the returned handle is left empty.

Since :
3.0
Parameters:
[in]handleHandle to an object
Returns:
Handle to a WidgetView or an empty handle

Reimplemented from Dali::Toolkit::Control.

static WidgetView Dali::WidgetView::WidgetView::New ( const std::string &  widgetId,
const std::string &  contentInfo,
int  width,
int  height,
float  updatePeriod 
) [static]

Creates a widget view.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Parameters:
[in]widgetIdThe widget id
[in]contentInfoContents that will be given to the widget instance
[in]widthThe widget width
[in]heightThe widget height
[in]updatePeriodThe period of updating contents of the widget
Returns:
A handle to WidgetView
WidgetView& Dali::WidgetView::WidgetView::operator= ( const WidgetView handle)

Assignment operator.

Since :
3.0
Parameters:
[in]handleThe handle to copy from
Returns:
A reference to this

Pauses a given widget.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
true on success, false otherwise

Resumes a given widget.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
true on success, false otherwise

This signal is emitted when the widget is added.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
The signal to connect to

This signal is emitted when the widget content is updated.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
The signal to connect to

This signal is emitted when the widget creation is aborted.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
The signal to connect to

This signal is emitted when the widget is deleted.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
The signal to connect to

This signal is emitted when the widget process is not running.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
The signal to connect to

This signal is emitted when the widget update period is changed.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
The signal to connect to