【功能說明】
用途:使用於Web網頁中,用來顯示日曆及當日佔用時間的資訊,此元件必須要與一個特殊的Table格式做資料連結,並指定各個資料的欄位名稱,即可以日曆的形式來顯示狀態圖(用條形圖來顯示)。顯示日曆狀態圖共有三種模式:一種為那一天到那一天(即一段期間),由指定資料的日期欄位內容來決定(DateFromField與DateToField),如果是單一日期的情況,可以僅使用DateFromField即可;另一種是固定以星期為週期為狀態,如每週一或週三等等,則可設定WeekField來達到星期週期的功能;最後一種是固定以月份為週期為狀態,如每月5日或25日等,可設定MonthField來達成此目的。此三種狀態可以混合使用,只要設定的欄位不一樣即可自動依據資料表的內容來顯示狀態。
【元件屬性】
ID(名稱)(string)
元件名稱,用於識別該組件。
DataSourceID(資料源ID)(string)
指定元件的資料源ID,選擇一個存在的Webdatasource的ID。
DateFromField(開始日期欄位)(string)
設定資料表中存放開始日期的欄位名稱,當日期在開始日期與結束日期之間時為符合條件,即可在日曆中顯示該期間的條形圖。
DateToField(結束日期欄位)(string)
設定資料表中存放結束日期的欄位,用來與DateFromField對應。
TimeFromField(開始時間欄位)(string)
指資料表中存放開始時間的欄位名稱,當日曆中的某天與所屬的日期條件符合時,該天將顯示一條反應當天時間(結束時間–開始時間)的條形圖,長度與位置設為對應的比例。
TimeToField(結束時間欄位)(string)
資料表中存放結束時間的欄位名稱,用來與TimeFromField對應。
WeekField(星期週期欄位)(string)
設定資料表中存放星期週期的欄位名稱,1對應星期一,2對應星期二,3對應星期三,4對應星期四,5對應星期五,6對應星期六,7對應星期日,當日期的星期數與欄位中的相等時為符合條件,注意,任何一筆不為0的資料都代表每週TimeFormField到TimeToField間,都是被佔有的情況。
MonthField(月日期欄位)(string)
設定資料表中存放月週期的欄位名稱,內容應為一數值欄位,為1到31間的範圍,可謂會在日曆中依欄位內容所指定的日期來顯示條形圖(每個月都會有)。注意,任何一筆不為0的資料都代表每月TimeFormField到TimeToField間,都是被佔有的情況。
DayLightOnly(日光時間)(bool)
用來控制要顯示的時間的範圍,如果DayLightOnly=True,則只顯示 08:00到20:59範圍間的條形圖,超出範圍者則最大以08:00~20:59為準,此目的是可以讓每日的TimeBar可以更寬一些。如設定False則每日都是以24小時為範圍顯示TimeBar,同樣的時間,會比DayLightOnly=True還小。
【事件】
此組件無事件。
【功能函數】
Show()
在新視窗中顯示日曆及時間資訊。
Show(string
WhereString)
按照whereString的條件到Server端重新取得資料,然後在新視窗中顯示日曆及時間資訊。
【其它說明】
例:有一個Schedulre的Table,其資料內容可以如下:
ID |
Description |
FromDate |
ToDate |
Weekly |
Monthly |
FromTime |
ToTime |
Remarks |
1 |
展覽 |
2006.05.18 |
|
|
|
10:00 |
12:00 |
單日活動 |
2 |
EEP |
2006.06.15 |
2006.06.17 |
|
|
09:30 |
17:00 |
三天活動 |
3 |
夏季郊遊 |
2006.07.05 |
|
|
|
09:00 |
17:00 |
單日活動 |
4 |
業務會議 |
|
|
1 |
|
09:00 |
10:00 |
每週一09:00 |
5 |
行銷會議 |
|
|
2 |
|
17:00 |
19:00 |
每週二17:00 |
6 |
主管會議 |
|
|
|
10 |
16:00 |
19:00 |
每月10日16:00 |
.. |
.. |
.. |
.. |
.. |
.. |
.. |
.. |
.. |
設定時,DataSourceID為Schedule,DateFromField為FromDate,DateToField為ToDate,TimeFormField為FormTime,TimeToField為ToTime,WeekField為Weekly,MonthField為Monthly。