Version 3.0.3 -- Year At A Glance

Year At A Glance provides a full twelve month view of the current year on a single screen.

HELP CONTENTS:
-1. General Help
-2. Twelve Month View Help
-3. Six Month View Help
-4. Three Month View Help
-5. One Month View Help
-6. Menu Help
-7. Preferences Help
-8. Event Entry and Edit Help
-9. Profile Help
-10.Export Import Help

1. General Help:

Current year is displayed at startup. Swipe screen to change the year forward or back by one year. Any year may be entered via the Enter a Year menu selection and displayed. Year entry screen can also be accessed by single tap of year displayed at top of twelve month view screen.

The background color is different for the current year display and a not current year display (Current Year -- WHITE | Other Year -- BLUE). Background color can be set to a custom value in preferences.

The Current Year menu selection returns the display to the current year.

Sundays and holidays are displayed in red. Today's date is displayed with a color background or rectangular outline (preference setting). Special dates, such as birthdays, can be designated via the Enter Events menu selection. Special dates are highlighted with a shaded background by default. Multiple event highlights can be defined and customized. Day with multiple events can be highlighted with the application launch icon emphasis rather than one of event highlights. Sunday, Saturday, and holiday display color is a preference setting.

The country for holidays is a preference setting. Selected country is shown in upper left corner of display. Display of holidays can be disabled (preference setting). Holidays are not displayed for years prior to 1971.

When enabled, a six, three or one month view can be displayed by tapping a month. Horizontal swipe screen to change the months forward or back when in these views. Vertical swipe of screen can be used to switch views when option set.

Custom colors are set with a RGB (red, green, blue) mixer. Adjust each color slider as desired. Resulting color is displayed in the small square area to the left of the sliders.

Profiles can be used to effectively have multiple calendars. When enabled, profiles are easily accessed from the current calendar view. Single tap profile label in upper right corner to bring up profile selector.

Single tap upper left corner in a calendar view for options menu. Access method provided mainly for devices without support for legacy menu key.

Double tap to close most screens.

2. Twelve Month View Help:

The Twelve Month View option must be enabled in Preferences for this view to be available.

Swipe screen to change the year forward or back by one year.

Any year may be entered via the Enter a Year menu selection and displayed. A single tap on the year at the top of the screen will bring up the year entry dialog also. Enter desired year to display.

The Current Year menu selection returns the display to the current year.

A single tap on a month will change the display to a six month view when the six month view has been enabled or to a three month view when the three month view has been enabled and the six month view has been disabled or to a one month view when the six month and three month views have been disabled and the one month view has been enabled.

A long press on a month will display entered events for that month. Events can be edited or deleted from entered events screen.

A double tap will exit the application. A dialog to confirm a double tap exit can be enabled in Preferences . When the dialog is enabled a yes/no pop-up follows the double tap to confirm exit. The Exit menu selection exits the application also.

3. Six Month View Help:

The Six Month View option must be enabled in Preferences for this view to be available.

A single tap on a month in the twelve month view will change the display to a six month view. View will show the first or second six months of the year that includes the month.

Swipe screen to change forward or back by six months.

A long press on a month will display entered events for that month. Events can be edited or deleted from entered events screen.

Any year may be entered via the Enter a Year menu selection. The Current Year menu selection returns the display to the current year.

When the Three Month View is enabled, a single tap on a month will change the display to a three month view of the tapped month. When the Three Month View is disabled and the One Month View is enabled, a single tap on a month will change the display to a one month view of the tapped month.

A double tap will return the display to twelve month view if twelve month view is enabled. If twelve month view is disabled, a double tap will exit the application. A dialog to confirm a double tap exit can be enabled in Preferences . When the dialog is enabled a yes/no pop-up follows the double tap to confirm exit.

The Exit menu selection will exit the application.

4. Three Month View Help:

The Three Month View option must be enabled in Preferences for this view to be available.

