【功能說明】
用途：使用於Client端，用在Grid的Column（Style為InfoDataGridViewRefValColumn）以及InfoTextBox。可以透過此元件呼叫關聯選單的資料，並充分利用關聯的資料的內容， 用於顯示名稱與輸入查表選單或將其部份欄位帶回來，使User界面更親和。例如，可以用此元件使訂單明細表中的Item_No欄位，關聯到Item表，並在Item_no欄位上顯示Item_Name的內容。
【元件屬性】
Name(名稱)(string)
元件名稱，用於識別該元件。
ActiveBox ( 啟動箱子 ) ( bool)
設置所使用的InfoRefValBox。
AlwaysClose ( 開啟模式 ) ( bool)
用來控制在此元件被啟動時是否要去下載資料， True 代表不會去下載 ( 會使用 Where 1=0 的方式將資料表打開但沒有資料 ) ， False 則會下載資料到此資料表中。
AllowAddData ( 是否允許資料新增 ) ( bool)
可控制 InfoRefVal 所打開的視窗中內的 DataGridView 是否要有 " 新增 " 的Button ，並可以新增資料。注意此功能僅針對資料來源為 InfoDataSet 接上 InfoBindingSource 者。
AutoGridSize(自動大小)(bool)
下拉的視窗是否要自動跟據欄位數多寡決定視窗的大小。
AutoLocate(自動定位)(bool)
設定用戶是否可以通過Keypress事件來自動定位。
Caption(抬頭)(string)
用來設定此RefVal視窗的抬頭。
CheckData(是否檢查)(bool)
可以設定是否在RefTextBox或DataGridView的RefValColumn輸入資料時， 檢查其鍵值是否存在。True為要檢查，False則不要。預設為True。
ColumnMatch(欄位對應)(collections)
設定從RefVal關聯的資料表中可以傳回部份欄位內容到原來的BindingSource欄位中。此屬性為一個集合，可設定多個欄位的對應關係，也就是說將User所選的RefVal的來源資料表的欄位值，傳回到目前資料表的某欄位上，每個集合的屬性如下：
SrcFieldName(來源欄位名稱)(string)：指來源資料表的欄位名稱。
ScrGetValue(來源運算式)(string)：當不能以ScrFieldName的某個欄位來取值，則改用此運算式呼叫另一個程式來傳回自定的內容值。
DestField(目的欄位名稱)(string)：指要設值的目的資料表的欄位，取自來源欄位。
Columns(顯示欄位明細)(collections)
設定打開下拉視窗時，要顯示那些欄位。此屬性為一個集合，可同時設定多個要顯示的欄位名稱，如果不設定，則顯示所有欄位。其中每個欄位還可以設定如下內容：
Column(欄位名稱)(string)：要顯示的欄位名稱。
DefaultCellStyle(顯示格式)(string)：設定資料顯示格式。
HeaderText(抬頭)(string)：要顯示欄位的表頭。此屬性可使用DD資料字典功能，在新增Column時，系統會自動到系統表COLDEF中找到該資料表該欄位的抬頭內容。
Width(寬度)(int32)：欄位的寬度。
Visible( 顯示 )( bool) ： 用來設定是否顯示。
DataSource(資料源)(InfoBindingSource)
定義下拉的關聯的資料表的來源，如果定義了SelectCommand則就可不必設定此DataSource屬性。
DisplayMember(顯示欄位)(string)
用來設定所要對應顯示的欄位名稱，在對應的TextBox或DataGridView中所要顯示的對方欄位名稱。例如以「客戶編號」去找對方「客戶名稱」並顯示出來。
Font(字型)(System.Drawing.Font)
用來設定RefVal所顯示的字型
IgnoreCase(忽略大小寫)(bool)
用來設定是否忽略大小寫。
PacketRecords ( 傳 送記錄數 )( int)
此屬性可是讓 SelectCommand 方式取得的 InfoRefVal 資料，也可以有 PackageRecord 功能，預設 為 100 。
SelectAlias(指定資料庫)(string)
配合SelectCommand 設定語法時，在RunTime上去New一個InfoBindingSource，讓RefVal能自行獨自運作。.
SelectCommand(關聯資料語法)(string)
設定此RefVal關聯的資料表的資料來源命令語法，系統會根據SelectAlias的資料庫到A/P Server上動態取得此關連選單的資
料，在此可以用我們內建的SQL Wizard來建立Select語句；另外也可以用DataSource方式對應到另一個InfoBindingSource，只不過這樣A/P Server也要設定InfoCommand，在Client端則要設定InfoDataSet與InfoBindingSource，手續較為煩瑣，使用SelectCommand方式則會內建一個InfoDataSet與InfoBindingSource在RefVal內部中。
ValueMember(關聯欄位)(string)
用來設定下拉打開關連表單時，要用此欄位去關聯到下拉出來的資料表。例如以「客戶編號」去下拉出客戶資料表的關聯選
單。
WhereItem(Where條件項目)(collections)
當RefVal被關聯或打開時，此時系統會自動以此Where的條件到後端重新區資料，WhereItem為一個集合，可以設定多個欄位的條件。
其中每個WhereItem可以設定：
FieldName(條件欄位名稱)(string)：需要設定條件的欄位名稱。
Condition(條件)(enum)：有＝，％，％％，>，<，!＝，>＝，<＝，用來控制何種Where條件。
Value(條件值)(string)：可設定常數或使用()的函數引用方式取得動態條件值。如可以利用此Value呼叫另一個程式取得其它TextBox.Text內容 傳回到此Value，來達到過濾與篩選此RefVal的條件。
WhereItemCache(Where條件項目緩存)(bool)
設置是否要緩存WhereItem。
FormSize(表單尺寸)(bool)
設置RefVal打開的表單大小。
【事件】
OnActive（被觸發時）
當此RefVal被觸發時的事件。
OnClose（被結束時）
當此RefVal被結束或關閉時的事件（取消、確定都會觸發此事件）。
OnReturn ( EventArg e)
當此 RefVal 被返回值時的事件。
QueryWhere(EventArgs e)
此事件可以讓 User 自行調整 Where 的 SQL 語句 . 如下 :
Private void rvOrdersCustomerID_QueryWhere(object sender, NavigatorQueryWhereEventArgse)
{
e.WhereString= " CustomerID= 'ALFKI'"; // 自行改變 Where 的 內容
}
【功能函數】
DoColumnMatch（執行欄位對應）
可以讓User在輸入資料時，不經過RefVal的按鈕也能執行ColumnMatch對應設值的動作。
【其他說明】
1. InfoRefval 如果 ValueMember 和 DisplayMember 是同一個欄位時，系統會自動不去尋找資料，以加快顯示速度。
| Converted from CHM to HTML with chm2web Pro 2.85 (unicode) |