Telerik.Web.UI.RadComboBox : Telerik.Web.UI.ControlItemContainer
Inheritance Hierarchy
Methods
attachDropDown
Use it in this scenario: Ajaxified control in ItemTemplate does a full postback.
Parameters
Returns
None
clearCache
Clears the items cache if EnableItemCaching is True.
Parameters
Returns
None
clearItems
Clears all items of the RadComboBox.
Parameters
Returns
None
clearSelection
Clears the selection.
Parameters
Returns
None
commitChanges
Commits the changes made to the RadComboBox that will be preserved over post-backs.
Parameters
Returns
None
disable
Disables the RadComboBox.
Parameters
Returns
None
disableEvents
Enables the control client-side event emitting. Events are enabled by default.
Parameters
Returns
None
enable
Enables the RadComboBox.
Parameters
Returns
None
enableCheckAllCheckBox
Enables the "CheckAll" checkbox, when multiple selection is enabled.
Parameters
Returns
None
enableEvents
Enables the control client-side event emitting. Events are enabled by default.
Parameters
Returns
None
findFirstMatch
Returns the first RadComboBoxItem object whose Text property equals the passed parameter.
Parameters
text String
text
Returns
Telerik.Web.UI.RadComboBoxItem RadComboBoxItem
findItemByText
Returns the first RadComboBoxItem object whose;Text property equals to the passed parameter.
Parameters
text String
text
Returns
Telerik.Web.UI.RadComboBoxItem
findItemByValue
Returns the first RadComboBoxItem object whose Value property equals the passed parameter.
Parameters
value String
value
Returns
Telerik.Web.UI.RadComboBoxItem RadComboBoxItem
get_allowCustomText
Gets a value indicating whether the RadComboBox" AllowCustomText property is true or false.
Parameters
Returns
Boolean true or false
get_attributes
Returns the collection of arbitrary attributes.
Parameters
Returns
Telerik.Web.UI.AttributeCollection The attribute collection.
get_causesValidation
Gets a value indicating whether the RadComboBox causes validation.
Parameters
Returns
Boolean true or false
get_changeText
True
Parameters
Returns
Boolean
get_checkAllCheckBoxDivElement
Returns the dom element for the check all checkbox.
Parameters
Returns
Element
get_checkedIndices
Returns the indices of all checked items
Parameters
Returns
Number[] Returns array of Integers
get_checkedItems
Gets an array of the checked RadComboBoxItem objects.
Parameters
Returns
Telerik.Web.UI.RadComboBoxItem[] All checked items
get_childListElement
Gets the UL element of the RadComboBox drop down. This element contains the Items of the RadComboBox.
Parameters
Returns
Element The UL element of the RadComboBox.
get_childListElementWrapper
Gets the scrollable DIV element of the RadComboBox drop down (which contains the UL element with Items).
Parameters
Returns
Element The scrollable DIV element of the RadComboBox drop down.
get_clientTemplate
Returns the value of the RadComboBox" ClientItemTemplate property.
Parameters
Returns
None
get_collapseAnimation
Returns an object containing the drop down's collapse animation settings.
Parameters
Returns
Telerik.Web.UI.AnimationSettings
get_dropDownElement
Gets the DIV element of the RadComboBox drop down.
Parameters
Returns
Element The DIV element of the RadComboBox drop down.
get_dropDownVisible
True
Parameters
Returns
Boolean
get_emptyMessage
Gets the EmptyMessage text of the RadComboBox.
Parameters
Returns
String string
get_enabled
Gets a value indicating whether the RadComboBox is enabled.
Parameters
Returns
Boolean True if the RadComboBox is enabled
get_enableItemCaching
Gets a value indicating whether the Item caching is enabled (in Load On Demand scenario).
Parameters
Returns
Boolean True if the Item caching is enabled
get_enableTextSelection
True
Parameters
Returns
Boolean
get_expandAnimation
Returns an object containing the drop down's expand animation settings.
Parameters
Returns
Telerik.Web.UI.AnimationSettings
get_highlightedItem
Gets the currently highlighted item.
Parameters
Returns
Telerik.Web.UI.RadComboBoxItem
get_highlightTemplatedItems
Gets a value indicating whether templated Items should be highlighted. (False by default.)
Parameters
Returns
Boolean True if the templated Items are highlighted
get_id
RadComboBox
Parameters
Returns
Object
get_imageDomElement
Gets a the image DOM element (drop down toggle image).
Parameters
Returns
Element The image DOM element.
get_inputDomElement
Gets a the input DOM element.
Parameters
Returns
Element The input DOM element.
get_isTemplated
Check if the RadComboBox has instantiated template.
Parameters
Returns
Boolean
get_items
Returns the Items collection for the RadComboBox.
Parameters
Returns
Telerik.Web.UI.RadComboBoxItemCollection RadComboBoxItemCollection
get_lastWord
Gets the word after the last separator in the text of the RadComboBox. If a separator is not set, returns the text itself.
Parameters
Returns
String string
get_markFirstMatch
True if MarkFirstMatch is true; false otherwise.
Parameters
Returns
Boolean boolean
get_moreResultsBoxElement
Gets the MoreResultsBox DOM element.
Parameters
Returns
Element The MoreResultsBox DOM element.
get_moreResultsBoxMessageElement
Gets a reference to the MoreResultsBox Message DOM element.
Parameters
Returns
Element The MoreResultsBox Message DOM element.
get_originalText
Gets the text which has been rendered from the server.
Parameters
Returns
String The text of the RadComboBox rendered from the server.
get_readOnly
Gets a value indicating whether the RadComboBox is read-only.
Parameters
Returns
Boolean True if the RadComboBox is read
get_selectedIndex
Gets the index of the currently selected Item.
Parameters
Returns
Number The index of the currently selected Item.
get_selectedItem
Gets the currently selected Item.
Parameters
Returns
Telerik.Web.UI.RadComboBoxItem RadComboBoxItem
get_selectElement
Gets the DomElement of the DropDown in simple rendering mode.
Parameters
Returns
Element The DOM element of the DropDown.
get_simpleRendering
Checks if the current rendering mode is "Simple rendering mode".
Parameters
Returns
Boolean True if simple rendering mode
get_slideDirection
Gets the direction of the drop down slide animation.
Parameters
Returns
Telerik.Web.UI.jSlideDirection The direction of the dropdown slide animation
get_tableElement
Gets a the RadComboBox table DOM element (containing the input and toggle image).
Parameters
Returns
Element The RadComboBox table DOM element.
get_text
Gets the text in the input field.
Parameters
Returns
String The text in the input field.
get_value
Gets the value of the RadComboBox.
Parameters
Returns
String The value of the RadComboBox.
get_visibleItems
Returns all visible Items.
Parameters
Returns
Telerik.Web.UI.RadComboBoxItem[] An array containing all visible Items.
get_webServiceSettings
Gets an object containing Web Service settings.
Parameters
Returns
Telerik.Web.UI.WebServiceSettings
getLastWord
Returns the word after the last autocomplete separator of the RadComboBox in the passed text argument.
Parameters
text String
text
Returns
String string
hideDropDown
Closes the drop down.
Parameters
Returns
None
highlightAllMatches
Filters Items by the passed text argument. The filter criteria is specified by the Filter property.
Parameters
text String
text
Returns
None
highlightFirstVisibleEnabledItem
Highlights the first visible and enabled Item in the drop down.
Parameters
Returns
None
highlightMatches
Highlights the first Item which starts with the currently typed text if the MarkFirstMatch property is set to true.
Parameters
Returns
None
highlightNextItem
Highlights the first Item starting with the specified letter and positioned after the currently highlighted one. The method sets the text of the new Item to the input or appends it to the current text if an autocomplete separator is specified.
Parameters
letter String
letter
Returns
None
highlightPreviousItem
Highlights the first Item starting with the specified letter and positioned before the currently highlighted one. The method sets the text of the new Item to the input or appends it to the current text if an autocomplete separator is specified.
Parameters
Returns
None
isIEDocumentMode8
Checks if the IE mode is 8.
Parameters
Returns
Boolean True if IE mode is 8
repaint
Repaints RadComboBox" "fake input" (IE8 only) and Label.
Parameters
Returns
None
requestItems
Initiates a load-on-demand callback request with the specified text, causing the ItemsRequested server event to fire or a request to be sent to a WebService. The second bool parameter instructs the combobox to append the new items (true) or clear items (false).
Parameters
text String
text
appendItems Boolean
Indicates whether to append the received items to the current set of items.
Returns
None
saveClientState
Saves the client state to the client state hidden field.
Parameters
Returns
None
selectText
Selects a text range in the input specified by the startIndex and endIndex parameters.
Parameters
Returns
None
set_allowCustomText
Sets the AllowCustomText property.
Parameters
value Boolean
value
Returns
None
set_causesValidation
Sets a boolean value indicating whether the RadComboBox causes validation.
Parameters
value Boolean
value
Returns
None
set_changeText
ChangeTextOnKeyBoardNavigation
Parameters
Boolean Boolean
Returns
Object
set_clientTemplate
Sets the value of the RadComboBox" ClientItemTemplate property.
Parameters
value String
value
Returns
None
set_closeDropDownOnBlur
showDropDown
Parameters
Boolean Boolean
Returns
Object
set_collapseAnimation
Sets an object containing RadComboBox" drop down collapse animation settings.
Parameters
value Telerik.Web.UI.AnimationSettings
value
Returns
None
set_emptyMessage
Sets the EmptyMessage text of the RadComboBox;
Parameters
value String
value
Returns
None
set_enabled
Sets a boolean value indicating whether the RadComboBox is enabled.
Parameters
value Boolean
value
Returns
None
set_enableItemCaching
Enables/disables item caching (when Load On Demand is enabled).
Parameters
value Boolean
value
Returns
None
set_enableTextSelection
EnableTextSelection
Parameters
boolean Object
Returns
Object
set_expandAnimation
Sets an object containing RadComboBox" drop down expand animation settings.
Parameters
value Telerik.Web.UI.AnimationSettings
value
Returns
None
set_highlightTemplatedItems
Sets a boolean value indicating whether templated Items should be highlighted.
Parameters
value Boolean
value
Returns
None
set_items
Sets the Items collection for the RadComboBox.
Parameters
value Telerik.Web.UI.RadComboBoxItemCollection
value
Returns
None
set_markFirstMatch
Sets the MarkFirstMatch property.
Parameters
value Boolean
value
Returns
None
set_selectedIndex
Sets the selected Index of the RadComboBox. The method does not actually select an Item.
Parameters
value Number
value
Returns
None
set_selectedItem
Sets the selected Item.
Parameters
value Telerik.Web.UI.RadComboBoxItem
value
Returns
None
set_slideDirection
Sets the direction of the drop down slide animation. It can be Up or Down.
Parameters
Returns
Telerik.Web.UI.jSlideDirection value
set_text
Sets the text of the input field to the value of the specified parameter.
Parameters
value String
value
Returns
None
set_value
Sets the value of RadComboBox.
Parameters
value String
value
Returns
None
set_webServiceSettings
Sets an object containing Web Service settings.
Parameters
value Telerik.Web.UI.WebServiceSettings
value
Returns
None
setAllItemsVisible
Sets all items visible / invisible
Parameters
value Boolean
value
Returns
None
showDropDown
Opens the drop down.
Parameters
Returns
None
toggleDropDown
Toggles the drop down visibility.
Parameters
Returns
None
trackChanges
Starts tracking changes made to the RadComboBox that will be preserved over post-backs.
Parameters
Returns
None
Events
checkAllChecked
Occurs after the "Check All" check box is checked.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.ComboBoxCheckAllCheckingEventArgs
The arguments of the CheckAllChecked event.
dropDownClosed
Occurs after the drop-down list has been closed.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxEventArgs
The arguments of the DropDownClosed event.
dropDownOpened
Occurs after the drop-down list has been opened.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxEventArgs
The arguments of the DropDownOpened event.
itemsRequested
Occurs after the load-on-demand mechanism has added new items to the RadComboBox.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxRequestEventArgs
The arguments of the ItemsRequested event.
itemDataBound
Occurs for each item that is created during WebService Load on Demand.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxItemDataBoundEventArgs
The arguments of the ItemDataBound event.
templateDataBound
Occurs for each item that is created during WebService Load on Demand.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadTemplateBoundEventArgs
The arguments of the TemplateDataBound event.
itemChecked
Occurs immediately after a particular item has been checked. (in CheckBoxes enabled scenario).
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxItemEventArgs
The arguments of the ItemChecked event.
checkAllChecking
Occurs just before the "Check All" check box is checked.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.ComboBoxCheckAllCheckingEventArgs
The arguments of the CheckAllChecking event.
dropDownClosing
Occurs just before the drop-down list closes.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxCancelEventArgs
The arguments of the DropDownClosing event.
dropDownOpening
Occurs just before the drop-down list gets opened.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxCancelEventArgs
The arguments of the DropDownOpening event.
selectedIndexChanging
Occurs just before the RadComboBox selection is about to be changed to a new item.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxItemCancelEventArgs
The arguments of the SelectedIndexChanging event.
itemChecking
Occurs when a particular item is about to be checked (in CheckBoxes enabled scenario).
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxItemCancelEventArgs
The arguments of the ItemChecking event.
itemsRequestFailed
Occurs when an error has occurred while loading elements using the load-on-demand mechanism.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxItemsRequestFailedEventArgs
The arguments of the ItemsRequestFailed event.
itemsRequesting
Occurs when EnableLoadOnDemand is enabled and the RadComboBox is about to send a server-side request to load more items.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxRequestCancelEventArgs
The arguments of the ItemsRequesting event.
keyPressing
Occurs when the RadComboBox receives the focus and the user presses a key.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxEventArgs
The arguments of the TextChange event.
onClientFocus
Occurs when the RadComboBox receives the input focus.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxEventArgs
The arguments of the OnClientFocus event.
selectedIndexChanged
Occurs when the RadComboBox selection has just changed to a new item.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxItemEventArgs
The arguments of the SelectedIndexChanged event.
textChange
Occurs when the user enters custom text in the input field of RadComboBox. Not triggered until the control is blurred or Enter key is pressed.
Event Data
sender Telerik.Web.UI.RadComboBox
The RadComboBox instance raised the event.
args Telerik.Web.UI.RadComboBoxCancelEventArgs
The arguments of the TextChange event.