Class WatchApplication

Definition

Namespace:: Tizen.Applications

Assembly:: Tizen.Applications.WatchApplication.dll

API Level:: 4

The class that represents the Tizen watch application.

public class WatchApplication : CoreApplication, IDisposable

Inheritance: Object

Application

CoreApplication

WatchApplication

Implements: IDisposable

Constructors

View Source

WatchApplication()

Initializes the WatchApplication class.

Declaration

public WatchApplication()

Remarks

Default backend for the watch application will be used.

API Level: 4

View Source

WatchApplication(ICoreBackend)

Initializes the WatchApplication class.

Declaration

public WatchApplication(ICoreBackend backend)

Parameters

Type	Name	Description
ICoreBackend	backend	The backend instance implementing the ICoreBackend interface.

Remarks

If you want to change the backend, use this constructor.

API Level: 4

Fields

View Source

Window

Instances for the window.

Declaration

protected Window Window

Field Value

Type	Description
Window

API Level: 4

Methods

View Source

GetAmbientTickType()

Gets the type of the periodic ambient tick.

Declaration

protected AmbientTickType GetAmbientTickType()

Returns

Type	Description
AmbientTickType	AmbientTickType

Examples

class MyApp : WatchApplication
{
    ...
    public void TestMethod()
    {
        AmbientTickType atType;
        try
        {
            atType = GetAmbientTickType();
        }
        catch
        {
        }
    }
}

Exceptions

Type	Condition
InvalidOperationException	Thrown when failed to get the ambient tick type.
NotSupportedException	Thrown when the method is not supported.

API Level: 4

Feature: http://tizen.org/feature/watch_app

View Source

GetCurrentTime()

Gets the current time.

Declaration

protected WatchTime GetCurrentTime()

Returns

Type	Description
WatchTime	WatchTime

Examples

class MyApp : WatchApplication
{
    ...
    public void TestMethod()
    {
        WatchTime wt;
        try
        {
            wt = GetCurrentTime();
        }
        catch
        {
        }
    }
}

Exceptions

Type	Condition
InvalidOperationException	Thrown when failed to get the current time because of an invalid parameter.
OutOfMemoryException	Thrown when failed to get the current time because the memory is not enough.
NotSupportedException	Thrown when the method is not supported.

API Level: 4

Feature: http://tizen.org/feature/watch_app

View Source

GetTimeTickFrequency(out Int32, out TimeTickResolution)

Gets the frequency of the time tick.

Declaration

protected void GetTimeTickFrequency(out int ticks, out TimeTickResolution type)

Parameters

Type	Name	Description
Int32	ticks	Ticks the number of ticks per given resolution type.
TimeTickResolution	type	Type of the resolution type.

Examples

class MyApp : WatchApplication
{
    ...
    public void TestMethod()
    {
        int tick;
        TimeTickResolution tType;
        try
        {
            GetTimeTickFrequency(out tick, out tType);
        }
        catch
        {
        }
    }
}

Exceptions

Type	Condition
InvalidOperationException	Thrown when failed to get the time tick frequency.
NotSupportedException	Thrown when the method is not supported.

API Level: 4

Feature: http://tizen.org/feature/watch_app

View Source

OnAmbientChanged(AmbientEventArgs)

Overrides this method to handle the behavior when the ambient mode is changed. If base.OnAmbientChanged() is not called, the event 'AmbientChanged' will not be emitted.

Declaration

protected virtual void OnAmbientChanged(AmbientEventArgs mode)

Parameters

Type	Name	Description
AmbientEventArgs	mode	The received AmbientEventArgs.

API Level: 4

View Source

OnAmbientTick(TimeEventArgs)

Overrides this method to handle the behavior when the time tick event comes in ambient mode. If base.OnAmbientTick() is not called, the event 'AmbientTick' will not be emitted.

Declaration

protected virtual void OnAmbientTick(TimeEventArgs time)

Parameters

Type	Name	Description
TimeEventArgs	time	The received TimeEventArgs to get time information.

API Level: 4

Privilege Level: public

Privilege: http://tizen.org/privilege/alarm.set

View Source

