/** * Static default value for this SelectItem. To default to the first option use {@link * com.smartgwt.client.widgets.form.fields.SelectItem#getDefaultToFirstOption defaultToFirstOption} instead. * * @param defaultValue defaultValue Default value is null */ public void setDefaultValue(Boolean defaultValue) { setAttribute("defaultValue", defaultValue); }
/** * If {@link com.smartgwt.client.widgets.form.fields.SelectItem#getShowPickerIcon showPickerIcon} is true for this item, * this property governs the size of the picker icon. If unset, the picker icon will be sized as a square to fit in the * available height for the icon. * <p><b>Note : </b> This is an advanced setting</p> * * @param pickerIconHeight pickerIconHeight Default value is null */ public void setPickerIconHeight(Integer pickerIconHeight) { setAttribute("pickerIconHeight", pickerIconHeight); }
/** * If this.animatePickList is true - this specifies the duration of the animation effect applied when showing the * pickList <p><b>Note : </b> This is an advanced setting</p> * * @param animationTime animationTime Default value is 200 */ public void setAnimationTime(int animationTime) { setAttribute("animationTime", animationTime); }
/** * Specifies the field by which this item should be initially sorted. Can be set to either a {@link * com.smartgwt.client.widgets.grid.ListGridField#getName 'field name'} or the index of the field in the fields Array. * Note that if <code>sortField</code> is initally specified as a number, it will be converted to a string (field name) * after the item is initialized. <P> To programmatically change sort field or direction after initialization, call * ${isc.DocUtils.linkForRef('sort')}. * * @param sortField sortField Default value is null */ public void setSortField(Integer sortField) { setAttribute("sortField", sortField); }
/** * Maximum height to show the pick list before it starts to scroll. Note that by default the pickList will be sized * to the height required by its content so it will be taller when more rows are available as selectable options * * @param pickListHeight pickListHeight Default value is 300 */ public void setPickListHeight(int pickListHeight) { setAttribute("pickListHeight", pickListHeight); }
/** * Height for an empty pick list (showing the empty message), if the pick list has no records and {@link * com.smartgwt.client.widgets.form.fields.PickList#getHideEmptyPickList hideEmptyPickList} is <code>false</code>. * * @param emptyPickListHeight emptyPickListHeight Default value is 100 */ public void setEmptyPickListHeight(int emptyPickListHeight) { setAttribute("emptyPickListHeight", emptyPickListHeight); }
/** * Select the first option as the default value for this SelectItem. <P> If options are derived from a dataSource, the * first value returned by the server will be used, otherwise the first value in the valueMap. Note that setting this * property to true will trigger a fetch at soon as the form is created, because the form will try to establish a default * value at that time. <P> If enabled, this setting overrides {@link * com.smartgwt.client.widgets.form.fields.SelectItem#getDefaultValue defaultValue} and {@link * com.smartgwt.client.widgets.form.fields.SelectItem#defaultDynamicValue SelectItem.defaultDynamicValue}. * * @param defaultToFirstOption defaultToFirstOption Default value is false */ public void setDefaultToFirstOption(Boolean defaultToFirstOption) { setAttribute("defaultToFirstOption", defaultToFirstOption); }
/** * If <code>filterLocally</code> is set for this item, and this item is showing options from a dataSource, fetch the * entire set of options from the server, and use these values to map the item value to the appropriate display value. Also * use <code>"local"</code> type filtering on drop down list of options. <P> This means data will only be fetched once from * the server, and then filtered on the client. * <p><b>Note : </b> This is an advanced setting</p> * * @param filterLocally filterLocally Default value is false * @see com.smartgwt.client.widgets.form.fields.FormItem#setFilterLocally */ public void setFilterLocally(Boolean filterLocally) { setAttribute("filterLocally", filterLocally); }
public void setOptionFilterContext(DSRequest dsRequestProperties) { setAttribute("optionFilterContext", dsRequestProperties); }
/** * If set to true, always show an empty option in this item's pickList, allowing the user to clear the value (even if there * is no empty entry in the valueMap for the item). <P> The empty value will be displayed with the {@link * com.smartgwt.client.widgets.form.fields.FormItem#getEmptyDisplayValue emptyDisplayValue}. <P> With a {@link * com.smartgwt.client.widgets.form.fields.SelectItem#getOptionDataSource databound selectItem}, enabling * <code>allowEmptyValue</code> disables data paging - all data matching the current criteria will be requested. * * @param allowEmptyValue allowEmptyValue Default value is false */ public void setAllowEmptyValue(Boolean allowEmptyValue) { setAttribute("allowEmptyValue", allowEmptyValue); }
/** * Base CSS class name for a form item's picker icon cell. If unset inherits from this items <code>controlStyle</code>. * * @param pickerIconStyle pickerIconStyle Default value is "selectItemPickerIcon", [IRA] * @see com.smartgwt.client.widgets.form.fields.SelectItem#setControlStyle * @see com.smartgwt.client.docs.Appearance Appearance overview and related methods */ public void setPickerIconStyle(String pickerIconStyle) { setAttribute("pickerIconStyle", pickerIconStyle); }
/** * When this item receives focus, should it be re-styled to indicate it has focus? * <p><b>Note : </b> This is an advanced setting</p> * * @param showFocused showFocused Default value is true, [IRWA] * @see com.smartgwt.client.widgets.form.fields.FormItem#setCellStyle * @see com.smartgwt.client.docs.Appearance Appearance overview and related methods */ public void setShowFocused(Boolean showFocused) { setAttribute("showFocused", showFocused); }
/** * Empty message to display in the pickList if {@link com.smartgwt.client.widgets.form.fields.PickList#getHideEmptyPickList * hideEmptyPickList} is <code>false</code>. <p><b>Note : </b> This is an advanced setting</p> * * @param emptyPickListMessage emptyPickListMessage Default value is null */ public void setEmptyPickListMessage(String emptyPickListMessage) { setAttribute("emptyPickListMessage", emptyPickListMessage); }
/** * Base Style for pickList cells. As with ListGrid Cells, will have 'over', 'selected' and 'disabled' appended on * changes of state for the cells. * * @param pickListBaseStyle pickListBaseStyle Default value is "pickListCell" */ public void setPickListBaseStyle(String pickListBaseStyle) { setAttribute("pickListBaseStyle", pickListBaseStyle); }
/** * If true, when the pickList is shown, it will be shown via an animated reveal effect <p><b>Note : </b> This is an * advanced setting</p> * * @param animatePickList animatePickList Default value is null */ public void setAnimatePickList(Boolean animatePickList) { setAttribute("animatePickList", animatePickList); }
/** * Specifies the field by which this item should be initially sorted. Can be set to either a {@link * com.smartgwt.client.widgets.grid.ListGridField#getName 'field name'} or the index of the field in the fields Array. * Note that if <code>sortField</code> is initally specified as a number, it will be converted to a string (field name) * after the item is initialized. <P> To programmatically change sort field or direction after initialization, call * ${isc.DocUtils.linkForRef('sort')}. * * @param sortField sortField Default value is null */ public void setSortField(String sortField) { setAttribute("sortField", sortField); }
/** * If this item has a specified <code>optionDataSource</code>, and this property is not null, this will be passed to * the datasource as {@link com.smartgwt.client.rpc.RPCRequest} properties when performing the filter operation on * the dataSource to obtain the set of options for the list. <p><b>Note : </b> This is an advanced setting</p> * * @param optionFilterContext optionFilterContext Default value is null */ public void setPickListCriteria(DSRequest optionFilterContext) { setAttribute("optionFilterContext", optionFilterContext); }
/** * Default values used when no value is provided for this item. Note that whenever this item's value is cleared by the user * or set to <code>null</code> programatically, it will be reverted to the <code>defaultValues</code>. * * @param defaultValues the defaultValues. Default value is null */ public void setDefaultValues(String... defaultValues) { setAttribute("defaultValue", defaultValues); }
/** * If this pickList contains no options, should it be hidden? If unset, default behavior is to allow the empty * pickList to show if it is databound. * * @param hideEmptyPickList hideEmptyPickList Default value is null */ public void setHideEmptyPickList(Boolean hideEmptyPickList) { setAttribute("hideEmptyPickList", hideEmptyPickList); }
/** * When applying filter criteria to pickList data, what type of matching to use. <P> For a databound pickList ({@link * com.smartgwt.client.widgets.form.fields.SelectItem#getOptionDataSource optionDataSource} set), * <code>textMatchStyle</code> is sent to the server as {@link com.smartgwt.client.data.DSRequest#getTextMatchStyle * textMatchStyle}. <P> For a non-databound pickList, <code>textMatchStyle</code> is applied by {@link * com.smartgwt.client.widgets.form.fields.SelectItem#getFilterClientPickListData filterClientPickListData}. * * @param textMatchStyle textMatchStyle Default value is "startsWith" */ public void setTextMatchStyle(TextMatchStyle textMatchStyle) { setAttribute("textMatchStyle", textMatchStyle.getValue()); }