WebDateTimeViewer

 

【功能說明】

用途：使用於 Web 網頁中，用來顯示日曆及當日佔用時間的資訊，此元件必須要與一個特殊的 Table 格式做資料連結，並指定各個資料的欄位名稱，即可以日曆的形式來顯示狀態圖 ( 用條形圖來顯示 ) 。顯示日曆狀態圖共有三種模式：一種為那一天到那一天 ( 即一段期間 ) ，由指定資料的日期欄位內容來決定 ( DateFromField 與 DateToField ) ，如果是單一日期的情況，可以僅使用 DateFromField 即可；另一種是固定以星期為週期為狀態，如每週一或週三等等，則可設定 WeekField 來達到星期週期的功能；最後一種是固定以月份為週期為狀態，如每月 5 日或 25 日等，可設定 MonthField 來達成此目的。此三種狀態可以混合使用，只要設定的欄位不一樣即可自動依據資料表的內容來顯示狀態。

 

【元件屬性】

Name( 名稱 )(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 ，其資料內容可以如下：

設定時， DataSourceID 為 Schedule ， DateFromField 為 FromDate ， DateToField 為 ToDate ， TimeFormField 為 FormTime ， TimeToField 為 ToTime ， WeekField 為 Weekly ， MonthField 為 Monthly 。