Create the best Web experiences in browsers and devices with our user interface controls designed expressly for jQuery, ASP.NET MVC, HTML 5 and CSS 3. You’ll be building on a solid and proven foundation without any plug-ins or extensions, just real world best practices and the most forward-thinking, robust Web technology.

Infragistics NetAdvantage jQuery API Reference

ui.igCurrencyEditor

ui.igCurrencyEditor_image

The igCurrencyEditor control includes a wide variety of formatting options for displaying and reading currency values. The control also features full support for handling currency from different locales. Further information regarding the classes, options, events, methods and themes of this API are available under the associated tabs above.

The igCurrencyEditor control extends the functionality of the igNumericEditor control. For more details on the igCurrencyEditor control’s API, refer to base igNumericEditor and igEditor control’s API documentation.

The following code snippet demonstrates how to initialize the igCurrencyEditor control.

Click here for more information on how to get started using this API. For details on how to reference the required scripts and themes for the igCurrencyEditor control read, Using JavaScript Resouces in NetAdvantage for jQuery and Styling and Theming NetAdvantage for jQuery.

Code Sample

      <!doctype html>
        <html>
        <head>
              <!-- Infragistics Combined CSS -->
              <link href="themes/ig/jquery.ui.custom.css" rel="stylesheet" type="text/css" />
              <link href="themes/base/ig.ui.css" rel="stylesheet" type="text/css" />
              <!-- jQuery Core -->
              <script src="js/jquery.js" type="text/javascript"></script>
              <!-- jQuery UI -->
              <script src="js/jquery-ui.js" type="text/javascript"></script>
              <!-- jQuery Templates: http://api.jquery.com/category/plugins/templates/ -->
              <script src="js/jquery.tmpl.js" type="text/javascript"></script>
              <!-- Infragistics Combined Scripts -->
              <script src="js/ig.ui.js" type="text/javascript"></script>
              <script type="text/javascript">
                  $(function(){
                         $("#currencyEditor").igCurrencyEditor({
                               width: 200
                    });
                  });
              </script>
        </head>
        <body>
           <input id="currencyEditor" />
        </body>
        </html>
    

Related Samples

Related Topics

Dependencies

