Edit this page

RadComboBoxItem Object

The RadComboBoxItem object is returned by the getItem method of the RadComboBoxItemCollection object. It is also exposed by the eventArgs of many client-side events (eventArgs.get_item()). The following table lists the most important methods:

Name Parameters Return Type Description
highlight none none Highlights an item.
unHighlight none none Unhighlights an item.
select none none Selects an item.
disable none none Disables an item.
enable none none Enables an item.
get_comboBox none object Gets the parent RadComboBox control. See Example 1.
get_highlighted none boolean True if the item is highlighted. To highlight an item use the highlight method.
get_index none int Gets the index of an item in the Items collection.
get_enabled none boolean True if the item is enabled. To enable an item use the enable method.
get_text none string Gets the text of an item.
set_text string none Sets text of an item.
get_value none string Gets the value of an item.
set_value string none Sets the value of an item.
get_checked none boolean True if an item is checked, False if not.
set_checked boolean none Checks or unchecks an item.
get_isSeparator none boolean True if an item is separator (IsSeparator="True").
get_attributes none collection Returns a collection of custom attributes defined for an item.
getAttribute String String Returns a specific attribute from the Attributes collection.
setAttribute String, String none Adds an attribute to the Attributes collection. See Example 2.
get_visible none boolean True if the item is visible.
set_visible boolean none Sets the visibility of an item.
show none none Makes the item visible, same as set_visible(true).
hide none none Makes the item invisible, same as set_visible(false).
get_imageUrl none string Returns the full path to an item's image.
set_imageUrl string none Sets the ImageUrl property of an item.
get_disabledImageUrl none string Returns the full path to the image of a disabled item.
set_disabledImageUrl string none Sets the DisabledImageUrl property of an item.
findControl string object Returns the object which is in the item template.
get_element none HTML element Returns the <LI> HTML element of an item.

Example 1: Gets the parent RadComboBox control.


<script language="javascript" type="text/javascript">
    function OnClientSelectedIndexChangingHandler(sender, eventArgs) {
        var item = eventArgs.get_item();
        var combo = item.get_comboBox();
    }
</script>

<telerik:radcombobox id="RadComboBox1" 
    runat="server" 
    onclientselectedindexchanging="OnClientSelectedIndexChangingHandler">
</telerik:radcombobox>

Example 2: Get an item's attribute and set a value to it.


var combo = $find("<%= RadComboBox2.ClientID %>");
var item = combo.findItemByText("Apples");

//get a custom attribute called "Color"
item.get_attributes().getAttribute("Color");

//set new custom attribute called "Size"
item.get_attributes().setAttribute("Size", "2");

See Also