Class WatchApplication

Definition

Namespace:: Tizen.Applications

Assembly:: Tizen.Applications.WatchApplication.dll

API Level:: 4

The class that represents the Tizen watch application.


                C#
                
                    Copy
                    
                
            
public class WatchApplication : CoreApplication, IDisposable

Inheritance: System.Object

Application

CoreApplication

WatchApplication

Implements: System.IDisposable

Constructors

View Source

WatchApplication()

Initializes the WatchApplication class.

Declaration


                C#
                
                    Copy
                    
                
            
public WatchApplication()

Remarks

Default backend for the watch application will be used.

API Level: 4

View Source

WatchApplication(ICoreBackend)

Initializes the WatchApplication class.

Declaration


                C#
                
                    Copy
                    
                
            
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


                C#
                
                    Copy
                    
                
            
protected Window Window

Field Value

Type	Description
Window

API Level: 4

Methods

View Source

GetAmbientTickType()

Gets the type of the periodic ambient tick.

Declaration


                C#
                
                    Copy
                    
                
            
protected AmbientTickType GetAmbientTickType()

Returns

Type	Description
AmbientTickType	AmbientTickType

Examples


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

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when failed to get the ambient tick type.
System.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


                C#
                
                    Copy
                    
                
            
protected WatchTime GetCurrentTime()

Returns

Type	Description
WatchTime	WatchTime

Examples


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

Exceptions

Type	Condition
System.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.
System.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


                C#
                
                    Copy
                    
                
            
protected void GetTimeTickFrequency(out int ticks, out TimeTickResolution type)

Parameters

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

Examples


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

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when failed to get the time tick frequency.
System.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


                C#
                
                    Copy
                    
                
            
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


                C#
                
                    Copy
                    
                
            
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


                C#
                
                    Copy
                    
                
            
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


                C#
                
                    Copy
                    
                
            
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


                C#
                
                    Copy
                    
                
            
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


                C#
                
                    Copy
                    
                
            
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


                C#
                
                    Copy
                    
                
            
public override void Run(string[] args)

Parameters

Type	Name	Description
System.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


                C#
                
                    Copy
                    
                
            
protected void SetAmbientTickType(AmbientTickType ambientTickType)

Parameters

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

Examples


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

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when failed to set the ambient tick type.
System.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


                C#
                
                    Copy
                    
                
            
protected void SetTimeTickFrequency(int ticks, TimeTickResolution type)

Parameters

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

Examples


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

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when failed to set the time tick frequency.
System.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


                C#
                
                    Copy
                    
                
            
public event EventHandler<AmbientEventArgs> AmbientChanged

Event Type

Type	Description
System.EventHandler<AmbientEventArgs>

API Level: 4

View Source

AmbientTick

Occurs whenever the time tick comes in the ambient mode.

Declaration


                C#
                
                    Copy
                    
                
            
public event EventHandler<TimeEventArgs> AmbientTick

Event Type

Type	Description
System.EventHandler<TimeEventArgs>

API Level: 4

View Source

Paused

Occurs whenever the application is paused.

Declaration


                C#
                
                    Copy
                    
                
            
public event EventHandler Paused

Event Type

Type	Description
System.EventHandler

API Level: 4

View Source

Resumed

Occurs whenever the application is resumed.

Declaration


                C#
                
                    Copy
                    
                
            
public event EventHandler Resumed

Event Type

Type	Description
System.EventHandler

API Level: 4

View Source

TimeTick

Occurs whenever the time tick comes.

Declaration


                C#
                
                    Copy
                    
                
            
public event EventHandler<TimeEventArgs> TimeTick

Event Type

Type	Description
System.EventHandler<TimeEventArgs>

API Level: 4

Implements

System.IDisposable