KaxComboBox Class

SystemObject
  System.Web.UIControl
    System.Web.UI.WebControlsWebControl
      System.Web.UI.WebControlsBaseDataBoundControl
        System.Web.UI.WebControlsDataBoundControl
          KaxDataBoundControl
            Kettic.AspNet.ControlsControlItemContainer
              Kettic.AspNet.ControlsKaxComboBox

public class KaxComboBox : ControlItemContainer, 
	IPostBackEventHandler, ICallbackEventHandler, IEditableTextControl, ITextControl, ILocalizableControl

Public Class KaxComboBox
	Inherits ControlItemContainer
	Implements IPostBackEventHandler, ICallbackEventHandler, IEditableTextControl, ITextControl, 
	ILocalizableControl

public ref class KaxComboBox : public ControlItemContainer, 
	IPostBackEventHandler, ICallbackEventHandler, IEditableTextControl, ITextControl, ILocalizableControl

type KaxComboBox =  
    class
        inherit ControlItemContainer
        interface IPostBackEventHandler
        interface ICallbackEventHandler
        interface IEditableTextControl
        interface ITextControl
        interface ILocalizableControl
    end

	Name	Description
	KaxComboBox

Top

	Name	Description
	ClearSelection	Clears out the list selection and sets the Selected property of all items to false.
	DataBind	Binds a data source to the invoked KaxComboBox and all its child controls. Does not bind the control if EnableAutomaticLoadOnDemand is true and the page request is not a callback. (Overrides BaseDataBoundControlDataBind.)
	FindItem	Returns the first KaxComboBoxItem that matches the conditions defined by the specified predicate. The predicate should returns a boolean value.
	FindItemByText(String)	Finds the first KaxComboBoxItem with Text that matches the given text value.
	FindItemByText(String, Boolean)	Finds the first KaxComboBoxItem with Text that matches the given text value.
	FindItemByValue(String)	Finds the first KaxComboBoxItem with Value that matches the given value.
	FindItemByValue(String, Boolean)	Finds the first KaxComboBoxItem with Value that matches the given value.
	FindItemIndexByText(String)	Returns the index of the first KaxComboBoxItem with Text that matches the given text value.
	FindItemIndexByText(String, Boolean)	Returns the index of the first KaxComboBoxItem with Text that matches the given text value.
	FindItemIndexByValue(String)	Returns the index of the first KaxComboBoxItem with Value that matches the given value.
	FindItemIndexByValue(String, Boolean)	Returns the index of the first KaxComboBoxItem with Value that matches the given value.
	LoadContentFile	Loads combobox items from an XML content file.
	RenderBeginTag	(Overrides KaxDataBoundControl.RenderBeginTag(HtmlTextWriter).)
	RenderEndTag	(Overrides KaxDataBoundControl.RenderEndTag(HtmlTextWriter).)
	SortItems	Sorts the items in the KaxComboBox.
	SortItems(IComparer)	Sorts the items in the KaxComboBox.

