Ignite UI API Reference

Gets sets ability to enter and keep custom value in field.
Notes for enabled:
1. The matching item in list becomes active, but not selected.
2. If load on demand or dataBindOnOpen is enabled, then after the load, the matching item can be selected.
3. If text option was not set, the selectedItems contain only one item and that item was not found in dataSource, then the "value" member of that selected item will be used as the custom text.

 
//Initialize 
$(".selector").igCombo({     
    allowCustomValue : true
});  

//Get 
var allowCustom = $(".selector").igCombo("option", "allowCustomValue");  

//Set 
$(".selector").igCombo("option", "allowCustomValue", true);       

Gets sets duration of hide drop-down list animation in milliseconds.

 
//Initialize 
$(".selector").igCombo({     
    animationHideDuration : 25
});  

//Get 
var animationDuration = $(".selector").igCombo("option", "animationHideDuration");  

//Set 
$(".selector").igCombo("option", "animationHideDuration", 25);   

Gets sets duration of show drop-down list animation in milliseconds.

 
//Initialize 
$(".selector").igCombo({     
    animationShowDuration : 25
});  

//Get 
var animationDuration = $(".selector").igCombo("option", "animationShowDuration");  

//Set 
$(".selector").igCombo("option", "animationShowDuration", 25);      

Gets sets ability to autocomplete field from matching item in list.
Note: if "autoComplete" option is enabled, then the "startsWith" is used for "filteringCondition" option.

 
//Initialize 
$(".selector").igCombo({     
    autoComplete : true
});  

//Get 
var autoComplete = $(".selector").igCombo("option", "autoComplete");  

//Set 
$(".selector").igCombo("option", "autoComplete", true);        

