Intersoft WebCombo Documentation
NoResultFoundAction Property
See Also  Example Send Feedback
ISNet.WebUI.WebCombo Namespace > LayoutSet Class : NoResultFoundAction Property






Gets or sets the action which WebCombo should perform when there are no results found and the WebCombo has lost its focus.

Gets or sets the action which WebCombo should perform when there are no results found and the WebCombo has lost its focus.

Syntax

Visual Basic (Declaration) 
<ISNet.Serialization.BinarySerializableAttribute()>
<DefaultValueAttribute()>
<ISNet.Serialization.XmlSerializableAttribute()>
<DescriptionAttribute("Gets or sets the action which WebCombo should perform when there are no results found and the WebCombo has lost its focus.")>
<NotifyParentPropertyAttribute(True)>
<CategoryAttribute("Behavior")>
Public Property NoResultFoundAction As NoResultFoundAction
Visual Basic (Usage)Copy Code
Dim instance As LayoutSet
Dim value As NoResultFoundAction
 
instance.NoResultFoundAction = value
 
value = instance.NoResultFoundAction
C# 
[ISNet.Serialization.BinarySerializableAttribute()]
[DefaultValueAttribute()]
[ISNet.Serialization.XmlSerializableAttribute()]
[DescriptionAttribute("Gets or sets the action which WebCombo should perform when there are no results found and the WebCombo has lost its focus.")]
[NotifyParentPropertyAttribute(true)]
[CategoryAttribute("Behavior")]
public NoResultFoundAction NoResultFoundAction {get; set;}
Delphi 
public read-write property NoResultFoundAction: NoResultFoundAction;
JScript 
ISNet.Serialization.BinarySerializableAttribute()
DefaultValueAttribute()
ISNet.Serialization.XmlSerializableAttribute()
DescriptionAttribute("Gets or sets the action which WebCombo should perform when there are no results found and the WebCombo has lost its focus.")
NotifyParentPropertyAttribute()
CategoryAttribute("Behavior")
public function get,set NoResultFoundAction : NoResultFoundAction
Managed Extensions for C++ 
[ISNet.Serialization.BinarySerializableAttribute()]
[DefaultValueAttribute()]
[ISNet.Serialization.XmlSerializableAttribute()]
[DescriptionAttribute("Gets or sets the action which WebCombo should perform when there are no results found and the WebCombo has lost its focus.")]
[NotifyParentPropertyAttribute(true)]
[CategoryAttribute("Behavior")]
public: __property NoResultFoundAction get_NoResultFoundAction();
public: __property void set_NoResultFoundAction( 
   NoResultFoundAction value
);
C++/CLI 
[ISNet.Serialization.BinarySerializableAttribute()]
[DefaultValueAttribute()]
[ISNet.Serialization.XmlSerializableAttribute()]
[DescriptionAttribute("Gets or sets the action which WebCombo should perform when there are no results found and the WebCombo has lost its focus.")]
[NotifyParentPropertyAttribute(true)]
[CategoryAttribute("Behavior")]
public:
property NoResultFoundAction NoResultFoundAction {
   NoResultFoundAction get();
   void set (    NoResultFoundAction value);
}

Example

 

The following sample code shows you how to configure the NoResultFundAction to RevertSelection programmatically.
C#Copy Code
WebCombo1.LayoutSettings.NoResultFoundAction =  NoResultFoundAction.RevertSelection;

Remarks

This property only applicable in following conditions:

  • WebCombo is configured to use Bound mode.
  • WebCombo is not using AllowAddItem feature.

WebCombo.NET v4.0 improves the natural behavior of end users while entering data. WebCombo.NET introduced Latency property which determines the number of milliseconds to wait before requesting the data to server. Everything is good except for fast-typing end users as the users typed the data quicker than the Latency period, and press Tab key to go to the next field.
In previous versions, the scenario above would fail as the typed data will be reverted back (or empty if previously has no selection). It would also sometimes display the resultbox in incorrect position and causing some interruption since the WebCombo expect the user to wait for the response and select an input before entering next field. In v4.0, this scenario has been completely taken care. WebCombo will do the following:

  • Silently select the result if the result row is only 1, and that row has the same text as input text. No display or focus interruption occurred.
  • If the returned rows are more than one or empty, WebCombo will get the NoResultFoundAction property and perform the action according to value of this property.

If this property is set to RevertSelection, then WebCombo will revert back the previously selected value when the returned rows are more than one or empty. Otherwise, WebCombo will take the focus back to the related WebCombo instance and display the ResultBox thus the end users know that their entry is incorrect.

This property only applicable when WebCombo is in following conditions: - WebCombo is configured to use Bound mode. - WebCombo is not using AllowAddItem feature.

WebCombo.NET V3 improves the natural behavior of end users while entrying data. WebCombo.NET introduced Latency property which determines the number of milliseconds to wait before requesting the data to server. Everything is good except for fast-typing end users as the users typed the data quicker than the Latency period, and press Tab key to go to the next field.

In previous versions, the scenario above would fail as the typed data will be reverted back (or empty if previously has no selection). It would also sometimes redisplay the resultbox in incorrect position and causing some interruption since the WebCombo expects the user to wait for the response and then select an input before entering next field. In V3, this scenario has been completely taken care. WebCombo will do following: - Silently select the result if the result row is only 1, and that row has the same text as input text. No display or focus interuption occured. - If the returned rows are more than one or empty, WebCombo will get the NoResultFoundAction property and perform the action according to value of this property.

If this property is set to RevertSelection, then WebCombo will revert back the previously selected value when the returned rows are more than one or empty. Otherwise, WebCombo will take the focus back to the related WebCombo instance and display the ResultBox so the end users know that his/her entry is incorrect.

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.