FormItem

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.smartgwt.client.widgets.form.fields
Class FormItem

java.lang.Object
  com.smartgwt.client.core.JsObject
      com.smartgwt.client.core.DataClass
          com.smartgwt.client.core.RefDataClass
              com.smartgwt.client.widgets.form.fields.FormItem

All Implemented Interfaces:: HasHandlers, HasBlurHandlers, HasChangedHandlers, HasChangeHandlers, HasClickHandlers, HasDoubleClickHandlers, HasFocusHandlers, HasIconClickHandlers, HasIconKeyPressHandlers, HasItemHoverHandlers, HasKeyDownHandlers, HasKeyPressHandlers, HasKeyUpHandlers, HasTitleClickHandlers, HasTitleDoubleClickHandlers, HasTitleHoverHandlers

Direct Known Subclasses:: BlurbItem, BooleanItem, CanvasItem, CheckboxItem, ColorPickerItem, DateItem, HeaderItem, HiddenItem, NativeCheckboxItem, RadioGroupItem, SelectItem, SpacerItem, StaticTextItem, TextAreaItem, TextItem

public class FormItem
extends RefDataClass
implements HasFocusHandlers, HasBlurHandlers, HasChangeHandlers, HasChangedHandlers, HasKeyPressHandlers, HasKeyUpHandlers, HasKeyDownHandlers, HasIconClickHandlers, HasIconKeyPressHandlers, HasItemHoverHandlers, HasClickHandlers, HasDoubleClickHandlers, HasTitleHoverHandlers, HasTitleClickHandlers, HasTitleDoubleClickHandlers
extends RefDataClass
implements HasFocusHandlers, HasBlurHandlers, HasChangeHandlers, HasChangedHandlers, HasKeyPressHandlers, HasKeyUpHandlers, HasKeyDownHandlers, HasIconClickHandlers, HasIconKeyPressHandlers, HasItemHoverHandlers, HasClickHandlers, HasDoubleClickHandlers, HasTitleHoverHandlers, HasTitleClickHandlers, HasTitleDoubleClickHandlers

An Item that can participate in a DynamicForm, managing some value.

FormItems are never directly created, instead, FormItem descriptors are passed to a DynamicForm. See the DynamicForm documentation for details.

Field Summary

Fields inherited from class com.smartgwt.client.core.JsObject
`jsObj`

Constructor Summary
`FormItem()`
`FormItem(JavaScriptObject jsObj)`
`FormItem(java.lang.String name)`

