Tizen Native API  7.0
Widget Viewer

API for widget viewer (widget screen, home screen, ...).

Required Header

#include <widget_viewer_evas.h>

Overview

Tizen Platform supports development of Widget Viewer Application. Many kinds of widgets can be installed on the Tizen Platform enhanced devices. Also it could be used by user via some kinds of viewer applications. This document will show you what kinds of APIs are existing and how to use them. First of all, the Tizen Platform uses the EFL as a core UIFW. So this API set is also based on the EFL.

Functions

int widget_viewer_evas_init (Evas_Object *win)
 Initializes the widget system.
int widget_viewer_evas_fini (void)
 Finalizes the widget system.
Evas_Objectwidget_viewer_evas_add_widget (Evas_Object *parent, const char *widget_id, const char *content_info, double period)
 Creates a new widget object.
int widget_viewer_evas_notify_resumed_status_of_viewer (void)
 Notifies the status of the viewer to all providers.
int widget_viewer_evas_notify_paused_status_of_viewer (void)
 Notifies the status of the viewer to all providers.
int widget_viewer_evas_notify_orientation_of_viewer (int orientation)
 Notifies the orientation of the viewer to all providers.
int widget_viewer_evas_pause_widget (Evas_Object *widget)
 Pauses given widget.
int widget_viewer_evas_resume_widget (Evas_Object *widget)
 Resumes given widget.
int widget_viewer_evas_set_option (widget_evas_conf_e type, int value)
 Changes the configurable values of widget system.
const char * widget_viewer_evas_get_content_info (Evas_Object *widget)
 Gets content string of widget.
const char * widget_viewer_evas_get_title_string (Evas_Object *widget)
 Gets summarized string of the widget content for accessibility.
const char * widget_viewer_evas_get_widget_id (Evas_Object *widget)
 Gets the ID of the widget.
double widget_viewer_evas_get_period (Evas_Object *widget)
 Gets the update period of the widget.
void widget_viewer_evas_cancel_click_event (Evas_Object *widget)
 Cancels click event procedure.
void widget_viewer_evas_disable_preview (Evas_Object *widget)
 Hides the preview of the widget.
void widget_viewer_evas_disable_overlay_text (Evas_Object *widget)
 Hides the help text of the widget.
void widget_viewer_evas_disable_loading (Evas_Object *widget)
 Hides the loading message of the widget.
int widget_viewer_evas_feed_mouse_up_event (Evas_Object *widget)
 Feeds the mouse_up event to the provider of the widget.
void widget_viewer_evas_activate_faulted_widget (Evas_Object *widget)
 Activates a widget in faulted state.
bool widget_viewer_evas_is_faulted (Evas_Object *widget)
 Checks whether the widget is faulted.
int widget_viewer_evas_freeze_visibility (Evas_Object *widget, widget_visibility_status_e status)
 Freezes visibility of the widget.
int widget_viewer_evas_thaw_visibility (Evas_Object *widget)
 Thaws visibility of the widget.
bool widget_viewer_evas_is_visibility_frozen (Evas_Object *widget)
 Gets the frozen state of visibility option.
bool widget_viewer_evas_is_widget (Evas_Object *widget)
 Validates the object, whether it is a widget object or not.
void widget_viewer_evas_set_permanent_delete (Evas_Object *widget, int flag)
 Sets the deletion mode before deleting a widget.
const char * widget_viewer_evas_get_widget_instance_id (Evas_Object *widget)
 Gets the widget object's instance ID.

Typedefs

typedef struct
widget_evas_event_info 
widget_evas_event_info_s
 Data structure which will be sent as a parameter of smart callback for signals WIDGET_SMART_SIGNAL_XXX.
typedef enum
widget_visibility_status 
widget_visibility_status_e
 Enumerations for setting visibility status of a widget.
typedef enum widget_evas_conf widget_evas_conf_e
 Enumeration for configuration keys.

Defines

#define WIDGET_VIEWER_EVAS_DEFAULT_PERIOD   -1.0f
 Definition for default refresh interval of widgets.
#define WIDGET_SMART_SIGNAL_WIDGET_CREATE_ABORTED   "widget,create,aborted"
 Widget event for smart callback when widget creation is aborted. You can listen some events from widget by calling evas_object_smart_callback_add.
#define WIDGET_SMART_SIGNAL_WIDGET_CREATED   "widget,created"
 Widget event for smart callback when widget is created. You can listen some events from widget by calling evas_object_smart_callback_add.
