SamLogic Calendar Components - Home
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)

 
 
 
SamLogic