MaskedEdit Demonstration

MaskedEdit Description:

MaskedEdit is an ASP.NET AJAX extender that attaches to a TextBox control to restrict the kind of text that can be entered. MaskedEdit applies a "mask" to the input that permits only certain types of characters/text to be entered. The supported data formats are: Number, Date, Time, and DateTime. MaskedEdit uses the culture settings specified in the CultureName property. If none is specified the culture setting will be the same as the page: English (United States).

MaskedEdit Properties:

The number control above is initialized with this code. The italic properties are optional.

<ajaxToolkit:MaskedEditExtender
    TargetControlID="TextBox2"
    Mask="9,999,999.99"
    MessageValidatorTip="true"
    OnFocusCssClass="MaskedEditFocus"
    OnInvalidCssClass="MaskedEditError"
    MaskType="Number"
    InputDirection="RightToLeft"
    AcceptNegative="Left"
    DisplayMoney="Left"
    ErrorTooltipEnabled="True"/>

    * MaskType - Type of validation to perform:
      None - No validation
      Number - Number validation
      Date - Date validation
      Time - Time validation
      DateTime - Date and time validation
    * Mask Characters and Delimiters
      9 - Only a numeric character
      L - Only a letter
      $ - Only a letter or a space
      C - Only a custom character (case sensitive)
      A - Only a letter or a custom character
      N - Only a numeric or custom character
      ? - Any character

      / - Date separator
      : - Time separator
      . - Decimal separator
      , - Thousand separator
      \ - Escape character
      { - Initial delimiter for repetition of masks
      } - Final delimiter for repetition of masks

      Examples:
      9999999 - Seven numeric characters
      99\/99 - Four numeric characters separated in the middle by a "/"
    * 
    * AcceptAMPM - True to display an AM/PM symbol
    * AcceptNegative - True if the negative sign (-) is allowed
      None - Do not show the negative sign
      Left - Show the negative sign on the left of the mask
      Right - Show the negative sign on the right of the mask
    * AutoComplete - True to automatically fill in empty mask characters not specified by the user
      MaskType=Number - Empty mask characters will be filled with zeros
      MaskType=Time - Empty mask characters will be filled with the current time
      MaskType=Date - Empty mask characters will be filled with the current date
      MaskType=DateTime - Empty mask characters will be filled with the current date/time
    * AutoCompleteValue - Default character to use when AutoComplete is enabled
    * Century - Default century used when a date mask only has two digits for the year
    * ClearMaskOnLostFocus - True to remove the mask when the TextBox loses focus
    * ClearTextOnInvalid - True to clear the TextBox when invalid text is entered
    * ClipboardEnabled- True to allow copy/paste with the clipboard
    * ClipboardText - Prompt text to use when a clipboard paste is performed
    * DisplayMoney - Specifies how the currency symbol is displayed
      None - Do not show the currency symbol
      Left - Show the currency symbol on the left of the mask
      Right - Show the currency symbol on the right of the mask
    * ErrorTooltipCssClass - CSS class for the tooltip message
    * ErrorTooltipEnabled - True to show a tooltip message when the mouse hovers over an invalid TextBox
    * Filtered - Valid characters for mask type "C" (case-sensitive)
    * InputDirection - Text input direction
      LeftToRight - Left to Right
      RightToLeft - Right to left
    * MessageValidatorTip - Message displayed when editing in TextBox
    * PromptChararacter - Prompt character for unspecified mask characters
    * UserDateFormat - Custom date format
    * UserTimeFormat - Custom time format
    * 
    * OnFocusCssClass - CSS class used when the TextBox receives focus
    * OnFocusCssNegative - CSS class used when the TextBox gets focus with a negative value
    * OnBlurCssNegative - CSS class used when the TextBox loses focus with a negative value
    * OnInvalidCssClass - CSS class used when the text is not valid.
    * 
    * CultureName - Name of culture to use (overrides the default page culture)
    * CultureAMPMPlaceholder - Culture override
    * CultureCurrencySymbolPlaceholder - Culture override
    * CultureDateFormat - Culture override
    * CultureDatePlaceholder - Culture override
    * CultureDecimalPlaceholder - Culture override
    * CultureThousandsPlaceholder - Culture override
    * CultureTimePlaceholder - Culture override

MaskedEdit Validator Description:

MaskedEditValidator is a custom validator which attaches to the MaskedEdit extender and its associated TextBox and verifies that the input text matches the pattern specified in the MaskedEdit extender. Once associated with a validation group, server- and client-side validation can be performed and used to display messages.

MaskedEditValidator Properties:

The control above is initialized with this code. The italic properties are optional.

<ajaxToolkit:MaskedEditValidator
    ControlExtender="MaskedEditExtender2"
    ControlToValidate="TextBox2"
    IsValidEmpty="False"
    MaximumValue="12000"
    EmptyValueMessage="Number is required"
    InvalidValueMessage="Number is invalid"
    MaximumValueMessage="Number > 12000"
    MinimumValueMessage="Number < -100"
    MinimumValue="-100"
    EmptyValueBlurredText="*"
    InvalidValueBlurredMessage="*"
    MaximumValueBlurredMessage="*"
    MinimumValueBlurredText="*"
    Display="Dynamic"
    TooltipMessage="Input a number: -100 up to 12.000"/>

    * ControlToValidate - ID of the TextBox to validate
    * ControlExtender - ID of the MaskedEditExtender attached to the TextBox
    * 
    * AcceptAMPM - Whether or not AM/PM is accepted on times.
      The default value is false.
    * ClientValidationFunction - Client script used for custom validation
    * InitialValue - Initial value of the TextBox
    * IsValidEmpty - True if the TextBox can be empty
    * MaximumValue - Maximum value of the input
    * MinimumValue - Minimum value of the input
    * ValidationExpression - Regular expression used to validate the input
    * 
    * TooltipMessage - Message displayed when the TextBox has focus with an empty value
    * EmptyValueMessage - Message displayed when empty and TextBox has focus
    * EmptyValueBlurredText - Message displayed when empty and TextBox does not have focus
    * InvalidValueMessage - Message displayed when invalid and TextBox has focus
    * InvalidValueBlurredMessage - Message displayed when invalid and TextBox does not have focus
    * MaximumValueMessage - Message displayed when maximum value exceeded and TextBox has focus
    * MaximumValueBlurredMessage - Message displayed when maximum value exceeded and TextBox does not have focus
    * MinimumValueMessage - Message displayed when minimum value exceeded and TextBox has focus
    * MinimumValueBlurredText - Message displayed when minimum value exceeded and TextBox does not have focus

MaskedEdit Known Issues:

Opera's keyboard handling implementation causes the "." key to map to "Del" and the "Ins" key to map to "-".

0 comments:

Post a Comment