"Highlight" is the term I'm using to describe holidays, anniversaries, birthdays, and other notable dates. Highlights are added to the calendar as it is being generated. The Highlight Editor described below is not the same as the requester that's a part of FWCAddEvent. The events entered in FWCAddEvent are added to a calendar that has already been generated. These events do not repeat themselves every year (at least not at the same time).

There are several possibilities for highlight information, depending on whether the highlight falls on a fixed date or can "float". Both fixed highlights and floating highlights and can be set to happen monthly, while "fixed" highlights can also be set to show up only on weekdays or to always show up on the last day of the month. Highlights can also be set to occur weekly or biweekly (ie, on a certain weekday of only odd or even weeks).

If a Standard calendar is generated, then Easter-based highlights, highlights based on the Hebrew calendar (e.g., Rosh Hashana), and highlights based on the Islamic calendar (e.g., Ramadan) can be included. If a Hebrew or Islamic calendar is generated, Easter-based highlights can be included. The highlights available depend on the calendar type selected (by way of the menu) when the Highlight Editor is started.

Multiple highlights falling on the same day will automatically be accounted for. If you're using different date-cell background colors for your holiday-highlights and other highlights, only the box for the first highlight will be drawn (this keeps boxes from covering up already-rendered text).

If a highlight is wider than the calendar box width, the highlight will be compressed if possible and word-wrapped if necessary.

The dates of all highlights will be bolded in minicalendars. If a highlight is indicated as Special, the date for that highlight will either be boxed or surrounded by an image of your choice (see Image.Special) in the minicalendars. If a highlight is indicated as Holiday, the date for that highlight will either be boxed or surrounded by an image of your choice (see Image.Holiday) in the minicalendars.

Highlights entered in this editor are added to the calendar as it is being generated. This is different from the requester that's a part of FWCAddEvent. The events entered in FWCAddEvent are added to a calendar that has already been generated. These events do not repeat themselves every year (at least not at the same time).

The Highlight Editor is called by clicking on the Highlight Editor button found on the "Variables" tab of the Variable Editor. This editor consists of the following fields, settings, and gadgets:

Help bubbles can be accessed by placing the mouse pointer over a gadget and pressing the 'Help' key on the keyboard. The bubble will go away after a short time (as defined by the HelpTime variable) or upon pressing the 'Help' key a second time (in the help-bubble window).

Event: Enter the highlight as you want it to appear in the calendar, including any quotes you want to appear. Although either single or double quotes can be used, only one type can be used in a given highlight.

An anniversary age can be included by entering %CYYYY or %OYYYY within the event, where YYYY is the "base year" (the initiating year of an event, such as the birth year or the wedding year). If the %C marker is used, then the counting "age" (e.g., "22") of the event will be substituted in the event, while the %O marker will cause the ordinal "age" (e.g., "22nd") of the event to be substituted. For example, given that the current year is 2002, entering the following event lines will result in the following outputs:

Given that different countries have different rules for creating ordinal numbers out of counting numbers, you may have to include some ordinal definitions in the FWCTranslations.txt file. The following definitions are used as a default:

OrdinalSuffix.11 = 'th'
OrdinalSuffix.12 = 'th'
OrdinalSuffix.13 = 'th'
OrdinalSuffix.1 = 'st'
OrdinalSuffix.2 = 'nd'
OrdinalSuffix.3 = 'rd'
OrdinalSuffix.Base = 'th'

This means to use th as the ordinal suffix for "ages" ending in '11', '12', or '13', use st if the "age" ends in '1', nd for "ages" ending in '2', and rd for "ages" ending in '3'. For all other "ages," use th as the suffix. Note that the first three lines (for 11, 12, and 13) are required to override the rules for "ages" ending in 1, 2, and 3.

File Selector: The file selector gadget is used to select images to appear on the calendar. If you want to shift the image (see the Images section), you can enter the comma-separated x- and y-shifts after selecting the image.

V: The chooser gadget will list the highlights for the current month in chronological order, even as new events are added.

