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 ( 下拉框顯示高度 )( int)

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

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

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

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

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

SelectCommand (SQL 語法 )(string)

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

SelectAlias ( 指定資料庫 )(string)

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

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

用來控制 SelectCommand 的 Top 命令。

EnterEnable (Enter 鍵離開 )( bool)

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

 

【事件】

請參閱 VS 有關 ComboBox 元件 Event 。

【功能函數】

請參閱 VS 有關 ComboBox 元件 Method 。

【其他說明】

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