A single tap on a month in the twelve month view (if six month view disabled) or the six month view will change the display to a three month view. View will show the tapped month at the center.

Swipe screen to change the month forward or back by one month. Preference can be set to change by three months rather than one month.

A long press on a month will display entered events for that month. Events can be edited or deleted from entered events screen.

Any year may be entered via the Enter a Year menu selection. The Current Year menu selection returns the display to the current year.

When the One Month View is enabled, a single tap on a month will change the display to a one month view of the tapped month.

A double tap will return the display to the largest number month view enabled. If three month view is largest number of months enabled, a double tap will exit the application. A dialog to confirm a double tap exit can be enabled in Preferences . When the dialog is enabled a yes/no pop-up follows the double tap to confirm exit.

The Exit menu selection will exit the application.

5. One Month View Help:

The One Month View option must be enabled in Preferences for this view to be available.

When the Three Month View option is enabled, a single tap on a month in the three month view will change the display to a one month view of the tapped month. When the Three Month View is disabled, single tap on a month in the twelve month view (if six month view disable) or the six month view will change the display to a one month view of the tapped month.

A single tap on a day in this view will bring up the Enter Events screen populated with the tapped day. Option can be set to disable the switch to Enter Events screen.

Swipe screen to change the month forward or back by one month.

A long press will display entered events. Events can be edited or deleted from entered events screen.

Any year may be entered via the Enter a Year menu selection. The Current Year menu selection returns the display to the current year.

A double tap will return the display to the largest number month view enabled. If one month view is largest number of months enabled, a double tap will exit the application. A dialog to confirm a double tap exit can be enabled in Preferences . When the dialog is enabled a yes/no pop-up follows the double tap to confirm exit.

The Exit menu selection will exit the application.

6. Menu Help:

Access menu with device menu key. Menu can be accessed by single tap of upper left corner in a calendar view.

Enter Events

Provides screen to enter special events. Enter event description and date. (See Event Entry and Edit Help section below.)

List/Edit Events

Lists special events by date with description. Multi-day events show number of days prepended to description. Events may be edited or deleted with this screen by selecting event and following prompt. Edits may be saved as update to event or can create a new event. List is updated as event changes are made.
Done -- Return button exits screen and returns to previous screen.

About -- Help

Displays this screen. Double Tap to close screen.

Enter a Year

Displays calendar for year that is entered. Enter year to display.

Current Year

Displays current year calendar.

More

List Holidays

Lists holidays for the currently set country. Day of week is shown. Month and day are shown for variable holidays with variable nature (such as third Monday). Swipe to change the listing by one year or select YEAR button to enter a year (does not change displayed calendar). Select COUNTRY button to switch country (does not change displayed calendar). Double Tap screen or select DONE -- RETURN button to close and return to calendar.

Preferences

Set preferences. Double tap main screen to return to calendar.

All Holidays List

Lists all holidays by country that can be displayed. If Detailed All Holiday List preference is set, displays selected country first and then all countries. Day of week is shown. Month and day are shown for variable holidays with variable nature (such as third Monday). Swipe to change the listing by one year or select YEAR button to enter a year (does not change displayed calendar). Select COUNTRY button to switch first country in list (does not change displayed calendar). Double Tap screen or select DONE -- RETURN button to close and return to calendar. If Detailed All Holiday List preference is not set, displays list without day of week detail or month and day of variable holidays. No buttons for year, country or return are provided. Double tap to close screen and return to calendar.

Utilities

Brings up a sub menu of following.
- Save Preferences
-Save current preference settings. Overwrites any previously saved.
- Restore Preferences
-Restore preference settings to values previously saved.
- Reset Preferences
-Resets preferences to factory default setting.
- Clear Event Data Only
-Clears all event data from database. Highlight and profile descriptions remain unchanged.
- Clear All Data
-Clears all event data from database. Also clears all highlight and profile descriptions from database.

