/** * Static default value for this SelectItem. To default to the first option use {@link * com.smartgwt.client.widgets.form.fields.SelectItem#getDefaultToFirstOption defaultToFirstOption} instead. * * * @return Boolean */ public Boolean getDefaultValue() { return getAttributeAsBoolean("defaultValue"); }
/** * If this item is part of a databound form, and has a specified <code>valueMap</code>, by default we show the valueMap * options in the pickList for the item. Setting this property to true will ensure that the options displayed in our * pickList are derived from the form's <code>dataSource</code>. * * * @return Boolean * @see com.smartgwt.client.docs.Databinding Databinding overview and related methods */ public Boolean getShowOptionsFromDataSource() { return getAttributeAsBoolean("showOptionsFromDataSource"); }
/** * When this item receives focus, should it be re-styled to indicate it has focus? * * * @return Boolean * @see com.smartgwt.client.widgets.form.fields.FormItem#getCellStyle * @see com.smartgwt.client.docs.Appearance Appearance overview and related methods */ public Boolean getShowFocused() { return getAttributeAsBoolean("showFocused"); }
/** * If showing a hint for this form item, should it be shown within the field? <P>CSS style for the hint is {@link * com.smartgwt.client.widgets.form.fields.SelectItem#getTextBoxStyle textBoxStyle} with the suffix "Hint" appended to it. * * * @return Boolean * @see com.smartgwt.client.widgets.form.fields.FormItem#getHint * @see com.smartgwt.client.docs.Appearance Appearance overview and related methods */ public Boolean getShowHintInField() { return getAttributeAsBoolean("showHintInField"); }
/** * If this select item retrieves its options from a <code>dataSource</code>, should options be fetched from the server when * the item is first drawn, or should this fetch be delayed until the user opens the pickList. <P> The default is true in * order to allow the user to select a value via keyboard input while keyboard focus is on the SelectItem but the pickList * has not actually been shown. * * * @return Boolean */ public Boolean getAutoFetchData() { return getAttributeAsBoolean("autoFetchData"); }
/** * When the user rolls over the select item, should the pickButton display it's <code>Over</code> state? * * * @return Boolean */ public Boolean getShowOver() { return getAttributeAsBoolean("showOver"); }
/** * If true, when the pickList is shown, it will be shown via an animated reveal effect * * @return Boolean */ public Boolean getAnimatePickList() { return getAttributeAsBoolean("animatePickList"); }
/** * 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. * * * @return Boolean * @see com.smartgwt.client.widgets.form.fields.FormItem#getFilterLocally */ public Boolean getFilterLocally() { return getAttributeAsBoolean("filterLocally"); }
/** * Should we show a special 'picker' icon for this form item. Picker icons are customizable via {@link * com.smartgwt.client.widgets.form.fields.SelectItem#getPickerIconProperties pickerIconProperties}. By default they will * be rendered inside the Form Item's "control box" area, and will call {@link * com.smartgwt.client.widgets.form.fields.SelectItem#showPicker SelectItem.showPicker} when clicked. * * * @return Boolean */ public Boolean getShowPickerIcon() { return getAttributeAsBoolean("showPickerIcon"); }
/** * 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. * * @return Boolean */ public Boolean getHideEmptyPickList() { return getAttributeAsBoolean("hideEmptyPickList"); }
/** * If true, even non-matching options will be shown, with configurable {@link com.smartgwt.client.widgets.form.fields.PickList#getSeparatorRows * separatorRows} in between. Not valid for {@link com.smartgwt.client.widgets.form.fields.PickList#getOptionDataSource * optionDataSource}. * * @return Boolean */ public Boolean getShowAllOptions() { return getAttributeAsBoolean("showAllOptions"); }
/** * 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. * * * @return Boolean */ public Boolean getAllowEmptyValue() { return getAttributeAsBoolean("allowEmptyValue"); }
/** * 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}. * * * @return Boolean */ public Boolean getDefaultToFirstOption() { return getAttributeAsBoolean("defaultToFirstOption"); }
/** * If we're setting the value of a select item and the value isn't a legal value in the valueMap, whether we should allow * the value (creating a new option for it) or reject it. <P> Exception: If the value is set to <code>null</code> but there * is no null entry in the valueMap for this item, setting <code>addUnknownValues</code> to true will not cause a null * option to show up at the top of the select item pickList. Whether an empty option is shown in the pickList is governed * by {@link com.smartgwt.client.widgets.form.fields.SelectItem#getAllowEmptyValue allowEmptyValue} instead. * * * @return Boolean * @see <a href="http://www.smartclient.com/smartgwt/showcase/#form_dep_dep_selects" target="examples">Dependent Selects Example</a> */ public Boolean getAddUnknownValues() { return getAttributeAsBoolean("addUnknownValues"); }
/** * If true, multiple values may be selected. <P> The SelectItem will either render as a drop-down allowing multiple * selections, or a multi-row list of options similar to a small headerless {@link * com.smartgwt.client.widgets.grid.ListGrid}, based on the {@link com.smartgwt.client.types.MultipleAppearance} setting. * <P> The logical value of the formItem, as retrieved by {@link com.smartgwt.client.widgets.form.fields.FormItem#getValue * getValue()} and set via {@link com.smartgwt.client.widgets.form.fields.FormItem#setValue setValue()}, is an Array of * Strings reflecting the selected values. <P> Note: <code>multiple:true</code> SelectItems do not currently support * optionDataSource binding. You can get around this by calling {@link com.smartgwt.client.data.DataSource#fetchData * DataSource.fetchData} directly and calling {@link com.smartgwt.client.data.List#getValueMap * dsResponse.data.getValueMap()} to obtain a valueMap. * * * @return Boolean * @see com.smartgwt.client.docs.Appearance Appearance overview and related methods */ public Boolean getMultiple() { return getAttributeAsBoolean("multiple"); }