#define WIDGET_SMART_SIGNAL_WIDGET_RESIZE_ABORTED   "widget,resize,aborted"
 Widget event for smart callback when resizing widget is aborted. You can listen some events from widget by calling evas_object_smart_callback_add.
#define WIDGET_SMART_SIGNAL_WIDGET_RESIZED   "widget,resized"
 Widget event for smart callback when widget is resized. You can listen some events from widget by calling evas_object_smart_callback_add.
#define WIDGET_SMART_SIGNAL_WIDGET_FAULTED   "widget,faulted"
 Widget event for smart callback when widget has faulted. You can listen some events from widget by calling evas_object_smart_callback_add.
#define WIDGET_SMART_SIGNAL_UPDATED   "updated"
 Widget event for smart callback when widget content is updated. You can listen some events from widget by calling evas_object_smart_callback_add.
#define WIDGET_SMART_SIGNAL_EXTRA_INFO_UPDATED   "info,updated"
 Widget event for smart callback when widget extra info is updated. You can listen some events from widget by calling evas_object_smart_callback_add.
#define WIDGET_SMART_SIGNAL_PROVIDER_DISCONNECTED   "provider,disconnected"
 Widget event for smart callback when provider is disconnected. You can listen some events from widget by calling evas_object_smart_callback_add.
#define WIDGET_SMART_SIGNAL_CONTROL_SCROLLER   "control,scroller"
 Widget event for smart callback when control scroller. You can listen some events from widget by calling evas_object_smart_callback_add.
#define WIDGET_SMART_SIGNAL_WIDGET_DELETED   "widget,deleted"
 Widget event for smart callback when widget is deleted. You can listen some events from widget by calling evas_object_smart_callback_add.
#define WIDGET_SMART_SIGNAL_PERIOD_CHANGED   "widget,period,changed"
 Widget event for smart callback when period is changed. You can listen some events from widget by calling evas_object_smart_callback_add.

Define Documentation

#define WIDGET_SMART_SIGNAL_CONTROL_SCROLLER   "control,scroller"

Widget event for smart callback when control scroller. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add
#define WIDGET_SMART_SIGNAL_EXTRA_INFO_UPDATED   "info,updated"

Widget event for smart callback when widget extra info is updated. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add
#define WIDGET_SMART_SIGNAL_PERIOD_CHANGED   "widget,period,changed"

Widget event for smart callback when period is changed. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add
#define WIDGET_SMART_SIGNAL_PROVIDER_DISCONNECTED   "provider,disconnected"

Widget event for smart callback when provider is disconnected. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add
#define WIDGET_SMART_SIGNAL_UPDATED   "updated"

Widget event for smart callback when widget content is updated. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add
#define WIDGET_SMART_SIGNAL_WIDGET_CREATE_ABORTED   "widget,create,aborted"

Widget event for smart callback when widget creation is aborted. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add
#define WIDGET_SMART_SIGNAL_WIDGET_CREATED   "widget,created"

Widget event for smart callback when widget is created. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add
#define WIDGET_SMART_SIGNAL_WIDGET_DELETED   "widget,deleted"

Widget event for smart callback when widget is deleted. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add
#define WIDGET_SMART_SIGNAL_WIDGET_FAULTED   "widget,faulted"

Widget event for smart callback when widget has faulted. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add
#define WIDGET_SMART_SIGNAL_WIDGET_RESIZE_ABORTED   "widget,resize,aborted"

Widget event for smart callback when resizing widget is aborted. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add
#define WIDGET_SMART_SIGNAL_WIDGET_RESIZED   "widget,resized"

Widget event for smart callback when widget is resized. You can listen some events from widget by calling evas_object_smart_callback_add.

Since :
2.3.1
See also:
widget_evas_event_info_s
evas_object_smart_callback_add

Definition for default refresh interval of widgets.

Since :
2.3.1
See also:
widget_viewer_evas_add_widget
widget_viewer_evas_get_period

Typedef Documentation

Enumeration for configuration keys.

Since :
2.3.1
See also:
widget_viewer_evas_set_option

Enumerations for setting visibility status of a widget.

Since :
2.3.1
See also:
widget_viewer_evas_freeze_visibility

Enumeration Type Documentation

Enumeration for configuration keys.

Since :
2.3.1
See also:
widget_viewer_evas_set_option
Enumerator:
WIDGET_VIEWER_EVAS_MANUAL_PAUSE_RESUME 

Visibility will be changed manually. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_USE_FIXED_SIZE 

Widget will be resized to specific size only. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_EASY_MODE 

Easy mode on/off. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_SCROLL_X 

Box will be scrolled from left to right vice versa. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_SCROLL_Y 