Profiles

Brings up a sub menu of following.
- Toggle Profiles On/Off
-Changes profile use from on to off or off to on. Current calendar view is updated to reflect new state.
- Create Profile Label
-Entry screen to create a new profile id.
- Edit Profile Label
-Entry screen to alter an existing profile id.
- Set Default Profile
-Select profile to use when no selection is offered.
(See Profile Help section below for more detail.)

Export Import

Brings up a sub menu of following.
-Export Data
-Exports event data and settings data for all profiles to sdcard. File name is YearAtAGlance.txt .
-Import Data
-Imports event data and settings data for all profiles from sdcard. File name is YearAtAGlance.txt .

Exit

Exits the application.

7. Preferences Help

Display
- Colors and Highlights -- Brings up a preference sub-screen to set color/highlight.
-- Highlight Today -- Brings up a sub-screen to select how today is highlighted.
--- Highlight Today -- Select color background or rectangular outline to highlight today's date. (Default is Blue Background )
--- Custom Highlight Color -- Brings up a dialog to set a custom color for today highlight color. (Default is factory value )
-- Holiday Display Color -- Brings up a sub-screen to select color for display of holidays.
--- Holiday Display Color -- Set color for display of holidays. (Default is Red )
--- Custom Holiday Color -- Brings up a dialog to set a custom color for holidays. (Default is factory value )
-- Saturday Display Color -- Brings up a sub-screen to select color for display of Saturdays.
--- Saturday Display Color -- Set color for display of Saturdays. (Default is Pale Black )
--- Custom Saturday Color -- Brings up a dialog to set a custom color for Saturdays. (Default is factory value )
-- Sunday Display Color -- Brings up a sub-screen to select color for display of Sundays.
--- Sunday Display Color -- Set color for display of Sundays. (Default is Pale Red )
--- Custom Sunday Color -- Brings up a dialog to set a custom color for Sundays. (Default is factory value )
-- Weekday Display Color -- Brings up a sub-screen to select color for display of weekdays.
--- Weekday Display Color -- Set color for display of weekdays. Foreground sets color to foreground color. (Default is Foreground )
--- Custom Weekday Color -- Brings up a dialog to set a custom color for weekdays. (Default is factory value )
-- Week Number Display Color -- Brings up a sub-screen to select color for display of week numbers.
--- Week Number Display Color -- Set color for display of week numbers. (Default is Pale Black )
--- Custom Week Number Color -- Brings up a dialog to set a custom color for week numbers. (Default is factory value )
-- Background/Foreground -- Brings up a sub-screen to set background and foreground colors.
--- Current Year -- Set to use custom background color for display of current year. Set enables preference to set custom color. (Default is Unset )
--- Current Year Color -- Brings up a dialog to set a custom color for the current year background. (Default is factory value )
--- Different Background -- Set to use different background for current and not current year. Set enables preferences to set not current year colors. (Default is Set )
--- Not Current Year -- Set to use custom background color for display of not current year. Set enables preference to set custom color. (Default is Unset )
--- Not Current Year Color -- Brings up a dialog to set a custom color for the not current year background. (Default is factory value )
--- Foreground -- Set to use custom foreground color. Set enables preference to set custom color. (Default is Unset )
--- Foreground Color -- Brings up a dialog to set a custom color for the foreground. (Default is factory value )
-- Grid/Shade Highlights -- Brings up a sub-screen to set grid and shading highlights.
--- Grid/Shade Highlights -- Set to enable grid and month label shading. Set enables preferences to set grid and shading. (Default is Set )
--- Grid Highlights -- Set to enable grid highlights. Set enables preferences to set color. (Default is Set )
--- Use Custom Color -- Set to use custom color for grid. Set enables preference to set custom color. (Default is Unset )
--- Custom Grid Color -- Brings up a dialog to set a custom color for the grid. (Default is factory value )
--- Shade Month Label -- Set to enable month label shading. Set enables preferences to set color. (Default is Set )
--- Use Custom Color -- Set to use custom color for month label shading. Set enables preference to set custom color. (Default is Unset )
--- Custom Color -- Brings up a dialog to set a custom color for the month label shading. (Default is factory value )
-- Event Shade -- Brings up a sub-screen to set event shading color.
--- Custom Event Shade -- Set to use custom color for event shade. Set enables preference to set custom color. (Default is Unset )
--- Custom Color -- Brings up a dialog to set a custom color for the event shading. (Default is factory value )
-- Multi Event Highlight -- Set to show icon on days with multi events. (Default is Unset )
- Event List -- Brings up a preference sub-screen to set event list format and notice behavior.
-- List Format -- Brings up a preference sub-screen to set event list date format and sort order.
--- Event List Header -- Set to show a format header. (Default is Unset )
--- Date Format -- Brings up a sub-screen to select date format. (Default is MM/DD/YYYY )
--- Sort Order -- Brings up a sub-screen to select date sorting order. (Default is Month Day Year )
--- Annual Event Year -- Set to show current year rather than 9999 as year. (Default is Unset ) (Date will be tagged with an * when set.)
-- Flash Notice -- Brings up a preference sub-screen to set flash notice behavior.
--- Flash On View -- Set to show an abbreviated event list for the month tapped to switch view. (Default is Unset )
--- Flash At Start -- Set to show an abbreviated event list for the current month at application start. (Default is Unset )
--- Flash Length -- Set to show notice for longer duration. (Default is Unset )
-- Show All Events -- Set to show events from all profiles. Setting available when profiles on. Per profile setting. (Default is Unset )
- Layout -- Brings up a preference sub-screen to set calendar layout
-- Day Week Starts -- Set Sunday or Monday displayed as first day of week. (Default is Sunday )
-- Landscape Layout -- Set whether months are arranged in rows or columns. (Default is Rows )
-- Portrait Layout -- Set whether months are arranged in rows or columns. (Default is Rows )
-- Portrait -- 3by4 -- Set enables portrait display as 3 columns by 4 rows and unset as 2 columns by 6 rows in 12 month view. (Default is Set )
-- Show Week Number -- Set enables display of week number in first column. Set enables preferences to set non ISO first week. (Default is Unset )
-- Non ISO-8601 First Week -- Set whether first week of year starts with January 1 or first Sunday of year when first day of week is Sunday. (Default is January 1 )
-- Hide Country Label -- Set to not show country label on calendar views. (Default is Unset )
- Views -- Brings up a preference sub-screen to enable 12, 6, 3 and 1 month views and view behaviors
-- Views
--- One Month View -- Enables switch to a one month view. Set to enable or unset to disable view switch. Set enables preference to disable switch to event entry screen. (Default is Set )
--- Three Month View -- Enables switch to a three month view. Set to enable or unset to disable view switch. Set enables preference to set one or three month change on horizontal swipe. (Default is Set )
--- Six Month View -- Enables switch to a six month view. Set to enable or unset to disable view switch. (Default is Set )
--- Twelve Month View -- Enables the twelve month view. Set to enable or unset to disable view. (Default is Set )
-- View Behavior
--- Change By Three -- Set to change display by three months rather than one month each horizontal swipe when in three month view. (Default is Unset )
--- Disable Switch to Entry -- Set to disable the switch to event entry screen when a day is single tapped in the one month view. (Default is Unset )
--- View Change On Swipe -- Set to enable vertical swipe to change view to next enabled view. (Default is Unset )
--- View At Start -- Brings up sub-screen to select initial view at start. (Default is Twelve Month View ) If all views are unset, the default will be enabled.

