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

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[]
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 privilege to access this method.
View Source

Dispose()

Releases all the resources used by the WidgetControl class.

Declaration
public void Dispose()
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
Exceptions
Type Condition
System.ArgumentNullException

Thrown when the argument is null.
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>
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 privilege 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
Exceptions
Type Condition
System.ArgumentNullException

Thrown when the argument is null.
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>
Exceptions
Type Condition
System.InvalidOperationException

Thrown in case of failed conditions.
System.UnauthorizedAccessException

Thrown when an application does not have the privilege to access this method.
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
Returns
Type Description
string[]
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 privilege to access this method.

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 privilege to access this method.
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 privilege to access this method.
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 privilege to access this method.
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 privilege to access this method.

Implements

System.IDisposable