public interface ComboBoxFiltering
While the user is typing in a value, the
ComboBoxItem.getPickListFilterCriteria() method will return the typed-in value as part of the
criteria, so that only matching values are shown. Matching is determined by the
ComboBoxItem.filterFields attribute may be used to determine which fields filtering is
performed against for databound comboBoxItems.
If the user explicitly shows the down-down pickList, via either clicking on the drop down icon or using the Ctrl+Arrow Down key combination, the typed-in value is ignored for filtering.
If included in the criteria, the
typed-in value will be included as a value for the
displayField (or for the
this.displayField is unspecified).
Static criteria, specified via
will always be included by the default implementation (combined with the typed in value if
For custom pick list filter criteria, we recommend calling the
If you are implementing your own pickList filter criteria, the read-only property
can be read to determine whether the ComboBox would ordinarily ignore the typed-in value for
filtering. Note that in addition to cases where the user explicitly shows the pickList,
filterWithValue will also be
true during a call to
ComboBoxItem.fetchData() on a
NOTE: The defaut implementation of this method will return an
AdvancedCriteria object if multiple
are specified, or if there are field collisions between any specified static
the entered value. AdvancedCriteria are not supported by all DataSource types, including the
built-in server-side SQL dataSources in Smart GWT Pro edition (though they are supported by SQL
dataSources in Power and Enterprise editions).
By default, the ComboBoxItem will automatically use client-side filtering whenever it receives a complete set of results for a given search string, and then the user types more letters (so reducing the results further).
Client-side filtering may malfunction if the server filtering
behavior can't be replicated client-side (for example, Google Search). To disable client-side
filtering so that the comboBox always contacts the server for data whenever the use changes
the search string, set
ComboBoxItem.useClientFiltering to false.
However, disabling client-side filtering will slow down the UI and cause more round-trips to the server, so if client-side filtering is malfunctioning but should work, try to correct the problem rather than disable the feature.
For example, if the initial search works correctly but adding more letters always causes zero matches, most likely the Records returned by the server lack values for the field(s) targeted by the filter criteria, or the field values returned by the server don't match the criteria values.
View the returned data in the RPC tab in the Developer Console
and enable the "ResultSet" log category in the "Results" tab to troubleshoot how the filter
criteria are being applied to data, and look closely at your settings for