Intersoft WebCombo Documentation
MultipleSelectionSettings Class
Members  See Also  Send Feedback
ISNet.WebUI.WebCombo Namespace : MultipleSelectionSettings Class






Provides advanced settings related to the MultipleSelection feature.

Object Model

MultipleSelectionSettings Class

Syntax

Visual Basic (Declaration) 
<PersistenceModeAttribute(PersistenceMode.InnerProperty)>
<DescriptionAttribute("Provides settings for multiple selections.")>
<SerializableAttribute()>
Public Class MultipleSelectionSettings 
   Inherits ISNet.WebUI.WebUIBaseClass
   Implements ISNet.ICopyable, ISNet.IResetable, ISNet.Serialization.BinarySerialization.IBinarySerialize 
Visual Basic (Usage)Copy Code
Dim instance As MultipleSelectionSettings
C# 
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[DescriptionAttribute("Provides settings for multiple selections.")]
[SerializableAttribute()]
public class MultipleSelectionSettings : ISNet.WebUI.WebUIBaseClass, ISNet.ICopyable, ISNet.IResetable, ISNet.Serialization.BinarySerialization.IBinarySerialize  
Delphi 
public class MultipleSelectionSettings = class(ISNet.WebUI.WebUIBaseClass, ISNet.ICopyable, ISNet.IResetable, ISNet.Serialization.BinarySerialization.IBinarySerialize)
JScript 
PersistenceModeAttribute(PersistenceMode.InnerProperty)
DescriptionAttribute("Provides settings for multiple selections.")
SerializableAttribute()
public class MultipleSelectionSettings extends ISNet.WebUI.WebUIBaseClass implements ISNet.ICopyable, ISNet.IResetable, ISNet.Serialization.BinarySerialization.IBinarySerialize 
Managed Extensions for C++ 
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[DescriptionAttribute("Provides settings for multiple selections.")]
[SerializableAttribute()]
public __gc class MultipleSelectionSettings : public ISNet.WebUI.WebUIBaseClass, ISNet.ICopyable, ISNet.IResetable, ISNet.Serialization.BinarySerialization.IBinarySerialize  
C++/CLI 
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[DescriptionAttribute("Provides settings for multiple selections.")]
[SerializableAttribute()]
public ref class MultipleSelectionSettings : public ISNet.WebUI.WebUIBaseClass, ISNet.ICopyable, ISNet.IResetable, ISNet.Serialization.BinarySerialization.IBinarySerialize  

Remarks

WebCombo.NET includes numerous advanced settings related to the MultipleSelection feature. These settings can be found in MultipleSelectionSettings object that contains all information about the MultipleSelection feature.

WebCombo.NET's MultipleSelection feature is designed to be very easy-to-use for end users while entering multiple values. Beside the advanced features in MultipleSelectionSettings, the feature includes numerous behaviors as you can explore as in following:

1. Data Input. There are several methods to accept an item, such as:
 Using Keyboard. Valid built-in keystrokes are Tab, Enter and the character specified in SeparatorChar property.  The above keys will be used to accept the selected item only when the ResultBox is shown. This will result in better consistency so that when the users have finished the input, they can hit Tab again to go to next field.
Using Mouse. When the resultbox is in open state, you can select the item by clicking your left mouse's button. WebCombo.NET will automatically position the cursor for next item input.

2. Navigation. WebCombo.NET allows you to easily navigate between items. You can use keyboard left and right arrow keys to navigate to previous and next items. WebCombo.NET will automatically determine entered valid items and set the cursor position accordingly.

3. Highlight. WebCombo.NET enables end-users to easily select an item among multiple values by clicking the region of valid item. When the clicked item is valid (it has Value content), the item will be highlighted similarly as in Outlook® 2003 textbox feature.

4. Item Deletion. To delete items, you can use keyboard DELETE and BACKSPACE key. WebCombo.NET will intelligently detects every tokens in the cursor position and delete the previous item when BACKSPACE is pressed. It will delete next item when DELETE key is pressed. WebCombo.NET will also automatically determine the current context when pressing these keys, e.g. whether the user is in editing mode or in selection mode. Editing mode is indicated when ResultBox is shown and the item is not valid yet.

5. Item Insertion. The MultipleSelection feature even allow users to insert an item. This can be easily done by placing the cursor in the position you want to insert, then start typing and press Tab to select an item. The new item will then be inserted properly among other values.

Inheritance Hierarchy

System.Object
   ISNet.WebUI.WebUIBaseClass
      ISNet.WebUI.WebCombo.MultipleSelectionSettings

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 Intersoft Solutions Corp. All Rights Reserved.