Box will be scrolled from top to bottom vice versa. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_EVENT_AUTO_FEED 

Feeds event automatically from the master provider. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_DELAYED_RESUME 

Delaying the pause/resume when it is automatically changed. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_SENSITIVE_MOVE 

Force feeds mouse up event if the box is moved. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_AUTO_RENDER_SELECTION 

Select render automatically, if a box moved, do not sync using animator, or use the animator. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_DIRECT_UPDATE 

Enable direct update path. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_USE_RENDER_ANIMATOR 

Use the render animator or not. 1 : on, 0 : off

WIDGET_VIEWER_EVAS_SKIP_ACQUIRE 

Even if the viewer cannot get acquired resource id, try to update using default one. 1 : on, 0 : off

Enumerations for setting visibility status of a widget.

Since :
2.3.1
See also:
widget_viewer_evas_freeze_visibility
Enumerator:
WIDGET_VISIBILITY_STATUS_SHOW_FIXED 

Visibility of the widget will be fixed as 'SHOW'

WIDGET_VISIBILITY_STATUS_HIDE_FIXED 

Visibility of the widget will be fixed as 'HIDE'


Function Documentation

Activates a widget in faulted state.

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

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object faulted
Exceptions:
WIDGET_ERROR_NONESuccessfully activate faulted widget
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()
Evas_Object* widget_viewer_evas_add_widget ( Evas_Object parent,
const char *  widget_id,
const char *  content_info,
double  period 
)

Creates a new widget object.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]parentEvas Object of parent
[in]widget_idWidget id
[in]content_infoContents that will be given to the widget instance. This value is result of bundle_encode.
[in]periodUpdate period (WIDGET_VIEWER_EVAS_DEFAULT_PERIOD can be used for this; this argument will be used to specify the period of updating contents of a widget)
Returns:
Widget Object. NULL on error
Exceptions:
WIDGET_ERROR_NONESuccessfully added
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTFailed to create instance
WIDGET_ERROR_MAX_EXCEEDEDMaximum number of instances exceeded
See also:
get_last_result()
widget_service_get_widget_id

Cancels click event procedure.

If you call this function after feeding the mouse_down(or mouse_set) event, the widget will get ON_HOLD events.
If a widget gets ON_HOLD event, it will not do anything even if you feed mouse_up(or mouse_unset) event.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Exceptions:
WIDGET_ERROR_NONESuccessfully get period
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()

Hides the loading message of the widget.

If you disable it, there is no preview & help text while creating a widget object.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
This function should be called right after creating the widget object before resizing it.
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Exceptions:
WIDGET_ERROR_NONESuccessfully disabled loading text
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()

Hides the help text of the widget.

While loading a box, hide the help text.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
This function should be called right after creating the widget object before resizing it.
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Exceptions:
WIDGET_ERROR_NONESuccessfully disabled overlay text
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()

Hides the preview of the widget.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
This function should be called right after creating the widget object before resizing it.
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Exceptions:
WIDGET_ERROR_NONESuccessfully disabled preview
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()

Feeds the mouse_up event to the provider of the widget.

This is very similar with widget_viewer_evas_cancel_click(), but this will sends mouse_up event explicitly.
Also feed the ON_HOLD event before feeds mouse_up event.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Parameters:
[in]widgeta widget object
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEif success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
int widget_viewer_evas_fini ( void  )

Finalizes the widget system.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEIf success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_FAULTUnrecoverable error occurred
See also:
widget_viewer_evas_init

Freezes visibility of the widget.

If you don't want to change the visibility automatically, freeze it.
The visibility will not be changed even though a box disappeared(hidden)/displayed(shown) from/on the screen.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Parameters:
[in]widgetA widget object
[in]statusA visibility status of the widget
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEIf success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
widget_visibility_status_e

Gets content string of widget.

This string can be used for creating contents of widget again after rebooting a device or it can be recovered from crash(abnormal status).

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
Returned string should not be freed.
The returned string is usable only before the widget is destroyed. If it's going to be needed after that, it should be copied.
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Returns:
Content string to be recognized content of the widget. This value is result of bundle_encode. NULL if there is no specific content string
Exceptions:
WIDGET_ERROR_NONESuccessfully get content string
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
Postcondition:
Returned string should not be freed.
See also:
get_last_result()

Gets the update period of the widget.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Returns:
Period the update period of the widget.
Exceptions:
WIDGET_ERROR_NONESuccessfully get period
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()

Gets summarized string of the widget content for accessibility.

