Class WidgetControl

Definition

Namespace:
Tizen.Applications
Assembly:
Tizen.Applications.WidgetControl.dll

The class for receiving widget events and sending data to the widget.

public class WidgetControl : IDisposable
Inheritance
object
WidgetControl
Implements
System.IDisposable

Constructors

View Source

WidgetControl(string)

The constructor of the WidgetControl object.

Declaration
public WidgetControl(string widgetId)
Parameters
Type Name Description
string widgetId

Widget ID.

Properties

View Source

Id

The widget ID.

Declaration
public string Id { get; }
Property Value
Type Description
string
View Source

IsNoDisplay

The flag value for "nodisplay".

Declaration
public bool IsNoDisplay { get; }
Property Value
Type Description
bool
Exceptions
Type Condition
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.
View Source

MainAppId

Gets main appid of the widget.

Declaration
public string MainAppId { get; }
Property Value
Type Description
string
Exceptions
Type Condition
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.
View Source

PackageId

Gets package ID of the widget.

Declaration
public string PackageId { get; }
Property Value
Type Description
string
Exceptions
Type Condition
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.

Methods

View Source

CreateAll(string)

Factory method for the WidgetControl. It will create all the objects of WidgetControl based on the package ID.

Declaration
public static WidgetControl[] CreateAll(string pkgId)
Parameters
Type Name Description
string pkgId

Package ID.
Returns
Type Description
WidgetControl[]

The widget control array.
Exceptions
Type Condition
System.ArgumentException

Thrown when failed because of an invalid argument.
System.InvalidOperationException

Thrown in case of failed conditions.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.
View Source

Dispose()

Releases all the resources used by the WidgetControl class.

Declaration
public void Dispose()
Exceptions
Type Condition
System.InvalidOperationException

Thrown in case of failed conditions.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.
View Source

~WidgetControl()

Finalizer of the WidgetControl class.

Declaration
protected ~WidgetControl()
View Source

GetIconPath(string)

Gets the widget icon path.

Declaration
public string GetIconPath(string lang)
Parameters
Type Name Description
string lang

Language.
Returns
Type Description
string

The widget icon path.
Exceptions
Type Condition
System.ArgumentNullException

Thrown when the argument is null.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.
View Source

GetInstances()

Gets the objects for widget instance information.

Declaration
public IEnumerable<WidgetControl.Instance> GetInstances()
Returns
Type Description
System.Collections.Generic.IEnumerable<T><WidgetControl.Instance>

The instances list.
Exceptions
Type Condition
System.InvalidOperationException

Thrown in case of failed conditions.
System.NotSupportedException

Thrown when the API is not supported in this device.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
View Source

GetName(string)

Gets the widget name.

Declaration
public string GetName(string lang)
Parameters
Type Name Description
string lang

Language.
Returns
Type Description
string

The widget name.
Exceptions
Type Condition
System.ArgumentNullException

Thrown when the argument is null.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.
View Source

GetScales()

Gets the objects for widget scale information.

Declaration
public IEnumerable<WidgetControl.Scale> GetScales()
Returns
Type Description
System.Collections.Generic.IEnumerable<T><WidgetControl.Scale>

The scales list.
Exceptions
Type Condition
System.InvalidOperationException

Thrown in case of failed conditions.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.
View Source

GetWidgetIds(string)

Gets all the widget IDs by the package ID.

Declaration
public static string[] GetWidgetIds(string pkgId)
Parameters
Type Name Description
string pkgId

Package ID.
Returns
Type Description
string[]

The widget id array.
Exceptions
Type Condition
System.ArgumentException

Thrown when failed because of an invalid argument.
System.InvalidOperationException

Thrown in case of failed conditions.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.

Events

View Source

Created

The event handler for a created widget instance.

Declaration
public event EventHandler<WidgetLifecycleEventArgs> Created
Event Type
Type Description
System.EventHandler<TEventArgs><WidgetLifecycleEventArgs>
Exceptions
Type Condition
System.InvalidOperationException

Thrown in case of failed conditions.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.
View Source

Destroyed

The event handler for a destroyed widget instance.

Declaration
public event EventHandler<WidgetLifecycleEventArgs> Destroyed
Event Type
Type Description
System.EventHandler<TEventArgs><WidgetLifecycleEventArgs>
Exceptions
Type Condition
System.InvalidOperationException

Thrown in case of failed conditions.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.
View Source

Paused

The event handler for a paused widget instance.

Declaration
public event EventHandler<WidgetLifecycleEventArgs> Paused
Event Type
Type Description
System.EventHandler<TEventArgs><WidgetLifecycleEventArgs>
Exceptions
Type Condition
System.InvalidOperationException

Thrown in case of failed conditions.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.
View Source

Resumed

The event handler for a resumed widget instance.

Declaration
public event EventHandler<WidgetLifecycleEventArgs> Resumed
Event Type
Type Description
System.EventHandler<TEventArgs><WidgetLifecycleEventArgs>
Exceptions
Type Condition
System.InvalidOperationException

Thrown in case of failed conditions.
System.UnauthorizedAccessException

Thrown when an application does not have the required privileges to access this method.
System.NotSupportedException

Thrown when the required features are not supported.

Implements

System.IDisposable