>: The right-pointing arrow is used to select the next (chronologically) highlight, wrapping around to the first event when necessary. Shift-clicking on the gadget will select the previous (chronologically) highlight, wrapping around to the last event when necessary.

Comment: Enter an optional comment for the highlight. Although the comment won't be printed, it is available to maintain compatability with previous versions of FWCalendar.

Month Selector: The month selector is used to select the month in which the highlight falls. Also available in this selector is "All" for those highlights (like pay days) that happen at the same time every month. Changes to the current month's highlights are saved to memory when a new month is selected; changes are not saved to the preference file until a calendar is generated.

Date Selectors: The calendar of gadgets is used to select the date on which a highlight falls. The "LD" gadget is used for highlights that fall on the last day of a month.

Category: The category of highlight being added. If a Standard calendar is being generated, then Easter, Jewish, and Islamic events can be selected with this gadget. If a Hebrew or Islamic calendar is being generated, then Easter events can be selected with this gadget.

Type:

	Standard	Standard highlights are those that happen on specified days of the month. Events like birthdays, anniversaries, and national holidays fall in this category. Standard highlights can be Fixed, Floating, or (Bi)Weekly (the descriptions of each of these highlight types can be read below).
	Easter	Easter highlights are those that are based on the day on which Easter falls. Events like Ash Wednesday, Palm Sunday, and Good Friday fall in this category. Easter highlights are always fixed. The number of days before Easter the highlight occurs is entered in the "Offset" string as a negative number, or the number of days after Easter the highlight occurs is entered in the "Offset" string as a positive number.
	Hebrew	Hebrew highlights are those that are based on the Hebrew calendar. Events like Rosh Hashana, Chanukah, and Passover fall in this category. Hebrew highlights are always fixed.
	Islamic	Islamic highlights are those that are based on the Islamic calendar. Events like Ramadan fall in this category. Islamic highlights are always fixed.

The gadget below the highlight type will change depending on the highlight type selected.

Color: The print color for the highlight can be selected with this gadget. If <Clear> is selected, the print color for the highlight will be determined by the values of Color.Highlight, Color.HighlightH, AltColor.Highlight, and AltColor.HighlightH as appropriate.

Day Type: If you want a highlight to be treated as Special or Holiday (which allows different background colors to be used for the days than used for non-holiday entries), set the cycle gadget to "Special" or "Holiday".

Delete Event: Highlights can be deleted with this gadget. The current highlight list will be saved to memory when the "Done" gadget is pressed, but not saved to the preference file until a calendar is generated.

Done: Selecting "Done" will cause any changes made to be saved to memory. Changes will not be saved to the preference file until a calendar is generated. Changes are also saved to memory anytime a new month is selected with the month selector. You can exit without saving current changes by selecting the "Close" gadget in the upper left corner of the requester; changes already saved to memory by switching months can only be cancelled by cancelling the main Variable Editor.

Fixed highlights are those highlights that always fall on the same day (for example, a birthday), and those highlights that usually fall on the same day (for example, tax day in America is always April 15 unless April 15 falls on a weekend, in which case it falls on the following Monday).

If a highlight always falls on the same day, leave the "Weekend" gadget set to "OK". If the highlight can't fall on the weekend, then set the "Weekend" gadget to "Prev Day" if the highlight gets moved up to the previous Friday, or to "Next Day" if the highlight gets moved back to the following Monday. Always set the date gadget to the day the highlight should fall on, even if it shows up on the weekend in the particular month shown in the editor.

The "LD" gadget is used for highlights that fall on the last day of a month.

Floating highlights are those that occur during a certain week of the month. Mother's Day, for example, always falls on the Sunday during the second week of May, while Memorial Day always falls on the Monday during the last week of May.

To set these highlights, select the date gadget for the day on which the highlight falls. The "Week Number" gadget will automatically indicate which week you have chosen. If you would like to change the week number, select the proper week number in the "Week Number" gadget, and the date will change accordingly. Be especially aware of the week number setting for those highlights that occur during the last week of a month rather than during the fourth week of a month.