If the accessibility feature is turned On, a viewer can use this text to describe the widget.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
Returned string should not be freed.
The returned string is usable only before the widget is destroyed. If it's going to be needed after that, it should be copied.
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Returns:
Title string to be used for summarizing the widget NULL if there is no summarized text for content of given widget
Exceptions:
WIDGET_ERROR_NONESuccessfully get title string
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()
const char* widget_viewer_evas_get_widget_id ( Evas_Object widget)

Gets the ID of the widget.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
Returned string should not be freed.
The returned string is usable only before the widget is destroyed. If it's going to be needed after that, it should be copied.
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Returns:
Widget ID NULL if an error occurred and you can get the reason of failure using get_last_result()
Exceptions:
WIDGET_ERROR_NONESuccessfully get widget ID
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()

Gets the widget object's instance ID.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
The returned instance ID should not be freed.
The returned widget instance ID is volatile. If the device reboots or the widget's process restarts, it will be changed.
So, you should not assume this value is a persistent one.
The returned string is usable only before the widget is destroyed. If it's going to be needed after that, it should be copied.
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Returns:
The widget's instance ID as a string, NULL in case of errors
Exceptions:
WIDGET_ERROR_NONESuccessfully retrieved the widget instance ID
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTWidget is not ready
See also:
get_last_result()

Initializes the widget system.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Parameters:
[in]winWindow object
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEIf success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_ALREADY_EXISTAlready initialized
See also:
widget_viewer_evas_fini

Checks whether the widget is faulted.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Returns:
Faulted state of the widget and you can get the result state of this function by using get_last_result() True for faulted state False for not faulted state
Exceptions:
WIDGET_ERROR_NONESuccessfully get the faulted state of the widget
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()

Gets the frozen state of visibility option.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Returns:
Fixed state of visibility and you can get the result state of this function by using get_last_result() True for frozen state False for not frozen state
Exceptions:
WIDGET_ERROR_NONESuccessfully get the state of visibility
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()

Validates the object, whether it is a widget object or not.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object
Returns:
Result of validation and you can get the result state of this function by using get_last_result() True this is a widget False this is not a widget
Exceptions:
WIDGET_ERROR_NONESuccessfully get result of validation
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()

Notifies the orientation of the viewer to all providers.

If you call this, all providers will gets "rotated" event.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Parameters:
[in]orientationOrientation of viewer
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEIf success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTIf it failed to send state (resumed) info

Notifies the status of the viewer to all providers.

If you call this, all providers will gets "paused" event.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEIf success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_FAULTIf it failed to send state (resumed) info
See also:
widget_viewer_evas_notify_resumed_status_of_viewer()

Notifies the status of the viewer to all providers.

If you call this, all providers will gets "resumed" event.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEIf success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_FAULTIf it failed to send state (paused) info
See also:
widget_viewer_evas_notify_paused_status_of_viewer()

Pauses given widget.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Parameters:
[in]widgetA widget object
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEIf success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTIf it failed to send state (resumed) info
WIDGET_ERROR_DISABLEDWidget is frozen by widget_viewer_evas_freeze_visibility()
See also:
widget_viewer_evas_freeze_visibility()

Resumes given widget.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Parameters:
[in]widgeta widget object
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEIf success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTIf it failed to send state (resumed) info
WIDGET_ERROR_DISABLEDWidget is frozen by widget_viewer_evas_freeze_visibility()
See also:
widget_viewer_evas_freeze_visibility()
int widget_viewer_evas_set_option ( widget_evas_conf_e  type,
int  value 
)

Changes the configurable values of widget system.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Parameters:
[in]typeConfiguration item
[in]valueIts value
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEIf success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
See also:
widget_evas_conf
void widget_viewer_evas_set_permanent_delete ( Evas_Object widget,
int  flag 
)

Sets the deletion mode before deleting a widget.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widgetA widget object which will be deleted soon
[in]flagPass 1 if you delete this widget instance permanently, or pass 0 if you want to keep it and it will be re-created soon
Exceptions:
WIDGET_ERROR_NONESuccessfully set the flag
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized
See also:
get_last_result()

Thaws visibility of the widget.

If you want to let the visibility change automatically again, call this function.

Since :
2.3.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/widget.viewer
Parameters:
[in]widgetA widget object
Returns:
0 on success, otherwise a negative error value
Return values:
WIDGET_ERROR_NONEIf success
WIDGET_ERROR_NOT_SUPPORTEDNot supported
WIDGET_ERROR_PERMISSION_DENIEDPermission denied
WIDGET_ERROR_INVALID_PARAMETERInvalid argument
WIDGET_ERROR_FAULTNot initialized