/** * If true, when the form is drawn, focus will automatically be put into the first focusable element in the form.<br> Note * that to put focus in a different item you can explicitly call <code>dynamicForm.focusInItem(<i>itemName</i>)</code> * * @param autoFocus autoFocus Default value is false * @see com.smartgwt.client.widgets.form.DynamicForm#focusInItem * @see com.smartgwt.client.docs.Focus Focus overview and related methods */ public void setAutoFocus(Boolean autoFocus) { setAttribute("autoFocus", autoFocus, true); }
/** * The amount of empty space, in pixels, surrounding each form item within its cell in the layout grid. * * @param cellPadding cellPadding Default value is 2 * @see com.smartgwt.client.docs.FormLayout FormLayout overview and related methods */ public void setCellPadding(int cellPadding) { setAttribute("cellPadding", cellPadding, true); }
/** * If true, we ensure that column widths are at least as large as you specify them. This means that if any single column * overflows (due to, eg, a long unbreakable title), the form as a whole overflows. <P> If false, columns will have their * specified sizes as long as no column overflows. If any column overflows, space will be taken from any other columns * that aren't filling the available room, until there is no more free space, in which case the form as a whole overflows. * * @param fixedColWidths fixedColWidths Default value is false * @see com.smartgwt.client.docs.FormLayout FormLayout overview and related methods */ public void setFixedColWidths(Boolean fixedColWidths) { setAttribute("fixedColWidths", fixedColWidths, true); }
/** * Warning to display to the user if an attempt to {@link com.smartgwt.client.widgets.form.DynamicForm#submitForm natively * submit} a form is unable to submit to the server. The most common cause for this failure is that the user has typed an * invalid file-path into an upload type field. * <p><b>Note : </b> This is an advanced setting</p> * * @param formSubmitFailedWarning formSubmitFailedWarning Default value is "Form was unable to be submitted. The most likely cause for this is an invalid value in an upload field." */ public void setFormSubmitFailedWarning(String formSubmitFailedWarning) { setAttribute("formSubmitFailedWarning", formSubmitFailedWarning, true); }
/** * Indicates whether the titles of required items in this form should use the special prefix and suffix specified by the * next two properties, instead of the standard prefix and suffix. * * @param hiliteRequiredFields hiliteRequiredFields Default value is true * @see com.smartgwt.client.docs.FormTitles FormTitles overview and related methods */ public void setHiliteRequiredFields(Boolean hiliteRequiredFields) { setAttribute("hiliteRequiredFields", hiliteRequiredFields, true); }
/** * Opacity for hovers shown for items * * @param itemHoverOpacity itemHoverOpacity Default value is null * @see com.smartgwt.client.widgets.form.fields.FormItem#setHoverOpacity */ public void setItemHoverOpacity(Integer itemHoverOpacity) { setAttribute("itemHoverOpacity", itemHoverOpacity, true); }
/** * Vertical text alignment for hovers shown for items * * @param itemHoverVAlign itemHoverVAlign Default value is null * @see com.smartgwt.client.widgets.form.fields.FormItem#setHoverVAlign */ public void setItemHoverVAlign(Integer itemHoverVAlign) { setAttribute("itemHoverVAlign", itemHoverVAlign, true); }
/** * When creating form items for fields with text type data, if the specified length of the field exceeds this threshold we * will create form item of type <code>this.longTextEditorType</code> (a TextAreaItem by default), rather than a simple * text item. Overridden by explicitly specifying <code>editorType</code> for the field. * * @param longTextEditorThreshold longTextEditorThreshold Default value is 255 * @see com.smartgwt.client.docs.Appearance Appearance overview and related methods */ public void setLongTextEditorThreshold(int longTextEditorThreshold) { setAttribute("longTextEditorThreshold", longTextEditorThreshold, true); }
/** * The required message for required field errors. * * @param requiredMessage requiredMessage Default value is null * @see com.smartgwt.client.docs.FormTitles FormTitles overview and related methods */ public void setRequiredMessage(String requiredMessage) { setAttribute("requiredMessage", requiredMessage, true); }
/** * The string prepended to the title of every required item in this form if highlightRequiredFields is true and the * titleOrientation property is set to "right". * * @param requiredRightTitlePrefix requiredRightTitlePrefix Default value is "<B>: " * @see com.smartgwt.client.docs.FormTitles FormTitles overview and related methods */ public void setRequiredRightTitlePrefix(String requiredRightTitlePrefix) { setAttribute("requiredRightTitlePrefix", requiredRightTitlePrefix, true); }
/** * The string prepended to the title of every required item in this form if highlightRequiredFields is true. * * @param requiredTitlePrefix requiredTitlePrefix Default value is "<B>" * @see com.smartgwt.client.docs.FormTitles FormTitles overview and related methods */ public void setRequiredTitlePrefix(String requiredTitlePrefix) { setAttribute("requiredTitlePrefix", requiredTitlePrefix, true); }
/** * The string prepended to the title of an item in this form if its titleOrientation property is set to "right". * * @param rightTitlePrefix rightTitlePrefix Default value is ": " * @see com.smartgwt.client.docs.FormTitles FormTitles overview and related methods */ public void setRightTitlePrefix(String rightTitlePrefix) { setAttribute("rightTitlePrefix", rightTitlePrefix, true); }
/** * Indicates whether on validation failure, the error message displayed to the user should be prepended with the * title for the item. * * @param showTitlesWithErrorMessages showTitlesWithErrorMessages Default value is false * @see com.smartgwt.client.docs.Validation Validation overview and related methods */ public void setShowTitlesWithErrorMessages(Boolean showTitlesWithErrorMessages) { setAttribute("showTitlesWithErrorMessages", showTitlesWithErrorMessages, true); }
/** * The string prepended to the title of every item in this form. * * @param titlePrefix titlePrefix Default value is "" * @see com.smartgwt.client.docs.FormTitles FormTitles overview and related methods */ public void setTitlePrefix(String titlePrefix) { setAttribute("titlePrefix", titlePrefix, true); }
/** * If this browser has a 'spellCheck' feature for text-based form item elements, should it be used for items in this form? * Can be overridden at the item level via {@link com.smartgwt.client.widgets.form.fields.FormItem#getBrowserSpellCheck * browserSpellCheck} <P> Notes:<br> - this property only applies to text based items such as TextItem and * TextAreaItem.<br> - this property is not supported on all browsers. * * @param browserSpellCheck browserSpellCheck Default value is true * @see com.smartgwt.client.widgets.form.fields.FormItem#setBrowserSpellCheck */ public void setBrowserSpellCheck(Boolean browserSpellCheck) { setAttribute("browserSpellCheck", browserSpellCheck, true); }
/** * If set to true, client-side validators will not run on the form when validate() is called. Server-side validators (if * any) will still run on attempted save. * * @param disableValidation disableValidation Default value is null * @see com.smartgwt.client.widgets.form.DynamicForm#saveData * @see com.smartgwt.client.widgets.form.DynamicForm#submit * @see com.smartgwt.client.docs.Validation Validation overview and related methods */ public void setDisableValidation(Boolean disableValidation) { setAttribute("disableValidation", disableValidation, true); }
/** * When {@link com.smartgwt.client.widgets.form.DynamicForm#getImplicitSave implicitSave} is true, indicates that form item * values will be automatically saved after a given pause during editing, as well as when each item's "editorExit" handler * is fired and when the entire form is submitted. * * @param implicitSaveDelay implicitSaveDelay Default value is 2000 */ public void setImplicitSaveDelay(int implicitSaveDelay) { setAttribute("implicitSaveDelay", implicitSaveDelay, true); }
/** * Minimum width of a form column. * * @param minColWidth minColWidth Default value is 20 * @see com.smartgwt.client.docs.FormLayout FormLayout overview and related methods */ public void setMinColWidth(int minColWidth) { setAttribute("minColWidth", minColWidth, true); }
/** * The width in pixels allocated to the title of every item in this form. If you don't specify explicit {@link DynamicForm#setColWidths(Object...) colWidths}, * you can set this value to the string "*" to divide the usable space evenly between titles and fields. * * @param titleWidth the title width */ public void setTitleWidth(int titleWidth) { setAttribute("titleWidth", titleWidth, true); }
/** * Default alignment for item titles. If unset default alignment will be derived from {@link * com.smartgwt.client.util.Page#isRTL text direction} as described in {@link * com.smartgwt.client.widgets.form.DynamicForm#getTitleAlign DynamicForm.getTitleAlign} * * @param titleAlign titleAlign Default value is null */ public void setTitleAlign(Alignment titleAlign) { setAttribute("titleAlign", titleAlign.getValue(), true); }