Calendar applet
Parameters and interface functions description

1. Parameters.

FORMATSTR

Specifies format of date representation (MM - month, dd - days, yyyy - year). Default is 'dd/MM/yyyy'

Example 1.

<PARAM NAME="FORMATSTR" VALUE ="MM/dd/yyyy">

Then, 31 January 2001 will be represented like 31/01/2001

LOCALE

Specifies locale from language, country, and variant, separated by commas (See Loacle class declaration for more detailed information). If not specified, default system locale will be used.

Example 2.

For USA: <PARAM NAME="LOCALE" VALUE ="en,US">
For Great Britain: <PARAM NAME="LOCALE" VALUE ="en,GB">
For France: <PARAM NAME="LOCALE" VALUE ="fr,FR">

JSCRIPT

Specifies name of script function that will be called when some date is selected.
Function's parameter will contain selected date in format specified with FORMATSTR parameter.
Note, that script function calling will work only if you specify MAYSCRIPT argument in applet definition.

Example 3.

<APPLET ... MAYSCRIPT>
<PARAM NAME="JSCRIPT" VALUE="selectFun">
</APPLET> 
<script language="JavaScript">
function selectFun( newDate ) 
{
	... code here ...
}
</script>

ON_LOAD

Specifies name of script function that will be called when applet loaded and initialized. 

COLOR parameters

The next set of parameters specifies applet's elements colors:

Name

Description

Default value

 
HeadingBackColor
 The color of the background for the heading part (with the month arrows) 
Color.gray
 
HeadingTextColor
 The color of the text (and arrows) for the heading part 
Color.black
 
WeekDaysBackColor
 The color of the background for the weekdays part 
Color.black
 
WeekDaysTextColor
 The color of the text for the weekdays part 
Color.white
 
ActiveMonthTextColor
 The color for the text of the active months days 
Color.blue
 
InactiveMonthTextColor
 The color for the text of the inactive months days 
Color.black
 
SelectingDayBackColor
 The back color for the day that is currently selected. 
Color.blue
 
SelectingDayTextColor
 The text color for the day that is currently selected. 
Color.white
 
BorderUpColor
 Color of left and top parts of frames around 3D objects 
Color.white
 
BorderDownColor
 Color of right and buttom parts of frames around 3D objects 
Color.black
 
BackgroundColor
 Background color 
Color.lightGray

BOLD_LIST and BOLD_LIST_DELIMITER parameters

Specifies the list of dates wich will be marked by BOLD font type, separated by BOLD_LIST_DELIMITER. Default value for BOLD_LIST_DELIMITER is comma.

Example 4.

<PARAM NAME="BOLD_LIST_DELIMITER" VALUE =";">
<PARAM NAME="BOLD_LIST" VALUE ="06/26/2001;07/2/2001;07/25/2001">

WEEK_DAYS_NAMES

Specifies the names of dates. If specified, locale dates will not be used.

Example 5.


<PARAM NAME="WEEK_DAYS_NAMES" VALUE="Su,Mo,Tu,We,Th,Fr,Sa">

MONTHS_NAMES

Specifies the names of monthes. If specified, locale monthes names will not be used.

Example 6.


<PARAM NAME="MONTHS_NAMES" VALUE="January,February,March,April,May,June,July,August,September,October,November,December">

2. Methods.

String getDate( [String formatstr] )

Returns selected date in format specified with FORMATSTR parameter.

boolean setDate( String date, [String formatstr] )

Sets calendar applet to specific date in format specified with FORMATSTR parameter. Returns true if date parameter is correct

void setDayBold(String date, boolean isBold)

Adds (or removes) specified date to/from bold list

boolean setColor( String colorName, String colorValue )

Set specified color parameter (See COLOR parameters) into specified value