Holidays
- Show Holidays -- Set to show or unset to hide holidays in display. (Default is Set )
- Country -- Set country for holidays. (Default is United States )

General
- Clear Event Input Values -- Set to clear input fields on the Enter Event screen when an event is saved. Unset to keep values in input fields. (Default is Set )
- Confirm Exit Dialog -- Enables yes/no dialog to confirm application exit on double tap . Set to enable or unset to disable confirm dialog. (Default is Set )
- Back Key -- Brings up a preference sub-screen to set Back Key behavior
-- Back Key Return -- Enables Back Key to return current month view to max month view rather than exiting. Set to enable return to max month view. (Default is Set )
-- Back Key Exit Enable -- Enables Back Key to exit from the max month view or any view if Back Key Return is not set. Set to enable back key to exit. Set enables preference for Back Key Exit Reset . (Default is Set )
-- Back Key Exit Reset -- Enables reset to current year and start up view on exit via back key. Set to enable reset on back key exit. (Default is Unset )
- Font Size -- Brings up a sub-screen to set smaller font size for listings
-- Smaller Font for List -- Enables smaller font for country holiday, country select, and event listing. (Default is Set )
-- Smaller Font for Help -- Enables smaller font for 'About -- Help' and 'All Holidays' screens. (Default is Set )
- Profiles -- Brings up a sub-screen to set profile settings
-- Profiles -- Set to enable use of profiles. Unset to not use profiles. Set enables setting of additional profile preferences. (Default is Unset )
-- Profile Select At Start -- Set to show profile select screen when starting. Also shows screen when toggling profiles on from menu select. Unset uses the profile set as default. (Default is Set )
-- Profile Events -- Set to only show events assigned the current profile. Unset to show events assigned any profile. (Default is Set )
-- Profile ID Label -- Set to display full profile label in upper right corner. Unset to display an * as the label. (Default is Set )
- Month/Day Label Language - - Set language to display month names and day abbreviations in calendar. (Default is English )
- Calendar View Menu Button -- Brings up a sub-screen to manage calendar view upper left corner menu icon.
-- Change Menu Button -- Set to enable access to option settings. (Default is Unset )
-- Need Menu Button -- Set enables menu access icon in upper left corner of calendar view. Unset to hide icon. (Default is Set )
- Detailed All Holiday List -- Set to enable detailed all holiday list. (Detailed list includes day of week, day and month and provides entry buttons and swipe function.) (Default is Unset )
- Dark or Light Theme -- Set to use a dark theme, unset for a light theme. (Default is Unset )
- Modern Theme -- Set to use 4.0+ system default theme. (Default is Unset ) Option available only on 4.0+ system and takes full effect at next start.

