9.1 Calendar-File Header

The first 8 bytes of a Calendar file are a character array identifying the file as a Calendar file. Following are the contents of the array:

'C' + 'r' = b5
'A' + 'a' = a2
'L' + 'd' = b0
'E' + 'n' = b3
'N' + 'e' = b3
'D' + 'l' = b0
'A' + 'a' = a2
'R' + 'c' = b5

The next 2 bytes (cDateDescriptors) contain the integer count of dates described in the file.

The next 12 bytes contain six 2-byte fields of information that is global to the entire file. These variables are normally set by the user through the Alarm Controls and Options Day dialog boxes. The header information has the following form:

WORD    MinEarlyRing
BOOL    fSound
int     interval
int     mininterval
BOOL    f24HourFormat
int     StartTime

Following are the members in the header structure:

MinEarlyRing

Specifies an early ring, in minutes.

fSound

Specifies whether alarms should be audible.

interval

Specifies the interval between appointments: 0 = 15 minutes, 1 = 30 minutes, 2 = 60 minutes.

mininterval

Specifies the interval, in minutes.

f24HourFormat

Specifies the time format: nonzero=24-hour format.

StartTime

Specifies the starting time in day mode—that is, the time that normally appears first in the display, in minutes past midnight.

The rest of the first 64 bytes are reserved.