Appendix BClient端元件\InfoComboBox

InfoComboBox

 

 

【功能說明】

用途:使用於Client端中,繼承自ComboBox元件,此元件的主要功能是以下拉方式來顯示選項內容。有兩種使用方式,一種是Items方式,通過設定內容來選擇,另外一種是將資料表的內容透過下拉框來顯示,如果使用這種方式則功能類似於InfoRefVal

 

【元件屬性】

Name(名稱)(string)

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

 

DataBindings(資料綁定)(DataBinding)

設定要與那一個資料源的那個欄位與本元件的那個屬性做資料綁定動作,一般對象都是選InfoBindingSource 中的欄位來綁定。如果ComboBox的選項資料來在DataSource時,在此請綁定SelectedValue到指定的欄位上。如果ComboBox資料不是來自資料表,來自Items時,則改綁定SelectedItem到指定的欄位上。

 

Items(選項)(string[])

在此設定下拉時可以選擇的內容項目。如果ComboBox的資料來源來自DataSource時,此不必設定。

 

DataSource(資料源)(DataSource)

下拉框顯示內容的資料來源,請選擇使用一個存在的InfoBindingSource

 

DisplayMember(顯示欄位)(string)

設定為DataSource時,要顯示的欄位名稱,通常用對方的說明或名稱做為顯示欄位,如產品名稱

 

ValueMemeber(內容欄位)(string)

設定為DataSource時,代表要存入資料庫時的內容值欄位名稱,通常使用的代碼或編號做為內容欄位,如產品編號。系統以此欄位來對應相互的內容值。

 

Expression(顯示運算式)(string)

資料來源為DataSource時,可設定更為進階的下拉框顯示的內容,透過本運算式可以更豐富ComboBox下拉時的顯示內容,如可以使用符號相加的方式。

 

例如:如果設定為CUST_NO+””+CUST_NAME+”,則下拉框顯示為:

A001(上海寶鋼)

A002(上海大眾)

……等等。

 

Text(顯示內容)(string)

顯示在ComboBox上的內容值,如果使用Items方式,則顯示SelectedItem.ToString()的內容,如果使用DataSource方式,則

顯示DisplayMember的值。

 

DropDownHeight(下拉框顯示高度)(int32)

用來設定下拉框的顯示高度。

 

DropDownWidth(下拉框顯示寬)(int32)

用來設定下拉框的顯示寬度。

 

MaxDropDownItems(最大顯示數量)(int32)

用來設定下拉框內可以顯示最大選項數量。

 

SelectCommand(SQL語法)(string)

設定關聯的資料表的資料來源命令語法,系統會根據SelectAlias的資料庫到A/P Server上動態取得此關連選單的資料,在此可以用我們內建的SQL Wizard來建立Select語句;另外也可以用DataSource方式對應到另一個InfoBindingSource,只不過這樣A/P Server也要設定InfoCommand,在Client端則要設定InfoDataSetInfoBindingSource,手續較為煩瑣,使用SelectCommand方式則會內建一個InfoDataSetInfoBindingSourceRefVal內部中。

 

SelectAlias (指定資料庫)(string)

配合SelectCommand 設定語法時,在RunTime上去New一個InfoBindingSource,讓InfoComboBox能自行獨自運作。.

 

SelectTop (只取前幾筆資料)(int32)

用來控制SelectCommandTop命令。

 

EnterEnable (Enter 鍵離開 )( bool)

用來控制按 Enter 鍵是否要離開。

 

Filter (過濾器)( bool)

DataSource如果是BindingSource的情況下才可以使用,對應BindingSourceFilter屬性,用來過濾DataSource獲取的資料。

 

【事件】

請參閱 VS有關 ComboBox元件Event

 

【功能函數】

請參閱 VS有關 ComboBox元件Method

 

【其他說明】

InfoComboBox 可以讓 User 以手動方式清除內容,離開此 InfoComboBox 時,系統會將 SelectIndex 請自動設為 -1 ,代表為 NULL 的內容,應用在查詢時,則代表不查詢此內容值。

 

 

Top of Page