8. Event Entry and Edit Help

Enter Events menu selection provides the screen for entry of special events. A single tap in the 1 month view will also provide the entry screen.
Enter a description to be displayed when events are listed in the Enter Event Description box.
Enter the event date as month, day, and year in the appropriate boxes. A year entry of 9999 will associate the event with all years or leave the year blank to associate with all years.
To display a multi-day event, enter number of days in the (Days) box. In the case of multi-day event, the event date is the first day of the event.
Select Highlight from drop down list. Select CREATE NEW DEFINITION to create a new highlight definition. Select EDIT DEFINITION to edit the selected highlight. (Note: FACTORY DEFAULT cannot be edited. The associated color can be changed in preferences.) Additional help for highlight definition entry and edit is below.

When profiles are active, select Profile to select a profile from drop down list. The default profile is used when profiles are not active.
SAVE button saves entry and clears entry fields. Fields will not be cleared if the Clear Event Input Values Preference setting is not set. A short pop up notice will indicate successful save or invalid values if unsuccessful.
CLEAR button clears the entry fields.
RETURN button exits screen and returns to previous screen.
LIST EVENTS button brings up List/Edit Events screen. List is updated as entries are saved.

Edit Event screen is activated when an event is selected on the List Events screen and Edit is selected from the dialog. Current values are show in the entry fields. Make changes as needed by editing appropriate value.
SAVE AS UPDATE button will update the event and return to previous screen. A short pop up notice will indicate successful update or invalid values if unsuccessful.
SAVE AS NEW button will save the event as a new entry with no change to the original event entry and return to previous screen. A short pop up notice will indicate successful save or invalid values if unsuccessful.
CANCEL - RETURN button returns to previous screen.