jquery-1.4.4.js
jquery.ui.core.js
jquery.ui.widget.js
jquery.ui.datepicker.js
ig.util.js
  • &nbspanimationHideDuration

    Type:
    number
    Default:
    200

    Sets gets duration of animation in milliseconds when drop-down list is hidden. That option is not supported when "type" is set to "datepicker", because the jquery.ui.datepicker does not have similar feature. Default is 200. If value is less than 5, then animation is disabled.

    Code Sample

          //Initialize
          $(".selector").igCurrencyEditor({
              animationHideDuration: 200
          });
     
          //Get
          var animationHideDuration= $(".selector").igCurrencyEditor("option", "animationHideDuration");
     
          //Set
          $(".selector").igCurrencyEditor("option", "animationHideDuration", 200);
          
  • &nbspanimationShowDuration

    Type:
    number
    Default:
    200

    Sets gets duration of animation in milliseconds when drop-down list or calendar is displayed. Default is 200. If value is less than 5, then animation is disabled.

    Code Sample

          //Initialize
          $(".selector").igCurrencyEditor({
            animationShowDuration: 200
          });
     
          //Get
          var animationShowDuration= $(".selector").igCurrencyEditor("option", "animationShowDuration");
     
          //Set
          $(".selector").igCurrencyEditor("option", "animationShowDuration", 200);
          
  • &nbspborderBetweenFieldAndButtons

    Type:
    bool
    Default:
    false

    Sets gets ability to keep left and/or right borders of input-field unchanged if buttons are enabled. Default is false. Value false will remove borders.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                borderBetweenFieldAndButtons : true
            });
    
            //Get
            var borderExists = $(".selector").igCurrencyEditor("option", "borderBetweenFieldAndButtons");
    
            //Set
            $(".selector").igCurrencyEditor("option", "borderBetweenFieldAndButtons", true);
            
  • &nbspbutton

    Type:
    enumeration
    Default:
    none

    Sets gets visibility of spin and drop-down button. That option can be set only on initialization. Combinations like 'dropdown,spin' or 'spinclear' are supported too.

    Members

    • dropdown
    • Type:string
    • button to open list is located on the right side of input-field (or left side if base html element has direction:rtl);.
    • clear
    • Type:string
    • button to clear value is located on the right side of input-field (or left side if base html element has direction:rtl);.
    • spin
    • Type:string
    • spin buttons are located on the right side of input-field (or left side if base html element has direction:rtl).

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                button : "dropdown"
            });
    
            //Get
            var button = $(".selector").igCurrencyEditor("option", "button");
    
            //Set
            $(".selector").igCurrencyEditor("option", "button", "spin");
            
  • &nbspbuttonHidden

    Type:
    bool
    Default:
    false

    Sets gets visibility of dropdown button. That option has effect only when dropdown or clear button is enabled.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                button : "dropdown",
                buttonHidden : true
            });
            
            //Get
            var isHidden = $(".selector").igCurrencyEditor("option", "buttonHidden");
            
            //Set
            $(".selector").igCurrencyEditor("option"), "buttonHidden", true);
          
  • &nbspdataMode

    Type:
    enumeration
    Default:
    double

    Sets gets type of value returned by the get of value() method. That also affects functionality of the set value(val) method and the copy/paste operations of browser.

    Members

    • text
    • Type:string
    • the String object is used with 'text' in display mode format.
    • -1
    • Type:number
    • editModeText
    • Type:string
    • the String object is used with 'text' in edit mode format.
    • 0
    • Type:number
    • double
    • Type:string
    • the Number object is used with limits of double and if value is not set, then the null or Number.NaN is used depending on the option 'nullable'. Note: that is used as default.
    • 1
    • Type:number
    • float
    • Type:string
    • the Number object is used with limits of double and if value is not set, then the null or Number.NaN is used depending on the option 'nullable'.
    • 2
    • Type:number
    • decimal
    • Type:string
    • the Number object is used with limits of double and if value is not set, then 0 is used.
    • 3
    • Type:number
    • long
    • Type:string
    • the Number object is used with limits of signed long and if value is not set, then 0 is used. .
    • 4
    • Type:number
    • ulong
    • Type:string
    • the Number object is used with limits of unsigned long and if value is not set, then 0 is used.
    • 5
    • Type:number
    • int
    • Type:string
    • the Number object is used with limits of signed int and if value is not set, then 0 is used.
    • 6
    • Type:number
    • uint
    • Type:string
    • the Number object is used with limits of unsigned int and if value is not set, then 0 is used.
    • 7
    • Type:number
    • short
    • Type:string
    • the Number object is used with limits of signed short and if value is not set, then 0 is used.
    • 8
    • Type:number
    • ushort
    • Type:string
    • the Number object is used with limits of unsigned short and if value is not set, then 0 is used.
    • 9
    • Type:number
    • sbyte
    • Type:string
    • the Number object is used with limits of signed byte and if value is not set, then 0 is used.
    • 10
    • Type:number
    • byte
    • Type:string
    • the Number object is used with limits of unsigned byte and if value is not set, then 0 is used.
    • 11
    • Type:number

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                dataMode : 0
            });
            
            //Get
            var dataMode = $(".selector").igCurrencyEditor("option", "dataMode");
            
            //Set
            $(".selector").igCurrencyEditor("option", "dataMode", "double");
          
  • &nbspdecimalSeparator

    Type:
    string
    Default:
    null

    Sets gets the character, which is used as decimal separator.
    Note: this option has priority over possible regional settings.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                decimalSeparator : ","
            });
            
            //Get
            var separator = $(".selector").igCurrencyEditor("option", "decimalSeparator");
            
            //Set
            $(".selector").igCurrencyEditor("option", "decimalSeparator", ",");
          
  • &nbspdisplay

    Type:
    string
    Default:
    inline-block

    Sets gets style.display for outer html element.
    The value of "" will disable changing style.display.
    If the base html element is not INPUT, TEXTAREA, SPAN or DIV, then it is recommended to set this option to an empty string,
    because, some browsers may fail to handle display other than default value of browser.
    For example, if base element for editor is TD, then behavior in Chrome can be problematic.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                display : "block"
            });
    
            //Get
            var display = $(".selector").igCurrencyEditor("option", "display");
    
            //Set
            $(".selector").igCurrencyEditor("option", "display", "block");
  • &nbspdisplayFactor

    Type:
    number
    Default:
    null

    Sets gets the factor which used for the get and set of the "value" method.
    On the get number (string) entered by user is divided by that factor and on the set the number (string) displayed in editor is multiplied by that factor.
    For example, if factor is 100 and the "value" is set to 0.123, then editor will show string "12.3".
    Possible values: 1, 10, 100, 1000, 10000, 100000, etc.
    Note: this option has priority over possible regional settings.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                displayFactor : 100
            });
    
            //Get
            var factor = $(".selector").igCurrencyEditor("option", "displayFactor");
    
            //Set
            $(".selector").igCurrencyEditor("option", "displayFactor", 100);      
          
  • &nbspdropDownOnReadOnly

    Type:
    bool
    Default:
    false

    Sets gets ability to override the "readOnly" option and allow showing the drop-down list and changing the value in the editor from a list. Value false does not allow drop-down when "readOnly" is true.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                dropDownOnReadOnly : true
            });
    
            //Get
            var readOnly = $(".selector").igCurrencyEditor("option", "dropDownOnReadOnly");
    
            //Set
            $(".selector").igCurrencyEditor("option", "dropDownOnReadOnly", true);      
          
  • &nbspdropDownTriggers

    Type:
    enumeration
    Default:
    button,ctrl+arrow,alt+arrow

    Sets gets list of actions which trigger display of drop-down list or calendar.

    Members

    • arrow
    • Type:string
    • down-arrow shows drop-down and up-arrow hides drop-down;.
    • button
    • Type:string
    • shows and hides drop-down;.
    • focus
    • Type:string
    • shows drop-down on focus.
    • A-Z
    • Type:string
    • Any upper case characters show drop-down.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                dropDownTriggers : "button,0,1,2,3,4,5,6,7,8,9"
            });
    
            //Get
            var triggers = $(".selector").igCurrencyEditor("option", "dropDownTriggers");
    
            //Set
            $(".selector").igCurrencyEditor("option", "dropDownTriggers", "button,0,1,2,3,4,5,6,7,8,9");      
          
  • &nbspexcludeKeys

    Type:
    string
    Default:
    null

    Sets gets ability to prevent entering specific characters from keyboard or on paste.
    Notes:
    If a character is specified in "includeKeys" option also, then "excludeKeys" has priority.
    Letters should be set in upper case.
    Making difference between upper and lower case is not supported.

    Code Sample

            //Initialize
            $(".selector").igCurrencyEditor({
                   excludeKeys: "ABC"
            });
     
            //Get
            var excludedKeys= $(".selector").igCurrencyEditor("option", "excludeKeys");
     
            //Set
            $(".selector").igCurrencyEditor("option", "excludeKeys", "ABC");
            
  • &nbspfocusOnSpin

    Type:
    bool
    Default:
    false

    If that option is disabled and the editor is not focused, then a mouse click on the spin button will keep the text in the editor in display (not focus) format and perform spin actions.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                focusOnSpin : true
            });
    
            //Get
            var spinFocus = $(".selector").igCurrencyEditor("option", "focusOnSpin");
    
            //Set
            $(".selector").igCurrencyEditor("option", "focusOnSpin", true);
            
  • &nbspgroups

    Type:
    object
    Default:
    null

    (array of number objects) Sets gets the number of digits in integer part of number, which are divided into groups.
    The "numericGroupSeparator" is inserted between groups.
    If the sum of all values in array is smaller than the length of integer part, then the last item in array is used for all following groups.
    Count of groups starts from the decimal point (from right to left).
    That option has effect only in display (no focus) state.
    Note: this option has priority over possible regional settings.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                groups : [1, 2, 3],
            });
    
            //Get
            var groups = $(".selector").igCurrencyEditor("option", "groups");
    
            //Set
            $(".selector").igCurrencyEditor("option", "groups", [3, 3, 3]);
            
  • &nbspgroupSeparator

    Type:
    string
    Default:
    null

    Sets gets the character, which is used as separator for groups (like thousands).
    That option has effect only in display (no focus) state.
    Note: this option has priority over possible regional settings.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                groupSeparator : ".",
            });
    
            //Get
            var groupSeparator = $(".selector").igCurrencyEditor("option", "groupSeparator");
    
            //Set
            $(".selector").igCurrencyEditor("option", "groupSeparator", ".");
            
  • &nbspheight

    Type:
    number
    Default:
    null

    Sets gets height of editor in pixels.
    Only positive values have effect.
    If that option is not set, then value of style.height of base html element will be used automatically. However, that value should be in the px units.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                height : 25
            });
    
            //Get
            var height = $(".selector").igCurrencyEditor("option", "height");
    
            //Set
            $(".selector").igCurrencyEditor("option", "height", 25);
            
  • &nbsphideEnterKey

    Type:
    bool
    Default:
    true

    Sets gets ability to hide the Enter key from browser.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                hideEnterKey : false
            });
    
            //Get
            var hideKey = $(".selector").igCurrencyEditor("option", "hideEnterKey");
    
            //Set
            $(".selector").igCurrencyEditor("option", "hideEnterKey", false);
            
  • &nbspincludeKeys

    Type:
    string
    Default:
    null

    Sets gets ability to enter only specific characters in input-field from keyboard and on paste.
    Notes:
    If "excludeKeys" option contains same characters as this option, then "excludeKeys" has priority.
    Letters should be set in upper case.
    Making difference between upper and lower case is not supported.

    Code Sample

            //Initialize
            $(".selector").igCurrencyEditor({
                 includeKeys: "ABC"
            });
     
            //Get
            var includedKeys= $(".selector").igCurrencyEditor("option", "includeKeys");
     
            //Set
            $(".selector").igCurrencyEditor("option", "includeKeys", "ABC");
           
  • &nbspinputName

    Type:
    string
    Default:
    null

    Gets sets name of (hidden) INPUT element, which value will be set to current value of editor on any change.

    Code Sample

          //Initialize 
          $(".selector").igCurrencyEditor({     
              inputName : "textField"
          });  
     
          //Get 
          var inputName = $(".selector").igCurrencyEditor("option", "inputName");  
     
          //Set 
          $(".selector").igCurrencyEditor("option", "inputName", "textField");
          
  • &nbsplistAutoComplete

    Type:
    bool
    Default:
    false

    Sets gets autocomplete.
    Value true enables and false disables auto-complete functionality to fill value of editor by a partially matching item from the listOfItems.
    If that option is enabled and entered text does not match with a part of any item in list, then original value is preserved.
    Notes:
    That option is supported only when the "type" of editor is "text" and it has effect only when listOfItems is set.
    Partial match can be validated from the beginning of an item or anywhere within an item. That is defined by the "listMatchContains" option.
    Validation can be case sensitive or not and that is defined by the "listMatchIgnoreCase" option.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                listAutoComplete : true
            });
    
            //Get
            var autocomplete = $(".selector").igCurrencyEditor("option", "listAutoComplete");
    
            //Set
            $(".selector").igCurrencyEditor("option", "listAutoComplete", true);
            
  • &nbsplistColumns

    Type:
    number
    Default:
    1

    Sets gets number of columns in drop-down list.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                listColumns : 2
            });
    
            //Get
            var listCols = $(".selector").igCurrencyEditor("option", "listColumns");
    
            //Set
            $(".selector").igCurrencyEditor("option", "listColumns", 2);
            
  • &nbsplistDropDownAsChild

    Type:
    bool
    Default:
    false

    Sets gets location of drop-down list.
    Value true will create html element for list as a child of main html element.
    Value false creates list as a child of body.
    Notes:
    That option has effect only for drop-down defined by listOfItems.
    The value of true is supported only when main (outer) html element of editor is container such as SPAN or DIV, or buttons are enabled, or renderInContainer is enabled, the theme is set.
    The value of true allows a better positioning and can be useful when editor is located in complex layout and containers with "position:fixed".

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                listDropDownAsChild : true
            });
    
            //Get
            var listChild = $(".selector").igCurrencyEditor("option", "listDropDownAsChild");
    
            //Set
            $(".selector").igCurrencyEditor("option", "listDropDownAsChild", true);      
            
  • &nbsplistItems

    Type:
    array
    Default:
    null
    Elements Type:

    Sets gets list of items which are used for drop-down list, spin, validation and auto-complete functionality.
    Items in list can be strings, numbers, dates or objects in any combination.
    If type of editor is date or datepicker and item is string, then igEditor will try to convert it to Date object and show item in display format.
    If type of editor is numeric, currency or percent and item is string, then igEditor will try to convert it to number and show item in display format.
    If item is object and it has member "text", then that member is used.
    If item is object and besides "text" has function getHtml(), then that function is used to render item in list.
    The item or item.text is used to set "value" of particular editor when list-item is selected.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                listItems : [
                    "red",
                    "blue",
                    "yellow"
                ]
            });
    
            //Get
            var items = $(".selector").igCurrencyEditor("option", "listItems");
    
            //Set
            $(".selector").igCurrencyEditor("option", "listItems", ["red", "blue", "yellow"]);
            
  • &nbsplistMatchContains

    Type:
    bool
    Default:
    false

    Sets gets list match contains.
    Value true enables and false disables validation for partial match of entered text anywhere within an item in the listOfItems or only from the beginning of an item.
    That option has effect only when "listMatchOnly" or "listAutoComplete" options are enabled.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                listMatchContains : true
            });
    
            //Get
            var listContains = $(".selector").igCurrencyEditor("option", "listMatchContains");
    
            //Set
            $(".selector").igCurrencyEditor("option", "listMatchContains", true);
            
  • &nbsplistMatchIgnoreCase

    Type:
    bool
    Default:
    true

    Sets gets case validation. Value of false enables and true disables validation for case of entries to match with items in listOfItems.
    That option has effect only when "listMatchOnly" or "listAutoComplete" options are enabled.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                listMatchIgnoreCase : false
            });
    
            //Get
            var ignoreCase = $(".selector").igCurrencyEditor("option", "listMatchIgnoreCase");
    
            //Set
            $(".selector").igCurrencyEditor("option", "listMatchIgnoreCase", false);     
            
  • &nbsplistMatchOnly

    Type:
    bool
    Default:
    false

    Set gets list match.
    Value true enables and false disables validation of keyboard entries to match with items in listOfItems.
    If that option is enabled and entered text does not match with a part of any item in list, then entry is canceled.
    Notes:
    That option is supported only when the "type" of editor is "text" and it has effect only when listOfItems is set.
    Partial match can be validated from the beginning of an item or anywhere within an item. That is defined by the "listMatchContains" option.
    Validation can be case sensitive or not and that is defined by the "listMatchIgnoreCase" option.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                listMatchOnly : true
            });
    
            //Get
            var matchOnly = $(".selector").igCurrencyEditor("option", "listMatchOnly");
    
            //Set
            $(".selector").igCurrencyEditor("option", "listMatchOnly", true);
            
  • &nbsplistMaxHeight

    Type:
    number
    Default:
    300

    Sets gets maximum height of drop-down list in pixels. If value is equal to 0 or negative, then the height of list is defined by number of items in list.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                listMaxHeight : 400
            });
    
            //Get
            var height = $(".selector").igCurrencyEditor("option", "listMaxHeight");
    
            //Set
            $(".selector").igCurrencyEditor("option", "listMaxHeight", 400);
            
  • &nbsplistWidth

    Type:
    number
    Default:
    0

    Sets gets custom width of drop-down list in pixels. If value is equal to 0 or negative, then the width of editor is used.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                listWidth : 200
            });
    
            //Get
            var width = $(".selector").igCurrencyEditor("option", "listWidth");
    
            //Set
            $(".selector").igCurrencyEditor("option", "listWidth", 200);
            
  • &nbsplocale

    Type:
    object
    Default:
    null

    Sets gets strings used for title of buttons. If the value of that option is String, such as 'bg', 'fr', etc., then editor will attempt to find and use $.ui.igEditor.locale[valueOfOption] object. Value of object should contain pairs or key:value members. Note: any sub-option of locale can appear within the main option of igEditor. In this case those values within main options will have highest priority and override corresponding value in locale.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                locale : "th"
            });
    
            //Get
            var regional = $(".selector").igCurrencyEditor("option", "locale");
    
            //Set
            $(".selector").igCurrencyEditor("option", "locale", "th");
            
  • &nbspmaxDecimals

    Type:
    number
    Default:
    null

    Sets gets the maximum number of decimal places which are used in display (no focus) state.
    Note: this option has priority over possible regional settings.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                maxDecimals: 10,
            });
    
            //Get
            var maxDecimals = $(".selector").igCurrencyEditor("option", "maxDecimals");
    
            //Set
            $(".selector").igCurrencyEditor("option", "maxDecimals", 5);
            
  • &nbspmaxLength

    Type:
    number
    Default:
    0

    Sets gets maximum length of text which can be entered by user.
    Negative values or 0 disables that behavior.
    Note: that property has no effect if "type" of editor is "mask", "date" or "datepicker".

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                maxLength : 25
            });
    
            //Get
            var textLength = $(".selector").igCurrencyEditor("option", "maxLength");
    
            //Set
            $(".selector").igCurrencyEditor("option", "maxLength", 25);
            
  • &nbspmaxValue

    Type:
    number
    Default:
    null

    Sets gets the maximum value which can be entered in editor by end user.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                maxValue : 100
            });
    
            //Get
            var maxValue = $(".selector").igCurrencyEditor("option", "maxValue");
    
            //Set
            $(".selector").igCurrencyEditor("option", "maxValue", 100);
            
  • &nbspminDecimals

    Type:
    number
    Default:
    null

    Sets gets the minimum number of decimal places which are used in display (no focus) state.
    If number of digits in fractional part of number is less than the value of this option, then the "0" characters are used to fill missing digits.
    Note: this option has priority over possible regional settings.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                minDecimals: 5,
            });
    
            //Get
            var minDecimals = $(".selector").igCurrencyEditor("option", "minDecimals");
    
            //Set
            $(".selector").igCurrencyEditor("option", "minDecimals", 3);
            
  • &nbspminValue

    Type:
    number
    Default:
    null

    Sets gets the minimum value which can be entered in editor by end user.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                minValue : 10
            });
    
            //Get
            var minValue = $(".selector").igCurrencyEditor("option", "minValue");
    
            //Set
            $(".selector").igCurrencyEditor("option", "minValue", 10);
            
  • &nbspnegativePattern

    Type:
    string
    Default:
    null

    Sets gets the pattern for negative numeric values, which is used in display (no focus) state.
    The "$" flag represents "numericSymbol".
    The "n" flag represents the value of number. The "-" and "()" flags are static part of pattern.
    Note: this option has priority over possible regional settings.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                negativePattern : "- &nbsp n"
            });
            
            //Get
            var pattern = $(".selector").igCurrencyEditor("option", "negativePattern");
            
            //Set
            $(".selector").igCurrencyEditor("option", "negativePattern", "- &nbsp n");
          
  • &nbspnegativeSign

    Type:
    string
    Default:
    null

    Sets gets the character, which is used for negative numeric values.
    Note: this option has priority over possible regional settings.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                negativeSign : "-"
            });
    
            //Get
            var negativeSign = $(".selector").igCurrencyEditor("option", "negativeSign");
    
            //Set
            $(".selector").igCurrencyEditor("option", "negativeSign", "-");
            
  • &nbspnullable

    Type:
    bool
    Default:
    true

    Sets gets ability of numeric and date editors to prevent null value.
    If that option is disabled, and editor has no value, then value of numeric editor is set to 0 (or minValue/maxValue) and value of date editor is set to today date (or minValue/maxValue).

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                nullable : false
            });
    
            //Get
            var nullable = $(".selector").igCurrencyEditor("option", "nullable");
    
            //Set
            $(".selector").igCurrencyEditor("option", "nullable", false);
            
  • &nbspnullText

    Type:
    string
    Default:
    null

    Sets gets text which appears in editor when editor has no focus and "value" in editor is null or empty string.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                nullText : "Enter Value"
            });
    
            //Get
            var nullText = $(".selector").igCurrencyEditor("option", "nullText");
    
            //Set
            $(".selector").igCurrencyEditor("option", "nullText", "Enter Value");
            
  • &nbspnullValue

    Type:
    number
    Default:
    null

    Sets gets the representation of null value.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                nullValue : 0
            });
    
            //Get
            var nullValue = $(".selector").igCurrencyEditor("option", "nullValue");
    
            //Set
            $(".selector").igCurrencyEditor("option", "nullValue", 0);
            
  • &nbsppositivePattern

    Type:
    string
    Default:
    null

    Sets gets the pattern for positive numeric values, which is used in display (no focus) state.
    The "$" flag represents "numericSymbol" and the "n" flag represents the value of number.
    Note: this option has priority over possible regional settings.

    Code Sample

     
                //Initialize
                $(".selector").igCurrencyEditor({
                    positivePattern : "+ &nbsp n"
                });
                
                //Get
                var pattern = $(".selector").igCurrencyEditor("option", "positivePattern");
                
                //Set
                $(".selector").igCurrencyEditor("option", "positivePattern", "+ &nbsp n");
          
  • &nbspreadOnly

    Type:
    bool
    Default:
    false

    Set gets ability to modify editor from keyboard (false) or disables keyboard (true).
    Notes:
    If the "spinOnReadOnly" is enabled, then value will be modified on spin regardless of the "readOnly".
    If the "listItems" has items and "dropDownTriggers" is defined, then value will be modified from drop-down list regardless of the "readOnly".

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                readOnly : true
            });
    
            //Get
            var readOnly = $(".selector").igCurrencyEditor("option", "readOnly");
    
            //Set
            $(".selector").igCurrencyEditor("option", "readOnly", true);
            
  • &nbspregional

    Type:
    object
    Default:
    null

    Sets gets custom regional settings for editor. If it is string, then $.ig.regional[stringValue] is assumed.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                regional: "en-US"
            });
            
            //Get
            var region = $(".selector").igCurrencyEditor("option", "regional");
            
            //Set
            $(".selector").igCurrencyEditor("option", "regional", "en-US");
          
  • &nbsprenderInContainer

    Type:
    bool
    Default:
    false

    Sets gets option to wrap input field into SPAN..
    That option can be set only on initialization and it is available only when base element is INPUT or TEXTAREA.
    If drop-down button or spin-buttons are enabled or the theme is set, then that option has no effect.
    The reason for that property is to allow vertical alignment of several igEditor controls when they are located in html inline and some of them have enabled buttons.
    If all editors are created within SPAN wrapper, then they will appear on the same line. Otherwise, editors in SPANs will be shifted 3-6 pixels above INPUT editors.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                renderInContainer : true
            });
    
            //Get
            var inContainer = $(".selector").igCurrencyEditor("option", "renderInContainer");
    
            //Set
            $(".selector").igCurrencyEditor("option", "renderInContainer", true);
            
  • &nbsprequired

    Type:
    bool
    Default:
    false

    Set gets validation for empty value in editor.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                required : true
            });
    
            //Get
            var isRequired = $(".selector").igCurrencyEditor("option", "required");
    
            //Set
            $(".selector").igCurrencyEditor("option", "required", true);
            
  • &nbspscientificFormat

    Type:
    enumeration
    Default:
    null

    Members

    • null
    • Type:object
    • scientific format is disabled.
    • E
    • Type:string
    • scientific format is enabled and the "E" character is used.
    • e
    • Type:string
    • scientific format is enabled and the "e" character is used.
    • E+
    • Type:string
    • scientific format is enabled and the "E" character is used. The "E+" is used for positive values in display mode.
    • e+
    • Type:string
    • scientific format is enabled and the "e" character is used. The "e+" is used for positive values in display mode.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                scientificFormat : "e"
            });
    
            //Get
            var scientificFormat = $(".selector").igCurrencyEditor("option", "scientificFormat");
    
            //Set
            $(".selector").igCurrencyEditor("option", "scientificFormat", "e+");
            
  • &nbspselectionOnFocus

    Type:
    enumeration
    Default:
    -1

    Sets gets behavior of selection/caret in input-field when editor gets focus.

    Members

    • select
    • Type:string
    • select all text.
    • -1
    • Type:number
    • select all text.
    • start
    • Type:string
    • set caret at the beginning of text.
    • 0
    • Type:number
    • set caret at the beginning of text.
    • end
    • Type:string
    • set caret at the end of text.
    • 1
    • Type:number
    • set caret at the end of text.
    • default
    • Type:string
    • use default behavior of browser (in case of mask, numeric and date editors it may be unreliable).
    • 2
    • Type:number
    • use default behavior of browser (in case of mask, numeric and date editors it may be unreliable).

    Code Sample

     
             //Initialize
             $(".selector").igCurrencyEditor({
             selectionOnFocus: -1
              });
     
            //Get
            var selectionOnFocus= $(".selector").igCurrencyEditor("option", "selectionOnFocus");
     
            //Set
            $(".selector").igCurrencyEditor("option", "selectionOnFocus", -1);
          
  • &nbspspinDelta

    Type:
    number
    Default:
    1

    Sets gets delta-value which is used to increment or decrement value in editor on spin events.
    In case of numeric editors, the numeric value is modified.
    In case of date editors, the value of field where caret is located is modified.
    In case of all other editors spin is applied to the items in the "listItems" and value of editor is set to an item in list.

    Code Sample

             //Initialize
             $(".selector").igCurrencyEditor({
             spinDelta: 1
             });
     
            //Get
            var spinDelta= $(".selector").igCurrencyEditor("option", "spinDelta");
     
            //Set
            $(".selector").igCurrencyEditor("option", "spinDelta", 1);
          
  • &nbspspinOnReadOnly

    Type:
    bool
    Default:
    false

    Sets gets ability to override the "readOnly" option and allow changes "value" of editor on spin events. Value false does not allow spin when "readOnly" is true.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                spinOnReadOnly : true
            });
    
            //Get
            var spin = $(".selector").igCurrencyEditor("option", "spinOnReadOnly");
    
            //Set
            $(".selector").igCurrencyEditor("option", "spinOnReadOnly", true);     
            
  • &nbspspinWrapAround

    Type:
    bool
    Default:
    false

    Sets gets ability to automatically set value in editor to opposite limit, when spin action reached minimum or maximum limit.
    In case of listOfItems, the first and the last items in list are used as minimum and maximum values.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                spinWrapAround : true
            });
    
            //Get
            var spinAround = $(".selector").igCurrencyEditor("option", "spinWrapAround");
    
            //Set
            $(".selector").igCurrencyEditor("option", "spinWrapAround", true);
            
  • &nbspsymbol

    Type:
    string
    Default:
    null

    Sets gets symbol, which is used in display (no focus) state.
    Note: this option has priority over possible regional settings.

    Code Sample

            //Initialize
            $(".selector").igCurrencyEditor({
                symbol: "*"
            });
     
            //Get
            var type= $(".selector").igCurrencyEditor("option", "symbol");
     
            //Set
            $(".selector").igCurrencyEditor("option", "symbol", "*");
            
  • &nbsptabIndex

    Type:
    number
    Default:
    null

    Gets sets value in tabIndex for editor.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                tabIndex : 3
            });
    
            //Get
            var tabIndex = $(".selector").igCurrencyEditor("option", "tabIndex");
    
            //Set
            $(".selector").igCurrencyEditor("option", "tabIndex", 3);
            
  • &nbsptextAlign

    Type:
    enumeration
    Default:
    null

    Sets gets horizontal alignment of text in editor. If that option is not set, then 'right' is used for 'numeric', 'currency' and 'percent' editors and the 'left' is used for all other types of editor.

    Members

    • null
    • Type:object
    • left
    • Type:string
    • right
    • Type:string
    • center
    • Type:string

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                textAlign : "center"
            });
    
            //Get
            var align = $(".selector").igCurrencyEditor("option", "textAlign");
    
            //Set
            $(".selector").igCurrencyEditor("option", "textAlign", "center");
            
  • &nbsptextMode

    Type:
    enumeration
    Default:
    null

    Sets gets text mode of editor such as: single-line text editor, password editor or multiline editor.

    Members

    • text
    • Type:string
    • single line text editor based on INPUT element is created.
    • password
    • Type:string
    • editor based on INPUT element is created.
    • multiline
    • Type:string
    • multiline editor based on TEXTAREA element is created. .
    • textarea
    • Type:string
    • multiline editor based on TEXTAREA element is created.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                textMode : "multiline"
            });
    
            //Get
            var mode = $(".selector").igCurrencyEditor("option", "textMode");
    
            //Set
            $(".selector").igCurrencyEditor("option", "textMode", "multiline");      
            
  • &nbsptheme

    Type:
    string
    Default:
    null

    Sets gets selector for css classes used by editor.
    That option allows replacing all default css styles of editor by custom values.
    Application should provide css classes for all members defined in the css options with "theme" selector.
    For example, if that property is set to "mytheme", then application should provide following css classes:
    .mytheme .ui-igedit-field{...};
    .mytheme .ui-igedit-focus{...};
    etc.
    Note: changing theme is not supported when base element is INPUT or TEXTAREA and fieldInContainer or button are not enabled.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                theme : "redmond"
            });
    
            //Get
            var theme = $(".selector").igCurrencyEditor("option", "theme");
    
            //Set
            $(".selector").igCurrencyEditor("option", "theme", "redmond");
            
  • &nbsptoLower

    Type:
    bool
    Default:
    false

    Sets gets ability to convert input characters to lower case (true) or keeps characters as they are (false). That option has effect only while keyboard entries and paste.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                toLower : true
            });
    
            //Get
            var toLower = $(".selector").igCurrencyEditor("option", "toLower");
    
            //Set
            $(".selector").igCurrencyEditor("option", "toLower", true);
            
  • &nbsptoUpper

    Type:
    bool
    Default:
    false

    Sets gets ability to convert input characters to upper case (true) or keeps characters as they are (false). That option has effect only while keyboard entries and paste.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                toUpper : true
            });
    
            //Get
            var toUpper = $(".selector").igCurrencyEditor("option", "toUpper");
    
            //Set
            $(".selector").igCurrencyEditor("option", "toUpper", true);
            
  • &nbsptype

    Type:
    enumeration
    Default:
    null

    Sets type of editor. If that option is not set, but the 'value' option is defined, then if type of 'value' is Number, then the 'numeric' type is used, if type of 'value' is Date, then the 'date' type is used. For all other types of 'value' the 'text' type is used. Note: if that option is set to 'datepicker', then application should ensure that css and js files used by jquery.ui.datepicker are available.

    Members

    • text
    • Type:string
    • text editor is created.
    • 0
    • Type:number
    • text editor is created (same as 'text').
    • mask
    • Type:string
    • mask editor is created.
    • 1
    • Type:number
    • mask editor is created (same as 'mask').
    • date
    • Type:string
    • date-time editor is created.
    • 2
    • Type:number
    • date-time editor is created (same as 'date').
    • datepicker
    • Type:string
    • date-picker is created.
    • 3
    • Type:number
    • date-picker is created (same as 'datepicker').
    • numeric
    • Type:string
    • numeric editor is created.
    • 4
    • Type:number
    • numeric editor is created (same as 'numeric').
    • currency
    • Type:string
    • currency editor is created.
    • 5
    • Type:number
    • currency editor is created (same as 'currency').
    • percent
    • Type:string
    • percent editor is created.
    • 6
    • Type:number
    • percent editor is created (same as 'percent').

    Code Sample

            //Initialize
            $(".selector").igCurrencyEditor({
             type: "text"
           });
     
          //Get
          var type= $(".selector").igCurrencyEditor("option", "type");
     
          //Set
          $(".selector").igCurrencyEditor("option", "type", 0);
          
  • &nbspvalidatorOptions

    Type:
    object
    Default:
    null

    Sets gets options supported by igValidator.
    In order to enable validation and use defaults, an empty object can be used.
    Note: validation rules of igValidator, such as min, max, minLength, required are not supported, but similar properties of igEditor should be used.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                validatorOptions : {
                    onblur: true,
    			    keepFocus: "once"
                }
            });
    
            //Get
            var validateOptions = $(".selector").igCurrencyEditor("option", "validatorOptions");
    
            //Set
            $(".selector").igCurrencyEditor("option", "validatorOptions", {onblur: true, keepFocus: "once"});
            
  • &nbspvalue

    Type:
    object
    Default:
    null

    Gets sets value in editor. The effect of setting/getting that option depends on type of editor and on dataMode options. That can be string, number or Date depending on type of editor. If it is used on initialization and the type option is missing, then if 'value' is Number, then 'numeric' editor is created automatically and if 'value' is Date, then the 'date' editor is created.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                value : 42
            });
    
            //Get
            var value = $(".selector").igCurrencyEditor("option", "value");
    
            //Set
            $(".selector").igCurrencyEditor("option", "value", 42);      
            
  • &nbspwidth

    Type:
    number
    Default:
    null

    Sets gets width of editor in pixels.
    Only positive values have effect. If that option is not set, then value of style.width of base html element will be used automatically. However, that value should be in the px units.

    Code Sample

     
            //Initialize
            $(".selector").igCurrencyEditor({
                width : 200
            });
    
            //Get
            var width = $(".selector").igCurrencyEditor("option", "width");
    
            //Set
            $(".selector").igCurrencyEditor("option", "width", 200);
            

