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 to 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 exist and how to use them.

First of all, the Tizen Platform uses the EFL as a core UIFW. So this API set also based on the EFL.

Related Features

This API is related with the following feature:

http://tizen.org/feature/shell.appwidget

Functions
int	widget_viewer_evas_init (Evas_Object *win)
	Initializes the widget system.
int	widget_viewer_evas_fini (void)
	Finalizes the widget system.
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.
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)
	Resume 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)
	Activate a widget in faulted state.
bool	widget_viewer_evas_is_faulted (Evas_Object *widget)
	Check 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)
	Get the frozen state of visibility option.
bool	widget_viewer_evas_is_widget (Evas_Object *widget)
	Validate the object, whether it is a widget object or not.
void	widget_viewer_evas_set_permanent_delete (Evas_Object *widget, int flag)
	Before delete a widget, set the deletion mode.
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
	Configuration keys.
Defines
#define	WIDGET_VIEWER_EVAS_DEFAULT_PERIOD -1.0f
	Default refresh interval of widgets.
#define	WIDGET_SMART_SIGNAL_WIDGET_CREATE_ABORTED "widget,create,aborted"
	Event name for smart callback of widget events: Widget creation is aborted.
#define	WIDGET_SMART_SIGNAL_WIDGET_CREATED "widget,created"
	Event name for smart callback of widget events: Widget is created.
#define	WIDGET_SMART_SIGNAL_WIDGET_RESIZE_ABORTED "widget,resize,aborted"
	Event name for smart callback of widget events: Resizing widget is aborted.
#define	WIDGET_SMART_SIGNAL_WIDGET_RESIZED "widget,resized"
	Event name for smart callback of widget events: Widget is resized.
#define	WIDGET_SMART_SIGNAL_WIDGET_FAULTED "widget,faulted"
	Event name for smart callback of widget events: Widget has faulted.
#define	WIDGET_SMART_SIGNAL_UPDATED "updated"
	Event name for smart callback of widget events: Widget content is updated.
#define	WIDGET_SMART_SIGNAL_EXTRA_INFO_UPDATED "info,updated"
	Event name for smart callback of widget events: Widget extra info is updated.
#define	WIDGET_SMART_SIGNAL_PROVIDER_DISCONNECTED "provider,disconnected"
	Event name for smart callback of widget events: Provider is disconnected.
#define	WIDGET_SMART_SIGNAL_CONTROL_SCROLLER "control,scroller"
	Event name for smart callback of widget events: Control Scroller.
#define	WIDGET_SMART_SIGNAL_WIDGET_DELETED "widget,deleted"
	Event name for smart callback of widget events: Widget is deleted.
#define	WIDGET_SMART_SIGNAL_PERIOD_CHANGED "widget,period,changed"
	Event name for smart callback of widget events: Period is changed.

Define Documentation

#define WIDGET_SMART_SIGNAL_CONTROL_SCROLLER "control,scroller"

Event name for smart callback of widget events: Control Scroller.

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"

Event name for smart callback of widget events: Widget extra info is updated.

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"

Event name for smart callback of widget events: Period is changed.

Since :: 2.3.1

See also:: widget_evas_event_info_s; evas_object_smart_callback_add

#define WIDGET_SMART_SIGNAL_PROVIDER_DISCONNECTED "provider,disconnected"

Event name for smart callback of widget events: Provider is disconnected.

Since :: 2.3.1

See also:: widget_evas_event_info_s; evas_object_smart_callback_add

#define WIDGET_SMART_SIGNAL_UPDATED "updated"

Event name for smart callback of widget events: Widget content is updated.

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"

Event name for smart callback of widget events: Widget creation is aborted.

Since :: 2.3.1

See also:: widget_evas_event_info_s; evas_object_smart_callback_add

#define WIDGET_SMART_SIGNAL_WIDGET_CREATED "widget,created"

Event name for smart callback of widget events: Widget is created.

Since :: 2.3.1

See also:: widget_evas_event_info_s; evas_object_smart_callback_add

#define WIDGET_SMART_SIGNAL_WIDGET_DELETED "widget,deleted"

Event name for smart callback of widget events: Widget is deleted.

Since :: 2.3.1

See also:: widget_evas_event_info_s; evas_object_smart_callback_add

#define WIDGET_SMART_SIGNAL_WIDGET_FAULTED "widget,faulted"

Event name for smart callback of widget events: Widget has faulted.

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"

Event name for smart callback of widget events: Resizing widget is aborted.

Since :: 2.3.1

See also:: widget_evas_event_info_s; evas_object_smart_callback_add

#define WIDGET_SMART_SIGNAL_WIDGET_RESIZED "widget,resized"

Event name for smart callback of widget events: Widget is resized.

Since :: 2.3.1

See also:: widget_evas_event_info_s; evas_object_smart_callback_add

#define WIDGET_VIEWER_EVAS_DEFAULT_PERIOD -1.0f

Default refresh interval of widgets.

Since :: 2.3.1

See also:: widget_viewer_evas_add_widget; widget_viewer_evas_get_period