Events may be deleted. From the List Events screen, select event. Select Delete from the dialog. Select Yes from the confirm Delete Entry dialog.

Highlight Definition entry screen is displayed when either CREATE NEW DEFINITION or EDIT DEFINITION is selected in the Highlight drop down list.
CREATE NEW DEFINITION displays entry screen with blank Label field and FACTORY DEFAULT Shape and Color values.
Enter Label for definition. The label is displayed in the highlight drop down list.
Select Shape from drop down list.
Select Color for the shape.
EDIT DEFINITION populates fields with current values. Make changes to shape and color as desired. If the label is changed, the save will be treated as a new value and not as an edit, i.e. a new definition will be created and saved. (Hint: To view a definition, select the definition in the drop down, then select EDIT DEFINITION and then CANCEL - RETURN .)
SAVE - RETURN button saves values and returns to previous screen. If the label exists, a confirmation dialog will be displayed.
CANCEL - RETURN returns to previous screen without making any changes.
To delete a definition, select CREATE NEW DEFINITION in the event entry or edit screen. Enter the label to delete in the Label field and select SAVE - RETURN button. A prompt will be displayed to Delete definition.( Update selection will change definition.)

9. Profile Help

Profiles effectively makes multiple calendars available. Profiles must be enabled to be available. Recommended method to activate profiles is via the Profiles menu selection Toggle Profiles On/Off selection. Likewise, recommend use same method to deactivate profiles.

Profiles may also be activated or deactivated from the preferences screen by setting or unsetting Profiles . However, any other preference settings that may have been changed while in Preferences will not be carried forwarded when exiting Preferences with Profiles preference changed. If using this method, do not change other preferences.

Preferences in the Profiles subscreen are applied to all profiles. All other preferences are applied only to the active profile state when set. Preference save, restore, or reset from the Utilities menu is only applied to the active profile state. Preferences in the Profiles subscreen are not reset by the Utilities menu Reset Preferences action.

When profiles are active, single tap profile label in upper right corner to bring up a profile selector screen. Current profile is highlighted. Select desired profile. The calendar view will be updated to reflect the selected profile.

Use menu Create Profile Label to create a new profile for use. Label length is limited to 16 characters. (Each profile will add to memory requirements and add more to memory requirements if saved via Utilities . Profiles cannot be deleted once created, only label edit available.) Preferences for new profile will be defaults.

Use menu Edit Profile Label selection to edit a label. Select profile to edit if more than one is defined. Save of the update returns to calendar view.

Event entry and edit screens have a profile selector when profiles are active. Current profile is shown in the Enter Events screen at start. The Edit Event screen shows the profile of the event, which is the same as current profile unless preference is to show all events.

List Events display content is according to preference and current profile. Screen has a Profile button when profiles are active. Button brings up the profile selector. Select profile to see a different list. If no events for selected profile, screen will return to calendar view.

When preference Flash Event Notice At Start is set for a profile, a profile change to the profile will flash current month events for the selected profile.

10.Export Import Help

The Export Import main menu selection provides ability to export or import user data and settings.

The submenu Export Data selection gathers all events data, highlight descriptions and profile labels into a text file which is saved to the sdcard directory. The file name is YearAtAGlance.txt . (The full file path is displayed briefly on the screen once the export is complete.)

To import data, place the file created by the export in the sdcard directory of the device. The submenu Import Data selection will prompt for a confirmation to import. Confirm to perform the data import. Existing events data, highlight definitions, and profile labels with be deleted and replaced by the import data. Preference settings will also be replaced by import data. The import process will turn off profiles if on and refresh screen.