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)
|
|