Top

	Name	Description
	AccessibilityMode	Determines whether the noscript tag containing select element to be rendered.
	AllowCustomText	Determines whether custom text can be entered into the input field of KaxComboBox.
	AutoCompleteSeparator	Gets or sets a list of separators: autocomplete logic is reset afer a separator is entered and users can autocomplete multiple items.
	AutoPostBack	Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the KaxComboBox selection.
	ChangeTextOnKeyBoardNavigation	Determines whether the text can be entered into the input field of KaxComboBox during keyboard navigation
	ClientChanges	Gets a list of all client-side changes (adding an item, removing an item, changing an item's property) which have occurred.
	CloseDropDownOnBlur	Determines whether drop down should be closed on blur
	CollapseAnimation	Gets the settings for the animation played when an item closes.
	CollapseDelay	Gets or sets a value indicating the timeout after which a dropdown starts to close.
	Controls	(Overrides ControlControls.)
	Culture
	DropDownCssClass	Gets or sets an additional Cascading Style Sheet (CSS) class applied to the Drop Down.
	DropDownWidth	Gets or sets the width of the dropdown in pixels.
	EmptyMessage
	EnableAutomaticLoadOnDemand	Gets or sets a value indicating whether the combobox should handle the items request automatically on the server.
	EnableItemBindingExpressions	Gets or sets a value indicating whether any databinding expressions specified in the ItemTemplate should be evaluated for unbound items (items added inline or programmatically).
	EnableItemCaching	Gets or sets a value indicating whether the combobox should cache items loaded on demand or via webservice
	EnableLoadOnDemand	Gets or sets a value indicating whether the combobox should issue a callback to the server whenever end-users change the text of the combo (keypress, paste, etc).
	EnableScreenBoundaryDetection	Determines whether the Screen Boundaries Detection is enabled or not.
	EnableTextSelection	Gets or sets a value indicating whether the text of combobox should be selected
	EnableVirtualScrolling	Gets or sets a value indicating whether the combobox should load items on demand (via callback) during scrolling-down the drop-down area.
	ErrorMessage	Determines the custom error message to be shown after the Load On Demand Callback error appears.
	ExpandAnimation	Gets the settings for the animation played when the dropdown opens.
	ExpandDelay	Gets or sets a value indicating the timeout after which a dropdown starts to open.
	ExpandDirection	Gets or sets a value indicating the opening direction of KaxComboBox dropdown. If this property is not set - by default dropdown opens downwards.
	Filter	Gets or sets a value indicating whether the combobox should automatically autocomplete and highlight the currently typed text to the all items text match.
	Footer	Get a footer of KaxcomboBox.
	FooterTemplate	Gets or sets the template for displaying footer in KaxcomboBox.
	Header	Get a header of KaxcomboBox.
	HeaderTemplate	Gets or sets the template for displaying header in KaxcomboBox.
	HighlightTemplatedItems	Gets or sets a value indicating whether items defined in the ItemTemplate template should be automatically highlighted on mouse hover or keyboard navigation.
	IsCaseSensitive	Gets or sets a value that indicates whether the combobox autocompletion logic is case-sensitive or not.
	IsEmpty	Gets a value indicating whether the current instance of the combobox has child items.
	ItemRequestTimeout	Specifies the timeout after each keypress before KaxComboBox fires an AJAX callback to the ItemsRequested server-side event.
	Items	Gets a KaxComboBoxItemCollection object that contains the items of the current KaxComboBox control.
	ItemsPerRequest	Gets or sets the number of Items the KaxComboBox will load per Item request.
	ItemTemplate	Gets or sets the template for displaying the items in KaxcomboBox.
	KaxComboBoxImagePosition	Sets or gets the position (left or right) of the arrow image dropdown.
	Label
	LabelCssClass
	LoadingMessage	The value of the message that is shown in KaxComboBox while AJAX callback call is in effect.
	Localization
	MarkFirstMatch	Gets or sets a value indicating whether the combobox should automatically autocomplete and highlight the currently typed text to the closest item text match.
	MaxHeight	Gets or sets the max height of the dropdown in pixels.
	MaxLength	Gets or sets the maximum number of characters allowed in the combobox.
	NoWrap	Gets or sets a value indicating whether the text in a combobox item automatically continues on the next line when it reaches the end of the dropdown.
	OffsetX	Gets or sets a value indicating the horizontal offset of the combobox dropdown
	OffsetY	Gets or sets a value indicating the vertical offset of the combobox dropdown.
	OnClientBlur	The client-side event that is fired when when the combo loses focus
	OnClientDropDownClosed	The client-side event that is fired after the dropdown of the combobox is closed.
	OnClientDropDownClosing	The client-side event that is fired before the dropdown of the combobox is closed.
	OnClientDropDownOpened	The client-side event that is fired after the dropdown of the combobox is opened.
	OnClientDropDownOpening	The client-side event that is fired before the dropdown of the combobox is opened.
	OnClientFocus	The client-side event that is fired when when the combo gains focus
	OnClientItemDataBound	Gets or sets the name of the JavaScript function called when an Item is created during Web Service Load on Demand.
	OnClientItemsRequested	Gets or sets a value indicating the client-side event handler that is called when the KaxComboBox items were just populated (for example from web service).
	OnClientItemsRequestFailed	Gets or sets a value indicating the client-side event handler that is called when the operation for populating the KaxComboBox has failed.
	OnClientItemsRequesting	Gets or sets a value indicating the client-side event handler that is called when the KaxComboBox is about to be populated (for example from web service).
	OnClientKeyPressing	The client-side event that is fired when the user presses a key inside the combobox.
	OnClientLoad	Gets or sets a value indicating the client-side event handler that is called after the KaxComboBox client-side object is initialized.
	OnClientSelectedIndexChanged	The client-side event that is fired after the selected index of the KaxComboBox has been changed.
	OnClientSelectedIndexChanging	The client-side event that is fired when the selected index of the KaxComboBox is about to be changed.
	OnClientTextChange
	OpenDropDownOnLoad	Gets or sets a value that indicates whether the dropdown of the combobox should be opened by default on loadnig the page.
	SelectedIndex	Gets the index of the currently selected item in the combobox.
	SelectedItem	Gets the currently selected item in the combobox.
	SelectedValue	Gets the value of the currently selected item in the combobox.
	ShowDropDownOnTextboxClick	Determines whether the dropdown shows when the user clicks in the input field.
	ShowMoreResultsBox	Gets or sets a value indicating whether the combobox should display the box for requesting additional items
	ShowToggleImage	Gets or sets a value indicating whether the dropdown image next to the combobox text area should be displayed.
	ShowWhileLoading	Indicates whether the combobox will be visible while loading.
	Sort	Automatically sorts items alphabetically (based on the Text property) in ascending or descending order.
	SortCaseSensitive	Gets/sets whether the sorting will be case-sensitive or not. By default is set to true.
	Text	Gets or sets the text content of the KaxComboBox control.
	UniqueID	(Overrides ControlUniqueID.)
	WebServiceSettings	Gets the settings for the web service used to populate items.
	ZIndex	The HTML Z-index of the items dropdown of KaxComboBox.Its default value is 6000.

Top

	Name	Description
	ItemCreated	Occurs on the server when an item in the KaxComboBox control is created.
	ItemDataBound	Occurs after an item is data bound to the KaxComboBox control.
	ItemsRequested	Occurs when KaxComboBox initiates an AJAX callback to the server.
	SelectedIndexChanged	Occurs when the SelectedIndex property has changed.
	TemplateNeeded	Occurs before template is being applied to the item.
	TextChanged	Occurs when the text of the KaxComboBox changes between postbacks to the server.

Top

The KaxComboBox control supports the following features:

Databinding that allows the control to be populated from various datasources
Programmatic access to the KaxComboBox object model which allows to dynamic creation of comboboxes, populate items, set properties.
Customizable appearance through built-in or user-defined skins.

Items

Each item has a Text and a Value property. The value of the Text property is displayed in the KaxComboBox control, while the Value property is used to store any additional data about the item, such as data passed to the postback event associated with the item.

Reference

Kettic.AspNet.Controls Namespace