Variable Editor

The Variable Editor is the opening requester for FWCalendar. Changes made in the Variable Editor are saved to the preference file.

Both FWCalendar and FWCAddEvent use the same user-chosen preference file for initializing variables, so you should not change the preference file between using FWCalendar and FWCAddEvent.

(ClassAct GUI only) 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).


Control Buttons:
The control buttons show up on all tabs.

(Start) Month: Allows you to select the month of the generated calendar. If the selected calendar type is multi-month (only available when PageStream is the host application), then this gadget selects the first month to be generated. This gadget will not be available for "yearly" calendar types.

End Month: Allows you to select the final month of a multi-month calendar (only available when PageStream is the host application) to be generated. This gadget will not be present for "yearly" or "single-month" calendar types.

Year: Allows you to select the year of the generated calendar. The up/down gadget can be used to change the value, or the value can be entered directly.

Calendar Type: Select the desired calendar type: Single-month, where each application document consists of a single calendar; Multi-month (only available when PageStream is the host application), where each application document consists of a number of calendars as defined by the start- and end- months; or Yearly, where each application document consists of twelve mini-calendars for the year.

Go: Begin generation of the selected calendar type and save changes made to the settings. (For the ClassAct GUI only, holding down a shift key will prevent changes made to the settings from being saved.)

Reset: Causes the default settings (the settings coded into FWCalendar) to be loaded.

Load: Allows you to load a preference file. The full path and file name of the loaded preference file will be displayed at the top of the requester; if the PrefsName variable is set in the preference file, that name will be displayed in place of the preference file's path and file name.

Save As: Allows you to save the current settings under a new name. The new file then becomes the default preference file.

Cancel: Cancels the operation. If the requester is cancelled, no changes made to any variables (either in the variable requester or in the highlight editor) will be saved.


Options & Layout Tab
MiniCals: If checked, mini-calendars showing the previous and next months will be included in the upper-left and upper-right corners of the calendar page.

Highlights: If checked, highlights found in the preference file will be included. Use the Highlight Editor to set the highlights.

Images: If checked, images will be included on days either defined in the Highlight Editor or identified as an Imageclass. variable. Note that the "Images" checkbox will be ghosted if FWCalendar can't find the graphics application identified in GfxApp. If the "Images" checkbox is ghosted and you don't think it should be, check the values of the GfxApp and GfxAppPath variables to make sure they are properly set.

Box Dates: If checked, a box will be drawn around the date in the Font.Date color. If Final Writer is the host application, don't use this option with CornerRadius (the curvature of the boxes will be different and not look very good).

Extended: If checked, the days from the previous month and the next month will be printed on the calendar as appropriate. This option is not possible at the same time as either the "Extra week at top" or "Note Box" options.

Extra week at top: If checked, the last week of months that extend into the 6th week will be printed as full-sized cells at the top of the calendar rather than half-height cells at the bottom of the calendar. This option is not possibe if the "Extended" option has been selected.

Note box: If checked, an empty box with the user-definable label (defaulting to "Notes") will be included where ever empty calendar boxes would show up. This option can be used with the "Extra week at top" option, but cannot be used with the "Extended" option (the entire calendar is filled with calendar boxes in this case.

Margins: The text boxes surrounding the cycle gadget correspond to (going clockwise from the top) the top, right, bottom, and left margins. The values are read from the application's preferences when Final Writer is the host application, and default to 0.5 units (as set by the application's preferences) when PageStream is the host application. If one of the margin gadgets is active, the <TAB> key will cycle through the margin settings.

Orientation: The center cycle gadget alternates between "Tall" (portrait) and "Wide" (landscape) settings.


Variables Tab
Font Variable: Select the desired font (see the variables for details) from the cycle gadget.

Font Name: This is a read-only gadget.

Ff: The file requester gadget must be used to change the font. When Final Writer is being used as the host application, a standard file requestor will appear from which you can select the desired font; when PageStream is being used as the host application, a list of all installed fonts will appear.

Color Variables: The text, line, and background colors (see the variables for details) will be presented in a list.

>: This gadget will allow you to cycle through the variables that have color attributes. Shift-click on this gadget to cycle through in reverse order.

Color: When this button is pressed, a list of available colors will be presented (if the host application is Final Writer, the actual color will be shown as well). Some variables allow <Clear> as an option, while others don't.

Date Color = Highlight Color: If checked, the date (and date box, if this option is selected) will be printed in the same color as the highlight text. If the checkbox is cleared, the date color will be determined by Color.Date.

Use Daily Colors: If checked, the date (and date box, if this option is selected) will be printed in a color determined by the variables Color.Sunday through Color.Saturday. If the checkbox is cleared, the date color will be determined by Color.Date.

Highlight Editor: The highlight editor can be invoked by clicking on this gadget.

Miscellaneous Variables: The miscellaneous (see the variables for details) will be presented in a list.

>: This gadget will allow you to cycle through the miscellaneous variables. Shift-click on this gadget to cycle through in reverse order.

Variable Value: Except for GfxApp, GfxAppPath, and SunCalcPath (the file requester gadget must be used to change the values of these variables), set the value of the selected variable here; you must either <RETURN> or <TAB> after entering the value. Quotes will automatically be added for variables requiring non-numeric values.

File Requester: Used for setting the values of GfxApp, GfxAppPath, SunCalcPath and ImageClass variables.

+IC: (ClassAct GUI only) Add an ImageClass variable. ImageClass variables can be deleted by clearing the value for the desired ImageClass variable.


Extras Tabs
The options for adding extras (moon phases, julian dates, week numbers, etc.) are found in the third and fourth tabs. The check boxes in the "Top" tab will locate the extras in the two available top positions, while the check boxes in the "Bottom" tab locate the extras in the three available bottom positions. Each of the extras is mutually exclusive--each extra can be used in one location only, and each location can hold only one extra. If any extras are added to the top of a date cell, highlights for that date will begin down one line.

The extras are:
Phases: Include the phases of the moon¹

Week Number: Include the sequential week number on the first day of each week.

Julian: Include the Julian day (the number of days since the beginning of the year).

Julian Left: Include the number of days remaining in the year.

Jul/Jul Left: Include both the Julian day and the number of days remaining, separated by a "/", in the same location.

Sunrise: Include the sunrise time².

Sunset: Include the sunset time².

Rise/Set: Include both the sunrise and sunset times, separated by a "/", in the same location².

History: Include a 'day in history' event. Only available for the bottom-center location, and no other bottom-located extras can be selected in conjunction with this. Will be ghosted unless the history files are present (see data files).

Random: Include a random event. Only available for the bottom-center location, and no other bottom-located extras can be selected in conjunction with this. Will be ghosted unless the random file is present (see data files).

¹Will be ghosted unless either rexxmathlib.library by Thomas Richter or date.library by Kai Hofmann are available.

²Will be ghosted if FWCalendar can't find SunCalc; check the value of the SunCalcPath variable to make sure you have properly set the path to SunCalc.