Class Alarm

Definition

Namespace:: Tizen.Applications

Assembly:: Tizen.Applications.Alarm.dll

API Level:: 3

The alarm API allows setting an "alarm clock" for the delivery of a notification at some point in the future.


                C#
                
                    Copy
                    
                
            
public class Alarm

Inheritance: System.Object

Alarm

Examples


                
                
                    Copy
                    
                
            
public class AlarmExample
{
    /// ...
    IEnumerable < Alarm > alarms = AlarmManager.GetAllScheduledAlarms();
    alarms[0].Cancel();
}

Properties

View Source

AlarmAppControl

Gets the AppControl to be invoked when the the alarm is triggered.

Declaration


                C#
                
                    Copy
                    
                
            
public AppControl AlarmAppControl { get; }

Property Value

Type	Description
AppControl

API Level: 3

Privilege Level: public

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

View Source

AlarmId

The alarm ID uniquely identifies an alarm.

Declaration


                C#
                
                    Copy
                    
                
            
public int AlarmId { get; }

Property Value

Type	Description
Int32

API Level: 3

View Source

Global

Gets whether the alarm will launch global application or not.

Declaration


                C#
                
                    Copy
                    
                
            
public bool Global { get; set; }

Property Value

Type	Description
Boolean

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/alarm.sethttp://tizen.org/privilege/alarm.get

View Source

Period

Gets the period of time between the recurrent alarms.

Declaration


                C#
                
                    Copy
                    
                
            
public int Period { get; set; }

Property Value

Type	Description
Int32

Remarks

The Period property setter is available since API Level 6. If the week recurrence flag was set before, it will be removed and the period will be set If the period was set before, it will be overwritten.If it was not, it will be set. If the @a period argument is 0 and the period was previously set, the period attribute will be cleared and the alarm will be changed to one-time. If the @a period argument is 0 and the period was not set, or the week recurrence flag was set, the alarm will be unchanged.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/alarm.sethttp://tizen.org/privilege/alarm.get

View Source

ScheduledDate

Gets or sets the scheduled time.

Declaration


                C#
                
                    Copy
                    
                
            
public DateTime ScheduledDate { get; set; }

Property Value

Type	Description
System.DateTime

Remarks

The SchduleDate property setter is available since API Level 6.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/alarm.sethttp://tizen.org/privilege/alarm.get

View Source

WeekFlag

Gets or sets the recurrence days of the week.

Declaration


                C#
                
                    Copy
                    
                
            
public AlarmWeekFlag WeekFlag { get; set; }

Property Value

Type	Description
AlarmWeekFlag

Remarks

The setter for WeekFlag property is available since API Level 6. Weekflag can be a combination of the days of the week, for example Tuesday | Friday. If the period is already set, it will be removed and the week repetition flag will be set. If the week repetition flag is already set, it will be overwritten. If not, it will be set. If the Weekflag argument is 0 and the flag is already set, the flag will be cleared and the alarm will be changed to set once. If the Weekflag argument is 0, and the flag is not set or the period is set, the alarm won't be changed.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/alarm.sethttp://tizen.org/privilege/alarm.get

Methods

View Source

Cancel()

Cancels the specific alarm.

Declaration


                C#
                
                    Copy
                    
                
            
public void Cancel()

Exceptions

Type	Condition
System.ArgumentException	Thrown in case of an invalid parmaeter.
UnauthorizedAccessException	Thrown in case of a permission denied due to insufficient privileges.
System.InvalidOperationException	Thrown in case of any internal error.