For more information on how to interact with the NetAdvantage for jQuery controls events, refer to
Using Events in NetAdvantage for jQuery

Show Details
  • &nbspblur

    Cancellable:
    false

    Event which is raised when input field of editor loses focus.
    Function takes argument evt.
    Use evt.originalEvent to obtain reference to event of browser.

    Code Sample

              $(document).delegate(".selector", "igcurrencyeditorblur", function (evt) {
    
                  //return browser event
                  evt.originalEvent;
              });
    
              //Initialize
              $(".selector").igCurrencyEditor({
                  blur: function (evt) {
                  ...
                  }
              });
          
  • &nbspbuttonClick

    Cancellable:
    false

    Event which is raised when button was clicked by mouse.
    Function takes argument evt.
    Use evt.originalEvent to obtain reference to event of browser.

    Code Sample

               $(document).delegate(".selector", "igcurrencyeditorbuttonclick", function (evt) {
                    
                  //return browser event
                  evt.originalEvent;
              });
              
              //Initialize
              $(".selector").igCurrencyEditor({
                  buttonClick: function (evt) {
                  ...
                  }
              });
            
  • &nbspfocus

    Cancellable:
    false

    Event which is raised when input field of editor gets focus.
    Function takes argument evt.
    Use evt.originalEvent to obtain reference to event of browser.

    Code Sample

                 $(document).delegate(".selector", "igcurrencyeditorfocus", function (evt) {
                      
                    //return browser event
                    evt.originalEvent;
                });
                
                //Initialize
                $(".selector").igCurrencyEditor({
                    focus: function (evt) {
                    ...
                    }
                });
              
  • &nbsphideDropDown

    Cancellable:
    true

    Event which is raised before drop-down list or calendar is opened.
    Function takes argument evt and ui.
    Use evt.originalEvent to obtain reference to event of browser.
    Use ui.value to obtain reference to the selected item in list or Date in calendar.
    If ui.value is not null and not undefined, that it means that drop-down was closed due to selection from drop-down list or from calendar.
    Otherwise, drop-down was closed due to lost focus or Esc key press.
    Return false in order to cancel hide action and keep drop-down visible.
    It is not recommended to cancel that action on blur event.
    Note: In case of calendar of datepicker, the evt or evt.originalEvent can be null. That happens if calendar was closed on blur or by Esc key.
    Returning the false in this situation will not prevent closing drop-down calendar.

    Code Sample

              $(document).delegate(".selector", "igcurrencyeditorhidedropdown", function (evt, ui) {
    
                  //return browser event
                  evt.originalEvent;
    
                  //return true if the drop down is closed due to selection and false if the drop down is closed due to losing focus or pressing Esc
                  ui.value;
              });
    
              //Initialize
              $(".selector").igCurrencyEditor({
                  hideDropDown: function (evt, ui) {...
                  }
              });
            
  • &nbspinvalidValue

    Cancellable:
    false

    Event which is raised on lost focus when editor contains invalid value. That event is available for all editors besides default "text" type editor.
    Function takes arguments evt and ui.
    Use ui.value to obtain suggested value.
    Set ui.value to change suggested value.
    If type of editor is numeric, currency, percent, date or datepicker, then ui.text contains actual text entered by user.
    If type of editor is numeric, currency or percent, then the ui.reason may have following flags: "null", "format" or "limit".
    If type of editor is date or datepicker, then ui contains following additional members:
    ui.reason may have following flags: "null", "dayOfMonth", "numberOfFields", "limit" or "invalid";
    ui.year - year of entered date;
    ui.month - month of entered date;
    ui.day - day of entered date;
    ui.hours - hours of entered date;
    ui.minutes - minutes of entered date;
    ui.seconds - seconds of entered date;
    ui.milliseconds - milliseconds of entered date.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditorinvalidvalue", function (evt, ui) {
              //return browser event
              evt.originalEvent;
    
              //obtains the suggested value
              ui.value;
              //if type is numeric, currency, percent, date or datepicker contains actual text entered by user
              ui.text;
    
              //if editor is date or datepicker you have these additional members:
        
              //may have following flags: "null", "dayOfMonth", "numberOfFields", "limit", "invalid"
              ui.reason;
              //year of entered date
              ui.year;
              //month of entered date
              ui.month;
              //day of entered date
              ui.day;
              //hours of entered date
              ui.hours;
              //minutes of entered date
              ui.minutes;
              //seconds of entered date
              ui.seconds;
              //milliseconds of entered date
              ui.milliseconds;
          });
    
          //Initialize
          $(".selector").igCurrencyEditor({
              invalidValue: function (evt, ui) {
              ...
              }
          });
                
  • &nbspkeydown

    Cancellable:
    true

    Event which is raised on keydown event.
    Return false in order to cancel key action.
    Function takes arguments evt and ui.
    Use ui.key to obtain value of keyCode.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditorkeydown", function (evt, ui) {
    
              //use to obtain value of keyCode
              ui.key;
          });
    
          //Initialize
          $(".selector").igCurrencyEditor({
              keydown: function (evt, ui) {
              ...
              }
          });
          
  • &nbspkeypress

    Cancellable:
    true

    Event which is raised on keypress event.
    Return false in order to cancel key action.
    Function takes arguments evt and ui.
    Use ui.key to obtain value of keyCode.
    Set ui.key to another character which will replace original entry.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditorkeypress", function (evt, ui) {
    
                //use to obtain value of keyCode
                ui.key;
                //set the ui.key to "A" -a cahracter which will replace the original entry
                ui.key = 65;
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                keypress: function (evt, ui) {
                ...
                }
            });       
            
  • &nbspkeyup

    Cancellable:
    false

    Event which is raised on keyup event.
    Function takes arguments evt and ui.
    Use ui.key to obtain value of keyCode.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditorkeyup", function (evt, ui) {
    
                //use to obtain value of keyCode
                ui.key;
    
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                keyup: function (evt, ui) {
                ...
                }
            });
            
  • &nbsplistSelected

    Cancellable:
    false

    Event which is raised after list item was selected.
    Function takes arguments evt and ui.
    Use evt.originalEvent to obtain reference to event of browser.
    Use ui.index to get new selected index.
    Use ui.oldIndex to get old selected index.
    Use ui.item to get reference to new selected item.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditorlistselected", function (evt, ui) {
    
                //return browser event
                evt.originalEvent;
                //gets the new selected index
                ui.index;
                //gets the old selected index
                ui.oldIndex;
                //gets reference to the new selected item
                ui.item;
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                listselected: function (evt, ui) {
                ...
                }
            });
            
  • &nbsplistSelecting

    Cancellable:
    true

    Event which is raised before list item is selected.
    Return false in order to cancel select action.
    Function takes arguments evt and ui.
    Use evt.originalEvent to obtain reference to event of browser.
    Use ui.index to get new selected index.
    Use ui.oldIndex to get old selected index.
    Use ui.item to get reference to new selected item.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditorlistselecting", function (evt, ui) {
    
                //return browser event
                evt.originalEvent;
                //gets the new selected index
                ui.index;
                //gets the old selected index
                ui.oldIndex;
                //gets reference to the new selected item
                ui.item;
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                listselecting: function (evt, ui) {
                ...
                }
            });        
            
  • &nbspmousedown

    Cancellable:
    false

    Event which is raised on mousedown at any part of editor including drop-down list.
    Function takes arguments evt and ui.
    Use ui.elementType to obtain type of html element under mouse, such as field, button, spinUpper, spinLower or item#.
    Use ui.id and ui.elementType to obtain flag which represents html element under mouse.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditormousedown", function (evt, ui) {
    
    
                //obtains type of html element under mouse, such as field, button, spinUpper, spinLower or item#.
                ui.elementType;
    
                //obtains id of html element under mouse, such as field, button, spinUpper, spinLower or item#.
                ui.id;
    
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                mousedown: function (evt, ui) {
                ...
                }
            });
            
  • &nbspmouseleave

    Cancellable:
    false

    Event which is raised on mouseleave at any part of editor including drop-down list.
    Function takes arguments evt and ui.
    Use ui.elementType to obtain type of html element under mouse, such as field, button, spinUpper, spinLower or item#.
    Use ui.id and ui.elementType to obtain flag which represents html element under mouse.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditormouseleave", function (evt, ui) {
    
    
                //obtains type of html element under mouse, such as field, button, spinUpper, spinLower or item#.
                ui.elementType;
    
                //obtains id of html element under mouse, such as field, button, spinUpper, spinLower or item#.
                ui.id;
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                mouseleave: function (evt, ui) {
                ...
                }
            });
            
  • &nbspmousemove

    Cancellable:
    false

    Event which is raised on mousemove at any part of editor including drop-down list.
    Function takes arguments evt and ui.
    Use ui.elementType to obtain type of html element under mouse, such as field, button, spinUpper, spinLower or item#.
    Use ui.id and ui.elementType to obtain flag which represents html element under mouse.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditormousemove", function (evt, ui) {
    
    
                //obtains type of html element under mouse, such as field, button, spinUpper, spinLower or item#.
                ui.elementType;
    
                //obtains id of html element under mouse, such as field, button, spinUpper, spinLower or item#.
                ui.id;
    
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                mousemove: function (evt, ui) {
                ...
                }
            });
            
  • &nbspmouseover

    Cancellable:
    false

    Event which is raised on mouseover at any part of editor including drop-down list.
    Function takes arguments evt and ui.
    Use ui.elementType to obtain type of html element under mouse, such as field, button, spinUpper, spinLower or item#.
    Use ui.id and ui.elementType to obtain flag which represents html element under mouse.

    Code Sample

          $(document).delegate(".selector", "igcurrencyeditormouseover", function (evt, ui) {
    
              //obtains type of html element under mouse, such as field, button, spinUpper, spinLower or item#.
              ui.elementType;
    
              //obtains id of html element under mouse, such as field, button, spinUpper, spinLower or item#.
              ui.id;
    
          });
    
          //Initialize
          $(".selector").igCurrencyEditor({
              mouseover: function (evt, ui) {
              ...
              }
          });
          
  • &nbspmouseup

    Cancellable:
    false

    Event which is raised on mouseup at any part of editor including drop-down list.
    Function takes arguments evt and ui.
    Use ui.elementType to obtain type of html element under mouse, such as field, button, spinUpper, spinLower or item#.
    Use ui.id and ui.elementType to obtain flag which represents html element under mouse.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditormouseup", function (evt, ui) {
    
    
                //obtains type of html element under mouse, such as field, button, spinUpper, spinLower or item#.
                ui.elementType;
    
                //obtains id of html element under mouse, such as field, button, spinUpper, spinLower or item#.
                ui.id;
    
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                mouseup: function (evt, ui) {
                ...
                }
            });
            
  • &nbspshowDropDown

    Cancellable:
    true

    Event which is raised before drop-down list or calendar is opened.
    Return false in order to cancel drop-down action.
    Function takes argument evt.
    Use evt.originalEvent to obtain reference to event of browser.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditorshowdropdown", function (evt) {
    
                //return browser event
                evt.originalEvent;
    
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                showDropDown: function (evt) {
                ...
                }
            });
            
  • &nbspspin

    Cancellable:
    true

    Event which is raised on spin event.
    Return false in order to cancel spin.
    Function takes arguments evt and ui.
    Use ui.delta to obtain delta for increment or decrement.
    Use ui.value to obtain the "value" of editor before spin action.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditorspin", function (evt, ui) {
    
                //gets delta for increment or decrement
                ui.delta;
                //gets the "value" of editor before spin action
                ui.value;
    
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                spin: function (evt, ui) {
                ...
                }
            });
            
  • &nbsptextChanged

    Cancellable:
    false

    Event which is raised after text in editor was changed.
    Function takes arguments evt and ui.
    Use ui.value to obtain new value and ui.oldValue to obtain old value.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditortextchanged", function (evt, ui) {
    
                //gets the new value
                ui.value;
                //gets the old value
                ui.oldValue;
    
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                textChanged: function (evt, ui) {
                ...
                }
            });
            
  • &nbspvalueChanged

    Cancellable:
    false

    Event which is raised after value in editor was changed. It can be raised on lost focus or on spin events.
    Function takes arguments evt and ui.
    Use ui.value to obtain new value and ui.oldValue to obtain old value.

    Code Sample

     
            $(document).delegate(".selector", "igcurrencyeditorvaluechanged", function (evt, ui) {
    
              //gets the new value
              ui.value;
              //gets the old value
              ui.oldValue;
    
          });
    
          //Initialize
          $(".selector").igCurrencyEditor({
              valueChanged: function (evt, ui) {
              ...
              }
          });
          
  • &nbspvalueChanging

    Cancellable:
    true

    Event which is raised before value in editor was changed.
    Return false in order to cancel change.
    It can be raised on lost focus or on spin events.
    Function takes arguments evt and ui.
    Use ui.value to obtain new value and ui.oldValue to obtain old value.

    Code Sample

            $(document).delegate(".selector", "igcurrencyeditorvaluechanging", function (evt, ui) {
    
                //gets the new value
                ui.value;
                //gets the old value
                ui.oldValue;
    
            });
    
            //Initialize
            $(".selector").igCurrencyEditor({
                valueChanging: function (evt, ui) {
                ...
                }
            });
            
  • &nbspaddListItem

    .igCurrencyEditor( "addListItem", item:object, [index:number] );
    Return Type:
    object

    Adds item to list.

    • item
    • Type:object
    • Item for list. It can be string, number or Date object.
    • index
    • Type:number
    • Optional
    • Index within current list where item is inserted. If parameter is missing or too large or negative, then item is appended to list.

    Code Sample

          $(".selector").igCurrencyEditor("addListItem", "New Item", 0);
          
  • &nbspaddListItems

    .igCurrencyEditor( "addListItems", items:object, [index:number] );
    Return Type:
    object

    Adds several items to list.

    • items
    • Type:object
    • Array of items.
    • index
    • Type:number
    • Optional
    • Index within current list where items are inserted. If parameter is missing or too large or negative, then items are appended to list.

    Code Sample

           $(".selector").igCurrencyEditor("addListItems", ["red", "blue"], 0);
           
  • &nbspclearListItems

    .igCurrencyEditor( "clearListItems" );
    Return Type:
    object

    Removes all items from list.

    Code Sample

     
            $(".selector").igCurrencyEditor("clearListItems");
          
  • &nbspdestroy

    .igCurrencyEditor( "destroy" );
    Return Type:
    object

    Destroys editor and return base element back to its pre-init state.

    Code Sample

     
          $(".selector").igCurrencyEditor("destroy");
          
  • &nbspdropDownElement

    .igCurrencyEditor( "dropDownElement" );

    Gets reference to jquery object which is used as container of drop-down.
    returnType="$" Returns reference to jquery object or null. That can be container of list items or in case of igDatePicker it can be calendar of jquery.datepicker.

    Code Sample

     
          var container = $(".selector").igCurrencyEditor("dropDownElement");
          
  • &nbspdropDownVisible

    .igCurrencyEditor( "dropDownVisible", [showHide:bool] );

    Gets sets visibility of drop-down list.
    returnType="bool|object" If parameter is defined, then returns reference to this igCombo, otherwise, returns true if drop down is visible and false if drop down is hidden.

    • showHide
    • Type:bool
    • Optional
    • Value true will show dropdown, false - hide dropdown. .

    Code Sample

     
            //Get
            var isVisible = $(".selector").igCurrencyEditor("dropDownVisible");
    
            //Set
            $(".selector").igCurrencyEditor("dropDownVisible", true);
            
  • &nbspfield

    .igCurrencyEditor( "field" );

    Gets reference to jquery object which is used as edit field.
    returnType="$" Returns reference to jquery object. That can be INPUT or TEXTAREA.

    Code Sample

     
          var field = $(".selector").igCurrencyEditor("field");
          
  • &nbspfindListItemIndex

    .igCurrencyEditor( "findListItemIndex", text:string, [ignoreCase:bool], [partial:bool], [contains:bool] );
    Return Type:
    number

    Finds index of list item by text.

    • text
    • Type:string
    • Text to search.
    • ignoreCase
    • Type:bool
    • Optional
    • Value true sets request to ignore case.
    • partial
    • Type:bool
    • Optional
    • Value true will perform partial search rather than full match.
    • contains
    • Type:bool
    • Optional
    • Value true will perform search anywhere within text of item, otherwise starts-with search is used.

    Code Sample

     
            var index = $(".selector").igCurrencyEditor("findListItemIndex", "search value", true);     
            
  • &nbspgetRegionalOption

    .igCurrencyEditor( "getRegionalOption", name:string );
    Return Type:
    string

    Gets calculated value of regional option used by numeric and date editors.

    • name
    • Type:string
    • Name of regional option, such as "monthNames", "dateLongPattern", "currencySymbol", etc.

    Code Sample

     
                var dayNames = $(".selector").igCurrencyEditor("getRegionalOption", "dayNames");
          
  • &nbspgetSelectedListItem

    .igCurrencyEditor( "getSelectedListItem" );

    Gets reference to selected item in list.
    returnType="string|number|date|object" Returns reference to selected item or null.

    Code Sample

     
          var item = $(".selector").igCurrencyEditor("getSelectedListItem");
          
  • &nbspgetSelectedText

    .igCurrencyEditor( "getSelectedText" );
    Return Type:
    string

    Gets selected text in editor.

    Code Sample

     
          var text = $(".selector").igCurrencyEditor("getSelectedText");
          
  • &nbspgetSelection

    .igCurrencyEditor( "getSelection", [start:bool] );
    Return Type:
    number

    Gets left or right edge of selection. That method can be used only when editor has focus.

    • start
    • Type:bool
    • Optional
    • If true then left edge of selection is returned. Otherwise, right edge selection is returned.

    Code Sample

          $(".selector").igCurrencyEditor("getSelection",true);
          
  • &nbspgetValueByMode

    .igCurrencyEditor( "getValueByMode", mode:string, [v:object], [getVal:object] );

    Get value in editor by dataMode.
    returnType="string|number|date|object" Returns value in editor or null.

    • mode
    • Type:string
    • The value of dataMode option supported by editor. It can be string or number. For example, in case of numeric editors that can be a number in range from -1 to 11, or string such as "text", "double", "byte", etc.
    • v
    • Type:object
    • Optional
    • Internal use only.
    • getVal
    • Type:object
    • Optional
    • Internal use only.

    Code Sample

     
            var textValue = $(".selector").igCurrencyEditor("getValueByMode", "text");      
            
  • &nbsphasFocus

    .igCurrencyEditor( "hasFocus" );
    Return Type:
    bool

    Checks if editor has focus.

    Code Sample

           
            var focus = $(".selector").igCurrencyEditor("hasFocus");
            
  • &nbsphasInvalidMessage

    .igCurrencyEditor( "hasInvalidMessage" );
    Return Type:
    bool

    Checks if invalid message is displayed.

    Code Sample

     
          var hasInvalidMessage = $(".selector").igCurrencyEditor("hasInvalidMessage");      
          
  • &nbsphide

    .igCurrencyEditor( "hide" );
    Return Type:
    object

    Hides editor.

    Code Sample

     
          $(".selector").igCurrencyEditor("hide");
          
  • &nbspisValid

    .igCurrencyEditor( "isValid" );
    Return Type:
    bool

    Checks if value in editor is value. Note: that method may fail if editor has focus (in edit mode).

    Code Sample

     
          var isValid = $(".selector").igCurrencyEditor("isValid");
          
  • &nbspmainElement

    .igCurrencyEditor( "mainElement" );

    Gets reference to jquery object which is used as top/outer element of igEditor.
    returnType="$" Returns reference to jquery object.

    Code Sample

     
          var element = $(".selector").igCurrencyEditor("mainElement");
          
  • &nbsppaste

    .igCurrencyEditor( "paste", txt:string, [flag:bool] );
    Return Type:
    object

    Paste text at location of caret. Note: method raises the "textChanged" event.

    • txt
    • Type:string
    • New text to paste.
    • flag
    • Type:bool
    • Optional
    • Internal use only.

    Code Sample

          $(".selector").igCurrencyEditor("paste","text");
          
  • &nbspremove

    .igCurrencyEditor( "remove" );
    Return Type:
    object

    Removes editor from its parent element, but keeps the rest of functionality.

    Code Sample

     
          $(".selector").igCurrencyEditor("remove");
          
  • &nbspremoveListItem

    .igCurrencyEditor( "removeListItem", item:object );
    Return Type:
    object

    Removes item from list.

    • item
    • Type:object
    • Current item in list. It can be string, number or Date object.

    Code Sample

     
          $(".selector").igCurrencyEditor("removeListItem", "red");
  • &nbspremoveListItemAt

    .igCurrencyEditor( "removeListItemAt", index:number );
    Return Type:
    object

    Removes item from list at index.

    • index
    • Type:number
    • Index of item. If it is negative number, then last item in list is removed.

    Code Sample

     
          $(".selector").igCurrencyEditor("removeListItemAt", 0);
          
  • &nbspselect

    .igCurrencyEditor( "select", [sel0:number], [sel1:number], [val:string] );
    Return Type:
    object

    Selects text in editor. If parameters are equal, then than method sets location of caret. That method has effect only when editor has focus.

    • sel0
    • Type:number
    • Optional
    • Left edge of selection. If parameter is missing, then all text is selected.
    • sel1
    • Type:number
    • Optional
    • Right edge of selection. If parameter is missing, then value of first parameter is used.
    • val
    • Type:string
    • Optional
    • Internal use only (new text).

    Code Sample

            $(".selector").igCurrencyEditor("select",1,5);
            
  • &nbspselectedListIndex

    .igCurrencyEditor( "selectedListIndex", [index:number] );
    Return Type:
    number

    Gets sets selected index of list item.

    • index
    • Type:number
    • Optional
    • Index of item.

    Code Sample

     
            //Get
            var index = $(".selector").igCurrencyEditor("selectedListIndex");
    
            //Set
            $(".selector").igCurrencyEditor("selectedListIndex", 1);
            
  • &nbspsetFocus

    .igCurrencyEditor( "setFocus", [delay:number] );
    Return Type:
    object

    Set focus to editor with delay.

    • delay
    • Type:number
    • Optional
    • Delay in milliseconds. If parameter is missing, then 0 is used. If parameter is -1, then focus is set without delay.

    Code Sample

     
          $(".selector").igCurrencyEditor("setFocus", true);
          
  • &nbspshow

    .igCurrencyEditor( "show" );
    Return Type:
    object

    Shows editor (if it was hidden).

    Code Sample

     
          $(".selector").igCurrencyEditor("show");
  • &nbspspin

    .igCurrencyEditor( "spin", delta:number );
    Return Type:
    object

    Increments of decrements value in editor according to the parameter.
    If editor has listItems, then that method increments or decrements selected index in list and sets value in editor to new selected item.
    In this case if delta is positive, then list selected index in incremented by 1 and if delta is negative then selected index is decremented by 1.

    • delta
    • Type:number
    • Value to increment or decrement current value in editor.

    Code Sample

     
          $(".selector").igCurrencyEditor("spin", 1);
          
  • &nbsptext

    .igCurrencyEditor( "text", [val:string], [flag:number] );

    Gets sets text in editor.
    returnType="string|object" Returns text in editor if parameter is undefined. Otherwise, it returns reference to this igEditor.

    • val
    • Type:string
    • Optional
    • New text for editor.
    • flag
    • Type:number
    • Optional
    • Internal use only.

    Code Sample

     
            //Get
            var text = $(".selector").igCurrencyEditor("text");
    
            //Set
            $(".selector").igCurrencyEditor("text", "new text");
            
  • &nbspvalidate

    .igCurrencyEditor( "validate", [noLabel:bool] );
    Return Type:
    bool

    Triggers validation of editor and show error message. That method has effect only when validation is enabled.

    • noLabel
    • Type:bool
    • Optional
    • Value of true will allow to skip error message if validation failed.

    Code Sample

     
          $(".selector").igCurrencyEditor("validate");
          
  • &nbspvalidator

    .igCurrencyEditor( "validator" );
    Return Type:
    object

    Gets reference to igValidator used by igEditor.

    Code Sample

              var validator = $(".selector").igCurrencyEditor("validator");
          
  • &nbspvalue

    .igCurrencyEditor( "value", [val:object] );

    Gets sets value in editor.
    returnType="string|number|date|object" Returns value in editor if parameter is undefined. Otherwise, it returns reference to this igEditor.

    • val
    • Type:object
    • Optional
    • New value for editor. It can be string, number or Date object.

    Code Sample

     
            //Get
            var editorVal = $(".selector").igCurrencyEditor("value");
    
            //Set
            $(".selector").igCurrencyEditor("value", 42);
            
  • ui-igedit-bordercolor

    Class applied to the editing element and buttons in normal state (not disabled and not focused). Default value is 'ui-igedit-bordercolor'.
  • ui-igedit-button

    Class applied to the SPAN element which represents button. Default value is 'ui-igedit-button'.
  • ui-icon-circle-close

    Class applied to the SPAN element which represents image on clear button. Default value is 'ui-icon-circle-close'.
  • ui-igedit-buttondefault ui-state-default

    Classes applied to the the SPAN element of button in default state (no focus, no mouse, no press). Default value is 'ui-igedit-buttondefault ui-state-default'.
  • ui-igedit-buttondisabled ui-state-disabled

    Classes applied to the SPAN element of button in disabled state. Default value is 'ui-igedit-buttondisabled ui-state-disabled'.
  • ui-igedit-buttonfocus ui-state-focus

    Classes applied to the SPAN element of button when editor has focus. Default value is 'ui-igedit-buttonfocus ui-state-focus'.
  • ui-igedit-buttonhover ui-state-hover

    Classes applied to the SPAN element of button in mouse-over state. Default value is 'ui-igedit-buttonhover ui-state-hover'.
  • ui-igedit-buttonimage ui-icon-triangle-1-s ui-icon

    Classes applied to the SPAN element which represents image on dropdown/clear button. Default value is 'ui-igedit-buttonimage ui-icon-triangle-1-s ui-icon'.
  • ui-igedit-buttonimagedisabled

    Class applied to the SPAN element which represents image on button in disabled state. Default value is 'ui-igedit-buttonimagedisabled'.
  • ui-igedit-buttonimagehover

    Class applied to the SPAN element which represents image on button in mouse-over state. Default value is 'ui-igedit-buttonimagehover'.
  • ui-igedit-buttonimagepressed

    Class applied to the SPAN element which represents image on button in pressed state. Default value is 'ui-igedit-buttonimagepressed'.
  • ui-igedit-buttonpressed ui-state-highlight

    Classes applied to the SPAN element of button in pressed state. Default value is 'ui-igedit-buttonpressed ui-state-highlight'.
  • ui-igedit-buttonsimagestateoverride

    Class applied to the images of buttons when editor has focus or mouse-over, but mouse-over does not belong to a particular button. Default value is 'ui-igedit-buttonsimagestateoverride'.
  • ui-igedit-disabled ui-state-disabled

    Classes applied to the editing element in disabled state. Default value is 'ui-igedit-disabled ui-state-disabled'.
  • ui-igedit-dropdown

    Class applied to the drop-down element which contains list of items or datepicker-calendar. Default value is 'ui-igedit-dropdown'.
  • ui-igedit

    Class applied to the main/top element. Default value is 'ui-igedit'.
  • ui-igedit-field

    Class applied to the editing element. Default value is 'ui-igedit-field'.
  • ui-igedit-fieldincontainer

    Class applied to the editing element when it is located in (SPAN) container. That happens when buttons are enabled, or base element is not INPUT, or renderInContainer option is enabled. Default value is 'ui-igedit-fieldincontainer'.
  • ui-igedit-focus

    Class applied to the editing element in focus state. Default value is 'ui-igedit-focus'.
  • ui-igedit-hover

    Class applied to the editing element in mouse-over state. Default value is 'ui-igedit-hover'.
  • ui-igedit-list ui-widget ui-widget-content

    Class applied to the DIV element which is used as container for dropdown list. Default value is 'ui-igedit-list ui-widget ui-widget-content'.
  • ui-igedit-listitem ui-state-default

    Class applied to the SPAN element which represents item in dropdown list. Default value is 'ui-igedit-listitem ui-state-default'.
  • ui-igedit-listitemcolumnborder

    Class applied to the SPAN elements located in columns on the right in dropdown list. That has effect only when multiple columns in list are enabled. Default value is 'ui-igedit-listitemcolumnborder'.
  • ui-igedit-listitemhover ui-state-hover

    Class applied to the Class applied to the SPAN element which represents item in dropdown list with mouse-over state. Default value is 'ui-igedit-listitemhover ui-state-hover'.
  • ui-igedit-listitemselected ui-state-highlight

    Class applied to the Class applied to the SPAN element which represents selected item in dropdown list. Default value is 'ui-igedit-listitemselected ui-state-highlight'.
  • ui-igedit-negative

    Class applied to the editing element of numeric editor when value is negative. Default value is 'ui-igedit-negative'.
  • ui-igedit-nullvalue

    Class applied to the editing element when it has no value. Default value is 'ui-igedit-nullvalue'.
  • ui-igedit-spinbutton

    Class applied to the SPAN element which represents spin button. Default value is 'ui-igedit-spinbutton'.
  • ui-igedit-spinbuttonimage

    Class applied to the SPAN element which represents image on spin button. Default value is 'ui-igedit-spinbuttonimage'.
  • ui-igedit-spinholder

    Class applied to the SPAN element which contains spin buttons. Default value is 'ui-igedit-spinholder'.
  • ui-igedit-spinlowerimage ui-icon-triangle-1-s ui-icon

    Class applied to the SPAN element which represents image on lower spin button. Default value is 'ui-igedit-spinlowerimage ui-icon-triangle-1-s ui-icon'.
  • ui-igedit-spinlowerimagedisabled

    Class applied to the SPAN element which represents image on lower spin button in disabled state. Default value is 'ui-igedit-spinlowerimagedisabled'.
  • ui-igedit-spinlowerimagehover

    Class applied to the SPAN element which represents image on lower spin button in mouse-over state. Default value is 'ui-igedit-spinlowerimagehover'.
  • ui-igedit-spinlowerimagepressed

    Class applied to the SPAN element which represents image on lower spin button in pressed state. Default value is 'ui-igedit-spinlowerimagepressed'.
  • ui-igedit-spinupperimage ui-icon-triangle-1-n ui-icon

    Class applied to the SPAN element which represents image on upper spin button. Default value is 'ui-igedit-spinupperimage ui-icon-triangle-1-n ui-icon'.
  • ui-igedit-spinupperimagedisabled

    Class applied to the SPAN element which represents image on upper spin button in disabled state. Default value is 'ui-igedit-spinupperimagedisabled'.
  • ui-igedit-spinupperimagehover

    Class applied to the SPAN element which represents image on upper spin button in mouse-over state. Default value is 'ui-igedit-spinupperimagehover'.
  • ui-igedit-spinupperimagepressed

    Class applied to the SPAN element which represents image on upper spin button in pressed state. Default value is 'ui-igedit-spinupperimagepressed'.
  • ui-igedit-textarea

    Class applied to the TEXTAREA element. Default value is 'ui-igedit-textarea'.