Typedef Documentation

typedef enum widget_evas_conf widget_evas_conf_e

Configuration keys.

Since :: 2.3.1

See also:: widget_viewer_evas_set_option

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.

Since :: 2.3.1

See also:: WIDGET_SMART_SIGNAL_WIDGET_CREATE_ABORTED; WIDGET_SMART_SIGNAL_WIDGET_CREATED; WIDGET_SMART_SIGNAL_WIDGET_RESIZE_ABORTED; WIDGET_SMART_SIGNAL_WIDGET_RESIZED; WIDGET_SMART_SIGNAL_WIDGET_FAULTED; WIDGET_SMART_SIGNAL_UPDATED; WIDGET_SMART_SIGNAL_EXTRA_INFO_UPDATED; WIDGET_SMART_SIGNAL_PROVIDER_DISCONNECTED; WIDGET_SMART_SIGNAL_CONTROL_SCROLLER; WIDGET_SMART_SIGNAL_WIDGET_DELETED; WIDGET_SMART_SIGNAL_PERIOD_CHANGED

typedef enum widget_visibility_status widget_visibility_status_e

Enumerations for setting visibility status of a widget.

Since :: 2.3.1

See also:: widget_viewer_evas_freeze_visibility

Enumeration Type Documentation

enum widget_evas_conf

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

enum widget_visibility_status

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

void widget_viewer_evas_activate_faulted_widget ( Evas_Object * widget )

Activate a widget in faulted state.

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

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object faulted

Exceptions:

