AjaxMaskedEdit

【功能說明】

用途： 對編輯框 TextBox 的功能擴展，用來定位 TextBox 的輸入格式，讓 User 輸入時能更親和。本元件繼承自 TextBox 元件。

【元件屬性】

ID( 元件名稱 )(string)

用於識別該元件。

AcceptAMPM ( 上午下午 )( bool)

在 MaskType 為 Time 的時候，是否提示 AM 或 PM 代表上午或下午。

AcceptNegative ( 負數顯示 )( bool)

在 MaskType 為 Number 的時候是否提示” - ”來代表負數。

AcceptComplete( 自動完成填充 ) ( bool)

是否啟動自動完成功能即自動填充未被完成的字元，如果不設置 AcceptCompleteValue ，並且 ValidType 是 Number 或者 Time 時，空白的字元會用 0 來填充； ValidType 是 Date 時，空白的字元會以目前的日期來自動填充。

AcceptCompleteValue( 自動填充值 )(string)

當 AcceptComplete 是 true 的時候，用來自動填充未完成輸入的值。

Century( 預設世紀年 )( int)

當 MaskType 為 Date 時使用，用在世紀的預設值，如設為 2000 ，數入 07 ，就會被設為 2007 。

ClearMaskOnLostFocus ( 清除定位樣本 )( bool)

是否在離開該元件，將這些定位樣本的字符清除，如： - ，括號，錢號，或被使用” \ ”開頭的字元 ( Escape character) 。

ClearTextOnInvalid ( 錯誤清為空白 ) （ bool ）

是否在驗證不通過時，將 TextBox 內容清除空白。

DisplayMoney ( 顯示當地錢幣 ) （ enum )

是否要顯示當地的錢幣符號在 TextBox 中，並可以指定其位置， none ：不顯示， left ：顯示在左邊， right ：顯示在右邊。

InputDirection ( 輸入方向 ) （ enum )

指輸入的方向， LeftToRight ：從左到右輸入， RightToLeft ：從右到左輸入。

Mask( 定位格式 ) （ string)

本 TextBox 的輸入定位格式，每一個字元都代表一個輸入的屬性，說明如下：

輸入字元控制符號：

9 = 只可以輸入數字。

L = 只能允許輸入英文字母。

$ = 只能允許輸入英文字母與空白鍵。

C = 自定字元，依據 Filtered 屬性所定義的字元集作為條件。

A = 只能允許輸入英文字母與自定字元。

N = 只能允許輸入數字與自定字元。

? = 可允許任何字元。

特殊定位符號：

/ - 日期的分隔符號，日期一定要使用本符號。

: - 時間的分隔符號，時間一定要使用本符號。

. – 數值小數點位置。

, - 數值千位符後位置。

\ - 特殊例外字元。

{n} – 指定重複次數， n 代表重複次數，如 L{10} 代表 LLLLLLLLLL ， L10 個的意思。

MaskType ( 格式類形 ) （ enum )

輸入的格式類型， None ：無特殊格式， Date ：日期格式， Number ：數值格式， Time ：時間格式。

MessageValidatorTip ( 提示驗證訊息 ) （ bool )

在編輯 TextBox 時，是否要提示 TooltipMessage 的 訊息，此訊息會自動顯示在本 TextBox 右方。

OnBlurCssNegative ( 平常負號 ) （ string)

當內容為負值，並且不在編輯時 ( 游標不在這個元件時 ) 的負號的樣式，此只能用在 Number 的格式。

OnFocusCssNegative ( 焦點負號 ) （ string)

當內容為負值，並且正在編輯時 ( 游標在這個元件時 ) 的負號的樣式。此只能用在 Number 的格式。

OnFocusCssClass ( 焦點樣式 ) （ string)

正在編輯時 ( 游標在這個元件時 ) 的樣式表名稱。

OnInValidCssClass ( 驗證失敗樣式 ) （ string)

當此 TextBox 驗證失敗時的樣式表名稱。

PromptChararacter ( 提示字元 ) （ char)

提示輸入的字元，預設都是” _ ”。

ClientValidationFunction ( 自定義前端程序 ) （ string)

可自定用戶端 javascript 驗證的程序 ( 函數 ) 的名稱。

EmptyValueMessage ( 空值訊息 ) （ string)

當資料為空值時所要顯示的訊息，將顯示在此 TextBox 右方。

InvalidValueMessage ( 驗證訊息 ) （ string)

當驗證失敗時所要顯示的訊息，將顯示在此 TextBox 右方。

IsvalidEmpty ( 空值檢查 ) （ bool )

是否進行空值的驗證。

MaximumValue ( 驗證最大值 ) （ string)

設定最大值驗證的最大值。

MaximumValueMessage ( 最大值訊息 ) （ string)

驗證超過最大值時顯示的訊息。

MinimumValue ( 驗證最小值 ) （ string)

設定最小值驗證的最小值。

MinimumValueMessage ( 最小值訊息 ) （ string)

驗證超過最小值時顯示的訊息。

TooltipMessage ( 提示輸入訊息 ) （ string)

當 TextBox 為空值時，在獲得焦點後，會在 TextBox 右方顯示此訊息，必須配合 MessageValidatorTip 為 True 。如可以設定”請輸入一個日期”。

ValidationExpression （ string)

驗證運算式

 

【其他說明】

其他屬性請參考 TextBox 這個元件的屬性。

 

【範例】

日期的範例一：如 MaskType =Date ， Mask=9999/99/99 ，代表 yyyy/mm/dd 的輸入。

日期的範例二：如 MaskType =None ， Mask=9999/99 ， ClientValidationFunction =checkDate1 ，代表 yyyy /mm 的輸入，其驗證的 JavaScript 如下：

function checkDate1(source, argument)

   {

        var srcValue = eval( "document.all." +source.controltovalidate).value;

        var parts = srcValue.split( '' );

        var year = parts[0] + parts[1];

        var month = parts[2] + parts[3];

        if (month < "01" || month > "12" )

       {

           argument.IsValid = false ;

       }

    }

時間的範例：如 MaskType =Time ， Mask=99:99:99 ，代表 hh:mm:ss 的輸入。

數值的範例一：如 MaskType =Number ， Mask=999,999.99 ，定位數值使用千位符號與小數 2 位。

數值的範例二：如 MaskType =Number ， Mask=\$999,999.99 ，使用錢號。

數值的範例三：如 MaskType =Number ， Mask=999,999.99 ， DisplayMoney =True ，使用本地錢號。

字串的範例一：如 MaskType =None ， Mask=(999)(9999-9999) ， ClearMaskOnLostFocus =True ，此為電話的格式。

字串的範例二：如 MaskType =None ， Mask=L9{9} ，等同於 L999999999 ，此為台灣身份證的格式，驗證需另外寫 javaScript 。