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
Implements

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
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
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
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
C#
Copy
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
Copy
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
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
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
String[] args

Arguments from the commandline.

Overrides
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
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
C#
Copy
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
Copy
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
C#
Copy
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
C#
Copy
public event EventHandler<TimeEventArgs> AmbientTick
Event Type
Type Description
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
EventHandler
API Level: 4
View Source

Resumed

Occurs whenever the application is resumed.

Declaration
C#
Copy
public event EventHandler Resumed
Event Type
Type Description
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
EventHandler<TimeEventArgs>
API Level: 4

Implements