Country
Files
Calendar text and public holiday dates are stored in external country files.
These country files are in the text format. The country files are located
in the folder \Program Files\SamLogic\SCC\CountryFiles on your harddisk.
Country files for USA, United Kingdom, Germany, France, Spain, Italy, Sweden,
Norway, Finland and Denmark are included, but you can easy create your own
country files. Below can you see how a country file is constructed:
[Info]
; General
information, not used by the component
Desc = Country file for Calendar ActiveX
Country =
[Data]
UseBuiltInHolidays =
; If built-in
functions for holiday calculation should be used (1=Yes,
0=No)
NrStaticHolidays =
; Number of not-movable
holidays in the file
NrDynamicHolidays
=
; Number of movable
holidays in the file
[Today]
TodayStr =
; Tip text that
informs if the mouse pointer is over today's date (e.g. "today")
DateFormat =
; Date format,
1 = MM/DD/YYYY, 2 = DD/MM/YYYY, 3 = YYYY-MM-DD, 4 = DD.MM.YYYY
[MonthNames]
; Month names
(e.g. January)
M1 =
M2 =
M3 =
M4 =
M5 =
M6 =
M7 =
M8 =
M9 =
M10 =
M11 =
M12 =
[WeekDayNames]
; Day of week
names (two letters, e.g. Mo)
D1 =
D2 =
D3 =
D4 =
D5 =
D6 =
D7 =
[UseBuiltInHolidays]
; If built-in
holidays should be shown (1=Yes, 0=No)
NewYearsDay =
; New Years Day
Epiphany =
; Epiphany
HolyThursday =
; Holy Thursday
GoodFriday =
; Good
Friday
EasterEve =
; Easter
Eve
EasterSunday =
; Easter Sunday
EasterMonday =
; Easter Monday
LaborDay =
; Labor
Day (May 1th)
AscensionThursday =
; Ascension Thursday
WhitsunEve =
; Whitsunday
Eve
Whitsunday =
; Whitsunday
Whitmonday =
; Whitmonday
MidsummersEve =
; Midsummers Eve
MidsummersDay =
; Midsummers Day
AllSaintsDay =
; All Saints Day
ChristmasEve =
; Christmas Eve
ChristmasDay =
; Christmas Day
BoxingDay =
; Boxing
Day
NewYearsEve =
; New Years Eve
GreatPrayerDay =
; Great Prayer
Day (used in Denmark)
ShowUKHolidays
=
; Special. If dynamic built-in holidays specific for UK should be
shown.
ShowUSAHolidays
=
; Special. If dynamic built-in holidays specific for USA should
be shown.
[BuiltInHolidaysTipText]
; Tip text for
built-in holidays (e.g. New Years Day)
NewYearsDay =
Epiphany =
HolyThursday =
GoodFriday =
EasterEve =
EasterSunday =
EasterMonday =
LaborDay =
AscensionThursday =
WhitsunEve =
Whitsunday =
Whitmonday =
MidsummersEve =
MidsummersDay =
AllSaintsDay =
ChristmasEve =
ChristmasDay =
BoxingDay =
NewYearsEve =
GreatPrayerDay =
[StatHol1]
; Non-movable
holiday number 1 (month, day and tip text)
Month =
Day =
TipText =
[StatHol2]
; Non-movable
holiday number 2
Month =
Day =
TipText =
[StatHol3]
; Non-movable
holiday number 3
etc...
[DynHol1]
; Movable holiday
number 1 (year, month, day and tip text)
Year =
Month =
Day =
TipText =
[DynHol2]
; Movable holiday
number 2
Year =
Month =
Day =
TipText =
[DynHol3]
; Movable holiday
number 3
osv...
|
The UseBuiltInHolidays value name in the
Data section turns on/off the built-in holidays
in the calendar component. If you have turned this option off you must specify
all holidays in the StatHolx and
DynHolx sections and specify the number
of holidays in the NrStaticHolidays and
NrDynamicHolidays value names in the
Data section.
If you use the built-in functions for showing holidays you can turn on/off
every individual holiday in the UseBuiltInHolidays
section. The value 1 turns a holiday on and the value 0 turns it off. When
a holiday is turned on, the text color of the day number in the corresponding
month will be set to the color specified by the HolidayTextColor
property of the calendar. As default this color is red. A tip text will
also be shown for this holiday if the mouse pointer is above the date. Tip
text are specified in the BuiltInHolidaysTipText
section of the country file.
Months names and of day of week names are specified in the
MonthNames and WeekDayNames
sections of the file. Day of week names should only contain the first 2
characters of the name (e.g. "Mo") because the space is very limited. Month
names can mostly be in it's full length.
The Today section of the country file specifies
the contents of the tip text that should be shown when the mouse pointer
is above today's date. The TodayStr value name
should contain the text to show in the tip box and the
DateFormat value name most specify the date
format. Can be one of the following values:
1 = MM/DD/YYYY
(European general format)
2 = DD/MM/YYYY (USA format)
3 = YYYY-MM-DD (ISO 8601)
4 = DD.MM.YYYY (German format)
|
|
