source: trunk/Cocoa/Pester/Source/PSAlarm.h@ 150

Last change on this file since 150 was 113, checked in by Nicholas Riley, 22 years ago

PSTimer.m: Fix bug 15, leaking PSTimer from NSInvocation argument retention.

Read Me.rtfd: Updated release notes.

PSAlarm.[hm]: Removed obsolete comment. Changed 1m-59m times to
display without `0h'. Moved code from deserialization to -resetTimer
to be used for alarm deletion undo - fix bug 14.

PSAlarmsController.m: Fix bug 14 - implement _restoreAlarms:,
_removeAlarms and _undoManager. Need to add localized string.

PSAlarmAlertController.m: Fix bug 17, move alert triggering from
constructor to -performAlertsForAlarm: to avoid nested notifications
delivering in wrong order.

PSAlarms.[hm]: Fix bug 14 - implement -restoreAlarms, invokes [PSAlarm
resetTimer]. Clarified a comment. Uncommented some debug logging.

package-Pester.sh: Implemented partition map-less disk image, saves a
few K on distribution. Removed obsolete comments. Added agvtool
bump.

File size: 2.6 KB
RevLine 
[24]1//
2// PSAlarm.h
3// Pester
4//
5// Created by Nicholas Riley on Wed Oct 09 2002.
6// Copyright (c) 2002 Nicholas Riley. All rights reserved.
7//
8
9#import <Foundation/Foundation.h>
[53]10#import "PSPropertyListSerialization.h"
[24]11
12typedef enum {
[53]13 PSAlarmInvalid, // incorrectly specified
14 PSAlarmInterval, // interval specified (possibly repeating)
15 PSAlarmDate, // date specified
16 PSAlarmSet, // pending, timer set
17 PSAlarmSnooze, // expired alarm with snooze interval set (possibly repeating)
18 PSAlarmExpired // expired alarm (possibly repeating)
[24]19} PSAlarmType;
20
[26]21extern NSString * const PSAlarmTimerSetNotification;
22extern NSString * const PSAlarmTimerExpiredNotification;
[53]23extern NSString * const PSAlarmDiedNotification;
[26]24
[61]25@class PSAlert, PSAlerts, PSTimer;
[34]26
[53]27@interface PSAlarm : NSObject <NSCoding, PSPropertyListSerialization> {
28 PSAlarmType alarmType; // changes during lifetime of alarm; more like a state
[24]29 NSCalendarDate *alarmDate;
30 NSTimeInterval alarmInterval;
[53]31 NSTimeInterval snoozeInterval;
32 NSTimeInterval timeRemaining;
[24]33 NSString *alarmMessage;
34 NSString *invalidMessage;
[61]35 PSTimer *timer;
[53]36 PSAlerts *alerts;
37 BOOL repeating;
[24]38}
39
40- (void)setInterval:(NSTimeInterval)anInterval;
[26]41- (void)setForDateAtTime:(NSCalendarDate *)dateTime;
[24]42- (void)setForDate:(NSDate *)date atTime:(NSDate *)time;
43- (void)setMessage:(NSString *)aMessage;
[53]44- (void)setAlerts:(PSAlerts *)theAlerts;
45- (void)setRepeating:(BOOL)isRepeating;
46- (void)setSnoozeInterval:(NSTimeInterval)anInterval;
[61]47- (void)setWakeUp:(BOOL)doWake;
[24]48
[28]49- (NSCalendarDate *)date;
[51]50- (NSCalendarDate *)time;
[24]51- (NSTimeInterval)interval;
[53]52- (NSTimeInterval)timeRemaining;
[26]53- (NSString *)message;
[53]54- (PSAlerts *)alerts;
55- (BOOL)isRepeating;
56- (NSTimeInterval)snoozeInterval; // most recent interval (nonzero return does not indicate alarm is snoozing or set to snooze)
[24]57
[43]58- (NSString *)dateString;
[28]59- (NSString *)shortDateString;
60- (NSString *)timeString;
[53]61- (NSString *)dateTimeString; // current or next alarm time
62- (NSString *)nextDateTimeString; // next alarm time
63- (NSString *)intervalString;
[28]64- (NSString *)timeRemainingString;
65
[24]66- (BOOL)isValid;
67- (NSString *)invalidMessage;
68
[53]69- (NSAttributedString *)prettyDescription;
70
[51]71- (NSComparisonResult)compareDate:(PSAlarm *)otherAlarm;
72- (NSComparisonResult)compareMessage:(PSAlarm *)otherAlarm;
[28]73
[53]74- (BOOL)setTimer; // or die, if expired and no snooze/repeat
[51]75- (void)cancelTimer;
[113]76- (void)resetTimer; // use after cancel, only effective on set alarms
[26]77
[53]78// 1.1 only, going away when we move to keyed archiving
79- (NSDictionary *)propertyListRepresentation;
80- (id)initWithPropertyList:(NSDictionary *)dict;
81
[24]82@end
Note: See TracBrowser for help on using the repository browser.