OnCreate()

Overrides this method to handle the behavior when the application is launched. If base.OnCreate() is not called, the event 'Created' will not be emitted.

Declaration

protected override void OnCreate()

Overrides

CoreApplication.OnCreate()

API Level: 4

View Source

OnPause()

Overrides this method to handle the behavior when the application is paused. If base.OnPause() is not called, the event 'Paused' will not be emitted.

Declaration

protected virtual void OnPause()

API Level: 4

View Source

OnResume()

Overrides this method to handle the behavior when the application is resumed. If base.OnResume() is not called, the event 'Resumed' will not be emitted.

Declaration

protected virtual void OnResume()

API Level: 4

View Source

OnTick(TimeEventArgs)

Overrides this method to handle the behavior when the time tick event comes. If base.OnTick() is not called, the event 'TimeTick' will not be emitted.

Declaration

protected virtual void OnTick(TimeEventArgs time)

Parameters

Type	Name	Description
TimeEventArgs	time	The received TimeEventArgs to get the time information.

API Level: 4

View Source

Run(String[])

Runs the UI applications' main loop.

Declaration

public override void Run(string[] args)

Parameters

Type	Name	Description
String[]	args	Arguments from the commandline.

Overrides

CoreApplication.Run(String[])

API Level: 4

View Source

SetAmbientTickType(AmbientTickType)

Sets the type of the periodic ambient tick. OnAmbientTick will be called for the following settings. If the SetAmbientTickType is not called, the OnAmbientTick will be called every minute.

Declaration

protected void SetAmbientTickType(AmbientTickType ambientTickType)

Parameters

Type	Name	Description
AmbientTickType	ambientTickType	The type of the ambient tick.

Examples

class MyApp : WatchApplication
{
    ...
    public void TestMethod()
    {
        try
        {
            SetAmbientTickType(AmbientTickType.EveryMinute);
        }
        catch
        {
        }
    }
}

Exceptions

Type	Condition
InvalidOperationException	Thrown when failed to set the ambient tick type.
NotSupportedException	Thrown when the method is not supported.

API Level: 4

Feature: http://tizen.org/feature/watch_app

View Source

SetTimeTickFrequency(Int32, TimeTickResolution)

Sets the frequency of the time tick. OnTick will be called for the following settings. If SetTimeTickFrequency is not called, OnTick will be called every second.

Declaration

protected void SetTimeTickFrequency(int ticks, TimeTickResolution type)

Parameters

Type	Name	Description
Int32	ticks	Ticks the number of ticks per given resolution type.
TimeTickResolution	type	Type of the resolution type.

Examples

class MyApp : WatchApplication
{
    ...
    public void TestMethod()
    {
        try
        {
            SetTimeTickFrequency(1, TimeTickResolution.TimeTicksPerMinute);
        }
        catch
        {
        }
    }
}

Exceptions

Type	Condition
InvalidOperationException	Thrown when failed to set the time tick frequency.
NotSupportedException	Thrown when the method is not supported.

API Level: 4

Feature: http://tizen.org/feature/watch_app

Events

View Source

AmbientChanged

Occurs when the ambient mode is changed.

Declaration

public event EventHandler<AmbientEventArgs> AmbientChanged

Event Type

Type	Description
EventHandler<AmbientEventArgs>

API Level: 4

View Source

AmbientTick

Occurs whenever the time tick comes in the ambient mode.

Declaration

public event EventHandler<TimeEventArgs> AmbientTick

Event Type

Type	Description
EventHandler<TimeEventArgs>

API Level: 4

View Source

Paused

Occurs whenever the application is paused.

Declaration

public event EventHandler Paused

Event Type

Type	Description
EventHandler

API Level: 4

View Source

Resumed

Occurs whenever the application is resumed.

Declaration

public event EventHandler Resumed

Event Type

Type	Description
EventHandler

API Level: 4

View Source

TimeTick

Occurs whenever the time tick comes.

Declaration

public event EventHandler<TimeEventArgs> TimeTick

Event Type

Type	Description
EventHandler<TimeEventArgs>

API Level: 4

Implements

System.IDisposable