iOS Developer Library

Developer

EventKit Framework Reference EKAlarm Class Reference

Options
Deployment Target:

On This Page
Language:

EKAlarm

An EKAlarm object represents an alarm in Event Kit. Use the alarmWithAbsoluteDate: and alarmWithRelativeOffset: class methods to create an alarm and use the properties to set information about an alarm. In OS X Mountain Lion, you can specify an action to trigger when the alarm fires via the emailAddress, soundName, or url property.

Inheritance


Conforms To


Import Statement


import EventKit @import EventKit;

Availability


Available in iOS 4.0 and later.
  • Creates and returns an alarm with an absolute date.

    Declaration

    Swift

    init!(absoluteDate date: NSDate!) -> EKAlarm

    Objective-C

    + (EKAlarm *)alarmWithAbsoluteDate:(NSDate *)date

    Parameters

    date

    The date for the alarm.

    Return Value

    The created alarm.

    Import Statement

    import EventKit

    Availability

    Available in iOS 4.0 and later.

  • Creates and returns an alarm with a relative offset.

    Declaration

    Swift

    init!(relativeOffset offset: NSTimeInterval) -> EKAlarm

    Objective-C

    + (EKAlarm *)alarmWithRelativeOffset:(NSTimeInterval)offset

    Parameters

    offset

    The offset from the start of an event, at which the alarm fires.

    Return Value

    The created alarm.

    Discussion

    Negative offset values fire before the start of the event, while positive values fire after the start.

    Import Statement

    import EventKit

    Availability

    Available in iOS 4.0 and later.

  • The absolute date for the alarm.

    Declaration

    Swift

    @NSCopying var absoluteDate: NSDate!

    Objective-C

    @property(nonatomic, copy) NSDate *absoluteDate

    Discussion

    If you set this property for a relative offset alarm, it loses the relative offset and becomes an absolute alarm.

    Import Statement

    import EventKit

    Availability

    Available in iOS 4.0 and later.

  • The offset from the start of an event, at which the alarm fires.

    Declaration

    Swift

    var relativeOffset: NSTimeInterval

    Objective-C

    @property(nonatomic) NSTimeInterval relativeOffset

    Discussion

    If you set this value for an absolute alarm, it loses its absolute date and becomes a relative offset alarm.

    Import Statement

    import EventKit

    Availability

    Available in iOS 4.0 and later.

  • The location to trigger an alarm.

    Declaration

    Swift

    @NSCopying var structuredLocation: EKStructuredLocation!

    Objective-C

    @property(nonatomic, copy) EKStructuredLocation *structuredLocation

    Discussion

    This property is used in conjunction with proximity to perform geofence-based triggering of reminders.

    Import Statement

    import EventKit

    Availability

    Available in iOS 6.0 and later.

  • proximity proximity Property

    A value indicating how a location-based alarm is triggered.

    Declaration

    Swift

    var proximity: EKAlarmProximity

    Objective-C

    @property(nonatomic) EKAlarmProximity proximity

    Discussion

    Alarms can be set to trigger when entering or exiting a location specified by structuredLocation. By default, alarms are not affected by location.

    Import Statement

    import EventKit

    Availability

    Available in iOS 6.0 and later.

    See Also

    EKAlarmProximity

Data Types

  • A value indicating whether an alarm is triggered by entering or exiting a region.

    Declaration

    Swift

    typealias EKAlarmProximity = Int

    Objective-C

    typedef enum { EKAlarmProximityNone, EKAlarmProximityEnter, EKAlarmProximityLeave, } EKAlarmProximity;

    Constants

    • EKAlarmProximityNone

      EKAlarmProximityNone

      The alarm has no proximity trigger.

      Available in iOS 6.0 and later.

    • EKAlarmProximityEnter

      EKAlarmProximityEnter

      The alarm is set to fire when entering a region.

      Available in iOS 6.0 and later.

    • EKAlarmProximityLeave

      EKAlarmProximityLeave

      The alarm is set to fire when leaving a region.

      Available in iOS 6.0 and later.

    Import Statement

    import EventKit

    Availability

    Available in iOS 6.0 and later.