Combobox Server-Side Documentation

Properties - styles

FolderStyle Path to the folder with style to use. Optional

Properties - Appearance settings

Width The width of the combobox. Default value: 180 Optional InnerWidth The width of the comobobx container. This can be used when you want to set the width of the combobox larger/smaller than the width of the textbox and arrow image Optional Height The height of the expanded combobox. Optional Cols The number of columns for the combobox. Default: 1 Optional AlignContainer Used to align the container of the combobox. Optional See the AlignContainer tutorial

Properties - settings

AutoCloseEnable If true the combobox will close when the mouse button is clicked outside the combobox. Optional AutoComplete If true the combobox will autocomplete the item that matches the typed text. Optional AutoPostbackEnable If this is set to true then the combobox will postback when the Value or the Text are changed. Optional AutoValidate If set to true the you don't need to pres Enter or Tab to persist the text typed in the combobox. Default: false Optional Enabled Enables/disables the combobox. Optional EnableViewState If set to true, the combobox will keep its state between postbacks. Optional Mode The mode in which the Combobox will work (Combobox / Textbox). OpenOnSuggest Enable/disable the option for opening the combobox when typing. ReadOnly Used to make the combobox text field uneditable. Default: false  Optional RenderHiddenIframe Used to enable/disable the rendering of the hidden iframe (which is used to solve a bug in the IE6 browser). Default: false  Optional SelectedIndex Used to set/get the index of the selected option of the combobox. Sort Set the sorting type for the list with options. Available values: SortType.None, SortType.Asc and SortType.Desc. Default: SortType.None Optional TabIndex The tab index of the control  Optional Text The text that will be displayed in the combobox. Optional Validate If set to false the user can write any text inside the combobox, otherwise only the options from the list are allowed. Default: true Optional Value The value stored in the combobox (this isn't displayed on the screen). Optional

CSS Properties - used to override the styles defined in the css file

CSSOption The CSS class for the options of the combobox. Optional CSSOptionOver The CSS class for the options of the combobox, used when the mouse is over them. Optional CSSContainer The CSS class for the container of the combobox Optional CSSTopContainer The CSS class for the top container of the combobox (the one that contains the textbox and the arrow button) Optional CSSTextbox The CSS class for the textbox of the combobox Optional CSSOptionIcon The CSS class for the icons inside the options Optional

Methods

AddOption Creates a new Option for the combobox cbo1.AddOption(string Value, string Text, string Icon, string Tooltip) Value - a string containing the value for the new option Text - the text for the new option Icon - path to an icon to be displayed in the added option Tooltip - the tooltip that will be used for the new option AddCustomOption Creates a new Custom option for the combobox cbo1.AddOption(Literal Html) Html - the inner html of the new custom option

Events

OnChange Server-side event that is executed on postback, if the Value or the Text of the combobox were changed. Optional

Client-Side Events

OnClientChange When the Value of the combobox is changed on the client-side, the OnClientChange event handler is executed. OnClientKeyPress A javascript function that will be executed on the client-side after a key is pressed inside the combobox. Optional OnClientOpen Client-side function to be executed when the combobox is opened. OnClientClose Client-side function to be executed when the combobox is closed. OnAjaxError Client-side function which is executed when the ajax autosuggest feature raises an error on the server-side.

Collections

Options A collection of Option objects - the options of the combobox Each option must have a Value and a Text. An optional icon can be also added. CustomOptions A collection of Custom objects - the custom options of the combobox Each custom option must have an Html content.

Data Binding

DataSource The name of the object that will be used as a data source for populating the combobox. Allowed object types: ArrayList, HashTable, DataSet Optional DataBind This method is used to populate the combobox, if a DataSource was specified. Optional  cbo1.DataSource = arrListOptions;   cbo1.DataBind(); DataSourceID The ID of an ObjectDataSource or SqlDataSource object that will be used to populate the combobox. Optional DataField_Value If the combobox is binded with a DataSet, this property is used to specify the name of the column that stores the values for the options of the combobox. Optional Default value: value DataField_Text If the combobox is binded with a DataSet, this property is used to specify the name of the column that stores the text for the options of the combobox. Optional Default value: text DataField_Icon If the combobox is binded with a DataSet, this property is used to specify the name of the column that stores the icons for the options of the combobox. Optional DataField_Tooltip If the combobox is binded with a DataSet, this property is used to specify the name of the column that stores the tooltips for the options of the combobox. Optional

Please visit HOW-TO and Help page for any questions.

"The components Obout has are very cool ... keep up the good work" Barry Cedergren