com.smartgwt.client.docs
Interface CriteriaEditing

public interface CriteriaEditing

Criteria Editing

DynamicForms may be used to edit Criteria or AdvancedCriteria for filtering data from a DataSource.

The main APIs for this are DynamicForm.getValuesAsCriteria and DynamicForm.setValuesAsCriteria.

getValuesAsCriteria() will return an AdvancedCriteria object in the following cases:

• The form was previously passed AdvancedCriteria via setValuesAsCriteria()
• The form has a specified operator of "or"
• FormItem.hasAdvancedCriteria returns true for some item(s) within the form

Note that at the form item level, individual items can support editing of advanced criteria via overrides to the FormItem.hasAdvancedCriteria, FormItem.canEditCriterion, FormItem.setCriterion and FormItem.getCriterion methods.

The common pattern of using nested dynamicForms to edit arbitrary advanced criteria has been implemented via overrides to these methods in the CanvasItem class. See CanvasItem.getCriterion for details.

For completely user-driven advanced criteria editing see also the FilterBuilder class.

See Also:

DynamicForm.getValuesAsCriteria(), DynamicForm.setValuesAsCriteria(com.smartgwt.client.data.Criterion), DynamicForm.getValuesAsAdvancedCriteria(), FormItem.hasAdvancedCriteria(), FormItem.canEditCriterion(com.smartgwt.client.data.Criterion), FormItem.getCriterion(), FormItem.setCriterion(com.smartgwt.client.data.Criterion), CanvasItem.hasAdvancedCriteria(), CanvasItem.canEditCriterion(com.smartgwt.client.data.Criterion), CanvasItem.getCriterion(), CanvasItem.setCriterion(com.smartgwt.client.data.Criterion), ComboBoxItem.hasAdvancedCriteria(), ComboBoxItem.getCriterion(), ComboBoxItem.canEditCriterion(), ComboBoxItem.setCriterion(), DateRangeItem.hasAdvancedCriteria(), CanvasItem.getCriterion(), DateRangeItem.canEditCriterion(com.smartgwt.client.data.Criterion), DateRangeItem.setCriterion(com.smartgwt.client.data.Criterion), MiniDateRangeItem.hasAdvancedCriteria(), MiniDateRangeItem.getCriterion(), MiniDateRangeItem.setCriterion(com.smartgwt.client.data.Criterion), MiniDateRangeItem.canEditCriterion(com.smartgwt.client.data.Criterion), FormItem.getOperator()