Method Summary
`HandlerRegistration`	`addBlurHandler(BlurHandler handler)` Add a blur handler.
`HandlerRegistration`	`addChangedHandler(ChangedHandler handler)` Add a changed handler.
`HandlerRegistration`	`addChangeHandler(ChangeHandler handler)` Add a change handler.
`HandlerRegistration`	`addClickHandler(ClickHandler handler)` Add a click handler.
`HandlerRegistration`	`addDoubleClickHandler(DoubleClickHandler handler)` Add a doubleClick handler.
`HandlerRegistration`	`addFocusHandler(FocusHandler handler)` Add a focus handler.
`HandlerRegistration`	`addIconClickHandler(IconClickHandler handler)` Add a iconClick handler.
`HandlerRegistration`	`addIconKeyPressHandler(IconKeyPressHandler handler)` Add a iconKeyPress handler.
`HandlerRegistration`	`addItemHoverHandler(ItemHoverHandler handler)` Add a itemHover handler.
`HandlerRegistration`	`addKeyDownHandler(KeyDownHandler handler)` Add a keyDown handler.
`HandlerRegistration`	`addKeyPressHandler(KeyPressHandler handler)` Add a keyPress handler.
`HandlerRegistration`	`addKeyUpHandler(KeyUpHandler handler)` Add a keyUp handler.
`HandlerRegistration`	`addTitleClickHandler(TitleClickHandler handler)` Add a titleClick handler.
`HandlerRegistration`	`addTitleDoubleClickHandler(TitleDoubleClickHandler handler)` Add a titleDoubleClick handler.
`HandlerRegistration`	`addTitleHoverHandler(TitleHoverHandler handler)` Add a titleHover handler.
`void`	`blurItem()` Takes focus from this form item's focusable element.
`java.lang.Boolean`	`canEditCriterion(Criterion criterion)` When a dynamic form is editing an advanced criteria object via `DynamicForm.setValuesAsCriteria`, this method is used to determine which sub-criteria apply to which form item(s).
`void`	`clearValue()` Clear the value for this form item.
`void`	`disable()` Set this item to be disabled (shortcut for `#setDisabled(Boolean),setDisabled(true)`).
`void`	`enable()` Set this item to be enabled (shortcut for `#setDisabled(Boolean),setDisabled(false)`).
`void`	`focusInItem()` Move the keyboard focus into this item's focusable element
`java.lang.String`	`getAccessKey()` AccessKey - a keyboard shortcut to trigger a form item's default behavior. Note: Alt+ (or in Moz Firefox 2.0 and above, Shift+Alt+) the specified key will trigger the form item's default behavior.
`Alignment`	`getAlign()` Alignment of this item in its cell.
`java.lang.Boolean`	`getAllowExpressions()` For a form that produces filter criteria (see `form.getValuesAsCriteria()`), allows the user to type in simple expressions to cause filtering with that operator.
`java.lang.Boolean`	`getAlwaysFetchMissingValues()` If this form item has a specified `optionDataSource` and `fetchMissingValues` is true, when the item value changes, a fetch will be performed against the optionDataSource to retrieve the related record if `displayField` is specified and the new item value is not present in any valueMap explicitly specified on the item.
`java.lang.String`	`getAttribute(java.lang.String attribute)`
`java.lang.Boolean`	`getAttributeAsBoolean(java.lang.String attribute)`
`java.util.Date`	`getAttributeAsDate(java.lang.String attribute)`
`java.lang.Double`	`getAttributeAsDouble(java.lang.String attribute)`
`java.lang.Float`	`getAttributeAsFloat(java.lang.String attribute)`
`java.lang.Integer`	`getAttributeAsInt(java.lang.String attribute)`
`JavaScriptObject`	`getAttributeAsJavaScriptObject(java.lang.String attribute)`
`java.lang.String`	`getAttributeAsString(java.lang.String attribute)`
`java.lang.Boolean`	`getBrowserSpellCheck()` If this browser supports spell-checking of text editing elements, do we want this enabled for this item? If unset the property will be inherited from the containing form.
`java.lang.Boolean`	`getCanFocus()` Is this form item focusable? Setting this property to true on an otherwise non-focusable element such as a `StaticTextItem` will cause the item to be included in the page's tab order and respond to keyboard events.
`java.lang.Integer`	`getCellHeight()` If specified, this property will govern the height of the cell in which this form item is rendered.
`java.lang.String`	`getCellStyle()` CSS style applied to the form item as a whole, including the text element, any icons, and any hint text for the item.
`JavaScriptObject`	`getConfig()` Returns the FormItem's config object suitable for use in API's that set the editorType
`Canvas`	`getContainerWidget()` A Read-Only pointer to the Smart GWT canvas that holds this form item.
`java.lang.String`	`getCriteriaField()` When using `operator`, the name of the DataSource field for the `Criterion` this FormItem generates.
`Criterion`	`getCriterion()` Override this method if you need to provide a specialized criterion from this formItem when creating an AdvancedCriteria via `DynamicForm.getValuesAsCriteria`.
`Criterion`	`getCriterion(TextMatchStyle textMatchStyle)` Override this method if you need to provide a specialized criterion from this formItem when creating an AdvancedCriteria via `DynamicForm.getValuesAsCriteria`.
`java.lang.String`	`getDataPath()` dataPath for this item.
`DateDisplayFormat`	`getDateFormatter()` Display format to use for date type values within this formItem.
`java.lang.String`	`getDefaultIconSrc()` Default icon image source.
`java.lang.Boolean`	`getDisabled()` Whether this item is disabled.
`java.lang.String`	`getDisplayField()` Specifies an alternative field from which display values should be retrieved for this item.
`java.lang.String`	`getDisplayFieldName()` Returns the `displayField` for this form item.
`java.lang.String`	`getDisplayValue()` Returns this item's value with any valueMap applied to it - the value as currently displayed to the user.
`java.lang.String`	`getDisplayValue(java.lang.String value)` Returns this item's value with any valueMap applied to it - the value as currently displayed to the user.
`JavaScriptObject`	`getEditorTypeConfig()`
`java.lang.String`	`getEmptyDisplayValue()` Text to display when this form item has a null or undefined value.
`java.lang.String`	`getEmptyValueIcon()` This property allows the developer to specify an icon to display when this item has no value.
`java.lang.Boolean`	`getEndRow()` Whether this item should end the row it's in in the form layout
`int`	`getErrorIconHeight()` Height of the error icon, if we're showing icons when validation errors occur.
`java.lang.String`	`getErrorIconSrc()` URL of the image to show as an error icon, if we're showing icons when validation errors occur.
`int`	`getErrorIconWidth()` Height of the error icon, if we're showing icons when validation errors occur.
`int`	`getErrorMessageWidth()` When `showInlineErrors` and `showErrorText` are both true and `errorOrientation` is "left" or "right", errorMessageWidth is the amount to reduce the width of the editor to accommodate the error message and icon.
`java.lang.Boolean`	`getFetchMissingValues()` If this form item has a specified `optionDataSource`, should the item ever perform a fetch against this dataSource to retrieve the related record.
`java.lang.String`	`getFieldName()` Return the name for the this formItem.
`java.lang.Boolean`	`getFilterLocally()` If this form item is mapping data values to a display value by fetching records from a dataSource (see `optionDataSource`, `displayField` and `fetchMissingValues`), setting this property to true ensures that when the form item value is set, entire data-set from the dataSource is loaded at once and used as a valueMap, rather than just loading the display value for the current value.
`DynamicForm`	`getForm()` A reference to the FormItem's DynamicForm.
`java.lang.String`	`getFullDataPath()` Return the fully-qualified dataPath for the this formItem (ie, the dataPath expressed in absolute terms from the root of the hierarchy, rather than relative to the item's parent form).
`java.lang.Integer`	`getGlobalTabIndex()` TabIndex for the form item within the page.
`int`	`getHeight()` Height of the FormItem.
`java.lang.String`	`getHint()` Specifies "hint" string to show next to the form item to indicate something to the user.
`java.lang.String`	`getHintStyle()` CSS class for the "hint" string.
`Alignment`	`getHoverAlign()` Text alignment for text displayed in this item's hover canvas, if shown.
`java.lang.Integer`	`getHoverDelay()` If specified, this is the number of milliseconds to wait between the user rolling over this form item, and triggering any hover action for it. If not specified `this.form.itemHoverDelay` will be used instead.
`java.lang.Integer`	`getHoverHeight()` Option to specify a height for any hover shown for this item.
`java.lang.Integer`	`getHoverOpacity()` Opacity for any hover shown for this item
`java.lang.String`	`getHoverStyle()` Explicit CSS Style for any hover shown for this item.
`VerticalAlignment`	`getHoverVAlign()` Vertical text alignment for text displayed in this item's hover canvas, if shown.
`java.lang.Integer`	`getHoverWidth()` Option to specify a width for any hover shown for this item.
`FormItemIcon`	`getIcon(java.lang.String name)` Given an `name` return a pointer to the icon definition
`int`	`getIconHeight()` Default height for form item icons
`Rectangle`	`getIconPageRect(FormItemIcon icon)`
`java.lang.String`	`getIconPrompt()` Default prompt (and tooltip-text) for icons.
`Rectangle`	`getIconRect(FormItemIcon icon)`
`VerticalAlignment`	`getIconVAlign()` How should icons be aligned vertically for this form item.
`int`	`getIconWidth()` Default width for form item icons
`java.lang.String`	`getImageURLPrefix()` Prefix to apply to the beginning of any `valueIcons` when determining the URL for the image.
`java.lang.String`	`getImageURLSuffix()` Suffix to apply to the end of any `valueIcons` when determining the URL for the image.
`java.lang.Boolean`	`getImplicitSave()` When true, indicates that changes to this item will cause an automatic save on a `delay`, as well as when the entire form is submitted.
`java.lang.Boolean`	`getImplicitSaveOnBlur()` If not set to false, form item values will be saved when this item's "editorExit" handler is fired as well as on a delay and when the entire form is submitted.
`java.lang.String`	`getInputFormat()` For fields of type `"date"`, if this is an editable field such as a `TextItem`, this property allows you to specify the `inputFormat` applied to the item.
`int`	`getLeft()` Left coordinate of this item in pixels.
`java.lang.String`	`getLocateItemBy()` When AutoTest.getElement is used to parse locator strings generated by link{isc.AutoTest.getLocator()} for this form item, should the item be identified? By default if the item has a name this will always be used, however for items with no name, the following options are available: `"title"` use the title as an identifier within this form `"value"` use the value of the item to identify it (often used for items with a static defaultValue such as HeaderItems `"index"` use the index within the form's items array.
`java.lang.String`	`getMultipleValueSeparator()` If this item is displaying multiple values, this property will be the string that separates those values for display purposes.
`java.lang.String`	`getName()` Name for this form field.
`OperatorId`	`getOperator()` `OperatorId` to be used when `DynamicForm.getValuesAsCriteria` is called.
`Criteria`	`getOptionCriteria()` If this item has a specified `optionDataSource`, and this property may be used to specify criteria to pass to the datasource when performing the fetch operation on the dataSource to obtain a data-value to display-value mapping
`RPCRequest`	`getOptionFilterContext()` If this item has a specified `optionDataSource`, and this property is not null, this will be passed to the datasource as `RPCRequest` properties when performing the fetch operation on the dataSource to obtain a data-value to display-value mapping
`java.lang.String`	`getOptionOperationId()` If this item has a specified `optionDataSource`, this attribute may be set to specify an explicit `operationId` when performing a fetch against the option dataSource to pick up display value mapping.
`static FormItem`	`getOrCreateRef(JavaScriptObject jsObj)`
`int`	`getPageLeft()` Returns the drawn page-left coordinate of this form item in pixels.
`Rectangle`	`getPageRect()` Return the page-level coordinates of this object.
`int`	`getPageTop()` Returns the drawn page-top coordinate of this form item in pixels.
`java.lang.Integer`	`getPickerIconHeight()` If `showPickerIcon` is true for this item, this property governs the size of the picker icon.
`java.lang.String`	`getPickerIconName()` If `showPickerIcon` is true, this attribute specifies the `name` applied to the picker icon
`java.lang.String`	`getPickerIconSrc()` If `showPickerIcon` is true for this item, this property governs the src of the picker icon image to be displayed.
`java.lang.Integer`	`getPickerIconWidth()` If `showPickerIcon` is true for this item, this property governs the size of the picker icon.
`java.lang.String`	`getPrintTextBoxStyle()` Base CSS class name for a form item's text box element when getting printable HTML for the form.
`java.lang.String`	`getPrintTitleStyle()` Base CSS stylename for a form item's title when generating print HTML for the item.
`java.lang.String`	`getPrompt()` This text is shown as a tooltip prompt when the cursor hovers over this item.
`Rectangle`	`getRect()` Return the coordinates of this object.
`java.lang.Boolean`	`getRejectInvalidValueOnChange()` If validateOnChange is true, and validation fails for this item on change, with no suggested value, should we revert to the previous value, or continue to display the bad value entered by the user.
`java.lang.Boolean`	`getRequired()` Whether a non-empty value is required for this field to pass validation.
`java.lang.String`	`getRequiredMessage()` The required message for required field errors.
`int`	`getRowSpan()` Number of rows that this item spans
`ListGridRecord`	`getSelectedRecord()` Get the record returned from the `optionDataSource` when `fetchMissingValues` is true, and the missing value is fetched.
`java.lang.Boolean`	`getSelectOnFocus()` Allows the `selectOnFocus` behavior to be configured on a per-FormItem basis.
`java.lang.Boolean`	`getShouldSaveValue()` Should this item's value be saved in the form's values and hence returned from `form.getValues()`?
`java.lang.Boolean`	`getShowDisabled()` When this item is disabled, should it be re-styled to indicate its disabled state?
`java.lang.Boolean`	`getShowErrorIcon()` `showErrorIcons`, `showErrorText`, and `showErrorStyle` control how validation errors are displayed when they are displayed inline in the form (next to the form item where there is a validation error).
`java.lang.Boolean`	`getShowErrorStyle()` `showErrorIcons`, `showErrorText`, and `showErrorStyle` control how validation errors are displayed when they are displayed inline in the form (next to the form item where there is a validation error).
`java.lang.Boolean`	`getShowErrorText()` `showErrorIcons`, `showErrorText`, and `showErrorStyle` control how validation errors are displayed when they are displayed inline in the form (next to the form item where there is a validation error).
`java.lang.Boolean`	`getShowFocused()` When this item receives focus, should it be re-styled to indicate it has focus?
`java.lang.Boolean`	`getShowFocusedIcons()` If we're showing icons, should we change their image source to the appropriate focused source when this item has focus? Can be overridden on a per icon basis by the formItemIcon `showFocused` property.
`java.lang.Boolean`	`getShowFocusedPickerIcon()` If `showPickerIcon` is true for this item, should the picker icon show a focused image when the form item has focus?
`java.lang.Boolean`	`getShowHint()` If a hint is defined for this form item, should it be shown?
`java.lang.Boolean`	`getShowIcons()` Set to false to suppress writing out any `icons` for this item.
`java.lang.Boolean`	`getShowOverIcons()` If we're showing icons, should we change their image source to the appropriate over source when the user rolls over (or puts focus onto) them? Can be overridden on a per icon basis by the formItemIcon `showOver` property.
`java.lang.Boolean`	`getShowPickerIcon()` Should we show a special 'picker' `icon` for this form item.
`java.lang.Boolean`	`getShowTitle()` Should we show a title cell for this formItem?
`java.lang.Boolean`	`getShowValueIconOnly()` If `valueIcons` is set, this property may be set to show the valueIcon only and prevent the standard form item element or text from displaying
`java.lang.Boolean`	`getStartRow()` Whether this item should always start a new row in the form layout.
`java.lang.Boolean`	`getStopOnError()` Indicates that if validation fails, the user should not be allowed to exit the field - focus will be forced back into the field until the error is corrected.
`java.lang.Boolean`	`getSuppressValueIcon()` If `valueIcons` is set, this property may be set to prevent the value icons from showing up next to the form items value
`java.lang.Boolean`	`getSynchronousValidation()` If enabled, whenever validation is triggered and a request to the server is required, user interactivity will be blocked until the request returns.
`java.lang.Integer`	`getTabIndex()` TabIndex for the form item within the form, which controls the order in which controls are visited when the user hits the tab or shift-tab keys to navigate between items.
`Alignment`	`getTextAlign()` Alignment of the text / content within this form item.
`java.lang.String`	`getTextBoxStyle()` Base CSS class name for a form item's text box element.
`TimeDisplayFormat`	`getTimeFormatter()` Time-format to apply to date type values within this formItem.
`java.lang.String`	`getTitle()` User visible title for this form item.
`Alignment`	`getTitleAlign()` Alignment of this item's title in its cell.
`int`	`getTitleColSpan()` Number of columns that this item's title spans.
`TitleOrientation`	`getTitleOrientation()` On which side of this item should the title be placed.
`java.lang.String`	`getTitleStyle()` Base CSS class name for a form item's title.
`VerticalAlignment`	`getTitleVAlign()` Vertical alignment of this item's title in its cell.
`java.lang.String`	`getTooltip()` This text is shown as a tooltip prompt when the cursor hovers over this item.
`int`	`getTop()` Top coordinate of this item in pixels.
`java.lang.String`	`getType()` The DynamicForm picks a field renderer based on the type of the field (and sometimes other attributes of the field).
`java.lang.Boolean`	`getValidateOnChange()` If true, form items will be validated when each item's "change" handler is fired as well as when the entire form is submitted or validated.
`java.lang.Boolean`	`getValidateOnExit()` If true, form items will be validated when each item's "editorExit" handler is fired as well as when the entire form is submitted or validated.
`OperatorId[]`	`getValidOperators()` Array of valid filtering operators (eg "greaterThan") that are legal for this FormItem.
`java.lang.Object`	`getValue()` Return the value tracked by this form item.
`java.lang.String`	`getValueField()` If this form item maps data values to display values by retrieving the `displayField` values from an `optionDataSource`, this property denotes the the field to use as the underlying data value in records from the optionDataSource. If unset, assumed to be the `name` of this form item.
`java.lang.String`	`getValueFieldName()` Getter method to retrieve the `valueField` for this item.
`java.lang.Integer`	`getValueIconHeight()` If `valueIcons` is specified, use this property to specify a height for the value icon written out.
`int`	`getValueIconLeftPadding()` If we're showing a value icon, this attribute governs the amount of space between the icon and the left edge of the form item cell
`int`	`getValueIconRightPadding()` If we're showing a value icon, this attribute governs the amount of space between the icon and the label of the form item
`int`	`getValueIconSize()` If `valueIcons` is specified, this property may be used to specify both the width and height of the icon written out.
`java.lang.Integer`	`getValueIconWidth()` If `valueIcons` is specified, use this property to specify a width for the value icon written out.
`java.lang.Boolean`	`getVisible()` Whether this item is currently visible.
`int`	`getVisibleHeight()` Output the drawn height for this item in pixels.
`int`	`getVisibleWidth()` Output the drawn width for this item in pixels.
`int`	`getWidth()` Width of the FormItem.
`java.lang.Boolean`	`getWrapTitle()` If specified determines whether this items title should wrap.
`java.lang.Boolean`	`hasAdvancedCriteria()` Does this form item produce an `AdvancedCriteria` sub criterion object? If this method returns true, `DynamicForm.getValuesAsCriteria` on the form containing this item will always return an `AdvancedCriteria` object, calling `FormItem.getCriterion` on each item to retrieve the individual criteria.
`void`	`hide()` Hide this form item.
`void`	`invalidateDisplayValueCache()` If this item has a specified `displayField`, the value displayed to the user for this item may be derived from another field.
`protected boolean`	`isCreated()`
`java.lang.Boolean`	`isDisabled()` Is this item disabled?
`java.lang.Boolean`	`isDrawn()` Returns true if this item has been written out into the DOM.
`void`	`redraw()` Causes the FormItem to be redrawn immediately with the new properties.
`void`	`setAccessKey(java.lang.String accessKey)` AccessKey - a keyboard shortcut to trigger a form item's default behavior. Note: Alt+ (or in Moz Firefox 2.0 and above, Shift+Alt+) the specified key will trigger the form item's default behavior.
`void`	`setAlign(Alignment align)` Alignment of this item in its cell.
`void`	`setAllowExpressions(java.lang.Boolean allowExpressions)` For a form that produces filter criteria (see `form.getValuesAsCriteria()`), allows the user to type in simple expressions to cause filtering with that operator.
`void`	`setAlwaysFetchMissingValues(java.lang.Boolean alwaysFetchMissingValues)` If this form item has a specified `optionDataSource` and `fetchMissingValues` is true, when the item value changes, a fetch will be performed against the optionDataSource to retrieve the related record if `displayField` is specified and the new item value is not present in any valueMap explicitly specified on the item.
`void`	`setAttribute(java.lang.String attribute, BaseClass[] value)`
`void`	`setAttribute(java.lang.String attribute, boolean value)`
`void`	`setAttribute(java.lang.String attribute, java.lang.Boolean value)`
`void`	`setAttribute(java.lang.String attribute, DataClass value)`
`void`	`setAttribute(java.lang.String attribute, DataClass[] value)`
`void`	`setAttribute(java.lang.String attribute, java.util.Date value)`
`void`	`setAttribute(java.lang.String attribute, double value)`
`void`	`setAttribute(java.lang.String attribute, int value)`
`void`	`setAttribute(java.lang.String attribute, int[] value)`
`void`	`setAttribute(java.lang.String attribute, JavaScriptObject value)`
`void`	`setAttribute(java.lang.String attribute, java.util.Map value)`
`void`	`setAttribute(java.lang.String attribute, java.lang.String value)`
`void`	`setAttribute(java.lang.String attribute, java.lang.String[] value)`
`void`	`setAttribute(java.lang.String attribute, ValueEnum[] value)`
`void`	`setBrowserSpellCheck(java.lang.Boolean browserSpellCheck)` If this browser supports spell-checking of text editing elements, do we want this enabled for this item? If unset the property will be inherited from the containing form.
`void`	`setCanFocus(java.lang.Boolean canFocus)` Is this form item focusable? Setting this property to true on an otherwise non-focusable element such as a `StaticTextItem` will cause the item to be included in the page's tab order and respond to keyboard events.
`void`	`setCellHeight(java.lang.Integer cellHeight)` If specified, this property will govern the height of the cell in which this form item is rendered.
`void`	`setCellStyle(java.lang.String cellStyle)` CSS style applied to the form item as a whole, including the text element, any icons, and any hint text for the item.
`void`	`setColSpan(int colSpan)` Number of columns that this item spans.
`void`	`setColSpan(java.lang.String colSpan)` Number of columns that this item spans.
`void`	`setCriteriaField(java.lang.String criteriaField)` When using `operator`, the name of the DataSource field for the `Criterion` this FormItem generates.
`void`	`setCriterion(Criterion criterion)` Update this form item to reflect a criterion object from within an AdvancedCriteria.
`void`	`setDataPath(java.lang.String dataPath)` dataPath for this item.
`void`	`setDateFormatter(DateDisplayFormat dateFormatter)` Display format to use for date type values within this formItem.
`void`	`setDefaultIconSrc(java.lang.String defaultIconSrc)` Default icon image source.
`void`	`setDefaultValue(java.lang.Boolean defaultValue)` Value used when no value is provided for this item.
`void`	`setDefaultValue(java.util.Date defaultValue)` Value used when no value is provided for this item.
`void`	`setDefaultValue(java.lang.Float defaultValue)` Value used when no value is provided for this item.
`void`	`setDefaultValue(java.lang.Integer defaultValue)` Value used when no value is provided for this item.
`void`	`setDefaultValue(java.lang.String defaultValue)` Value used when no value is provided for this item.
`void`	`setDisabled(java.lang.Boolean disabled)` Whether this item is disabled.
`void`	`setDisplayField(java.lang.String displayField)` Specifies an alternative field from which display values should be retrieved for this item.
`void`	`setDisplayFormat(DateDisplayFormat displayFormat)` Fields of type `"date"` or `"time"` will be edited using a `DateItem` or `TimeItem` by default.
`void`	`setDisplayFormat(TimeFormatter displayFormat)` Fields of type `"date"` or `"time"` will be edited using a `DateItem` or `TimeItem` by default.
`void`	`setEditorType(FormItem editorType)` Name of the FormItem properties to use for editing.
`void`	`setEditorValueFormatter(FormItemValueFormatter formatter)` An optional `FormItemValueFormatter` to map this item's current data value to a display value.
`void`	`setEditorValueParser(FormItemValueParser valueParser)` An optional `FormItemValueParser` to map a user-entered display value to a data value for storage.
`void`	`setEmptyDisplayValue(java.lang.String emptyDisplayValue)` Text to display when this form item has a null or undefined value.
`void`	`setEmptyValueIcon(java.lang.String emptyValueIcon)` This property allows the developer to specify an icon to display when this item has no value.
`void`	`setEndRow(java.lang.Boolean endRow)` Whether this item should end the row it's in in the form layout
`void`	`setErrorFormatter(FormItemErrorFormatter errorFormatter)` Register a custom error formatter for this FormItem.
`void`	`setErrorIconHeight(int errorIconHeight)` Height of the error icon, if we're showing icons when validation errors occur.
`void`	`setErrorIconSrc(java.lang.String errorIconSrc)` URL of the image to show as an error icon, if we're showing icons when validation errors occur.
`void`	`setErrorIconWidth(int errorIconWidth)` Height of the error icon, if we're showing icons when validation errors occur.
`void`	`setErrorMessageWidth(int errorMessageWidth)` When `showInlineErrors` and `showErrorText` are both true and `errorOrientation` is "left" or "right", errorMessageWidth is the amount to reduce the width of the editor to accommodate the error message and icon.
`void`	`setErrorOrientation(FormErrorOrientation errorOrientation)` If `showInlineErrors` is true, where should the error icon and text appear relative to the form item itself.
`void`	`setFetchMissingValues(java.lang.Boolean fetchMissingValues)` If this form item has a specified `optionDataSource`, should the item ever perform a fetch against this dataSource to retrieve the related record.
`void`	`setFilterLocally(java.lang.Boolean filterLocally)` If this form item is mapping data values to a display value by fetching records from a dataSource (see `optionDataSource`, `displayField` and `fetchMissingValues`), setting this property to true ensures that when the form item value is set, entire data-set from the dataSource is loaded at once and used as a valueMap, rather than just loading the display value for the current value.
`void`	`setGlobalTabIndex(java.lang.Integer globalTabIndex)` TabIndex for the form item within the page.
`void`	`setHeight(int height)` Height of the FormItem.
`void`	`setHeight(java.lang.String height)`
`void`	`setHint(java.lang.String hint)` Specifies "hint" string to show next to the form item to indicate something to the user.
`void`	`setHintStyle(java.lang.String hintStyle)` CSS class for the "hint" string.
`void`	`setHoverAlign(Alignment hoverAlign)` Text alignment for text displayed in this item's hover canvas, if shown.
`void`	`setHoverDelay(java.lang.Integer hoverDelay)` If specified, this is the number of milliseconds to wait between the user rolling over this form item, and triggering any hover action for it. If not specified `this.form.itemHoverDelay` will be used instead.
`void`	`setHoverHeight(java.lang.Integer hoverHeight)` Option to specify a height for any hover shown for this item.
`void`	`setHoverOpacity(java.lang.Integer hoverOpacity)` Opacity for any hover shown for this item
`void`	`setHoverStyle(java.lang.String hoverStyle)` Explicit CSS Style for any hover shown for this item.
`void`	`setHoverVAlign(VerticalAlignment hoverVAlign)` Vertical text alignment for text displayed in this item's hover canvas, if shown.
`void`	`setHoverWidth(java.lang.Integer hoverWidth)` Option to specify a width for any hover shown for this item.
`void`	`setIconHeight(int iconHeight)` Default height for form item icons
`void`	`setIconPrompt(java.lang.String iconPrompt)` Default prompt (and tooltip-text) for icons.
`void`	`setIcons(FormItemIcon... icons)` An array of descriptor objects for icons to display in a line after this form item.
`void`	`setIconVAlign(VerticalAlignment iconVAlign)` How should icons be aligned vertically for this form item.
`void`	`setIconWidth(int iconWidth)` Default width for form item icons
`void`	`setImageURLPrefix(java.lang.String imageURLPrefix)` Prefix to apply to the beginning of any `valueIcons` when determining the URL for the image.
`void`	`setImageURLSuffix(java.lang.String imageURLSuffix)` Suffix to apply to the end of any `valueIcons` when determining the URL for the image.
`void`	`setImplicitSave(java.lang.Boolean implicitSave)` When true, indicates that changes to this item will cause an automatic save on a `delay`, as well as when the entire form is submitted.
`void`	`setImplicitSaveOnBlur(java.lang.Boolean implicitSaveOnBlur)` If not set to false, form item values will be saved when this item's "editorExit" handler is fired as well as on a delay and when the entire form is submitted.
`void`	`setInitHandler(FormItemInitHandler initHandler)` Specify a notification method to fire when this formItem is initialized in JavaScript.
`void`	`setInputFormat(java.lang.String inputFormat)` For fields of type `"date"`, if this is an editable field such as a `TextItem`, this property allows you to specify the `inputFormat` applied to the item.
`void`	`setInputTransformer(FormItemInputTransformer inputTransformer)` The transformer is called when a FormItem's value is about to change as the result of user interaction.
`void`	`setItemHoverFormatter(FormItemHoverFormatter hoverFormatter)` The FormItemHoverFormatter should return the HTML to display in a hover canvas when the user holds the mousepointer over this item.
`void`	`setItemTitleHoverFormatter(FormItemHoverFormatter hoverFormatter)` The FormItemHoverFormatter should return the HTML to display in a hover canvas when the user holds the mousepointer over the item's title.
`void`	`setLeft(int left)` Left coordinate of this item in pixels.
`void`	`setLocateItemBy(java.lang.String locateItemBy)` When AutoTest.getElement is used to parse locator strings generated by link{isc.AutoTest.getLocator()} for this form item, should the item be identified? By default if the item has a name this will always be used, however for items with no name, the following options are available: `"title"` use the title as an identifier within this form `"value"` use the value of the item to identify it (often used for items with a static defaultValue such as HeaderItems `"index"` use the index within the form's items array.
`void`	`setMultipleValueSeparator(java.lang.String multipleValueSeparator)` If this item is displaying multiple values, this property will be the string that separates those values for display purposes.
`void`	`setName(java.lang.String name)` Name for this form field.
`void`	`setOperator(OperatorId operator)` `OperatorId` to be used when `DynamicForm.getValuesAsCriteria` is called.
`void`	`setOptionCriteria(Criteria optionCriteria)` If this item has a specified `optionDataSource`, and this property may be used to specify criteria to pass to the datasource when performing the fetch operation on the dataSource to obtain a data-value to display-value mapping
`void`	`setOptionDataSource(DataSource dataSource)`
`void`	`setOptionFilterContext(RPCRequest rpcRequestProperties)` If this item has a specified `optionDataSource`, and this property is not null, this will be passed to the datasource as `RPCRequest` properties when performing the fetch operation on the dataSource to obtain a data-value to display-value mapping
`void`	`setOptionOperationId(java.lang.String optionOperationId)` If this item has a specified `optionDataSource`, this attribute may be set to specify an explicit `operationId` when performing a fetch against the option dataSource to pick up display value mapping.
`void`	`setPickerIconHeight(java.lang.Integer pickerIconHeight)` If `showPickerIcon` is true for this item, this property governs the size of the picker icon.
`void`	`setPickerIconName(java.lang.String pickerIconName)` If `showPickerIcon` is true, this attribute specifies the `name` applied to the picker icon
`void`	`setPickerIconSrc(java.lang.String pickerIconSrc)` If `showPickerIcon` is true for this item, this property governs the src of the picker icon image to be displayed.
`void`	`setPickerIconWidth(java.lang.Integer pickerIconWidth)` If `showPickerIcon` is true for this item, this property governs the size of the picker icon.
`void`	`setPrintTextBoxStyle(java.lang.String printTextBoxStyle)` Base CSS class name for a form item's text box element when getting printable HTML for the form.
`void`	`setPrintTitleStyle(java.lang.String printTitleStyle)` Base CSS stylename for a form item's title when generating print HTML for the item.
`void`	`setPrompt(java.lang.String prompt)` This text is shown as a tooltip prompt when the cursor hovers over this item.
`void`	`setProperty(java.lang.String property, boolean value)`
`void`	`setProperty(java.lang.String property, double value)`
`void`	`setProperty(java.lang.String property, int value)`
`void`	`setProperty(java.lang.String property, JavaScriptObject value)`
`void`	`setProperty(java.lang.String property, java.lang.String value)`
`void`	`setRedrawOnChange(boolean redrawOnChange)` Setting to true causes the FormItem to be immediately redrawn with the new properties when its value changes
`void`	`setRejectInvalidValueOnChange(java.lang.Boolean rejectInvalidValueOnChange)` If validateOnChange is true, and validation fails for this item on change, with no suggested value, should we revert to the previous value, or continue to display the bad value entered by the user.
`void`	`setRequired(java.lang.Boolean required)` Whether a non-empty value is required for this field to pass validation.
`void`	`setRequiredMessage(java.lang.String requiredMessage)` The required message for required field errors.
`void`	`setRowSpan(int rowSpan)` Number of rows that this item spans
`void`	`setSelectOnFocus(java.lang.Boolean selectOnFocus)` Allows the `selectOnFocus` behavior to be configured on a per-FormItem basis.
`void`	`setShouldSaveValue(java.lang.Boolean shouldSaveValue)` Should this item's value be saved in the form's values and hence returned from `form.getValues()`?
`void`	`setShowDisabled(java.lang.Boolean showDisabled)` When this item is disabled, should it be re-styled to indicate its disabled state? If this method is called after the component has been drawn/initialized: Setter method for `showDisabled`
`void`	`setShowErrorIcon(java.lang.Boolean showErrorIcon)` `showErrorIcons`, `showErrorText`, and `showErrorStyle` control how validation errors are displayed when they are displayed inline in the form (next to the form item where there is a validation error).
`void`	`setShowErrorStyle(java.lang.Boolean showErrorStyle)` `showErrorIcons`, `showErrorText`, and `showErrorStyle` control how validation errors are displayed when they are displayed inline in the form (next to the form item where there is a validation error).
`void`	`setShowErrorText(java.lang.Boolean showErrorText)` `showErrorIcons`, `showErrorText`, and `showErrorStyle` control how validation errors are displayed when they are displayed inline in the form (next to the form item where there is a validation error).
`void`	`setShowFocused(java.lang.Boolean showFocused)` When this item receives focus, should it be re-styled to indicate it has focus?
`void`	`setShowFocusedIcons(java.lang.Boolean showFocusedIcons)` If we're showing icons, should we change their image source to the appropriate focused source when this item has focus? Can be overridden on a per icon basis by the formItemIcon `showFocused` property.
`void`	`setShowFocusedPickerIcon(java.lang.Boolean showFocusedPickerIcon)` If `showPickerIcon` is true for this item, should the picker icon show a focused image when the form item has focus?
`void`	`setShowHint(java.lang.Boolean showHint)` If a hint is defined for this form item, should it be shown?
`void`	`setShowIcons(java.lang.Boolean showIcons)` Set to false to suppress writing out any `icons` for this item.
`void`	`setShowIfCondition(FormItemIfFunction showIf)` Expression that's evaluated to see if an item should be dynamically hidden.
`void`	`setShowOverIcons(java.lang.Boolean showOverIcons)` If we're showing icons, should we change their image source to the appropriate over source when the user rolls over (or puts focus onto) them? Can be overridden on a per icon basis by the formItemIcon `showOver` property.
`void`	`setShowPickerIcon(java.lang.Boolean showPickerIcon)` Should we show a special 'picker' `icon` for this form item.
`void`	`setShowTitle(java.lang.Boolean showTitle)` Should we show a title cell for this formItem?
`void`	`setShowValueIconOnly(java.lang.Boolean showValueIconOnly)` If `valueIcons` is set, this property may be set to show the valueIcon only and prevent the standard form item element or text from displaying
`void`	`setStartRow(java.lang.Boolean startRow)` Whether this item should always start a new row in the form layout.
`void`	`setStopOnError(java.lang.Boolean stopOnError)` Indicates that if validation fails, the user should not be allowed to exit the field - focus will be forced back into the field until the error is corrected.
`void`	`setSuppressValueIcon(java.lang.Boolean suppressValueIcon)` If `valueIcons` is set, this property may be set to prevent the value icons from showing up next to the form items value
`void`	`setSynchronousValidation(java.lang.Boolean synchronousValidation)` If enabled, whenever validation is triggered and a request to the server is required, user interactivity will be blocked until the request returns.
`void`	`setTabIndex(java.lang.Integer tabIndex)` TabIndex for the form item within the form, which controls the order in which controls are visited when the user hits the tab or shift-tab keys to navigate between items.
`void`	`setTextAlign(Alignment textAlign)` Alignment of the text / content within this form item.
`void`	`setTextBoxStyle(java.lang.String textBoxStyle)` Base CSS class name for a form item's text box element.
`void`	`setTimeFormatter(TimeDisplayFormat timeFormatter)` Time-format to apply to date type values within this formItem.
`void`	`setTitle(java.lang.String title)` User visible title for this form item.
`void`	`setTitleAlign(Alignment titleAlign)` Alignment of this item's title in its cell.
`void`	`setTitleColSpan(int titleColSpan)` Number of columns that this item's title spans.
`void`	`setTitleOrientation(TitleOrientation titleOrientation)` On which side of this item should the title be placed.
`void`	`setTitleStyle(java.lang.String titleStyle)` Base CSS class name for a form item's title.
`void`	`setTitleVAlign(VerticalAlignment titleVAlign)` Vertical alignment of this item's title in its cell.
`void`	`setTooltip(java.lang.String tooltip)` This text is shown as a tooltip prompt when the cursor hovers over this item.
`void`	`setTop(int top)` Top coordinate of this item in pixels.
`void`	`setType(java.lang.String type)` The DynamicForm picks a field renderer based on the type of the field (and sometimes other attributes of the field).
`void`	`setValidateOnChange(java.lang.Boolean validateOnChange)` If true, form items will be validated when each item's "change" handler is fired as well as when the entire form is submitted or validated.
`void`	`setValidateOnExit(java.lang.Boolean validateOnExit)` If true, form items will be validated when each item's "editorExit" handler is fired as well as when the entire form is submitted or validated.
`void`	`setValidators(Validator... validators)` Validators for this form item.
`void`	`setValidOperators(OperatorId... validOperators)` Array of valid filtering operators (eg "greaterThan") that are legal for this FormItem.
`void`	`setValue(boolean value)` Set the value of the form item.
`void`	`setValue(java.util.Date value)` Set the value of the form item.
`void`	`setValue(double value)` Set the value of the form item.
`void`	`setValue(float value)`
`void`	`setValue(int value)`
`void`	`setValue(java.lang.Object value)` Set the value of the form item as an object.
`void`	`setValue(java.lang.String value)` Set the value of the form item.
`void`	`setValueField(java.lang.String valueField)` If this form item maps data values to display values by retrieving the `displayField` values from an `optionDataSource`, this property denotes the the field to use as the underlying data value in records from the optionDataSource. If unset, assumed to be the `name` of this form item.
`void`	`setValueFormatter(FormItemValueFormatter formatter)` Optional `FormItemValueFormatter`, if provided, is evaluated to get the display value to show for this form items underlying data value.
`void`	`setValueIconHeight(java.lang.Integer valueIconHeight)` If `valueIcons` is specified, use this property to specify a height for the value icon written out.
`void`	`setValueIconLeftPadding(int valueIconLeftPadding)` If we're showing a value icon, this attribute governs the amount of space between the icon and the left edge of the form item cell
`void`	`setValueIconMapper(ValueIconMapper valueIconMapper)` Set the FormItem Value Icon mapper that allows the developer to specify the image source for an icon to be displayed for the current form item value.
`void`	`setValueIconRightPadding(int valueIconRightPadding)` If we're showing a value icon, this attribute governs the amount of space between the icon and the label of the form item
`void`	`setValueIcons(java.util.Map valueIcons)` Set the valueIcons for this item.
`void`	`setValueIconSize(int valueIconSize)` If `valueIcons` is specified, this property may be used to specify both the width and height of the icon written out.
`void`	`setValueIconWidth(java.lang.Integer valueIconWidth)` If `valueIcons` is specified, use this property to specify a width for the value icon written out.
`void`	`setValueMap(java.util.LinkedHashMap valueMap)` Set the valueMap for this item.
`void`	`setValueMap(java.lang.String... valueMap)` Set the valueMap for this item.
`void`	`setVisible(java.lang.Boolean visible)` Whether this item is currently visible.
`void`	`setWidth(int width)` Width of the FormItem.
`void`	`setWidth(java.lang.String width)`
`void`	`setWrapTitle(java.lang.Boolean wrapTitle)` If specified determines whether this items title should wrap.
`java.lang.Boolean`	`shouldFetchMissingValue(java.lang.Object newValue)` If this field has a specified `optionDataSource`, should we perform a fetch against that dataSource to find the record that matches this field's value?
`void`	`show()` Show this form item.
`void`	`showPicker()` Method to show a picker for this item.
`void`	`stopHover()` This method is fired when the user rolls off this item (or the title for this item) and will clear any hover canvas shown by the item.
`void`	`updateState()` Update the visual state of a FormItem to reflect any changes in state or any changes in style settings (eg `textBoxStyle`).
`java.lang.Boolean`	`validate()` Validate this item.

Methods inherited from class com.smartgwt.client.core.RefDataClass
`getRef, getRef`

Methods inherited from class com.smartgwt.client.core.DataClass
`doAddHandler, fireEvent, getAttributeAsDoubleArray, getAttributeAsIntArray, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsStringArray, getAttributes, getHandlerCount, getJsObj, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute`

Methods inherited from class com.smartgwt.client.core.JsObject
`setJsObj`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Methods inherited from interface com.google.gwt.event.shared.HasHandlers
`fireEvent`

Constructor Detail

FormItem

public FormItem()

FormItem

public FormItem(JavaScriptObject jsObj)

FormItem

public FormItem(java.lang.String name)

Method Detail

getOrCreateRef

public static FormItem getOrCreateRef(JavaScriptObject jsObj)

setAccessKey

public void setAccessKey(java.lang.String accessKey)

AccessKey - a keyboard shortcut to trigger a form item's default behavior.
Note: Alt+ (or in Moz Firefox 2.0 and above, Shift+Alt+) the specified key will trigger the form item's default behavior.

Parameters:: accessKey - accessKey Default value is null
See Also:: Focus overview and related methods

getAccessKey

public java.lang.String getAccessKey()

AccessKey - a keyboard shortcut to trigger a form item's default behavior.
Note: Alt+ (or in Moz Firefox 2.0 and above, Shift+Alt+) the specified key will trigger the form item's default behavior.

Returns:: String
See Also:: Focus overview and related methods

setAlign

public void setAlign(Alignment align)

Alignment of this item in its cell. Note that the alignment of content within this item can be separately controlled via textAlign (typically only applies to items showing a "textBox", such as textItems or selectItems).

Parameters:: align - align Default value is Canvas.LEFT
See Also:: Appearance overview and related methods

getAlign

public Alignment getAlign()

Returns:: Alignment
See Also:: Appearance overview and related methods

setAllowExpressions

public void setAllowExpressions(java.lang.Boolean allowExpressions)

For a form that produces filter criteria (see form.getValuesAsCriteria()), allows the user to type in simple expressions to cause filtering with that operator. For example, entering ">5" means values greater than 5, and ">0 and <5" means values between 0 and 5.

The following table lists character sequences that can be entered as a prefix to a value, and the corresponding operator that will be used. Note that in the absence of a prefix, the operator specified via operator is used.

Prefix	Operator
<	lessThan
>	greaterThan
<=	lessThanOrEqual
>=	greaterThanOrEqual
someValue...someValue	betweenInclusive
!	notEqual
^	startsWith
\|	endsWith
!^	notStartsWith plus logical not
!@	notEndsWith plus logical not
~	contains
!~	notContains
#	isNull
!#	isNotNull
==	exact match (for fields where 'contains' is the default)

Two further special notations are allowed:

/regex/ means the value is taken as a regular expression and applied via the "regexp" operator
=.fieldName means the value should match the value of another field. Either the user-visible title of the field (field.title) or the field's name (field.name) may be used.

In all cases, if an operator is disallowed for the field (via field.validOperators at either the dataSource or field level), the operator character is ignored (treated as part of a literal value).

By default, the case-insensitive version of the operator is used (eg, startsWith will actually use "iStartsWith"). To avoid this, explicitly set item.operator (the default operator) to any case sensitive operator (eg "equals" or "contains") and case sensitive operators will be used for user-entered expressions.

Compound expressions (including "and" and "or") are allowed only for numeric or date/time types.

To enable this behavior for all fields in a form that allow text entry, see allowExpressions.

Note that, like operator, enabling allowExpressions:true causes form.getValuesAsCriteria()) to return AdvancedCriteria.

Parameters:: allowExpressions - allowExpressions Default value is null

getAllowExpressions

public java.lang.Boolean getAllowExpressions()

Prefix	Operator
<	lessThan
>	greaterThan
<=	lessThanOrEqual
>=	greaterThanOrEqual
someValue...someValue	betweenInclusive
!	notEqual
^	startsWith
\|	endsWith
!^	notStartsWith plus logical not
!@	notEndsWith plus logical not
~	contains
!~	notContains
#	isNull
!#	isNotNull
==	exact match (for fields where 'contains' is the default)

Two further special notations are allowed:

/regex/ means the value is taken as a regular expression and applied via the "regexp" operator
=.fieldName means the value should match the value of another field. Either the user-visible title of the field (field.title) or the field's name (field.name) may be used.

In all cases, if an operator is disallowed for the field (via field.validOperators at either the dataSource or field level), the operator character is ignored (treated as part of a literal value).

Compound expressions (including "and" and "or") are allowed only for numeric or date/time types.

To enable this behavior for all fields in a form that allow text entry, see allowExpressions.

Note that, like operator, enabling allowExpressions:true causes form.getValuesAsCriteria()) to return AdvancedCriteria.

Returns:: Boolean

setAlwaysFetchMissingValues

public void setAlwaysFetchMissingValues(java.lang.Boolean alwaysFetchMissingValues)

If this form item has a specified optionDataSource and fetchMissingValues is true, when the item value changes, a fetch will be performed against the optionDataSource to retrieve the related record if displayField is specified and the new item value is not present in any valueMap explicitly specified on the item.

Setting this property to true means that a fetch will occur against the optionDataSource to retrieve the related record even if displayField is unset, or the item has a valueMap which explicitly contains this field's value.

An example of a use case where this might be set would be if FormItem.formatValue or FormItem.formatEditorValue were written to display properties from the selected record.

Note - for efficiency we cache the associated record once a fetch has been performed, meaning if the value changes, then reverts to a previously seen value, we do not kick off an additional fetch even if this property is true. If necessary this cache may be explicitly invalidated via a call to FormItem.invalidateDisplayValueCache

Note : This is an advanced setting

Parameters:: alwaysFetchMissingValues - alwaysFetchMissingValues Default value is false

getAlwaysFetchMissingValues

public java.lang.Boolean getAlwaysFetchMissingValues()

An example of a use case where this might be set would be if FormItem.formatValue or FormItem.formatEditorValue were written to display properties from the selected record.

Returns:: Boolean

setBrowserSpellCheck

public void setBrowserSpellCheck(java.lang.Boolean browserSpellCheck)

If this browser supports spell-checking of text editing elements, do we want this enabled for this item? If unset the property will be inherited from the containing form.

Notes:
- this property only applies to text based items such as TextItem and TextAreaItem.
- this property is not supported on all browsers.

Note : This is an advanced setting

Parameters:: browserSpellCheck - browserSpellCheck Default value is null
See Also:: DynamicForm.setBrowserSpellCheck(java.lang.Boolean)

getBrowserSpellCheck

public java.lang.Boolean getBrowserSpellCheck()

If this browser supports spell-checking of text editing elements, do we want this enabled for this item? If unset the property will be inherited from the containing form.

Notes:
- this property only applies to text based items such as TextItem and TextAreaItem.
- this property is not supported on all browsers.

Returns:: Boolean
See Also:: DynamicForm.getBrowserSpellCheck()

setCanFocus

public void setCanFocus(java.lang.Boolean canFocus)

Is this form item focusable? Setting this property to true on an otherwise non-focusable element such as a StaticTextItem will cause the item to be included in the page's tab order and respond to keyboard events.

Note : This is an advanced setting

Parameters:: canFocus - canFocus Default value is null
See Also:: Focus overview and related methods

getCanFocus

public java.lang.Boolean getCanFocus()

Returns:: Returns true for items that can accept keyboard focus such as data items (TextItems, TextAreaItems, etc), CanvasItems with a focusable canvas, or items where canFocus was explicitly set to true.
See Also:: Focus overview and related methods

setCellHeight

public void setCellHeight(java.lang.Integer cellHeight)

If specified, this property will govern the height of the cell in which this form item is rendered. Will not apply when the containing DynamicForm sets itemLayout:"absolute".

Parameters:: cellHeight - cellHeight Default value is null

getCellHeight

public java.lang.Integer getCellHeight()

If specified, this property will govern the height of the cell in which this form item is rendered. Will not apply when the containing DynamicForm sets itemLayout:"absolute".

Returns:: Integer

setCellStyle

public void setCellStyle(java.lang.String cellStyle)

CSS style applied to the form item as a whole, including the text element, any icons, and any hint text for the item. Applied to the cell containing the form item.

NOTE: See the CompoundFormItem_skinning discussion for special skinning considerations.

Parameters:: cellStyle - cellStyle Default value is "formCell"
See Also:: Appearance overview and related methods

getCellStyle

public java.lang.String getCellStyle()

CSS style applied to the form item as a whole, including the text element, any icons, and any hint text for the item. Applied to the cell containing the form item.

NOTE: See the CompoundFormItem_skinning discussion for special skinning considerations.

Returns:: String
See Also:: Appearance overview and related methods

getContainerWidget

public Canvas getContainerWidget()

A Read-Only pointer to the Smart GWT canvas that holds this form item. In most cases this will be the DynamicForm containing the item but in some cases editable components handle writing out form items directly. An example of this is

Grid
 Editing

- when a listGrid shows per-field editors, the containerWidget for each item will be the listGrid body.

Note that even if the containerWidget is not a DynamicForm, a DynamicForm will still exist for the item (available as form), allowing access to standard APIs such as DynamicForm.getValues

Returns:: Canvas

setCriteriaField

public void setCriteriaField(java.lang.String criteriaField)

When using operator, the name of the DataSource field for the Criterion this FormItem generates. If not specified, defaults to name.

Generally, because criteriaField defaults to item.name, you don't need to specify it. However, if more than one FormItem specifies criteria for the same DataSource field, they will need unique values for name but should set criteriaField to the name of DataSource field they both target.

For example, if two DateItems are used to provide a min and max date for a single field called "joinDate", set criteriaField to "joinDate" on both fields but give the fields distinct names (eg "minDate" and "maxDate") and use those names for any programmatic access, such as DynamicForm.setValue.

Parameters:: criteriaField - criteriaField Default value is null

getCriteriaField

public java.lang.String getCriteriaField()

When using operator, the name of the DataSource field for the Criterion this FormItem generates. If not specified, defaults to name.

Returns:: String

setDataPath

public void setDataPath(java.lang.String dataPath)

dataPath for this item. Allows the user to edit details nested data structures in a flat set of form fields

Parameters:: dataPath - dataPath Default value is null

getDataPath

public java.lang.String getDataPath()

dataPath for this item. Allows the user to edit details nested data structures in a flat set of form fields

Returns:: Return the dataPath for the this formItem.

setDateFormatter

public void setDateFormatter(DateDisplayFormat dateFormatter)

Display format to use for date type values within this formItem.

Note that Fields of type "date", "datetime" or "time" will be edited using a DateItem or TimeItem by default, but this can be overridden - for canEdit:false fields, a StaticTextItem is used by default, and the developer can always specify a custom editorType as well as data type.

The timeFormatter may also be used to format underlying Date values as times (ommitting the date part entirely). If both dateFormatter and timeFormatter are specified on an item, for fields specified as type "time" the timeFormatter will be used, otherwise the dateFormatter

If item.dateFormatter and item.timeFormatter is unspecified, date display format may be defined at the component level via dateFormatter, or for fields of type "datetime" datetimeFormatter. Otherwise the default is to use the system-wide default short date format, configured via Date.setShortDisplayFormat. Specify any valid DateDisplayFormat to change the format used by this item.

Note that if this is a freeform editable field, such a TextItem, with type specified as "date" or "datetime" the system will automatically attempt to parse user entered values back to a Date value, assuming the entered string matches the date format for the field. Developers may further customize this via an explicit inputFormat or via entirely custom setEditorValueFormatter and setEditorValueParser methods.

Note : This is an advanced setting

Parameters:: dateFormatter - dateFormatter Default value is null
See Also:: setTimeFormatter(com.smartgwt.client.types.TimeDisplayFormat), Appearance overview and related methods

getDateFormatter

public DateDisplayFormat getDateFormatter()

Display format to use for date type values within this formItem.

Returns:: DateDisplayFormat
See Also:: getTimeFormatter(), Appearance overview and related methods

setDefaultIconSrc

public void setDefaultIconSrc(java.lang.String defaultIconSrc)

Default icon image source. Specify as the partial URL to an image, relative to the imgDir of this component. To specify image source for a specific icon use the icon.src property.
If this item is drawn in the disabled state, the url will be modified by adding "_Disabled" to get a disabled state image for the icon. If icon.showOver is true, this url will be modified by adding "_Over" to get an over state image for the icon.

Note : This is an advanced setting

Parameters:: defaultIconSrc - defaultIconSrc Default value is "[SKIN]/DynamicForm/default_formItem_icon.gif"

getDefaultIconSrc

public java.lang.String getDefaultIconSrc()

Returns:: String

setDisabled

public void setDisabled(java.lang.Boolean disabled)

Whether this item is disabled. Can be updated at runtime via the setDisabled() method. Note that if the widget containing this formItem is disabled, the formItem will behave in a disabled manner regardless of the setting of the item.disabled property.

Note that not all items can be disabled, and not all browsers show an obvious disabled style for native form elements.

If this method is called after the component has been drawn/initialized: Set this item to be enabled or disabled at runtime.

Parameters:: disabled - true if this item should be disabled. Default value is false
See Also:: setDisabled(java.lang.Boolean), Appearance overview and related methods, Enable & Disable Example

getDisabled

public java.lang.Boolean getDisabled()

Note that not all items can be disabled, and not all browsers show an obvious disabled style for native form elements.

Returns:: Boolean
See Also:: setDisabled(java.lang.Boolean), Appearance overview and related methods, Enable & Disable Example

setDisplayField

public void setDisplayField(java.lang.String displayField)

Specifies an alternative field from which display values should be retrieved for this item.

The display field can be either another field value in the same record or a field that must be retrieved from a related optionDataSource.

If this item is not databound (optionDataSource is unset), or bound to the same dataSource as the form as a whole, this item will call form.getValue() the form named after is implemented by picking up the value of the specified field from the Form's values object.

Otherwise this item will attempt to map its underlying value to a display value by retrieving a record from the optionDataSource where the valueField matches this item's value, and displaying the displayField value from that record. Note that if optionDataSource is set and this value is not set, FormItem.getDisplayFieldName will return the dataSource title field by default.

This essentially enables the specified optionDataSource to be used as a server based valueMap.

Parameters:: displayField - displayField Default value is null
See Also:: invalidateDisplayValueCache()

getDisplayField

public java.lang.String getDisplayField()

Specifies an alternative field from which display values should be retrieved for this item.

The display field can be either another field value in the same record or a field that must be retrieved from a related optionDataSource.

This essentially enables the specified optionDataSource to be used as a server based valueMap.

Returns:: String
See Also:: invalidateDisplayValueCache()

setEmptyDisplayValue

public void setEmptyDisplayValue(java.lang.String emptyDisplayValue)

Text to display when this form item has a null or undefined value.

Parameters:: emptyDisplayValue - emptyDisplayValue Default value is ""

getEmptyDisplayValue

public java.lang.String getEmptyDisplayValue()

Text to display when this form item has a null or undefined value.

Returns:: String

setEmptyValueIcon

public void setEmptyValueIcon(java.lang.String emptyValueIcon)

This property allows the developer to specify an icon to display when this item has no value. It is configured in the same way as any other valueIcon (see valueIcons)

Parameters:: emptyValueIcon - emptyValueIcon Default value is null

getEmptyValueIcon

public java.lang.String getEmptyValueIcon()

This property allows the developer to specify an icon to display when this item has no value. It is configured in the same way as any other valueIcon (see valueIcons)

Returns:: String

setEndRow

public void setEndRow(java.lang.Boolean endRow)

Whether this item should end the row it's in in the form layout

Parameters:: endRow - endRow Default value is false
See Also:: FormLayout overview and related methods

getEndRow

public java.lang.Boolean getEndRow()

Whether this item should end the row it's in in the form layout

Returns:: Boolean
See Also:: FormLayout overview and related methods

setErrorIconHeight

public void setErrorIconHeight(int errorIconHeight)

Height of the error icon, if we're showing icons when validation errors occur.

Parameters:: errorIconHeight - errorIconHeight Default value is 16
See Also:: setShowErrorIcon(java.lang.Boolean)

getErrorIconHeight

public int getErrorIconHeight()

Height of the error icon, if we're showing icons when validation errors occur.

Returns:: int
See Also:: getShowErrorIcon()

setErrorIconSrc

public void setErrorIconSrc(java.lang.String errorIconSrc)

URL of the image to show as an error icon, if we're showing icons when validation errors occur.

Parameters:: errorIconSrc - errorIconSrc Default value is "[SKIN]/DynamicForm/validation_error_icon.png"
See Also:: setShowErrorIcon(java.lang.Boolean)

getErrorIconSrc

public java.lang.String getErrorIconSrc()

URL of the image to show as an error icon, if we're showing icons when validation errors occur.

Returns:: String
See Also:: getShowErrorIcon()

setErrorIconWidth

public void setErrorIconWidth(int errorIconWidth)

Height of the error icon, if we're showing icons when validation errors occur.

Parameters:: errorIconWidth - errorIconWidth Default value is 16
See Also:: setShowErrorIcon(java.lang.Boolean)

getErrorIconWidth

public int getErrorIconWidth()

Height of the error icon, if we're showing icons when validation errors occur.

Returns:: int
See Also:: getShowErrorIcon()

setErrorMessageWidth

public void setErrorMessageWidth(int errorMessageWidth)

When showInlineErrors and showErrorText are both true and errorOrientation is "left" or "right", errorMessageWidth is the amount to reduce the width of the editor to accommodate the error message and icon.

Parameters:: errorMessageWidth - errorMessageWidth Default value is 80
See Also:: Validation overview and related methods

getErrorMessageWidth

public int getErrorMessageWidth()

Returns:: int
See Also:: Validation overview and related methods

setFetchMissingValues

public void setFetchMissingValues(java.lang.Boolean fetchMissingValues)

If this form item has a specified optionDataSource, should the item ever perform a fetch against this dataSource to retrieve the related record.

The fetch occurs if the item value is non null on initial draw of the form or whenever setValue() is called. Once the fetch completes, the returned record is available via the FormItem.getSelectedRecord api.

By default, a fetch will only occur if displayField is specified, and the item does not have an explicit valueMap containing the data value as a key.
However you can also set alwaysMissingFetchValues to have a fetch occur even if no displayField is specified. This ensures FormItem.getSelectedRecord will return a record if possible - useful for custom formatter functions, etc.

Note - for efficiency we cache the associated record once a fetch has been performed, meaning if the value changes, then reverts to a previously seen value, we do not kick off an additional fetch to pick up the display value for the previously seen data value. If necessary this cache may be explicitly invalidated via a call to FormItem.invalidateDisplayValueCache

Note : This is an advanced setting

Parameters:: fetchMissingValues - fetchMissingValues Default value is true
See Also:: setOptionDataSource(com.smartgwt.client.data.DataSource), getSelectedRecord(), setFilterLocally(java.lang.Boolean)

getFetchMissingValues

public java.lang.Boolean getFetchMissingValues()

If this form item has a specified optionDataSource, should the item ever perform a fetch against this dataSource to retrieve the related record.

Note - for efficiency we cache the associated record once a fetch has been performed, meaning if the value changes, then reverts to a previously seen value, we do not kick off an additional fetch to pick up the display value for the previously seen data value. If necessary this cache may be explicitly invalidated via a call to FormItem.invalidateDisplayValueCache

Returns:: Boolean
See Also:: com.smartgwt.client.widgets.form.fields.FormItem#getOptionDataSource, getSelectedRecord(), getFilterLocally()

setFilterLocally

public void setFilterLocally(java.lang.Boolean filterLocally)

If this form item is mapping data values to a display value by fetching records from a dataSource (see optionDataSource, displayField and fetchMissingValues), setting this property to true ensures that when the form item value is set, entire data-set from the dataSource is loaded at once and used as a valueMap, rather than just loading the display value for the current value. This avoids the need to perform fetches each time setValue() is called with a new value.

See also filterLocally for behavior on form items such as SelectItems that show pick-lists.

Note : This is an advanced setting

Parameters:: filterLocally - filterLocally Default value is null

getFilterLocally

public java.lang.Boolean getFilterLocally()

See also filterLocally for behavior on form items such as SelectItems that show pick-lists.

Returns:: Boolean

setGlobalTabIndex

public void setGlobalTabIndex(java.lang.Integer globalTabIndex)

TabIndex for the form item within the page. Takes precedence over any local tab index specified as item.tabIndex.

Use of this API is extremely advanced and essentially implies taking over management of tab index assignment for all components on the page.

Note : This is an advanced setting

Parameters:: globalTabIndex - globalTabIndex Default value is null
See Also:: Focus overview and related methods

getGlobalTabIndex

public java.lang.Integer getGlobalTabIndex()

TabIndex for the form item within the page. Takes precedence over any local tab index specified as item.tabIndex.

Use of this API is extremely advanced and essentially implies taking over management of tab index assignment for all components on the page.

Returns:: Integer
See Also:: Focus overview and related methods

setHeight

public void setHeight(int height)

Height of the FormItem. Can be either a number indicating a fixed height in pixels, a percentage indicating a percentage of the overall form's height, or "*" indicating take whatever remaining space is available.

See the FormLayout overview for details.

Parameters:: height - height Default value is 20
See Also:: FormLayout overview and related methods, Filling Example

getHeight

public int getHeight()

See the FormLayout overview for details.

Returns:: int
See Also:: FormLayout overview and related methods, Filling Example

setHint

public void setHint(java.lang.String hint)

Specifies "hint" string to show next to the form item to indicate something to the user. This string generally appears to the right of the form item.

If this method is called after the component has been drawn/initialized: Set the hint text for this item

Parameters:: hint - new hint for the item. Default value is null
See Also:: setHintStyle(java.lang.String), Appearance overview and related methods, Hints Example

getHint

public java.lang.String getHint()

Specifies "hint" string to show next to the form item to indicate something to the user. This string generally appears to the right of the form item.

Returns:: String
See Also:: getHintStyle(), Appearance overview and related methods, Hints Example

setHintStyle

public void setHintStyle(java.lang.String hintStyle)

CSS class for the "hint" string.

If this method is called after the component has been drawn/initialized: Set the hintStyle for this item

Parameters:: hintStyle - new style for hint text. Default value is "formHint"
See Also:: setHint(java.lang.String), Appearance overview and related methods

getHintStyle

public java.lang.String getHintStyle()

CSS class for the "hint" string.

Returns:: String
See Also:: getHint(), Appearance overview and related methods

setHoverAlign

public void setHoverAlign(Alignment hoverAlign)

Text alignment for text displayed in this item's hover canvas, if shown.

Parameters:: hoverAlign - hoverAlign Default value is null
See Also:: DynamicForm.setItemHoverAlign(com.smartgwt.client.types.Alignment)

getHoverAlign

public Alignment getHoverAlign()

Text alignment for text displayed in this item's hover canvas, if shown.

Returns:: Alignment
See Also:: DynamicForm.getItemHoverAlign()

setHoverDelay

public void setHoverDelay(java.lang.Integer hoverDelay)

If specified, this is the number of milliseconds to wait between the user rolling over this form item, and triggering any hover action for it.
If not specified this.form.itemHoverDelay will be used instead.

Note : This is an advanced setting

Parameters:: hoverDelay - hoverDelay Default value is null

getHoverDelay

public java.lang.Integer getHoverDelay()

Returns:: Integer

setHoverHeight

public void setHoverHeight(java.lang.Integer hoverHeight)

Option to specify a height for any hover shown for this item.

Parameters:: hoverHeight - hoverHeight Default value is null
See Also:: DynamicForm.setItemHoverHeight(java.lang.Integer)

getHoverHeight

public java.lang.Integer getHoverHeight()

Option to specify a height for any hover shown for this item.

Returns:: Integer
See Also:: DynamicForm.getItemHoverHeight()

setHoverOpacity

public void setHoverOpacity(java.lang.Integer hoverOpacity)

Opacity for any hover shown for this item

Parameters:: hoverOpacity - hoverOpacity Default value is null
See Also:: DynamicForm.setItemHoverOpacity(java.lang.Integer)

getHoverOpacity

public java.lang.Integer getHoverOpacity()

Opacity for any hover shown for this item

Returns:: Integer
See Also:: DynamicForm.getItemHoverOpacity()

setHoverStyle

public void setHoverStyle(java.lang.String hoverStyle)

Explicit CSS Style for any hover shown for this item.

Parameters:: hoverStyle - hoverStyle Default value is null
See Also:: DynamicForm.setItemHoverStyle(java.lang.String)

getHoverStyle

public java.lang.String getHoverStyle()

Explicit CSS Style for any hover shown for this item.

Returns:: String
See Also:: DynamicForm.getItemHoverStyle()

setHoverVAlign

public void setHoverVAlign(VerticalAlignment hoverVAlign)

Vertical text alignment for text displayed in this item's hover canvas, if shown.

Parameters:: hoverVAlign - hoverVAlign Default value is null
See Also:: DynamicForm.setItemHoverVAlign(java.lang.Integer)

getHoverVAlign

public VerticalAlignment getHoverVAlign()

Vertical text alignment for text displayed in this item's hover canvas, if shown.

Returns:: VerticalAlignment
See Also:: DynamicForm.getItemHoverVAlign()

setHoverWidth

public void setHoverWidth(java.lang.Integer hoverWidth)

Option to specify a width for any hover shown for this item.

Parameters:: hoverWidth - hoverWidth Default value is null
See Also:: DynamicForm.setItemHoverWidth(java.lang.Integer)

getHoverWidth

public java.lang.Integer getHoverWidth()

Option to specify a width for any hover shown for this item.

Returns:: Integer
See Also:: DynamicForm.getItemHoverWidth()

setIconHeight

public void setIconHeight(int iconHeight)

Default height for form item icons

Note : This is an advanced setting

Parameters:: iconHeight - iconHeight Default value is 20

getIconHeight

public int getIconHeight()

Default height for form item icons

Returns:: Takes an icon definition object, and returns the height for that icon in px.

setIconPrompt

public void setIconPrompt(java.lang.String iconPrompt)

Default prompt (and tooltip-text) for icons.

Note : This is an advanced setting

Parameters:: iconPrompt - iconPrompt Default value is ""

getIconPrompt

public java.lang.String getIconPrompt()

Default prompt (and tooltip-text) for icons.

Returns:: String

setIconVAlign

public void setIconVAlign(VerticalAlignment iconVAlign)

How should icons be aligned vertically for this form item.

Note : This is an advanced setting

Parameters:: iconVAlign - iconVAlign Default value is "bottom"

getIconVAlign

public VerticalAlignment getIconVAlign()

How should icons be aligned vertically for this form item.

Returns:: VerticalAlignment

setIconWidth

public void setIconWidth(int iconWidth)

Default width for form item icons

Note : This is an advanced setting

Parameters:: iconWidth - iconWidth Default value is 20

getIconWidth

public int getIconWidth()

Default width for form item icons

Returns:: Takes an icon definition object, and returns the width for that icon in px.

setImageURLPrefix

public void setImageURLPrefix(java.lang.String imageURLPrefix)

Prefix to apply to the beginning of any valueIcons when determining the URL for the image. Will not be applied if the valueIcon URL is absolute.

Note : This is an advanced setting

Parameters:: imageURLPrefix - imageURLPrefix Default value is null

getImageURLPrefix

public java.lang.String getImageURLPrefix()

Prefix to apply to the beginning of any valueIcons when determining the URL for the image. Will not be applied if the valueIcon URL is absolute.

Returns:: String

setImageURLSuffix

public void setImageURLSuffix(java.lang.String imageURLSuffix)

Suffix to apply to the end of any valueIcons when determining the URL for the image. A common usage would be to specify a suffix of ".gif" in which case the valueIcons property would map values to the names of images without the ".gif" extension.

Note : This is an advanced setting

Parameters:: imageURLSuffix - imageURLSuffix Default value is null

getImageURLSuffix

public java.lang.String getImageURLSuffix()

Returns:: String

setImplicitSave

public void setImplicitSave(java.lang.Boolean implicitSave)

When true, indicates that changes to this item will cause an automatic save on a delay, as well as when the entire form is submitted. Unless implicitSaveOnBlur is set to false on either this formItem or it's form changes will also be automatically saved on editorExit.

Parameters:: implicitSave - implicitSave Default value is false

getImplicitSave

public java.lang.Boolean getImplicitSave()

Returns:: Boolean

setImplicitSaveOnBlur

public void setImplicitSaveOnBlur(java.lang.Boolean implicitSaveOnBlur)

If not set to false, form item values will be saved when this item's "editorExit" handler is fired as well as on a delay and when the entire form is submitted.

Parameters:: implicitSaveOnBlur - implicitSaveOnBlur Default value is false

getImplicitSaveOnBlur

public java.lang.Boolean getImplicitSaveOnBlur()

If not set to false, form item values will be saved when this item's "editorExit" handler is fired as well as on a delay and when the entire form is submitted.

Returns:: Boolean

setInputFormat

public void setInputFormat(java.lang.String inputFormat)

For fields of type "date", if this is an editable field such as a TextItem, this property allows you to specify the inputFormat applied to the item.

Note : This is an advanced setting

Parameters:: inputFormat - inputFormat Default value is null
See Also:: setDateFormatter(com.smartgwt.client.types.DateDisplayFormat)

getInputFormat

public java.lang.String getInputFormat()

For fields of type "date", if this is an editable field such as a TextItem, this property allows you to specify the inputFormat applied to the item.

Returns:: String
See Also:: getDateFormatter()

setLeft

public void setLeft(int left)

Left coordinate of this item in pixels. Applies only when the containing DynamicForm sets itemLayout:"absolute".

If this method is called after the component has been drawn/initialized: For a form with itemLayout:"absolute" only, set the left coordinate of this form item.

Causes the form to redraw.

Note : This is an advanced setting

Parameters:: left - left Default value is 0

getLeft

public int getLeft()

Left coordinate of this item in pixels. Applies only when the containing DynamicForm sets itemLayout:"absolute".

Returns:: Returns the left coordinate of this form item in pixels. Note that this method is only reliable after the item has been drawn.

setLocateItemBy

public void setLocateItemBy(java.lang.String locateItemBy)

When AutoTest.getElement is used to parse locator strings generated by link{isc.AutoTest.getLocator()} for this form item, should the item be identified? By default if the item has a name this will always be used, however for items with no name, the following options are available:

"title" use the title as an identifier within this form
"value" use the value of the item to identify it (often used for items with a static defaultValue such as HeaderItems
"index" use the index within the form's items array.

If unset, and the item has no specified name, default behavior is to identify by title (if available), otherwise by index.

Note : This is an advanced setting

Parameters:: locateItemBy - locateItemBy Default value is null

getLocateItemBy

public java.lang.String getLocateItemBy()

"title" use the title as an identifier within this form
"value" use the value of the item to identify it (often used for items with a static defaultValue such as HeaderItems
"index" use the index within the form's items array.

If unset, and the item has no specified name, default behavior is to identify by title (if available), otherwise by index.

Returns:: String

setMultipleValueSeparator

public void setMultipleValueSeparator(java.lang.String multipleValueSeparator)

If this item is displaying multiple values, this property will be the string that separates those values for display purposes.

Parameters:: multipleValueSeparator - multipleValueSeparator Default value is ', '

getMultipleValueSeparator

public java.lang.String getMultipleValueSeparator()

If this item is displaying multiple values, this property will be the string that separates those values for display purposes.

Returns:: String

setOperator

public void setOperator(OperatorId operator)

OperatorId to be used when DynamicForm.getValuesAsCriteria is called.

item.operator can be used to create a form that offers search functions such as date range filtering, without the more advanced user interface of the FilterBuilder.

When item.operator is set for any FormItem in a form, form.getValuesAsCriteria() will return an AdvancedCriteria object instead of a normal Criteria object. Each FormItem will produce one Criterion affecting the DataSource field specified by criteriaField. The criteria produced by the FormItems will be grouped under the logical operator provided by operator.

if operator is set for some fields but not others, the default operator is "equals" for fields with a valueMap or an optionDataSource, and for fields of type "enum" (or of a type that inherits from "enum"). The default operator for all other fields is "iContains" (case-insensitive match)

Note: Advanced criteria will only be created for items in a Databound form. If this item is part of a form with no dataSource, the operator attribute will have no effect.

Parameters:: operator - operator Default value is null
See Also:: CriteriaEditing overview and related methods

getOperator

public OperatorId getOperator()

OperatorId to be used when DynamicForm.getValuesAsCriteria is called.

item.operator can be used to create a form that offers search functions such as date range filtering, without the more advanced user interface of the FilterBuilder.

Note: Advanced criteria will only be created for items in a Databound form. If this item is part of a form with no dataSource, the operator attribute will have no effect.

Returns:: OperatorId
See Also:: CriteriaEditing overview and related methods

setOptionOperationId

public void setOptionOperationId(java.lang.String optionOperationId)

If this item has a specified optionDataSource, this attribute may be set to specify an explicit operationId when performing a fetch against the option dataSource to pick up display value mapping.

Note : This is an advanced setting

Parameters:: optionOperationId - optionOperationId Default value is null

getOptionOperationId

public java.lang.String getOptionOperationId()

If this item has a specified optionDataSource, this attribute may be set to specify an explicit operationId when performing a fetch against the option dataSource to pick up display value mapping.

Returns:: String

setPickerIconHeight

public void setPickerIconHeight(java.lang.Integer pickerIconHeight)

If showPickerIcon is true for this item, this property governs the size of the picker icon. If unset picker icon will be sized as a square to fit in the available height for the icon.

Note : This is an advanced setting

Parameters:: pickerIconHeight - pickerIconHeight Default value is null

getPickerIconHeight

public java.lang.Integer getPickerIconHeight()

If showPickerIcon is true for this item, this property governs the size of the picker icon. If unset picker icon will be sized as a square to fit in the available height for the icon.

Returns:: Integer

setPickerIconName

public void setPickerIconName(java.lang.String pickerIconName)

If showPickerIcon is true, this attribute specifies the name applied to the picker icon

Note : This is an advanced setting

Parameters:: pickerIconName - pickerIconName Default value is "picker"

getPickerIconName

public java.lang.String getPickerIconName()

If showPickerIcon is true, this attribute specifies the name applied to the picker icon

Returns:: String

setPickerIconSrc

public void setPickerIconSrc(java.lang.String pickerIconSrc)

If showPickerIcon is true for this item, this property governs the src of the picker icon image to be displayed.

Note : This is an advanced setting

Parameters:: pickerIconSrc - pickerIconSrc Default value is ""

getPickerIconSrc

public java.lang.String getPickerIconSrc()

If showPickerIcon is true for this item, this property governs the src of the picker icon image to be displayed.

Returns:: String

setPickerIconWidth

public void setPickerIconWidth(java.lang.Integer pickerIconWidth)

If showPickerIcon is true for this item, this property governs the size of the picker icon. If unset picker icon will be sized as a square to fit in the available height for the icon.

Note : This is an advanced setting

Parameters:: pickerIconWidth - pickerIconWidth Default value is null

getPickerIconWidth

public java.lang.Integer getPickerIconWidth()

If showPickerIcon is true for this item, this property governs the size of the picker icon. If unset picker icon will be sized as a square to fit in the available height for the icon.

Returns:: Integer

setPrintTextBoxStyle

public void setPrintTextBoxStyle(java.lang.String printTextBoxStyle)

Base CSS class name for a form item's text box element when getting printable HTML for the form. If unset textBoxStyle will be used instead. Note that focused styling will never be displayed while printing, though error and disabled styling will.

Parameters:: printTextBoxStyle - printTextBoxStyle Default value is null
See Also:: Printing overview and related methods

getPrintTextBoxStyle

public java.lang.String getPrintTextBoxStyle()

Returns:: String
See Also:: Printing overview and related methods

setPrintTitleStyle

public void setPrintTitleStyle(java.lang.String printTitleStyle)

Base CSS stylename for a form item's title when generating print HTML for the item. If unset titleStyle will be used instead.

Parameters:: printTitleStyle - printTitleStyle Default value is null
See Also:: Printing overview and related methods

getPrintTitleStyle

public java.lang.String getPrintTitleStyle()

Base CSS stylename for a form item's title when generating print HTML for the item. If unset titleStyle will be used instead.

Returns:: String
See Also:: Printing overview and related methods

setPrompt

public void setPrompt(java.lang.String prompt)

This text is shown as a tooltip prompt when the cursor hovers over this item.

Parameters:: prompt - prompt Default value is null
See Also:: Basics overview and related methods

getPrompt

public java.lang.String getPrompt()

This text is shown as a tooltip prompt when the cursor hovers over this item.

Returns:: String
See Also:: Basics overview and related methods

setRejectInvalidValueOnChange

public void setRejectInvalidValueOnChange(java.lang.Boolean rejectInvalidValueOnChange)

If validateOnChange is true, and validation fails for this item on change, with no suggested value, should we revert to the previous value, or continue to display the bad value entered by the user. May be set at the item or form level.

Note : This is an advanced setting

Parameters:: rejectInvalidValueOnChange - rejectInvalidValueOnChange Default value is false

getRejectInvalidValueOnChange

public java.lang.Boolean getRejectInvalidValueOnChange()

Returns:: Boolean

setRequired

public void setRequired(java.lang.Boolean required)

Whether a non-empty value is required for this field to pass validation.

If the user does not fill in the required field, the error message to be shown will be taken from these properties in the following order: requiredMessage, requiredMessage, requiredMessage, requiredField.

Note: if specified on a FormItem, required is only enforced on the client. required should generally be specified on a DataSourceField.

If this method is called after the component has been drawn/initialized: Setter to mark this formItem as required, or not required at runtime. Note that an alternative approach to updating the required flag directly would be to simply use a requiredIf type validator.

Note that this method will not re-validate this item by default or clear any existing validation errors. If desired, this may be achieved by calling FormItem.validate or DynamicForm.clearErrors.

Parameters:: required - new required value.. Default value is null
See Also:: Validation overview and related methods, Show & Hide Example

getRequired

public java.lang.Boolean getRequired()

Whether a non-empty value is required for this field to pass validation.

Note: if specified on a FormItem, required is only enforced on the client. required should generally be specified on a DataSourceField.

Returns:: Boolean
See Also:: Validation overview and related methods, Show & Hide Example

setRequiredMessage

public void setRequiredMessage(java.lang.String requiredMessage)

The required message for required field errors.

Parameters:: requiredMessage - requiredMessage Default value is null
See Also:: Validation overview and related methods

getRequiredMessage

public java.lang.String getRequiredMessage()

The required message for required field errors.

Returns:: String
See Also:: Validation overview and related methods

setRowSpan

public void setRowSpan(int rowSpan)

Number of rows that this item spans

Parameters:: rowSpan - rowSpan Default value is 1
See Also:: FormLayout overview and related methods

getRowSpan

public int getRowSpan()

Number of rows that this item spans

Returns:: int
See Also:: FormLayout overview and related methods

setSelectOnFocus

public void setSelectOnFocus(java.lang.Boolean selectOnFocus)

Allows the selectOnFocus behavior to be configured on a per-FormItem basis. Normally all items in a form default to the value of selectOnFocus.

Parameters:: selectOnFocus - selectOnFocus Default value is null
See Also:: Focus overview and related methods

getSelectOnFocus

public java.lang.Boolean getSelectOnFocus()

Allows the selectOnFocus behavior to be configured on a per-FormItem basis. Normally all items in a form default to the value of selectOnFocus.

Returns:: Boolean
See Also:: Focus overview and related methods

setShouldSaveValue

public void setShouldSaveValue(java.lang.Boolean shouldSaveValue)

Should this item's value be saved in the form's values and hence returned from form.getValues()?

shouldSaveValue:false is used to mark formItems which do not correspond to the underlying data model and should not save a value into the form's values. Example includes visual separators, password re-type fields, or checkboxes used to show/hide other form items.

A shouldSaveValue:false item should be given a value either via defaultValue or by calling form.setValue(item, value) or formItem.setValue(value). Providing a value via form.values or form.setValues() will automatically switch the item to shouldSaveValue:true.

Note that

if an item is shouldSaveValue true, but has no name, a warning is logged, and shouldSaveValue will be set to false.

Parameters:: shouldSaveValue - shouldSaveValue Default value is true

getShouldSaveValue

public java.lang.Boolean getShouldSaveValue()

Should this item's value be saved in the form's values and hence returned from form.getValues()?

Note that

if an item is shouldSaveValue true, but has no name, a warning is logged, and shouldSaveValue will be set to false.

Returns:: Boolean

setShowDisabled

public void setShowDisabled(java.lang.Boolean showDisabled)

When this item is disabled, should it be re-styled to indicate its disabled state?

If this method is called after the component has been drawn/initialized: Setter method for showDisabled

Note : This is an advanced setting

Parameters:: showDisabled - new showDisabled setting. Default value is true
See Also:: setCellStyle(java.lang.String), Appearance overview and related methods

getShowDisabled

public java.lang.Boolean getShowDisabled()

When this item is disabled, should it be re-styled to indicate its disabled state?

Returns:: Boolean
See Also:: getCellStyle(), Appearance overview and related methods

setShowErrorIcon

public void setShowErrorIcon(java.lang.Boolean showErrorIcon)

showErrorIcons, showErrorText, and showErrorStyle control how validation errors are displayed when they are displayed inline in the form (next to the form item where there is a validation error). To instead display all errors at the top of the form, set showInlineErrors:false.

showErrorIcons, showErrorText and showErrorStyle are all boolean properties, and can be set on a DynamicForm to control the behavior form-wide, or set on individual FormItems.

The HTML displayed next to a form item with errors is generated by FormItem.getErrorHTML. The default implementation of that method respects showErrorIcons and showErrorText as follows:

showErrorIcons, or showErrorIcon at the FormItem level controls whether an error icon should appear next to fields which have validation errors. The icon's appearance is governed by errorIconSrc, errorIconWidth and errorIconHeight

showErrorText determines whether the text of the validation error should be displayed next to fields which have validation errors. The attribute showTitlesWithErrorMessages may be set to prefix error messages with the form item's title + ":" (may be desired if the item has showTitle set to false).

errorOrientation controls where the error HTML should appear relative to form items. Therefore the combination of showErrorText:false and errorOrientation:"left" creates a compact validation error display consisting of just an icon, to the left of the item with the error message available via a hover (similar appearance to ListGrid validation error display).

In addition to this, showErrorStyle determines whether fields with validation errors should have special styling applied to them. See String for a discussion for how error styling is calculated.

Parameters:: showErrorIcon - showErrorIcon Default value is null
See Also:: Appearance overview and related methods

getShowErrorIcon

public java.lang.Boolean getShowErrorIcon()

showErrorIcons, showErrorText and showErrorStyle are all boolean properties, and can be set on a DynamicForm to control the behavior form-wide, or set on individual FormItems.

The HTML displayed next to a form item with errors is generated by FormItem.getErrorHTML. The default implementation of that method respects showErrorIcons and showErrorText as follows:

In addition to this, showErrorStyle determines whether fields with validation errors should have special styling applied to them. See String for a discussion for how error styling is calculated.

Returns:: Boolean
See Also:: Appearance overview and related methods

setShowErrorStyle

public void setShowErrorStyle(java.lang.Boolean showErrorStyle)

showErrorIcons, showErrorText and showErrorStyle are all boolean properties, and can be set on a DynamicForm to control the behavior form-wide, or set on individual FormItems.

The HTML displayed next to a form item with errors is generated by FormItem.getErrorHTML. The default implementation of that method respects showErrorIcons and showErrorText as follows:

In addition to this, showErrorStyle determines whether fields with validation errors should have special styling applied to them. See String for a discussion for how error styling is calculated.

Parameters:: showErrorStyle - showErrorStyle Default value is null
See Also:: setCellStyle(java.lang.String), Appearance overview and related methods

getShowErrorStyle

public java.lang.Boolean getShowErrorStyle()

showErrorIcons, showErrorText and showErrorStyle are all boolean properties, and can be set on a DynamicForm to control the behavior form-wide, or set on individual FormItems.

The HTML displayed next to a form item with errors is generated by FormItem.getErrorHTML. The default implementation of that method respects showErrorIcons and showErrorText as follows:

In addition to this, showErrorStyle determines whether fields with validation errors should have special styling applied to them. See String for a discussion for how error styling is calculated.

Returns:: Boolean
See Also:: getCellStyle(), Appearance overview and related methods

setShowErrorText

public void setShowErrorText(java.lang.Boolean showErrorText)

showErrorIcons, showErrorText and showErrorStyle are all boolean properties, and can be set on a DynamicForm to control the behavior form-wide, or set on individual FormItems.

The HTML displayed next to a form item with errors is generated by FormItem.getErrorHTML. The default implementation of that method respects showErrorIcons and showErrorText as follows:

In addition to this, showErrorStyle determines whether fields with validation errors should have special styling applied to them. See String for a discussion for how error styling is calculated.

Parameters:: showErrorText - showErrorText Default value is null
See Also:: Appearance overview and related methods

getShowErrorText

public java.lang.Boolean getShowErrorText()

showErrorIcons, showErrorText and showErrorStyle are all boolean properties, and can be set on a DynamicForm to control the behavior form-wide, or set on individual FormItems.

The HTML displayed next to a form item with errors is generated by FormItem.getErrorHTML. The default implementation of that method respects showErrorIcons and showErrorText as follows:

In addition to this, showErrorStyle determines whether fields with validation errors should have special styling applied to them. See String for a discussion for how error styling is calculated.

Returns:: Boolean
See Also:: Appearance overview and related methods

setShowFocused

public void setShowFocused(java.lang.Boolean showFocused)

When this item receives focus, should it be re-styled to indicate it has focus?

Note : This is an advanced setting

Parameters:: showFocused - showFocused Default value is false
See Also:: setCellStyle(java.lang.String), Appearance overview and related methods

getShowFocused

public java.lang.Boolean getShowFocused()

When this item receives focus, should it be re-styled to indicate it has focus?

Returns:: Boolean
See Also:: getCellStyle(), Appearance overview and related methods

setShowFocusedIcons

public void setShowFocusedIcons(java.lang.Boolean showFocusedIcons)

If we're showing icons, should we change their image source to the appropriate focused source when this item has focus? Can be overridden on a per icon basis by the formItemIcon showFocused property.

Note : This is an advanced setting

Parameters:: showFocusedIcons - showFocusedIcons Default value is null

getShowFocusedIcons

public java.lang.Boolean getShowFocusedIcons()

Returns:: Boolean

setShowFocusedPickerIcon

public void setShowFocusedPickerIcon(java.lang.Boolean showFocusedPickerIcon)

If showPickerIcon is true for this item, should the picker icon show a focused image when the form item has focus?

Parameters:: showFocusedPickerIcon - showFocusedPickerIcon Default value is false

getShowFocusedPickerIcon

public java.lang.Boolean getShowFocusedPickerIcon()

If showPickerIcon is true for this item, should the picker icon show a focused image when the form item has focus?

Returns:: Boolean

setShowHint

public void setShowHint(java.lang.Boolean showHint)

If a hint is defined for this form item, should it be shown?

Note : This is an advanced setting

Parameters:: showHint - showHint Default value is true
See Also:: Appearance overview and related methods

getShowHint

public java.lang.Boolean getShowHint()

If a hint is defined for this form item, should it be shown?

Returns:: Boolean
See Also:: Appearance overview and related methods

setShowIcons

public void setShowIcons(java.lang.Boolean showIcons)

Set to false to suppress writing out any icons for this item.

Note : This is an advanced setting

Parameters:: showIcons - showIcons Default value is true

getShowIcons

public java.lang.Boolean getShowIcons()

Set to false to suppress writing out any icons for this item.

Returns:: Boolean

setShowOverIcons

public void setShowOverIcons(java.lang.Boolean showOverIcons)

If we're showing icons, should we change their image source to the appropriate over source when the user rolls over (or puts focus onto) them? Can be overridden on a per icon basis by the formItemIcon showOver property.

Note : This is an advanced setting

Parameters:: showOverIcons - showOverIcons Default value is null

getShowOverIcons

public java.lang.Boolean getShowOverIcons()

Returns:: Boolean

setShowPickerIcon

public void setShowPickerIcon(java.lang.Boolean showPickerIcon)

Should we show a special 'picker' icon for this form item. Picker icons are customizable via pickerIconProperties. By default they will be rendered inside the Form Item's "control box" area, and will call FormItem.showPicker when clicked.

Parameters:: showPickerIcon - showPickerIcon Default value is false

getShowPickerIcon

public java.lang.Boolean getShowPickerIcon()

Returns:: Boolean

setShowTitle

public void setShowTitle(java.lang.Boolean showTitle)

Should we show a title cell for this formItem?

Note: the default value of this attribute is overridden by some subclasses.

Parameters:: showTitle - showTitle Default value is true

getShowTitle

public java.lang.Boolean getShowTitle()

Should we show a title cell for this formItem?

Note: the default value of this attribute is overridden by some subclasses.

Returns:: Boolean

setShowValueIconOnly

public void setShowValueIconOnly(java.lang.Boolean showValueIconOnly)

If valueIcons is set, this property may be set to show the valueIcon only and prevent the standard form item element or text from displaying

Note : This is an advanced setting

Parameters:: showValueIconOnly - showValueIconOnly Default value is null

getShowValueIconOnly

public java.lang.Boolean getShowValueIconOnly()

If valueIcons is set, this property may be set to show the valueIcon only and prevent the standard form item element or text from displaying

Returns:: Boolean

setStartRow

public void setStartRow(java.lang.Boolean startRow)

Whether this item should always start a new row in the form layout.

Parameters:: startRow - startRow Default value is false
See Also:: FormLayout overview and related methods

getStartRow

public java.lang.Boolean getStartRow()

Whether this item should always start a new row in the form layout.

Returns:: Boolean
See Also:: FormLayout overview and related methods

setStopOnError

public void setStopOnError(java.lang.Boolean stopOnError)

Indicates that if validation fails, the user should not be allowed to exit the field - focus will be forced back into the field until the error is corrected.

This property defaults to stopOnError if unset.

Enabling this property also implies validateOnExit is automatically enabled. If there are server-based validators on this item, setting this property also implies that synchronousValidation is forced on.

Parameters:: stopOnError - stopOnError Default value is null

getStopOnError

public java.lang.Boolean getStopOnError()

Indicates that if validation fails, the user should not be allowed to exit the field - focus will be forced back into the field until the error is corrected.

This property defaults to stopOnError if unset.

Returns:: Boolean

setSuppressValueIcon

public void setSuppressValueIcon(java.lang.Boolean suppressValueIcon)

If valueIcons is set, this property may be set to prevent the value icons from showing up next to the form items value

Note : This is an advanced setting

Parameters:: suppressValueIcon - suppressValueIcon Default value is null

getSuppressValueIcon

public java.lang.Boolean getSuppressValueIcon()

If valueIcons is set, this property may be set to prevent the value icons from showing up next to the form items value

Returns:: Boolean

setSynchronousValidation

public void setSynchronousValidation(java.lang.Boolean synchronousValidation)

If enabled, whenever validation is triggered and a request to the server is required, user interactivity will be blocked until the request returns. Can be set for the entire form or individual FormItems.

If false, the form will try to avoid blocking user interaction until it is strictly required. That is until the user attempts to use a FormItem whose state could be affected by a server request that has not yet returned.

Parameters:: synchronousValidation - synchronousValidation Default value is null

getSynchronousValidation

public java.lang.Boolean getSynchronousValidation()

Returns:: Boolean

setTabIndex

public void setTabIndex(java.lang.Integer tabIndex)

TabIndex for the form item within the form, which controls the order in which controls are visited when the user hits the tab or shift-tab keys to navigate between items.

tabIndex is automatically assigned as the order that items appear in the items list.

To specify the tabindex of an item within the page as a whole (not just this form), use globalTabIndex instead.

Parameters:: tabIndex - tabIndex Default value is null
See Also:: Focus overview and related methods

getTabIndex

public java.lang.Integer getTabIndex()

TabIndex for the form item within the form, which controls the order in which controls are visited when the user hits the tab or shift-tab keys to navigate between items.

tabIndex is automatically assigned as the order that items appear in the items list.

To specify the tabindex of an item within the page as a whole (not just this form), use globalTabIndex instead.

Returns:: Integer
See Also:: Focus overview and related methods

setTextAlign

public void setTextAlign(Alignment textAlign)

Alignment of the text / content within this form item. Note that align may be used to control alignment of the entire form item within its cell. May not apply to all form item types.

Parameters:: textAlign - textAlign Default value is Canvas.LEFT
See Also:: Appearance overview and related methods

getTextAlign

public Alignment getTextAlign()

Alignment of the text / content within this form item. Note that align may be used to control alignment of the entire form item within its cell. May not apply to all form item types.

Returns:: Alignment
See Also:: Appearance overview and related methods

setTextBoxStyle

public void setTextBoxStyle(java.lang.String textBoxStyle)

Base CSS class name for a form item's text box element.

NOTE: See the CompoundFormItem_skinning discussion for special skinning considerations.

Parameters:: textBoxStyle - textBoxStyle Default value is null
See Also:: setCellStyle(java.lang.String), Appearance overview and related methods

getTextBoxStyle

public java.lang.String getTextBoxStyle()

Base CSS class name for a form item's text box element.

NOTE: See the CompoundFormItem_skinning discussion for special skinning considerations.

Returns:: String
See Also:: getCellStyle(), Appearance overview and related methods

setTimeFormatter

public void setTimeFormatter(TimeDisplayFormat timeFormatter)

Time-format to apply to date type values within this formItem. If specified, any dates displayed in this item will be formatted as times using the appropriate format. This is most commonly only applied to fields specified as type "time" though if no explicit dateFormatter is specified it will be respected for other fields as well.

If unspecified, a timeFormatter may be defined at the component level and will be respected by fields of type "time".

Note : This is an advanced setting

Parameters:: timeFormatter - timeFormatter Default value is null
See Also:: Appearance overview and related methods

getTimeFormatter

public TimeDisplayFormat getTimeFormatter()

If unspecified, a timeFormatter may be defined at the component level and will be respected by fields of type "time".

Returns:: TimeDisplayFormat
See Also:: Appearance overview and related methods

setTitle

public void setTitle(java.lang.String title)

User visible title for this form item.

Parameters:: title - title Default value is null
See Also:: Basics overview and related methods

getTitle

public java.lang.String getTitle()

User visible title for this form item.

Returns:: Return the title of this formItem
See Also:: Basics overview and related methods

setTitleAlign

public void setTitleAlign(Alignment titleAlign)

Alignment of this item's title in its cell.

If null, dynamically set according to text direction.

Parameters:: titleAlign - titleAlign Default value is null

getTitleAlign

public Alignment getTitleAlign()

Alignment of this item's title in its cell.

If null, dynamically set according to text direction.

Returns:: Alignment

setTitleColSpan

public void setTitleColSpan(int titleColSpan)

Number of columns that this item's title spans.

This setting only applies for items that are showing a title and whose TitleOrientation is either "left" or "right".

Parameters:: titleColSpan - titleColSpan Default value is 1
See Also:: FormLayout overview and related methods

getTitleColSpan

public int getTitleColSpan()

Number of columns that this item's title spans.

This setting only applies for items that are showing a title and whose TitleOrientation is either "left" or "right".

Returns:: int
See Also:: FormLayout overview and related methods

setTitleOrientation

public void setTitleOrientation(TitleOrientation titleOrientation)

On which side of this item should the title be placed. TitleOrientation lists valid options.

Note that titles on the left or right take up a cell in tabular form layouts, but titles on top do not.

Parameters:: titleOrientation - titleOrientation Default value is Canvas.LEFT
See Also:: DynamicForm.setTitleOrientation(com.smartgwt.client.types.TitleOrientation)

getTitleOrientation

public TitleOrientation getTitleOrientation()

On which side of this item should the title be placed. TitleOrientation lists valid options.

Note that titles on the left or right take up a cell in tabular form layouts, but titles on top do not.

Returns:: TitleOrientation
See Also:: DynamicForm.getTitleOrientation()

setTitleStyle

public void setTitleStyle(java.lang.String titleStyle)

Base CSS class name for a form item's title. Note that this is a String so will pick up stateful suffixes on focus, disabled state change etc. by default.

Parameters:: titleStyle - titleStyle Default value is "formTitle"
See Also:: setCellStyle(java.lang.String)

getTitleStyle

public java.lang.String getTitleStyle()

Base CSS class name for a form item's title. Note that this is a String so will pick up stateful suffixes on focus, disabled state change etc. by default.

Returns:: String
See Also:: getCellStyle()

setTitleVAlign

public void setTitleVAlign(VerticalAlignment titleVAlign)

Vertical alignment of this item's title in its cell. Only applies when titleOrientation is "left" or "right".

Parameters:: titleVAlign - titleVAlign Default value is Canvas.CENTER

getTitleVAlign

public VerticalAlignment getTitleVAlign()

Vertical alignment of this item's title in its cell. Only applies when titleOrientation is "left" or "right".

Returns:: VerticalAlignment

setTop

public void setTop(int top)

Top coordinate of this item in pixels. Applies only when the containing DynamicForm sets itemLayout:"absolute".

If this method is called after the component has been drawn/initialized: For a form with itemLayout:"absolute" only, set the top coordinate of this form item.

Causes the form to redraw.

Note : This is an advanced setting

Parameters:: top - top Default value is 0

getTop

public int getTop()

Top coordinate of this item in pixels. Applies only when the containing DynamicForm sets itemLayout:"absolute".

Returns:: Returns the top coordinate of the form item in pixels. Note that this method is only reliable after the item has been drawn out.

setValidateOnChange

public void setValidateOnChange(java.lang.Boolean validateOnChange)

If true, form items will be validated when each item's "change" handler is fired as well as when the entire form is submitted or validated.

Note that this property can also be set at the form level or on each validator; If true at the form or field level, validators not explicitly set with validateOnChange:false will be fired on change - displaying errors and rejecting the change on validation failure.

Parameters:: validateOnChange - validateOnChange Default value is false
See Also:: DynamicForm.setValidateOnChange(java.lang.Boolean)

getValidateOnChange

public java.lang.Boolean getValidateOnChange()

If true, form items will be validated when each item's "change" handler is fired as well as when the entire form is submitted or validated.

Returns:: Boolean
See Also:: DynamicForm.getValidateOnChange()

setValidateOnExit

public void setValidateOnExit(java.lang.Boolean validateOnExit)

If true, form items will be validated when each item's "editorExit" handler is fired as well as when the entire form is submitted or validated.

Note that this property can also be set at the form level. If true at either level the validator will be fired on editorExit.

Parameters:: validateOnExit - validateOnExit Default value is false
See Also:: DynamicForm.setValidateOnExit(java.lang.Boolean)

getValidateOnExit

public java.lang.Boolean getValidateOnExit()

If true, form items will be validated when each item's "editorExit" handler is fired as well as when the entire form is submitted or validated.

Note that this property can also be set at the form level. If true at either level the validator will be fired on editorExit.

Returns:: Boolean
See Also:: DynamicForm.getValidateOnExit()

setValidOperators

public void setValidOperators(OperatorId... validOperators)

Array of valid filtering operators (eg "greaterThan") that are legal for this FormItem.

Applies only to form/formItem when allowExpressions is true, allowing the user to input expressions.

Parameters:: validOperators - validOperators Default value is null

getValidOperators

public OperatorId[] getValidOperators()

Array of valid filtering operators (eg "greaterThan") that are legal for this FormItem.

Applies only to form/formItem when allowExpressions is true, allowing the user to input expressions.

Returns:: OperatorId

setValueField

public void setValueField(java.lang.String valueField)

If this form item maps data values to display values by retrieving the displayField values from an optionDataSource, this property denotes the the field to use as the underlying data value in records from the optionDataSource.
If unset, assumed to be the name of this form item.

Parameters:: valueField - valueField Default value is null

getValueField

public java.lang.String getValueField()

Returns:: String

setValueIconHeight

public void setValueIconHeight(java.lang.Integer valueIconHeight)

If valueIcons is specified, use this property to specify a height for the value icon written out.

Parameters:: valueIconHeight - valueIconHeight Default value is null
See Also:: setValueIconWidth(java.lang.Integer), setValueIconSize(int)

getValueIconHeight

public java.lang.Integer getValueIconHeight()

If valueIcons is specified, use this property to specify a height for the value icon written out.

Returns:: Integer
See Also:: getValueIconWidth(), getValueIconSize()

setValueIconLeftPadding

public void setValueIconLeftPadding(int valueIconLeftPadding)

If we're showing a value icon, this attribute governs the amount of space between the icon and the left edge of the form item cell

Parameters:: valueIconLeftPadding - valueIconLeftPadding Default value is 0
See Also:: setValueIcons(java.util.Map)

getValueIconLeftPadding

public int getValueIconLeftPadding()

If we're showing a value icon, this attribute governs the amount of space between the icon and the left edge of the form item cell

Returns:: int
See Also:: com.smartgwt.client.widgets.form.fields.FormItem#getValueIcons

setValueIconRightPadding

public void setValueIconRightPadding(int valueIconRightPadding)

If we're showing a value icon, this attribute governs the amount of space between the icon and the label of the form item

Parameters:: valueIconRightPadding - valueIconRightPadding Default value is 3
See Also:: setValueIcons(java.util.Map)

getValueIconRightPadding

public int getValueIconRightPadding()

If we're showing a value icon, this attribute governs the amount of space between the icon and the label of the form item

Returns:: int
See Also:: com.smartgwt.client.widgets.form.fields.FormItem#getValueIcons

setValueIconSize

public void setValueIconSize(int valueIconSize)

If valueIcons is specified, this property may be used to specify both the width and height of the icon written out. Note that valueIconWidth and valueIconHeight take precedence over this value, if specified.

Parameters:: valueIconSize - valueIconSize Default value is 16
See Also:: setValueIconWidth(java.lang.Integer), setValueIconHeight(java.lang.Integer)

getValueIconSize

public int getValueIconSize()

Returns:: int
See Also:: getValueIconWidth(), getValueIconHeight()

setValueIconWidth

public void setValueIconWidth(java.lang.Integer valueIconWidth)

If valueIcons is specified, use this property to specify a width for the value icon written out.

Parameters:: valueIconWidth - valueIconWidth Default value is null
See Also:: setValueIconHeight(java.lang.Integer), setValueIconSize(int)

getValueIconWidth

public java.lang.Integer getValueIconWidth()

If valueIcons is specified, use this property to specify a width for the value icon written out.

Returns:: Integer
See Also:: getValueIconHeight(), getValueIconSize()

setVisible

public void setVisible(java.lang.Boolean visible)

Whether this item is currently visible.

visible can only be set on creation. After creation, use FormItem.show and FormItem.hide to manipulate visibility.

Parameters:: visible - visible Default value is true
See Also:: Appearance overview and related methods

getVisible

public java.lang.Boolean getVisible()

Whether this item is currently visible.

visible can only be set on creation. After creation, use FormItem.show and FormItem.hide to manipulate visibility.

Returns:: Boolean
See Also:: Appearance overview and related methods

setWidth

public void setWidth(int width)

Width of the FormItem. Can be either a number indicating a fixed width in pixels, or "*" indicating the FormItem fills the space allocated to it's column (or columns, for a column spanning item).

See the FormLayout overview for details.

Parameters:: width - width Default value is "*"
See Also:: FormLayout overview and related methods, Spanning Example

getWidth

public int getWidth()

Width of the FormItem. Can be either a number indicating a fixed width in pixels, or "*" indicating the FormItem fills the space allocated to it's column (or columns, for a column spanning item).

See the FormLayout overview for details.

Returns:: Output the width for this element. Note this returns the specified width for the element, which may be "*" or a percentage value. Use 'getVisibleWidth()' to get the drawn width in pixels.
See Also:: FormLayout overview and related methods, Spanning Example

setWrapTitle

public void setWrapTitle(java.lang.Boolean wrapTitle)

If specified determines whether this items title should wrap. Overrides wrapItemTitles at the DynamicForm level.

Parameters:: wrapTitle - wrapTitle Default value is null

getWrapTitle

public java.lang.Boolean getWrapTitle()

If specified determines whether this items title should wrap. Overrides wrapItemTitles at the DynamicForm level.

Returns:: Boolean

addBlurHandler

public HandlerRegistration addBlurHandler(BlurHandler handler)

Add a blur handler.

Called when this FormItem loses focus.

Specified by:: addBlurHandler in interface HasBlurHandlers

Parameters:: handler - the blur handler
Returns:: HandlerRegistration used to remove this handler

blurItem

public void blurItem()

Takes focus from this form item's focusable element.

canEditCriterion

public java.lang.Boolean canEditCriterion(Criterion criterion)

When a dynamic form is editing an advanced criteria object via DynamicForm.setValuesAsCriteria, this method is used to determine which sub-criteria apply to which form item(s).

This method will be called on each item, and passed the sub-criterion of the AdvancedCriteria object. It should return true if the item can edit the criterion, otherwise false. If it returns true, setValuesAsCriteria() will call FormItem.setCriterion to actually apply the criterion to the form item, and DynamicForm.getValuesAsCriteria can subsequently retrieve the edited criterion by calling FormItem.getCriterion.

Default implementation will return true if the criterion fieldName and operator match the fieldName and operator (or default operator) for this item.

Parameters:: criterion - sub-criterion from an AdvancedCriteria object
Returns:: return true if this item can edit the criterion in question.
See Also:: CriteriaEditing overview and related methods

addChangeHandler

public HandlerRegistration addChangeHandler(ChangeHandler handler)

Add a change handler.

Called when a FormItem's value is about to change as the result of user interaction. This method fires after the user performed an action that would change the value of this field, but before the element itself is changed.

Returning false cancels the change. Note that if what you want to do is transform the user's input, for example, automatically change separator characters to a standard separator character, you should implement transformInput rather than using a combination of change() and setValue() to accomplish the same thing. Returning false from change is intended for rejecting input entirely, such as typing invalid characters.

Note that if you ask the form for the current value in this handler, you will get the old value because the change has not yet been committed. The new value is available as a parameter to this method.

Specified by:: addChangeHandler in interface HasChangeHandlers

Parameters:: handler - the change handler
Returns:: HandlerRegistration used to remove this handler

addChangedHandler

public HandlerRegistration addChangedHandler(ChangedHandler handler)

Add a changed handler.

Called when a FormItem's value has been changed as the result of user interaction. This method fires after the newly specified value has been stored.

Specified by:: addChangedHandler in interface HasChangedHandlers

Parameters:: handler - the changed handler
Returns:: HandlerRegistration used to remove this handler

clearValue

public void clearValue()

Clear the value for this form item.

Note that if a default value is specified, value will be set to that default value, otherwise value will be cleared, (and removed from the containing form's values).

addClickHandler

public HandlerRegistration addClickHandler(ClickHandler handler)

Add a click handler.

Called when this FormItem is clicked on.

Note: click() is available on StaticTextItem, BlurbItems, ButtonItem, and derivatives. Other form items (such as HiddenItem) do not support click().

Specified by:: addClickHandler in interface HasClickHandlers

Parameters:: handler - the click handler
Returns:: HandlerRegistration used to remove this handler

addDoubleClickHandler

public HandlerRegistration addDoubleClickHandler(DoubleClickHandler handler)

Add a doubleClick handler.

Called when this FormItem is double-clicked.

Specified by:: addDoubleClickHandler in interface HasDoubleClickHandlers

Parameters:: handler - the doubleClick handler
Returns:: HandlerRegistration used to remove this handler

addFocusHandler

public HandlerRegistration addFocusHandler(FocusHandler handler)

Add a focus handler.

Called when this FormItem receives focus.

Specified by:: addFocusHandler in interface HasFocusHandlers

Parameters:: handler - the focus handler
Returns:: HandlerRegistration used to remove this handler

focusInItem

public void focusInItem()

Move the keyboard focus into this item's focusable element

getCriterion

public Criterion getCriterion()

Override this method if you need to provide a specialized criterion from this formItem when creating an AdvancedCriteria via DynamicForm.getValuesAsCriteria.

This API is provided to allow you to specify a more complex criterion than the "field-operator-value" criterions that are built-in. Note that the built-in behavior is generally quite flexible and powerful enough for most requirements. An example of a case where you might want to override this method is if you wanted to implement a date range selection (ie, date > x AND date < y) on a form that was combining its other criteria fields with an "or" operator.

Note that this method is part of the criteria editing subsystem: if overridden, it is likely that you will want to also override FormItem.hasAdvancedCriteria to ensure this method is called by the form, and to support editing of existing advanced criteria you may also need to override FormItem.canEditCriterion and FormItem.setCriterion.

The default implementation will return a criterion including the form item value, fieldName and specified operator, or a default operator derived from the form item data type if no explicit operator is specified.

Returns:: criterion object based on this fields current edited value(s).
See Also:: CriteriaEditing overview and related methods

getCriterion

public Criterion getCriterion(TextMatchStyle textMatchStyle)

Override this method if you need to provide a specialized criterion from this formItem when creating an AdvancedCriteria via DynamicForm.getValuesAsCriteria.

Parameters:: textMatchStyle - If passed assume the textMatchStyle will be used when performing a fetch operation with these criteria. This may impact the criterion's operator property.
Returns:: criterion object based on this fields current edited value(s).
See Also:: CriteriaEditing overview and related methods

getDisplayFieldName

public java.lang.String getDisplayFieldName()

Returns the displayField for this form item. If unset, and optionDataSource is explicitly specified, this method will return the title field for the optionDataSource

Returns:: display field name, or null

getFieldName

public java.lang.String getFieldName()

Return the name for the this formItem.

Returns:: name for this form item
See Also:: Drawing overview and related methods

getFullDataPath

public java.lang.String getFullDataPath()

Return the fully-qualified dataPath for the this formItem (ie, the dataPath expressed in absolute terms from the root of the hierarchy, rather than relative to the item's parent form). Note that the item's name is substituted into the full dataPath if the item does not specify an explicit dataPath. For example, if we have a field called name that specifies no dataPath, on a form that specifies a dataPath of /order/items, this method will return /order/items/name

Returns:: Fully-qualified dataPath for this form item

getIcon

public FormItemIcon getIcon(java.lang.String name)

Given an name return a pointer to the icon definition

Parameters:: name - specified name
Returns:: form item icon matching the specified name

getPageLeft

public int getPageLeft()

Returns the drawn page-left coordinate of this form item in pixels.

Returns:: page-left coordinate in px
See Also:: Positioning overview and related methods

getPageTop

public int getPageTop()

Returns the drawn page-top coordinate of this form item in pixels.

Returns:: page-top coordinate in px
See Also:: Positioning overview and related methods

getSelectedRecord

public ListGridRecord getSelectedRecord()

Get the record returned from the optionDataSource when fetchMissingValues is true, and the missing value is fetched.

fetchMissingValues kicks off the fetch when the form item is initialized with a non null value or when setValue() is called on the item. Note that this method will return null before the fetch completes, or if no record is found in the optionDataSource matching the underlying value.

Returns:: selected record

getValueFieldName

public java.lang.String getValueFieldName()

Getter method to retrieve the valueField for this item. If unset, default behavior will return the name of this field.

Returns:: fieldName to use a "value field" in records from this items optionDataSource

hasAdvancedCriteria

public java.lang.Boolean hasAdvancedCriteria()

Does this form item produce an AdvancedCriteria sub criterion object? If this method returns true, DynamicForm.getValuesAsCriteria on the form containing this item will always return an AdvancedCriteria object, calling FormItem.getCriterion on each item to retrieve the individual criteria.

Default implementation will return true if operator is explicitly specified.

Returns:: true if this item will return an AdvancedCriteria sub-criterion.
See Also:: CriteriaEditing overview and related methods

hide

public void hide()

Hide this form item.

This will cause the form to redraw. If this item had an item.showIf expression, it will be destroyed.

addIconClickHandler

public HandlerRegistration addIconClickHandler(IconClickHandler handler)

Add a iconClick handler.

StringMethod. Default action to fire when the user clicks on a form item icon. May be overridden by setting click on the form item icon directly.

Specified by:: addIconClickHandler in interface HasIconClickHandlers

Parameters:: handler - the iconClick handler
Returns:: HandlerRegistration used to remove this handler

addIconKeyPressHandler

public HandlerRegistration addIconKeyPressHandler(IconKeyPressHandler handler)

Add a iconKeyPress handler.

StringMethod. Default action to fire when an icon has keyboard focus and the user types a key. May be overridden by setting keyPress on the form item icon directly.

Specified by:: addIconKeyPressHandler in interface HasIconKeyPressHandlers

Parameters:: handler - the iconKeyPress handler
Returns:: HandlerRegistration used to remove this handler

invalidateDisplayValueCache

public void invalidateDisplayValueCache()

If this item has a specified displayField, the value displayed to the user for this item may be derived from another field.

The display field can be either another field value in the same record or a field that must be retrieved from a related optionDataSource if fetchMissingValues is true. In this latter case, we perform a fetch against the option dataSource when the item value changes in order to determine the display value to show (and we make the associated record available via FormItem.getSelectedRecord).

We cache this data on the form item, so if the item value changes to a new value, then reverts to a previously-seen value, the display value and selected record are already available without the need for an additional fetch. The cached values will also be kept in synch with the dataSource data assuming it is modified via standard add, update or delete operations.

This method explicitly invalidates this cache of optionDataSource data, and if the item value is non null and fetchMissingValues is still true, re-fetches the data.

isDisabled

public java.lang.Boolean isDisabled()

Is this item disabled?

Returns:: disabledtrue if this item is be disabled
See Also:: getDisabled(), Enable overview and related methods

isDrawn

public java.lang.Boolean isDrawn()

Returns true if this item has been written out into the DOM.

Returns:: whether this item is drawn
See Also:: Drawing overview and related methods

addItemHoverHandler

public HandlerRegistration addItemHoverHandler(ItemHoverHandler handler)

Add a itemHover handler.

Optional stringMethod to fire when the user hovers over this item. Call com.smartgwt.client.widgets.form.fields.events.ItemHoverEvent#cancel() from within ItemHoverHandler#onItemHover to suppress default behavior of showing a hover canvas containing the HTML returned by formItem.itemHoverHTML() / form.itemHoverHTML().

Specified by:: addItemHoverHandler in interface HasItemHoverHandlers

Parameters:: handler - the itemHover handler
Returns:: HandlerRegistration used to remove this handler

addKeyDownHandler

public HandlerRegistration addKeyDownHandler(KeyDownHandler handler)

Add a keyDown handler.

StringMethod fired in response to a keydown while focused in this form item.

Specified by:: addKeyDownHandler in interface HasKeyDownHandlers

Parameters:: handler - the keyDown handler
Returns:: HandlerRegistration used to remove this handler

addKeyPressHandler

public HandlerRegistration addKeyPressHandler(KeyPressHandler handler)

Add a keyPress handler.

StringMethod fired when the user presses a key while focused in this form item.

Specified by:: addKeyPressHandler in interface HasKeyPressHandlers

Parameters:: handler - the keyPress handler
Returns:: HandlerRegistration used to remove this handler

addKeyUpHandler

public HandlerRegistration addKeyUpHandler(KeyUpHandler handler)

Add a keyUp handler.

StringMethod fired in response to a keyup while focused in this form item.

Specified by:: addKeyUpHandler in interface HasKeyUpHandlers

Parameters:: handler - the keyUp handler
Returns:: HandlerRegistration used to remove this handler

setCriterion

public void setCriterion(Criterion criterion)

Update this form item to reflect a criterion object from within an AdvancedCriteria. Called by DynamicForm.setValuesAsCriteria when FormItem.canEditCriterion returns true for this item.

Default implementation simply calls FormItem.setValue with the value of the criterion passed in

Parameters:: criterion - criterion to edit

shouldFetchMissingValue

public java.lang.Boolean shouldFetchMissingValue(java.lang.Object newValue)

If this field has a specified optionDataSource, should we perform a fetch against that dataSource to find the record that matches this field's value?

If the value is non-null, this method is called when the item is first rendered or whenever the value is changed via a call to FormItem.setValue. If it returns true, a fetch will be dispatched against the optionDataSource to get the record matching the value

When the fetch completes, if a record was found that matches the data value (and the form item value has not subsequently changed again), the item will be re-rendered to reflect any changes to the display value, and the record matching the value will be available via getSelectedRecord.

Default behavior will return false if fetchMissingValues is set to false. Otherwise it will return true if alwaysFetchMissingValues is set to true, or if a displayField is specified for this item and the item value is not already present in the item's valueMap.

Parameters:: newValue - The new data value of the item.
Returns:: should we fetch the record matching the new value from the item's optionDataSource?

show

public void show()

Show this form item.

This will cause the form to redraw. If this item had an item.showIf expression, it will be destroyed.

stopHover

public void stopHover()

This method is fired when the user rolls off this item (or the title for this item) and will clear any hover canvas shown by the item.

addTitleClickHandler

public HandlerRegistration addTitleClickHandler(TitleClickHandler handler)

Add a titleClick handler.

Notification method fired when the user clicks the title for this item

Specified by:: addTitleClickHandler in interface HasTitleClickHandlers

Parameters:: handler - the titleClick handler
Returns:: HandlerRegistration used to remove this handler

addTitleDoubleClickHandler

public HandlerRegistration addTitleDoubleClickHandler(TitleDoubleClickHandler handler)

Add a titleDoubleClick handler.

Notification method fired when the user double-clicks the title for this item

Specified by:: addTitleDoubleClickHandler in interface HasTitleDoubleClickHandlers

Parameters:: handler - the titleDoubleClick handler
Returns:: HandlerRegistration used to remove this handler

addTitleHoverHandler

public HandlerRegistration addTitleHoverHandler(TitleHoverHandler handler)

Add a titleHover handler.

Optional stringMethod to fire when the user hovers over this item's title. Call com.smartgwt.client.widgets.form.fields.events.TitleHoverEvent#cancel() from within TitleHoverHandler#onTitleHover to suppress default behavior of showing a hover canvas containing the HTML returned by formItem.titleHoverHTML() / form.titleHoverHTML().

Specified by:: addTitleHoverHandler in interface HasTitleHoverHandlers

Parameters:: handler - the titleHover handler
Returns:: HandlerRegistration used to remove this handler

updateState

public void updateState()

Update the visual state of a FormItem to reflect any changes in state or any changes in style settings (eg textBoxStyle).

Calls to updateState() normally occur automatically as a consequence of focus changes, items becoming disabled, etc. This method is advanced and intended only for use in workarounds.

validate

public java.lang.Boolean validate()

Validate this item.

Returns:: returns true if validation was successful (no errors encountered), false otherwise.

setInitHandler

public void setInitHandler(FormItemInitHandler initHandler)

Specify a notification method to fire when this formItem is initialized in JavaScript. This allows developers to set up form item state dynamically when the item is created.

Parameters:: initHandler -

setAttribute

public void setAttribute(java.lang.String attribute,
                         java.lang.String value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         java.lang.Boolean value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         java.util.Map value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         int[] value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         BaseClass[] value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         DataClass[] value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         double value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         int value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         java.util.Date value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         ValueEnum[] value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         DataClass value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         JavaScriptObject value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         java.lang.String[] value)

Overrides:: setAttribute in class DataClass

setAttribute

public void setAttribute(java.lang.String attribute,
                         boolean value)

Overrides:: setAttribute in class DataClass

getAttribute

public java.lang.String getAttribute(java.lang.String attribute)

Overrides:: getAttribute in class DataClass

getAttributeAsString

public java.lang.String getAttributeAsString(java.lang.String attribute)

Overrides:: getAttributeAsString in class DataClass

getAttributeAsDate

public java.util.Date getAttributeAsDate(java.lang.String attribute)

Overrides:: getAttributeAsDate in class DataClass

getAttributeAsDouble

public java.lang.Double getAttributeAsDouble(java.lang.String attribute)

Overrides:: getAttributeAsDouble in class DataClass

getAttributeAsJavaScriptObject

public JavaScriptObject getAttributeAsJavaScriptObject(java.lang.String attribute)

Overrides:: getAttributeAsJavaScriptObject in class DataClass

getAttributeAsInt

public java.lang.Integer getAttributeAsInt(java.lang.String attribute)

Overrides:: getAttributeAsInt in class DataClass

getAttributeAsFloat

public java.lang.Float getAttributeAsFloat(java.lang.String attribute)

Overrides:: getAttributeAsFloat in class DataClass

getAttributeAsBoolean

public java.lang.Boolean getAttributeAsBoolean(java.lang.String attribute)

Overrides:: getAttributeAsBoolean in class DataClass

setProperty

public void setProperty(java.lang.String property,
                        java.lang.String value)

setProperty

public void setProperty(java.lang.String property,
                        boolean value)

setProperty

public void setProperty(java.lang.String property,
                        int value)

setProperty

public void setProperty(java.lang.String property,
                        double value)

setProperty

public void setProperty(java.lang.String property,
                        JavaScriptObject value)

isCreated

protected boolean isCreated()

Overrides:: isCreated in class JsObject

setOptionDataSource

public void setOptionDataSource(DataSource dataSource)

setName

public void setName(java.lang.String name)

Name for this form field.

The FormItem's name determines the name of the property it edits within the form.

Parameters:: name - name Default value is null

getName

public java.lang.String getName()

Name for this form field.

The FormItem's name determines the name of the property it edits within the form.

Returns:: String

setValidators

public void setValidators(Validator... validators)

Validators for this form item.

Note: these validators will only be run on the client; to do real client-server validation, validators must be specified on the DataSource.

Parameters:: validators - the validators

setIcons

public void setIcons(FormItemIcon... icons)

An array of descriptor objects for icons to display in a line after this form item. These icons are clickable images, often used to display some kind of helper for populating a form item.

Parameters:: icons - icons Default value is null

setErrorOrientation

public void setErrorOrientation(FormErrorOrientation errorOrientation)

If showInlineErrors is true, where should the error icon and text appear relative to the form item itself. Valid options are "top", "bottom", "left" or "right".
If unset the orientation will be derived from errorOrientation.

Parameters:: errorOrientation - errorOrientation Default value is null

setType

public void setType(java.lang.String type)

The DynamicForm picks a field renderer based on the type of the field (and sometimes other attributes of the field).

Parameters:: type - type Default value is "text"

setColSpan

public void setColSpan(java.lang.String colSpan)

Number of columns that this item spans.

The colSpan setting does not include the title shown for items with showTitle:true, so the effective colSpan is one higher than this setting for items that are showing a title and whose TitleOrientation is either "left" or "right".

Parameters:: colSpan - colSpan Default value is 1

setColSpan

public void setColSpan(int colSpan)

Number of columns that this item spans.

Parameters:: colSpan - colSpan Default value is 1

getType

public java.lang.String getType()

The DynamicForm picks a field renderer based on the type of the field (and sometimes other attributes of the field).

Returns:: the type

setDefaultValue

public void setDefaultValue(java.lang.String defaultValue)

Value used when no value is provided for this item. Note that whenever this item's value is cleared by the user or set to null programatically, it will be reverted to the defaultValue. Developers should use the values object if their intention is to provide an initial value for a field in a form rather than a value to use in place of null.

Parameters:: defaultValue - defaultValue Default value is null

setDefaultValue

public void setDefaultValue(java.lang.Integer defaultValue)

Parameters:: defaultValue - defaultValue Default value is null

setDefaultValue

public void setDefaultValue(java.util.Date defaultValue)

Parameters:: defaultValue - defaultValue Default value is null

setDefaultValue

public void setDefaultValue(java.lang.Boolean defaultValue)

Parameters:: defaultValue - defaultValue Default value is null

setDefaultValue

public void setDefaultValue(java.lang.Float defaultValue)

Parameters:: defaultValue - defaultValue Default value is null

setValueMap

public void setValueMap(java.lang.String... valueMap)

Set the valueMap for this item.

Parameters:: valueMap - the value map

setValueMap

public void setValueMap(java.util.LinkedHashMap valueMap)

Set the valueMap for this item.

Parameters:: valueMap - the value map

setValueIcons

public void setValueIcons(java.util.Map valueIcons)

Set the valueIcons for this item.

Parameters:: valueIcons - mapping of logical values for this item to icon src URLs

setWidth

public void setWidth(java.lang.String width)

setHeight

public void setHeight(java.lang.String height)

setRedrawOnChange

public void setRedrawOnChange(boolean redrawOnChange)

Setting to true causes the FormItem to be immediately redrawn with the new properties when its value changes

Parameters:: redrawOnChange - true to redraw on change. Default is false

setEditorType

public void setEditorType(FormItem editorType)

Name of the FormItem properties to use for editing.

The type of FormItem to use for editing is normally derived automatically from type, which is the data type of the field, by the rules explained here.

Note : When you supply a custom FormItem via setEditorType(), you're really providing properties which are then used to create multiple FormItems (eg, in grids, forms and trees) and there's an underlying limitation here where event handlers have to be written to dynamically receive the actual FormItem rather than relying on "this" (because there's more than one "this").

Parameters:: editorType - editorType Default value is null

setValue

public void setValue(int value)

setValue

public void setValue(float value)

setValue

public void setValue(double value)

Set the value of the form item.

Parameters:: value - the form item value

setValue

public void setValue(java.util.Date value)

Set the value of the form item.

Parameters:: value - the form item value

setValue

public void setValue(java.lang.String value)

Set the value of the form item.

Parameters:: value - the form item value

setValue

public void setValue(boolean value)

Set the value of the form item.

Parameters:: value - the form item value

setValue

public void setValue(java.lang.Object value)

Set the value of the form item as an object. GWT objects set as FormItem values are typically used with FormItemValueParser and FormItemValueFormatter API's for custom value parsing and formatting.

Parameters:: value - the form item value

getDisplayValue

public java.lang.String getDisplayValue()

Returns this item's value with any valueMap applied to it - the value as currently displayed to the user.

Returns:: value displayed to the user

getDisplayValue

public java.lang.String getDisplayValue(java.lang.String value)

Returns this item's value with any valueMap applied to it - the value as currently displayed to the user.

Returns:: value displayed to the user

getVisibleHeight

public int getVisibleHeight()

Output the drawn height for this item in pixels. Note: this is only reliable after this item has been written out into the DOM.

Returns:: height of the form item. returns 0 if the parent form has not been rendered.

getVisibleWidth

public int getVisibleWidth()

Output the drawn width for this item in pixels. Note: this is only reliable after this item has been written out into the DOM.

Returns:: height of the form item. returns 0 if the parent form has not been rendered.

getPageRect

public Rectangle getPageRect()

Return the page-level coordinates of this object.

Returns:: the page-level coordinates of this object

getRect

public Rectangle getRect()

Return the coordinates of this object.

Returns:: the coordinates of this object

redraw

public void redraw()

Causes the FormItem to be redrawn immediately with the new properties.

See Also:: setRedrawOnChange(boolean)

getIconRect

public Rectangle getIconRect(FormItemIcon icon)

getIconPageRect

public Rectangle getIconPageRect(FormItemIcon icon)

getConfig

public JavaScriptObject getConfig()

Returns the FormItem's config object suitable for use in API's that set the editorType

Returns:: the config object

getEditorTypeConfig

public JavaScriptObject getEditorTypeConfig()

setTooltip

public void setTooltip(java.lang.String tooltip)

This text is shown as a tooltip prompt when the cursor hovers over this item. Alias for setPrompt(java.lang.String).

Parameters:: tooltip - tooltip Default value is null

getTooltip

public java.lang.String getTooltip()

This text is shown as a tooltip prompt when the cursor hovers over this item. Alias for getPrompt()

Returns:: String

setOptionFilterContext

public void setOptionFilterContext(RPCRequest rpcRequestProperties)

If this item has a specified optionDataSource, and this property is not null, this will be passed to the datasource as RPCRequest properties when performing the fetch operation on the dataSource to obtain a data-value to display-value mapping

Note : This is an advanced setting

Parameters:: rpcRequestProperties - optionFilterContext Default value is null

getOptionFilterContext

public RPCRequest getOptionFilterContext()

Returns:: RPCRequest Properties

setOptionCriteria

public void setOptionCriteria(Criteria optionCriteria)

If this item has a specified optionDataSource, and this property may be used to specify criteria to pass to the datasource when performing the fetch operation on the dataSource to obtain a data-value to display-value mapping

Note : This is an advanced setting

Parameters:: optionCriteria - optionCriteria Default value is null

getOptionCriteria

public Criteria getOptionCriteria()

Returns:: the option criteria

setShowIfCondition

public void setShowIfCondition(FormItemIfFunction showIf)

Expression that's evaluated to see if an item should be dynamically hidden. The showIf FormItemIfFunction is is evaluated whenever the form draws or redraws.

Parameters:: showIf - the showIf handler
See Also:: setRedrawOnChange(boolean)

setErrorFormatter

public void setErrorFormatter(FormItemErrorFormatter errorFormatter)

Parameters:: errorFormatter - the error formatter.

setInputTransformer

public void setInputTransformer(FormItemInputTransformer inputTransformer)

The transformer is called when a FormItem's value is about to change as the result of user interaction. This method fires after the user performed an action that would change the value of this field, and allows the developer to modify / reformat the value before it gets validated / saved. Fires before the change event.

Parameters:: inputTransformer - the input transformer

setItemHoverFormatter

public void setItemHoverFormatter(FormItemHoverFormatter hoverFormatter)

The FormItemHoverFormatter should return the HTML to display in a hover canvas when the user holds the mousepointer over this item. Return null to suppress the hover canvas altogether.

Parameters:: hoverFormatter - the hover formatter

setItemTitleHoverFormatter

public void setItemTitleHoverFormatter(FormItemHoverFormatter hoverFormatter)

The FormItemHoverFormatter should return the HTML to display in a hover canvas when the user holds the mousepointer over the item's title. Return null to suppress the hover canvas altogether.

Parameters:: hoverFormatter - the hover formatter

getForm

public DynamicForm getForm()

A reference to the FormItem's DynamicForm.

Note that you must treat this as a read-only reference to the from

Returns:: the form

getValue

public java.lang.Object getValue()

Return the value tracked by this form item.

Note that for FormItems that have a ValueMap or where a formatter has been defined, getValue() returns the underlying value of the FormItem, not the displayed value.

Returns:: value of this element

showPicker

public void showPicker()

Method to show a picker for this item. By default this method is called if the user clicks on a pickerIcon, shown by setting this.showPickerIcon to true. May also be called programatically.
Default implementation lazily creates a 'picker' from the set of defaults defined on this FormItem.

setValueFormatter

public void setValueFormatter(FormItemValueFormatter formatter)

Optional FormItemValueFormatter, if provided, is evaluated to get the display value to show for this form items underlying data value.

This provides a way to perform a more complex data to display value manipulation than a simple valueMap. Note that this method will not be applied to values displayed in a freeform text entry field (such as a TextItem or TextAreaItem), where an equivalent parser method would be required to convert a user-entered value back into a data value. Use setEditorValueFormatter(com.smartgwt.client.widgets.form.FormItemValueFormatter) and setEditorValueParser(com.smartgwt.client.widgets.form.FormItemValueParser) instead for these cases.

Parameters:: formatter - the FormItemValueFormatter

setEditorValueFormatter

public void setEditorValueFormatter(FormItemValueFormatter formatter)

An optional FormItemValueFormatter to map this item's current data value to a display value.

Note that this only applies to items which show a freeform entry area, such as a TextItem or TextAreaItem. For display values which will not be directly manipulated by the user, use setValueFormatter(com.smartgwt.client.widgets.form.FormItemValueFormatter) instead.

Parameters:: formatter - the FormItemValueFormatter

setEditorValueParser

public void setEditorValueParser(FormItemValueParser valueParser)

An optional FormItemValueParser to map a user-entered display value to a data value for storage. This method only applies to form items which show a freeform text entry area, such at the TextItem or TextAreaItem.

See also com.smartgwt.client.widgets.form.fields.FormItem#formatEditorValue

Parameters:: valueParser - the FormItemValueParser

setValueIconMapper

public void setValueIconMapper(ValueIconMapper valueIconMapper)

Set the FormItem Value Icon mapper that allows the developer to specify the image source for an icon to be displayed for the current form item value. Takes precedence over setValueIcons(java.util.Map).

Parameters:: valueIconMapper - the valueIconMapper

setDisplayFormat

public void setDisplayFormat(DateDisplayFormat displayFormat)

Fields of type "date" or "time" will be edited using a DateItem or TimeItem by default.

However this can be overridden - for canEdit:false fields, a StaticTextItem is used by default, and the developer can always specify a custom editorType as well as data type.

For fields of type "date", set this property to a valid DateDisplayFormat to specify how the date should be formatted.
For fields of type "time", set this property to a valid timeFormatter to specify how the time should be formatted.
Note that if dateFormatter or timeFormatter are specified they will take precedence over this setting.

If this field is of type "date" and is editable, the inputFormat may be used to specify how user-edited date strings will be parsed.

Note : This is an advanced setting

Parameters:: displayFormat - displayFormat Default value is null
See Also:: setInputFormat(java.lang.String), setDateFormatter(com.smartgwt.client.types.DateDisplayFormat), setTimeFormatter(com.smartgwt.client.types.TimeDisplayFormat)

setDisplayFormat

public void setDisplayFormat(TimeFormatter displayFormat)

Fields of type "date" or "time" will be edited using a DateItem or TimeItem by default.

However this can be overridden - for canEdit:false fields, a StaticTextItem is used by default, and the developer can always specify a custom editorType as well as data type.

If this field is of type "date" and is editable, the inputFormat may be used to specify how user-edited date strings will be parsed.

Note : This is an advanced setting

Parameters:: displayFormat - displayFormat Default value is null
See Also:: setInputFormat(java.lang.String), setDateFormatter(com.smartgwt.client.types.DateDisplayFormat), setTimeFormatter(com.smartgwt.client.types.TimeDisplayFormat)

enable

public void enable()

Set this item to be enabled (shortcut for #setDisabled(Boolean),setDisabled(false)).

disable

public void disable()

Set this item to be disabled (shortcut for #setDisabled(Boolean),setDisabled(true)).

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.smartgwt.client.widgets.form.fields Class FormItem

FormItem

FormItem

FormItem

getOrCreateRef

setAccessKey

getAccessKey

setAlign

getAlign

setAllowExpressions

getAllowExpressions

setAlwaysFetchMissingValues

getAlwaysFetchMissingValues

setBrowserSpellCheck

getBrowserSpellCheck

setCanFocus

getCanFocus

setCellHeight

getCellHeight

setCellStyle

getCellStyle

getContainerWidget

setCriteriaField

getCriteriaField

setDataPath

getDataPath

setDateFormatter

getDateFormatter

setDefaultIconSrc

getDefaultIconSrc

setDisabled

getDisabled

setDisplayField

getDisplayField

setEmptyDisplayValue

getEmptyDisplayValue

setEmptyValueIcon

getEmptyValueIcon

setEndRow

getEndRow

setErrorIconHeight

getErrorIconHeight

setErrorIconSrc

getErrorIconSrc

setErrorIconWidth

getErrorIconWidth

setErrorMessageWidth

getErrorMessageWidth

setFetchMissingValues

getFetchMissingValues

setFilterLocally

getFilterLocally

setGlobalTabIndex

getGlobalTabIndex

setHeight

getHeight

setHint

getHint

setHintStyle

getHintStyle

setHoverAlign

getHoverAlign

setHoverDelay

getHoverDelay

setHoverHeight

getHoverHeight

setHoverOpacity

getHoverOpacity

setHoverStyle

getHoverStyle

setHoverVAlign

getHoverVAlign

setHoverWidth

getHoverWidth

setIconHeight

getIconHeight

setIconPrompt

getIconPrompt

setIconVAlign

getIconVAlign

com.smartgwt.client.widgets.form.fields
Class FormItem