SuperCalendar

Pro | Enterprise | Gold

The SuperCalendar feature of ASP-db2000 is a heavy duty calendar component that offers a wide variety of calendar functions. This component is designed for the ASP-db2002 and is available at this time as a stand alone component.

General

If an ASP page contains multiple calendar instances, programmer should assume separate numbers for them. User can use these numbers to set custom properties for each calendar on the page.

Syntax (2002)

X.dbCalendar = "Property list separated by [;]"

Modify the following defaults -

Index = Calendar Field index - e.g. AddText(0).
Array of values.. = "date1, date2, date3..."

c = ""
c = c & "BGColor = FFE4E1"
c = c & "WeekEndBGColor = AFEEEE"
c = c & "WeekNumbersBGColor = FFB6C1"
c = c & "NeighbourMonthDateColor = BC8F8F"
c = c & "UnselectableColor = C0C0C0"
c = c & "HolidayColor = FF6347"
c = c & "HighlightColor = FF0000"
c = c & "TodayHighlightColor = DDA0DD"
c = c & "DateColor = 000000"
c = c & "WeekDayColor = 0000FF"
c = c & "WeekNumbers = False"
c = c & "WeekEnd = True"
c = c & "FirstDayOfWeek = 1"
c = c & "CloseCalendarAfterClick = False"
c = c & "FirstWeekOfYear = 1"
c = c & "IsNeighbourMonthVisible = True"
c = c & "IsTodayHighlighted = True"
c = c & "DayAbbs = Sun,Mon,Tue,Wed,Thu,Fri,Sat"
c = c & "DayNames = Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday"
c = c & "MonthAbbs = Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec"
c = c & "MonthNames = "January,February,March,April,May,June,July,August,September,October,November,December"
c = c & "bImage = ImageDir & "calendar1.gif"
c = c & "Archive = /aspdb/Jars/calendar.jar"
c = c & "FrameX = 100"
c = c & "Framey = 100"
c = c & "FrameWidth = 280"
c = c & "FrameHeight = 300"
c = c & "isDateFormatUSA = True"
c = c & "Dates = 1/1/1999,1/1/2010"
c = c & "CalendarTitle = inedex, FieldName"
c = c & "AddText = index, Text"
c = c & "RowNUmber = index, # of rows of TextArea"
c = c & "SubmitFlags = index, False"
c = c & "HighLightDates = index, Array of dates"
c = c & "ExcludeDates = index, Array of Exclude dates"

X.dbCalendar = c

Parameters

Properties	Type	Description
AddText (number)=Text	String	Adds to the text that will be disposed below the date boxes. Default = ""
Archive	String	Sets or retrieves the name of the java archive file. Default = ""
BGColor	String	Sets or retrieves the background color of the calendar. Default = “”, means system default.
ButtonImage	String	Specifies the image to display for the popup button.Default = “”, means that no image is used.
CalendarTitle(number)=text	String	Sets or retrieves the title of the calendar frame. Default = "Calendar"
CloseCalendarAfterClick	Boolean	Close the calendar right after the click. Def=false
CodeBase	String	Sets or retrieves the URL of the applet. Default = ""
DateColor	String	Sets or retrieves the color of the calendar dates. Default = “”, means the same as bgcolor
DateFont	Font	Retrieves the reference to the Font object. Serves to set the date font properties (face,style,size)
Dates (number)="start, end"	String	Sets or retrieves the range of the dates to allow Format: "dd/mm/yyyy,dd/mm/yyyy". Default = “”, means any.
DayAbbs	String	Sets or retrieves the three-letter day abbreviations used when creating dates in your form fields based on your Date selection. Default = “Sun,Mon,Tue,Wed,Thu,Fri,Sat”
DayNames	String	Sets or retrieves the day names. Default = "Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday". (in IE and Netscape6 client local settings are used)
ExcludeDates (number)	String	Lists the dates which cannot be chosen. Format: “dd/mm/yyyy\|dd/mm, …” Default = “”
Field	String	The field property set the <input> name of the field to which the calendar popup will apply. See General section of this document.
Font	Font	Font objects are used to set the properties of the fonts used in Cal. The following properties are applicable to DateFont and WeekDayFont:
Face	String	Sets or retrieve the name of the font. Permitted values: "Helvetica","TimesRoman","Courier". Default = "Helvetica"
Style	String	Sets or retrieve the style of the font. Permitted values: "Bold","Plain","Italic". Default = "Plain" (for week days),"Bold" (for dates)
Size	String	Sets or retrieve the size of the font. Default = 13 (for week days),18 (for dates)
FirstDayofWeek	String	The firstdayofweek permits you to change the appearance to support various first days of week. Default = 1 (Sunday)
FirstWeekofYear	String	Firstweekofyear determines which week is treated as the first week of a year. Used in conjunction with weeknumbers. Default = 1 (First week with at least one day).
Form	String	The form property specifies the name of the form to attach to.
FrameHeight	String	Sets or retrieves the height of the calendar frame
FrameWidth	String	Sets or retrieves the width of the calendar frame.
FrameX	String	Sets or retrieves the x-coordinate of the calendar frame.
FrameY	String	Sets or retrieves the y-coordinate of the calendar frame.
HighlightColor	String	Sets or retrieves the color to highlight the dates from the list defined by HighlightDates.
HighlightDates	String	Sets or retrieves the list of the dates that should be highlighted. Format: "dd/mm/yyyy,dd/mm/yyyy,..." Default = ""
HolidayColor	String	The holidaycolor property sets the color of the calendar holidays. Default = “red”.
Holidays	String	Lists the holidays. Default = “01/15, 02/02, 02/12, 02/14, 02/19, 03/17, 05/13, 05/28, 06/17, 07/04, 09/03, 10/08, 10/31, 11/22, 12/25, 12/31”
IsNeighbourMonthVisible	String	Sets or retrieves the boolean value: true - if the neighbor month dates are displayed on the calendar false - if the neighbor month dates are not displayed. Default = true
IsTodayHighlighted	Boolean	Sets or retrieves the boolean value: true - if today's date will be highlighted. false - if not. Default = true
Mask	String	The mask property determines the way that date is entered in your field. Mask properties: d - Single/Double digit day number dd - Double digit day number ddd - Three-character day abbreviation dddd - Full day name m - Single/Double digit month number mm - Double digit month number mmm - Three-character month abbreviation mmmm - Full month name yy - Two-digit year yyyy - Four-digit year Default = “dd/mm/yyyy”
MonthAbbs	String	The monthabbs property permits customization of the three-day month abbreviations used when creating dates in your form fields based on your Date selection. Default = “Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec”
MonthNames	String	The monthnames property permits customization of the month names used when creating dates in your form fields based on your date selection. Default = “January, February, March, April, May, June, July, August, September, October, November, December”
NeighbourMonthDateColor	String	Sets or retrieves the color of the neighbor month dates
RowsNumber (number)	Long	Sets or retrieves the number of rows of the text area.
Submit (number)	Boolean	Sets or retrieves the Boolean value: - true, if the form will be submit - false, if not. Default = false
Title (number)	String	Sets or retrieves the calendar title. Default = "Calendar"
TodayHighlightColor	String	Sets or retrieves the color to highlight today date
UnselectableColor	String	Sets or retrieves the color of the unselectable dates
WeekDaycolor	String	The weekdaycolor property sets the color of the calendar weekdays.
WeekDayFont	Font	Retrieves the reference to the Font object. Serves to set the week day font properties (face,style,size)
WeekEnd	Boolean	Sets or retrieves the boolean value: true - if the week-end days are displayed on the calendar. false - if the week-end days are not displayed. Default = true
WeekEndBGColor	String	Sets or retrieves the background color of the calendar weekends
WeekNumbers	Boolean	Week numbers are displayed to the left of the calendar for reference when selecting dates. Default = false.
WeekNumbersBGColor	String	Sets or retrieves the background color of the calendar weekends
WeekNumTitle	String	Sets or retrieves the title for the week numbers column. Default = ""
Years	String	Sets or retrieves the range of the years to allow. Format: "yyyy,yyyy". Default = ""