WIDGET_ERROR_NONE	Successfully activate faulted widget
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

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]	parent	Evas Object of parent
[in]	widget_id	widget id
[in]	content_info	Contents that will be given to the widget instance
[in]	period	Update period (`WIDGET_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_NONE	Successfully added
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result(); widget_service_get_widget_id

void widget_viewer_evas_cancel_click_event ( Evas_Object * widget )

Cancels click event procedure.

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

If you call this function after feed 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

Parameters:

[in] widget a widget object

Exceptions:

WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

void widget_viewer_evas_disable_loading ( Evas_Object * widget )

Hides the loading message of the widget.

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

Remarks:: This function should be called right after create 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.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Exceptions:

WIDGET_ERROR_NONE	Successfully disabled loading text
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

void widget_viewer_evas_disable_overlay_text ( Evas_Object * widget )

Hides the help text of the widget.

While loading a box, hide the help text

Remarks:: This function should be called right after create 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.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Exceptions:

WIDGET_ERROR_NONE	Successfully disabled overlay text
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

void widget_viewer_evas_disable_preview ( Evas_Object * widget )

Hides the preview of the widget.

Remarks:: This function should be called right after create 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.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Exceptions:

WIDGET_ERROR_NONE	Successfully disabled preview
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

int widget_viewer_evas_feed_mouse_up_event ( Evas_Object * widget )

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] widget a widget object

Returns:: 0 on success, otherwise a negative error value

Return values:

WIDGET_ERROR_NONE	if success
WIDGET_ERROR_INVALID_PARAMETER	Invalid argument
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

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_NONE	If success
WIDGET_ERROR_FAULT	Unrecoverable error occurred
WIDGET_ERROR_PERMISSION_DENIED	Permission denied
WIDGET_ERROR_NOT_SUPPORTED	Not supported

See also:: widget_viewer_evas_init

int widget_viewer_evas_freeze_visibility	(	Evas_Object *	widget,
		widget_visibility_status_e	status
	)

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]	widget	a widget object
[in]	status	a visibility status of the widget

Returns:: 0 on success, otherwise a negative error value

Return values:

WIDGET_ERROR_NONE	if success
WIDGET_ERROR_INVALID_PARAMETER	Invalid argument
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: widget_visibility_status_e

const char* widget_viewer_evas_get_content_info ( Evas_Object * widget )

Gets content string of widget.

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

Remarks:: Returned string should not be freed.; The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Returns:: content string to be recognize content of the widget

Return values:

NULL	if there is no specific content string.

Exceptions:

WIDGET_ERROR_NONE	Successfully get content string
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

Postcondition:: Returned string should not be freed

double widget_viewer_evas_get_period ( Evas_Object * widget )

Gets the update period of the widget.

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Returns:: period the update period of the widget.

Return values:

the	update interval of the widget

Exceptions:

WIDGET_ERROR_NONE	Successfully get period
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

const char* widget_viewer_evas_get_title_string ( Evas_Object * widget )

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.

Remarks:: Returned string should not be freed.; The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Returns:: title string to be used for summarizing the widget

Return values:

NULL	if there is no summarized text for content of given widget.

Exceptions:

WIDGET_ERROR_NONE	Successfully get title string
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

const char* widget_viewer_evas_get_widget_id ( Evas_Object * widget )

Gets the id of the widget.

Remarks:: Returned string should not be freed.; The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Returns:: widget id

Return values:

NULL	if an error occurred and you can get the reason of failure using get_last_result()

Exceptions:

WIDGET_ERROR_NONE	Successfully get widget id
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

int widget_viewer_evas_init ( Evas_Object * win )

Initializes the widget system.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] win Window object

Returns:: 0 on success, otherwise a negative error value

Return values:

WIDGET_ERROR_NONE	If success
WIDGET_ERROR_INVALID_PARAMETER
WIDGET_ERROR_ALREADY_EXIST	Already initialized
WIDGET_ERROR_PERMISSION_DENIED	Permission denied
WIDGET_ERROR_NOT_SUPPORTED	Not supported

See also:: widget_viewer_evas_fini

bool widget_viewer_evas_is_faulted ( Evas_Object * widget )

Check whether the widget is faulted.

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Returns:: faulted state of the widget and you can get the result state of this function by using get_last_result()

Return values:

true	for faulted state
false	for not faulted state

Exceptions:

WIDGET_ERROR_NONE	Successfully get the faulted state of the widget
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

bool widget_viewer_evas_is_visibility_frozen ( Evas_Object * widget )

Get the frozen state of visibility option.

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Returns:: fixed state of visibility and you can get the result state of this function by using get_last_result()

Return values:

true	for frozen state
false	for not frozen state

Exceptions:

WIDGET_ERROR_NONE	Successfully get the state of visibility
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

bool widget_viewer_evas_is_widget ( Evas_Object * widget )

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

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Returns:: result of validation and you can get the result state of this function by using get_last_result()

Return values:

true	this is a widget
false	this is not a widget

Exceptions:

WIDGET_ERROR_NONE	Successfully get result of validation
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

int widget_viewer_evas_notify_orientation_of_viewer ( int orientation )

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] orientation orientation of viewer

Returns:: 0 on success, otherwise a negative error value

Return values:

WIDGET_ERROR_NONE	if success
WIDGET_ERROR_FAULT	if it failed to send state (resumed) info
WIDGET_ERROR_PERMISSION_DENIED	Permission denied
WIDGET_ERROR_NOT_SUPPORTED	Not supported

int widget_viewer_evas_notify_paused_status_of_viewer ( void )

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_NONE	if success
WIDGET_ERROR_FAULT	if it failed to send state (resumed) info
WIDGET_ERROR_PERMISSION_DENIED	Permission denied
WIDGET_ERROR_NOT_SUPPORTED	Not supported

See also:: widget_viewer_evas_notify_resumed_status_of_viewer()

int widget_viewer_evas_notify_resumed_status_of_viewer ( void )

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_NONE	if success
WIDGET_ERROR_FAULT	if it failed to send state (paused) info
WIDGET_ERROR_PERMISSION_DENIED	Permission denied
WIDGET_ERROR_NOT_SUPPORTED	Not supported

See also:: widget_viewer_evas_notify_paused_status_of_viewer()

int widget_viewer_evas_pause_widget ( Evas_Object * widget )

Pauses given widget.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Returns:: 0 on success, otherwise a negative error value

Return values:

WIDGET_ERROR_NONE	if success
WIDGET_ERROR_INVALID_PARAMETER	Invalid argument
WIDGET_ERROR_PERMISSION_DENIED	Permission denied
WIDGET_ERROR_FAULT	if it failed to send state (resumed) info
WIDGET_ERROR_NOT_SUPPORTED	Not supported

int widget_viewer_evas_resume_widget ( Evas_Object * widget )

Resume given widget.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in] widget a widget object

Returns:: 0 on success, otherwise a negative error value

Return values:

WIDGET_ERROR_NONE	if success
WIDGET_ERROR_INVALID_PARAMETER	Invalid argument
WIDGET_ERROR_FAULT	if it failed to send state (resumed) info
WIDGET_ERROR_PERMISSION_DENIED	Permission denied
WIDGET_ERROR_NOT_SUPPORTED	Not supported

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]	type	Configuration item
[in]	value	Its value

Returns:: 0 on success, otherwise a negative error value

Return values:

WIDGET_ERROR_NONE	if success
WIDGET_ERROR_INVALID_PARAMETER	Invalid argument
WIDGET_ERROR_PERMISSION_DENIED	Permission denied
WIDGET_ERROR_NOT_SUPPORTED	Not supported

See also:: widget_evas_conf

void widget_viewer_evas_set_permanent_delete	(	Evas_Object *	widget,
		int	flag
	)

Before delete a widget, set the deletion mode.

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/widget.viewer

Parameters:

[in]	widget	a widget object which will be deleted soon
[in]	flag	Pass 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_NONE	Successfully set the flag
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

See also:: get_last_result()

int widget_viewer_evas_thaw_visibility ( Evas_Object * widget )

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] widget a widget object

Returns:: 0 on success, otherwise a negative error value

Return values:

WIDGET_ERROR_NONE	if success
WIDGET_ERROR_INVALID_PARAMETER	Invalid argument
WIDGET_ERROR_NOT_SUPPORTED	Not supported
WIDGET_ERROR_PERMISSION_DENIED	Permission denied

Required Header

Overview

Related Features

Functions

Typedefs

Defines

Define Documentation

Typedef Documentation

Enumeration Type Documentation

Function Documentation