【功能說明】

用途：使用於Client端，本元件繼承自DataTimePicker元件，可下拉出日曆，用於編輯日期型態的欄位，或者字串型態的VARCHAR(8)類型。

【元件屬性】

Name(名稱)(string)

元件名稱，用於識別該元件。

DataBindings(資料綁定)(DataBinding)

設定要與那一個資料源的那個欄位與本元件的那個屬性做資料綁定動作，一般對象都是選InfoBindingSource 中的欄位來綁定。綁定方式可分為兩種類型，如果綁定的欄位型態為日期(DateTime)，則需要以Text屬性綁定到該欄位，如果綁定的欄位型態為字串VARCHAR(8)，則需要將DateTimeString屬性綁定到該欄位。

DateTimeType(日期類型)(enum)

可選擇設定為日期型DateTime，或者是字串VARCHAR(8)型態。

DateTimeString(日期內容)(string)

如DateTimeType為VarChar時，必須使用DateTimeString與其欄位進行綁定。

Format(日期格式)(enum)

日期的輸入與顯示格式，可設定custom(自定)，Long(長字串，依OS的格式設定)，Short(短字串依OS的格式設定)，Time(僅顯示時間格式，依OS的格式)。其中custom則定義在CustomFormat屬性中。

CustomFormat(自定格式)(stirng)

使用於Format為Custom時的自定格式，以字母來定義代表意義，如下：

M： 月份，一個Byte到兩個Bytes，前面不補’0’，1-12。

MM：月份，固定兩個Bytes，前面補’0’ ，01-12。

MMM：月份，英文三個字母的縮寫，Jan-Dec。

MMMM：月份，英文月份的全名，January-December。

d：日期，一個Byte到兩個Bytes，前面不補’0’ ，1-31。

dd：日期，固定兩個Bytes，前面補’0’， 01-31。

ddd：星期，使用星期的英文三個字母的縮寫，Sun-Sat。

dddd：星期，英文星期的全名，Sunday-Saturday。

y：年度，一個Byte到兩個Bytes，最多只取2位，前面不補’0’，0-99。

yy：年度，固定兩個Bytes，前面補’0’ ，00-99。

yyyy：年度，固定四個Bytes，1900-9999。

h：小時，12小時制，一個Byte到兩個Bytes，前面不補’0’ ，0-12。

hh：小時，12小時制，固定兩個Bytes，前面補’0’ ，00-12。

H：小時，24小時制，一個Byte到兩個Bytes，前面不補’0’ ，0-23。

HH：小時，24小時制，固定兩個Bytes，前面補’0’ ，00-23。

m：分鐘，一個Byte到兩個Bytes，最多只取2位，前面不補’0’，0-59。

mm：分鐘，固定兩個Bytes，前面補’0’ ，00-59。

s：秒鐘，一個Byte到兩個Bytes，最多只取2位，前面不補’0’，0-59。

ss：秒鐘，固定兩個Bytes，前面補’0’ ，00-59。

t：上下午，12小時制時使用，顯示’A’或’P’。

tt：上下午，12小時制時使用，顯示’AM’或’PM’。

如： yyyyMMdd，如日期為2006年03月18日，就會以20060318的方式顯示日期，

MM/dd/yyyy  HH:mm:ss，顯示 03/18/2006 15:18:47。

Ddd d MMM yy’,h:mm:ss tt，顯示 Sat 18 Mar 06’,3:18:47 PM

MaxDate(最大日期)(DateTime)

設定可允許的輸入最大日期。

MinDate(最小日期)(DateTime)

設定可允許的輸入最小日期。

Value(選定日期)(DateTime)

目前的日期值，不論綁定的欄位是日期還是字串類型，在此都為日期型態。

AllowDrop(允許拖入)(bool)

允許別的表單將資料拖入，須配合Form的AllowDrop設定。

CausesValidation(自動檢驗)(bool)

是否自動驗證元件內的日期是否合法。

Checked(是否勾選)(bool)

配合ShowCheckBox=True時，用來判斷User是否勾選此日期。

ShowCheckBox(顯示選項)(bool)

用來在日期前面顯示一個CheckBox讓User來勾選此日期。

Dock(對齊方式)(enum)

Grid的對齊方式，可設定None(無)，Top(靠上)，Bottom(靠下)，Right(靠右)，Left(靠左)，Fill(佔滿)。

Enabled(致能)(bool)

是否可以致能。

Visible(是否顯示)(bool)

設定此元件是否要顯示。

【事件】

請參閱 VS有關 DateTimePicker元件Event。

【功能函數】

請參閱 VS有關 DateTimePicker元件Method。

【其他說明】

如果綁定的欄位為字串VARCHAR(8)類型，則資料的存儲的格式必須為yyyyMMdd的格式，系統會自動將欄位內容轉換成此格式並存放到資料庫中。

訊光科技系統股份有限公司