Methods	Description
Build (number As Long, Optional ButtonCaption As String)	The Build method produces HTML text that causes a field to be attached to a Cal. It also creates a button or image whereby you popup the Cal from the webpage.
BuildHeader	When you have completed setting properties for your Calendar object, call the buildheader method. This creates the required script.

Example

<%
set cal = server.CreateObject("ASPdb.Calendar")
cal.archive = "calendar.jar"
cal.buttonimage = "calendar1.gif"
cal.form = "f1"
cal(0) = "dat1"
cal(1) = "dat2"
cal(2) = "dat3"
cal.highlightdates(0) = "3/5/2001,3/16/2001,01/01/2001"
cal.highlightdates(1) = "3/6/2001,3/17/2001,01/01/2001"
cal.excludedates(1) = "3/23/2001, 4/15/2001, 11/17/2001, 5/23/2002 - 5/25/2002" ' a single date or a range of dates
cal.dates(2) = "1/1/1990, 3/ 10/ 2020"
cal.years(2) = " 1991, 2050"
cal.firstdayofweek = 2
cal.mask = "mm-mmmm dd-dddd yyyy"
cal.holidays = "1/1, 1/17, 2/21, 3/21, 5/29, 11/23, 12/24, 12/25"
cal.weeknumbers = true
cal.firstweekofyear = 4
cal.isneighbourmonthvisible = true
cal.datefont.face = "Helvetica"
cal.datefont.style = "Plain"
cal.datefont.size = 12
cal.weekdayfont.face = "Plain"
cal.weekdayfont.style = "Plain"
cal.weekdayfont.size = 12
cal.BGColor = "FFE4E1"
cal.WeekEndBGColor = "AFEEEE"
cal.WeekNumbersBGColor = "FFB6C1"
cal.NeighbourMonthDateColor = "BC8F8F"
cal.UnselectableColor = "C0C0C0"
cal.HolidayColor = "FF6347"
cal.HighlightColor = "FF0000"
cal.DateColor = "000000"
cal.WeekDayColor = "0000FF"
cal.framex = 350
cal.framey = 350
cal.framewidth = 280
cal.frameheight = 300
cal.weekend = true
cal.weeknumtitle = "#"
cal.addtext(1) = "Text for Calendar #1"
cal.addtext(1) = "Line 2 of Calendar #1"
cal.calendartitle(0) = "Start Date"
cal.calendartitle(1) = "End Date"
cal.rowsnumber(1) = 1
cal.addtext(2) = "Text for Calendar #2"
cal.addtext(2) = "Line 2 of Calendar #2"
cal.rowsnumber(2) = 1
cal.closecalendarafterclick = false
cal.todayhighlightcolor = "DDA0DD"
cal.submit(2) = true
cal.buildheader
%>

Notes

The overall concept of calendar is that Calendar should know the input it is attached to.

<%
cal(0) = "dat1"
cal(1) = "dat2"
cal(2) = "dat3"
%>