Gets sets collection (array or dictonary) of javascript objects which allows to configure dataSource and other properties of this igCombo.
The key in dictionary should represent selected value in parent igCombo. If value in parent igCombo is integer, then array can be used instead of dictionary.
Each item in collection may contain dataSource, or an object, which should have following members.
dataSource: reference to dataSource,
valueKey: optional override for valueKey of this igCombo,
textKey: optional override for textKey of this igCombo,
dataSourceUrl: optional dataSourceUrl when dataSource is not set.
Note: that option has effect only when "parentCombo" option is set and it has priority over "parentComboKey".

 
      	dsCountryCascading = [
			{ txtCountry: "United States", valCountry: "US" },
			{ txtCountry: "Bulgaria", valCountry: "BG" },
		];
		dsStatesUS = [
			{ state: "New Jersey"},
			{ state: "California"},
			{ state: "Ilionois"},
			{ state: "New York"},
			{ state: "Florida"}
		];
		dsDistrictBG = [
			{ district: "Sofia"},
			{ district: "Plovdiv"},
			{ district: "Varna"},
			{ district: "Yambol"}
		];
        // Cascading Data Source as dictionary
		dsCascStatesDistricts = {
			"US": { dataSource: dsStatesUS, textKey: "state" },
			"BG": { dataSource: dsDistrictBG, textKey: "district" }
		};
        
        dsParent = [
            { textKey: "Local", valKey: 0 },
            { textKey: "Remote", valKey: 1}
        ]
        // Cascading Data Source as an array. Note that this is only possible if parent value key is integer.
        dsCascRemoteLocal = [
            { dataSource: localDS, valueKey: “Identificator” }
            { dataSourceUrl: http://odata.netflix.com/Catalog/Titles?$filter=Name%20eq%20%27The%20Name%20of%20The%20Rose%27&$format=json, valueKey: “Id”}
        ]
        
        //Initialize 
        $(".selector").igCombo({     
            cascadingDataSources : dsCascStatesDistricts
        }); 
        
        //Get 
        var ds = $(".selector").igCombo("option", "cascadingDataSources");  

        //Set 
        $(".selector").igCombo("option", "cascadingDataSources", dsCascRemoteLocal);
      

Gets sets ability to use case sensitive or ignore case searching for matches defined by "renderMatchItems" and "filteringCondition" options.

 
//Initialize 
$(".selector").igCombo({     
    caseSensitive : true
});  

//Get 
var caseSensitive = $(".selector").igCombo("option", "caseSensitive");  

//Set 
$(".selector").igCombo("option", "caseSensitive", true);          

Gets sets title for html element which represend clear button. That is an override for the $.ig.Combo.locale.clearButtonTitle.

 
//Initialize 
$(".selector").igCombo({     
    clearButtonTitle : "Clear value"
});  

//Get 
var title = $(".selector").igCombo("option", "clearButtonTitle");  

//Set 
$(".selector").igCombo("option", "clearButtonTitle", "Clear value");        

Preserves the selected items, even the text in the input is not available in the drop down items.
This options is useful, when we have the 'allowCustomValue' option enabled. Then we can have a text in the input that is not related to the selected item or items.
E.g. We select 2 drop down items, then we put custom text in the input "2 items selected", replacing existing text - both values separated with comma.
If you don't want to loose the selected items on blur, 'clearSelectionOnBlur' should be set to false.
If you want to clear the selected items when none of them is matching the text in the input, then set 'clearSelectionOnBlur' to true.

 
//Initialize 
$(".selector").igCombo({     
    clearSelectionOnBlur : true
});  

//Get 
var clearSelection = $(".selector").igCombo("option", "clearSelectionOnBlur");  

//Set 
$(".selector").igCombo("option", "clearSelectionOnBlur", true);       

Sets gets ability to close drop-down list when control loses focus. Note: if application disables that option, then it is responsible for closing drop-down list.

//Initialize 
$(".selector").igCombo({     
    closeDropDownOnBlur: false
});  

//Get 
var closeDropDownOnBlur = $(".selector").igCombo("option", "closeDropDownOnBlur");

//Set 
$(".selector").igCombo("option", "closeDropDownOnBlur", false);

Sets gets ability to close drop-down list when item is the list is selected.

//Initialize 
$(".selector").igCombo({     
    closeDropDownOnSelect: false
});  

//Get 
var closeDropDownOnSelect = $(".selector").igCombo("option", "closeDropDownOnSelect");

//Set 
$(".selector").igCombo("option", "closeDropDownOnSelect", false);
      

Gets sets ability to load data (bind dataSource) at the time when drop-down list is opened.
Notes:
1. Before data is loaded the selectedItems, value, text and other options/methods will fail.
2. Initial selection, text and value will have no effect.
3. If on first drop-down the dataSource does not contain selectedItems (for example, enabled load on demand), then selection will be destroyed.
4. To get around with values, an application may enable "allowCustomValue" option and use the "text" option instead of "selectedItems".

//Initialize 
$(".selector").igCombo({     
    dataBindOnOpen: true
});  

//Get 
var closeDropDownOnSelect = $(".selector").igCombo("option", "dataBindOnOpen");

//Set 
$(".selector").igCombo("option", "dataBindOnOpen", true);
      

Gets sets a valid data source accepted by $.ig.DataSource, or an instance of an $.ig.DataSource itself.
Note: if it is set to string and "dataSourceType" option is not set, then $.ig.JSONPDataSource is used.

 
//Initialize 
$(".selector").igCombo({     
    dataSource : data
});  

//Get 
var data = $(".selector").igCombo("option", "dataSource");  
   

Gets sets data source type (such as "json", "xml", etc). Please refer to the documentation of $.ig.DataSource and its type property.

 
//Initialize 
$(".selector").igCombo({     
    dataSourceType : "xml"
});  

//Get 
var dataType = $(".selector").igCombo("option", "dataSourceType");  
    

Gets sets url which is used for sending JSON on request for remote filtering (MVC for example). That option is required when load on demand is enabled and its type is remote.

 
//Initialize 
$(".selector").igCombo({     
    dataSourceUrl : "data.svc"
});  

//Get 
var dataUrl = $(".selector").igCombo("option", "dataSourceUrl");  
       

Gets sets ability to append container of drop-down list to the body or to the parent of combo.

 
//Initialize 
$(".selector").igCombo({     
    dropDownAsChild : true
});  

//Get 
var isChild = $(".selector").igCombo("option", "dropDownAsChild");  

//Set 
$(".selector").igCombo("option", "dropDownAsChild", true);         

Gets sets title for html element which represend drop-down button. That is an override for the $.ig.Combo.locale.dropDownButtonTitle.

 
//Initialize 
$(".selector").igCombo({     
    dropDownButtonTitle : "Open Dropdown"
});  

//Get 
var title = $(".selector").igCombo("option", "dropDownButtonTitle");  

//Set 
$(".selector").igCombo("option", "dropDownButtonTitle", "Open Dropdown");           

Gets sets maximum height of drop-down list in pixels.

 
//Initialize 
$(".selector").igCombo({     
    dropDownMaxHeight : 25
});  

//Get 
var height = $(".selector").igCombo("option", "dropDownMaxHeight");  

//Set 
$(".selector").igCombo("option", "dropDownMaxHeight", 25);         

Gets sets minimum height of drop-down list in pixels.

 
//Initialize 
$(".selector").igCombo({     
    dropDownMinHeight : 25
});  

//Get 
var height = $(".selector").igCombo("option", "dropDownMinHeight");  

//Set 
$(".selector").igCombo("option", "dropDownMinHeight", 25);        

Sets gets ability to show drop-down list when combo gets focus.

 
//Initialize 
$(".selector").igCombo({     
    dropDownOnFocus : true
});  

//Get 
var dropOnFocus = $(".selector").igCombo("option", "dropDownOnFocus");  

//Set 
$(".selector").igCombo("option", "dropDownOnFocus", true);        

Gets sets width of drop-down list in pixels. If it is 0, then width of combo is used.

 
//Initialize 
$(".selector").igCombo({     
    dropDownWidth : 200
});  

//Get 
var width = $(".selector").igCombo("option", "dropDownWidth");  

//Set 
$(".selector").igCombo("option", "dropDownWidth", 200);        

Gets sets ability to render focus/active item in drop-down list.
Notes: If list had active item and it was closed and opened again, then active item is reset to the first selected item.
It there is no selected items, then active item is not reset.
If that option is disabled, then functionality becomes similar to the SELECT html element.
For example, if list is opened then action keys like up/down arrows/page, home and end will change selected item instead of active item.
If list is closed, then up/down arrow keys will change selected item and update text field for it.
If list is opened, then text-changes in field will select matching item in list instead of activating it.

 
//Initialize 
$(".selector").igCombo({     
    enableActiveItem : false
});  

//Get 
var enableActiveItem = $(".selector").igCombo("option", "enableActiveItem");  

//Set 
$(".selector").igCombo("option", "enableActiveItem", false);         

Gets sets ability to show a button which allows to clear field.
Button is automatically hidden when field is empty and it automatically appears when field is not empty.

 
//Initialize 
$(".selector").igCombo({     
    enableClearButton : false
});  

//Get 
var enableClearButton = $(".selector").igCombo("option", "enableClearButton");  

//Set 
$(".selector").igCombo("option", "enableClearButton", false);         

Gets sets style.display "block" or "inline-block" applied to main/outer html element.

 
//Initialize 
$(".selector").igCombo({     
    enableDisplayBlock : true
});  

//Get 
var enableDisplayBlock = $(".selector").igCombo("option", "enableDisplayBlock");  

//Set 
$(".selector").igCombo("option", "enableDisplayBlock", true);       

Gets sets url key name that specifies how the remote filtering expressions will be encoded for remote requests, e.g. &filter('col') = startsWith. Default is OData.

 
//Initialize 
$(".selector").igCombo({     
    filterExprUrlKey : "filter"
});  

//Get 
var filterKey = $(".selector").igCombo("option", "filterExprUrlKey");  

//Set 
$(".selector").igCombo("option", "filterExprUrlKey", "filter");       

Gets sets condition used for filtering.
Notes:
If the "autoComplete" option is enabled, then the "startsWith" is used regardless of value for this option.
If "parentComboKey" option is set, then data is filtered internally, therefore, filtering while changing text in editor is not available.

 
//Initialize 
$(".selector").igCombo({     
    filteringCondition : "startsWith"
});  

//Get 
var condition = $(".selector").igCombo("option", "filteringCondition");  

//Set 
$(".selector").igCombo("option", "filteringCondition", "startsWith");       

Gets sets type of filtering. Notes: If "parentComboKey" option is set, then data is filtered internally, therefore, filtering while changing text in editor is not available; though, that option will still define type of filtering used by cascading functionality. If this option is set to "remote", then the "css.waitFiltering" is applied to combo and its drop-down list.

 
//Initialize 
$(".selector").igCombo({     
    filteringType : "remote"
});  

//Get 
var filterType = $(".selector").igCombo("option", "filteringType");  

//Set 
$(".selector").igCombo("option", "filteringType", "remote");       

Gets sets template used to render footer in drop-down list. Note: template is rendered inside of DIV html element.

 
//Initialize 
$(".selector").igCombo({     
    footerTemplate : "<h4>Footer</h4>"
});  

//Get 
var template = $(".selector").igCombo("option", "footerTemplate");  

//Set 
$(".selector").igCombo("option", "footerTemplate", "<h4>Footer</h4>");    

Gets sets format which is applied to items in list. Values null or false will disable format.
Value "auto" or true will use automatic format for Date and number objects.
Value null or false will disable automatic format.
Custom values can be something like "currency", "percent", "dateLong", "time", "MMM-dd-yyyy H:mm tt", etc.
However, custom format should be valid for a specific data type in "textKey" column.

 
//Initialize 
$(".selector").igCombo({     
    format : "auto"
});  

//Get 
var template = $(".selector").igCombo("option", "format");  

//Set 
$(".selector").igCombo("option", "format", "auto");       

Gets sets template used to render header in drop-down list. Template is rendered inside of DIV html element.

 
//Initialize 
$(".selector").igCombo({     
    headerTemplate : "<h4>Header</h4>"
});  

//Get 
var template = $(".selector").igCombo("option", "headerTemplate");  

//Set 
$(".selector").igCombo("option", "headerTemplate", "<h4>Header</h4>");       

Gets sets height of combo. The numeric and string values (valid html units for size) are supported. It includes %, px, em and other units.

 
//Initialize 
$(".selector").igCombo({     
    height : "25px"
});  

//Get 
var height = $(".selector").igCombo("option", "height");  

//Set 
$(".selector").igCombo("option", "height", "25px");        

Gets sets name of (hidden) INPUT element, which value will be set to values of selected items separated by "," character on any change in igCombo.

      //Initialize 
$(".selector").igCombo({     
    inputName : "textField"
});  

//Get 
var inputName = $(".selector").igCombo("option", "inputName");  

//Set 
$(".selector").igCombo("option", "inputName", "textField");
      

Gets sets separator between items in field. Note: that option has effect only when "multiSelection" option is enabled.

 
//Initialize 
$(".selector").igCombo({     
    itemSeparator : ";"
});  

//Get 
var itemSeparator = $(".selector").igCombo("option", "itemSeparator");  

//Set 
$(".selector").igCombo("option", "itemSeparator", ";");    

Gets sets template used to render an item in list. Notes:
1. The jquery.tmpl.js of Microsoft is used and application should provide supported syntax for content.
2. Template is rendered inside of LI html element.
So, application should consider restriction for layout: do not use "block" html elements and in case of absolutely positioned elements,
they should not overlap with checkbox icons.

 
//Initialize 
$(".selector").igCombo({     
    itemTemplate: "<span class="movieTitle">${Name}</span><img src="${Url}" />"
});  

//Get 
var template = $(".selector").igCombo("option", "itemTemplate");  
  

Gets sets container of variables which define load on demand functionality.
Notes:
That option has effect only when data is loaded remotely using dataSourceUrl.
If the parentComboKey is set, then that option is not supported.
Selection is supported only for already loaded items.

//Initialize 
$(".selector").igCombo({     
    loadOnDemandSettings: {
                    enabled: true,
                    pageSize: 55
                }
});  

//Get 
var loadOnDemandSettings = $(".selector").igCombo("option", "loadOnDemandSettings");
//  Get the enabled state
loadOnDemandSettings.enabled;
//  Get the drop down list page size
loadOnDemandSettings.pageSize;

//Set 
$(".selector").igCombo("option", "loadOnDemandSettings", { enabled: true, pageSize: 55 });
      

• enabled

  Type:

  bool

  Default:

  false

  Gets sets option to enable load on demand.

  Code Sample

  //Initialize 
  $(".selector").igCombo({     
      loadOnDemandSettings: { enabled: true }
  });  
  
  //Get 
  var loadOnDemandSettings = $(".selector").igCombo("option", "loadOnDemandSettings");
  //  Get the enabled state
  loadOnDemandSettings.enabled;
  
  //Set 
  $(".selector").igCombo("option", "loadOnDemandSettings", { enabled: true });
            

• pageSize

  Type:

  number

  Default:

  null

  Gets sets number of records loaded on each request.

  Code Sample

  //Initialize 
  $(".selector").igCombo({     
      loadOnDemandSettings: {
                      enabled: true,
                      pageSize: 55
                  }
  });  
  
  //Get 
  var loadOnDemandSettings = $(".selector").igCombo("option", "loadOnDemandSettings");
  //  Get the drop down list page size
  loadOnDemandSettings.pageSize;
  
  //Set 
  $(".selector").igCombo("option", "loadOnDemandSettings", { enabled: true, pageSize: 55 });
            

Sets gets functionality mode.

 
//Initialize 
$(".selector").igCombo({     
    mode : "readonlylist"
});  

//Get 
var mode = $(".selector").igCombo("option", "mode");  

//Set 
$(".selector").igCombo("option", "mode", "readonlylist");        

Gets sets ability to select multiple items in list and enter multiple items in field which are separated by the 'itemSeparator'.

 
//Initialize 
$(".selector").igCombo({     
    multiSelection : "onWithCheckboxes"
});  

//Get 
var multiSelection = $(".selector").igCombo("option", "multiSelection");  

//Set 
$(".selector").igCombo("option", "multiSelection", "onWithCheckboxes"); 

Gets sets text of list item for condition when "filteringType" option is enabled and no match was found. That is an override for the $.ig.Combo.locale.noMatchFoundText.

 
//Initialize 
$(".selector").igCombo({     
    noMatchFoundText : "Please try again"
});  

//Get 
var text = $(".selector").igCombo("option", "noMatchFoundText");  

//Set 
$(".selector").igCombo("option", "noMatchFoundText", "Please try again"); 

Sets gets text which appears in field in no-focus state and there is no value.

 
//Initialize 
$(".selector").igCombo({     
    nullText : "Please enter text"
});  

//Get 
var text = $(".selector").igCombo("option", "nullText");  

//Set 
$(".selector").igCombo("option", "nullText", "Please enter text"); 

Gets sets selector/id of parent igCombo or reference to parent igCombo object, which is used for cascading functionality. Notes: The selected value in parent igCombo will be used as key to adjust dataSource in this igCombo. Multiselection in parentCombo has no effect on items in child combo: only first selected item of parentCombo is used.

 
        //Initialize
      	$(".selector").igCombo({
			parentCombo: "#idComboParent"
		});
        
        //Get 
        var oParent = $(".selector").igCombo("option", "parentCombo");  
        
        //Set 
        $(".selector").igCombo("option", "parentCombo", "#idComboParent");
      

Gets sets column key in dataSource, which will be used by cascading functionality in order to get records matching with selected value in parent igCombo.
Notes:
That option has effect only when "parentCombo" option is set and it has no effect if "cascadingDataSources" is set.
If that option is set, then data is filtered internally, therefore, filtering while changing text in editor is not available.
If that option is set, then loadOnDemand is not supported.

 
        //Initialize
        $(".selector").igCombo({
			parentComboKey: "keyParent"
		});
        
        //Get 
        var key = $(".selector").igCombo("option", "parentComboKey"); 
        
        //Set 
        $(".selector").igCombo("option", "parentComboKey", "keyParent");
      

Gets sets condition used for rendering of matching parts in items of drop-down list. Note: that option is not related to "filteringType" and "filteringCondition" options.

 
//Initialize 
$(".selector").igCombo({     
    renderMatchItems : "contains"
});  

//Get 
var match = $(".selector").igCombo("option", "renderMatchItems");  

//Set 
$(".selector").igCombo("option", "renderMatchItems", "contains"); 

Specifies the HTTP verb to be used to issue the request.

Content type of the response. See http://api.jquery.com/jQuery.ajax/ => contentType.

See $.ig.DataSource. This is basically the property in the responses where data records are held, if the response is wrapped.

 
//Initialize 
$(".selector").igCombo({     
    responseDataKey : "d.results"
});  

//Get 
var dataKey = $(".selector").igCombo("option", "responseDataKey");  
   

See $.ig.DataSource. property in the response specifying the total number of records on the server.

 
//Initialize 
$(".selector").igCombo({     
    responseTotalRecCountKey : "count"
});  

//Get 
var countKey = $(".selector").igCombo("option", "responseTotalRecCountKey");        

Gets sets list of selected items. It should contain array of objects.
Each object should contain the member "index" equals to the index of selected item or the member "value" equals to value of item in dataSource in "valueKey" column.
The member "text" contains value of item in "textKey" column.
Missing values are filled automatically while rendering list items and on other actions. If application set more than one member, then it is responsible for match.
Note: that option is supported only for currently available list of items. When load-on-demand or filtering is enabled, then attempt to select not loaded item will fail.

 
//Initialize 
$(".selector").igCombo({     
    selectedItems : [
        {
            index: 3
        }
    ]
});  

//Get 
var selectedItems = $(".selector").igCombo("option", "selectedItems");  

//Set 
$(".selector").igCombo("option", "selectedItems", [ { index: 3 }]);

• index

  Type:

  number

  Default:

  -1

  Optional="true" Index of item in list. Value should be larger than -1 and less than number of items in list (rows in dataSource).

  Code Sample

       
            //Initialize 
            $(".selector").igCombo({     
                selectedItems : [{ index: 3 }]
            });  
  
            //Get 
            var index = $(".selector").igCombo("option", "selectedItems")[0].index;
  
            //Set
            $(".selector").igCombo("option", "selectedItems", [{ index: 3 }]);
            

• text

  Type:

  string

  Default:

  null

  Optional="true" Value of cell in textKey column for index.

  Code Sample

            //Get 
            var text = $(".selector").igCombo("option", "selectedItems")[0].text;
            

• value

  Type:

  object

  Default:

  null

  Optional="true" Value of cell in valueKey column for index.

  Code Sample

     
            //Get 
            var value = $(".selector").igCombo("option", "selectedItems")[0].value;  
  		

Gets sets ability to select active item in list by Space key.
Note: if that options is enabled, then it will be not possible to type-in the Space character when list is opened.

 
//Initialize 
$(".selector").igCombo({     
    selectItemBySpaceKey : true
});  

//Get 
var selectSpace = $(".selector").igCombo("option", "selectItemBySpaceKey");  

//Set 
$(".selector").igCombo("option", "selectItemBySpaceKey", true);        

Gets sets visibility of drop-down button.

 
//Initialize 
$(".selector").igCombo({     
    showDropDownButton : false
});  

//Get 
var showButton = $(".selector").igCombo("option", "showDropDownButton");  

//Set 
$(".selector").igCombo("option", "showDropDownButton", false);         

Gets sets tabIndex for field of combo.

 
//Initialize 
$(".selector").igCombo({     
    tabIndex : 3
});  

//Get 
var tabIndex = $(".selector").igCombo("option", "tabIndex");  

//Set 
$(".selector").igCombo("option", "tabIndex", 3);          

Gets sets text which appears in combo on initialization. If it is not set, then the value from target html element is used automatically.
If selectedItems option is not set and allowCustomValue option is enabled, then first matching item in list will be selected.
Notes: After initialization that option is reset to null. To get text in field, the text() method can be used.

 
//Initialize 
$(".selector").igCombo({     
    text : "green"
});  

//Get 
var text = $(".selector").igCombo("option", "text");  

//Set 
$(".selector").igCombo("option", "text", "green");          

Gets sets name of column which contains the displayed text. If it is missing, then "valueKey" option will be used.

 
//Initialize 
$(".selector").igCombo({     
    textKey : "ProductName"
});  

//Get 
var key = $(".selector").igCombo("option", "textKey");  
  

Gets sets type of values used for data cells/items with textKey. That value is assign to schema of $.ig.DataSource.

 
//Initialize 
$(".selector").igCombo({     
    textKeyType : "string"
});  

//Get 
var type = $(".selector").igCombo("option", "textKeyType");  
       

Gets or sets object which contains options supported by igValidator.
Notes: in order for validator to work, application should ensure that igValidator is loaded (ig.ui.validator.js/css files).
Example:
$('#combo1').igCombo({ validatorOptions: { required: true } });.

            //Initialize 
      $(".selector").igCombo({
          validatorOptions: {
              required: true
          }
      });

      //Get 
      var text = $(".selector").igCombo("option", "validatorOptions");

      //Set 
      $(".selector").igCombo("option", "validatorOptions", {
          required: true
      });
      

Gets sets name of column which contains the "value". If it is missing, then name of first column will be used.

 
//Initialize 
$(".selector").igCombo({     
    valueKey : "ProductID"
});  

//Get 
var key = $(".selector").igCombo("option", "valueKey");        

Gets sets type of values used for data cell/items with valueKey. That value is assign to schema of $.ig.DataSource.

 
//Initialize 
$(".selector").igCombo({     
    valueKeyType : "number"
});  

//Get 
var type = $(".selector").igCombo("option", "valueKeyType");        

Gets sets ability to use virtual rendering for drop-down list.
If that option is enabled, then only visible items are created and top edge of first visible item in list is alligned to the top edge of list.

 
//Initialize 
$(".selector").igCombo({     
    virtualization : true
});  

//Get 
var isEnabled = $(".selector").igCombo("option", "virtualization");         

Gets sets width of combo. The numeric and string values (valid html units for size) are supported. It includes %, px, em and other units.

 
//Initialize 
$(".selector").igCombo({     
    width : "300px"
});  

//Get 
var width = $(".selector").igCombo("option", "width");  

//Set 
$(".selector").igCombo("option", "width", "300px");