public class StaticTextItem extends FormItem
FormItem.CustomStateGetter, FormItem.StateCustomizer
scClassName, warnOnEditorTypeConversion, warnOnEditorTypeConversionDefault
id
factoryCreated, factoryProperties, readOnly
Constructor and Description |
---|
StaticTextItem() |
StaticTextItem(com.google.gwt.core.client.JavaScriptObject jsObj) |
StaticTextItem(java.lang.String name) |
StaticTextItem(java.lang.String name,
java.lang.String title) |
Modifier and Type | Method and Description |
---|---|
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
Canvas defaults)
Changes the defaults for Canvas AutoChildren named
autoChildName . |
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
FormItem defaults)
Changes the defaults for FormItem AutoChildren named
autoChildName . |
static void |
changePickerIconDefaults(FormItemIcon defaults) |
boolean |
getApplyAlignToText()
|
java.lang.Boolean |
getApplyHeightToTextBox()
If
FormItem.height is specified, should it be applied
to the item's text box element? |
boolean |
getCanSelectText()
Should the user be able to select the text in this item?
|
java.lang.Boolean |
getClipValue()
If true, text that exceeds the specified size of the form item will be clipped.
|
DateDisplayFormat |
getDateFormatter()
Display format to use for date type values within this formItem.
|
java.lang.String |
getEditProxyConstructor()
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode . |
java.lang.Boolean |
getEscapeHTML()
By default HTML values in a staticTextItem will be interpreted by the browser.
|
static StaticTextItem |
getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) |
java.lang.String |
getTextBoxStyle()
Base CSS class for this item
|
java.lang.Boolean |
getWrap()
If true, item contents can wrap.
|
void |
setApplyAlignToText(boolean applyAlignToText)
|
void |
setApplyHeightToTextBox(java.lang.Boolean applyHeightToTextBox)
If
FormItem.height is specified, should it be applied
to the item's text box element? |
void |
setCanSelectText(boolean canSelectText)
Should the user be able to select the text in this item?
|
void |
setClipValue(java.lang.Boolean clipValue)
If true, text that exceeds the specified size of the form item will be clipped.
|
void |
setDateFormatter(DateDisplayFormat dateFormatter)
Display format to use for date type values within this formItem.
|
static void |
setDefaultProperties(StaticTextItem staticTextItemProperties)
Class level method to set the default properties of this class.
|
void |
setEditProxyConstructor(java.lang.String editProxyConstructor)
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode . |
void |
setEscapeHTML(java.lang.Boolean escapeHTML)
By default HTML values in a staticTextItem will be interpreted by the browser.
|
void |
setTextBoxStyle(java.lang.String textBoxStyle)
Base CSS class for this item
|
void |
setWrap(java.lang.Boolean wrap)
If true, item contents can wrap.
|
_getValue, addBlurHandler, addChangedHandler, addChangeHandler, addClickHandler, addDoubleClickHandler, addEditorEnterHandler, addEditorExitHandler, addFocusHandler, addIconClickHandler, addIconKeyPressHandler, addItemHoverHandler, addKeyDownHandler, addKeyPressHandler, addKeyUpHandler, addPendingStatusChangedHandler, addPickerIconClickHandler, addShowContextMenuHandler, addTitleClickHandler, addTitleDoubleClickHandler, addTitleHoverHandler, addValueHoverHandler, addValueIconClickHandler, applyFormula, asSGWTComponent, blurItem, canEditCriterion, clearErrors, clearValue, disable, disableIcon, enable, enableIcon, error, error, errorIfNotCreated, focusInItem, getAccessKey, getAlign, getAllowExpressions, getAlwaysFetchMissingValues, getAriaRole, getAttribute, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsFloat, getAttributeAsInt, getAttributeAsJavaScriptObject, getAttributeAsObject, getAttributeAsString, getAutoComplete, getBrowserInputType, getBrowserSpellCheck, getCanEdit, getCanEditOpaqueValues, getCanFocus, getCanTabToIcons, getCanvasAutoChild, getCellHeight, getCellStyle, getChangeOnKeypress, getClassName, getClipStaticValue, getClipTitle, getConfig, getContainerWidget, getControlStyle, getCriteriaField, getCriterion, getCriterion, getCursorPosition, getCustomState, getDataPath, getDecimalPad, getDecimalPrecision, getDefaultIconSrc, getDisabled, getDisableIconsOnReadOnly, getDisplayField, getDisplayFieldName, getDisplayValue, getDisplayValue, getEditorTypeConfig, getEditPendingCSSText, getEmptyDisplayValue, getEmptyValueIcon, getEndRow, getErrorIconHeight, getErrorIconSrc, getErrorIconWidth, getErrorMessageWidth, getErrors, getExportFormat, getFetchMissingValues, getFieldName, getFilterLocally, getForeignDisplayField, getForm, getFormat, getFormItemAutoChild, getFormula, getFullDataPath, getGlobalTabIndex, getGridColNum, getGridRowNum, getHeight, getHeightAsString, getHidden, getHint, getHintStyle, getHoverAlign, getHoverDelay, getHoverHeight, getHoverOpacity, getHoverStyle, getHoverVAlign, getHoverWidth, getIcon, getIconHeight, getIconHSpace, getIconPageRect, getIconPrompt, getIconRect, getIconVAlign, getIconWidth, getImageURLPrefix, getImageURLSuffix, getImplicitSave, getImplicitSaveOnBlur, getInputFormat, getLeft, getLoadingDisplayValue, getLocateItemBy, getMinHintWidth, getMultipleValueSeparator, getName, getOperator, getOptionCriteria, getOptionDataSource, getOptionDataSourceAsString, getOptionFilterContext, getOptionOperationId, getOriginalValueMessage, getPageLeft, getPageRect, getPageTop, getPicker, getPickerIconHeight, getPickerIconName, getPickerIconPrompt, getPickerIconProperties, getPickerIconSrc, getPickerIconStyle, getPickerIconWidth, getPixelHeight, getPixelWidth, getPrintTextBoxStyle, getPrintTitleStyle, getPrompt, getReadOnlyDisplay, getReadOnlyHover, getReadOnlyTextBoxStyle, getReadOnlyWhen, getRect, getRedrawOnChange, getRejectInvalidValueOnChange, getRequired, getRequiredMessage, getRequiredWhen, getRowSpan, getSaveOnEnter, getScClassName, getSelectedRecord, getSelectOnClick, getSelectOnFocus, getShouldSaveValue, getShowClippedTitleOnHover, getShowClippedValueOnHover, getShowDeletions, getShowDisabled, getShowErrorIcon, getShowErrorStyle, getShowErrorText, getShowFocused, getShowFocusedErrorState, getShowFocusedIcons, getShowFocusedPickerIcon, getShowHint, getShowIcons, getShowOldValueInHover, getShowOver, getShowOverIcons, getShowPending, getShowPickerIcon, getShowRTL, getShowTitle, getShowValueIconOnly, getStartRow, getStaticHeight, getStopOnError, getSupportsCutPasteEvents, getSuppressValueIcon, getSynchronousValidation, getTabIndex, getTextAlign, getTextFormula, getTimeFormatter, getTitle, getTitleAlign, getTitleColSpan, getTitleOrientation, getTitleStyle, getTitleVAlign, getTooltip, getTop, getType, getUpdateControlOnOver, getUpdatePickerIconOnOver, getUpdateTextBoxOnOver, getUseDisabledHintStyleForReadOnly, getValidateOnChange, getValidateOnExit, getValidOperators, getVAlign, getValue, getValueAsRecordList, getValueDeselectedCSSText, getValueField, getValueFieldName, getValueIconHeight, getValueIconLeftPadding, getValueIconRightPadding, getValueIconSize, getValueIconWidth, getVisible, getVisibleHeight, getVisibleTitleWidth, getVisibleWhen, getVisibleWidth, getWarnOnEditorTypeConversion, getWarnOnEditorTypeConversionDefault, getWidth, getWidthAsString, getWrapHintText, getWrapTitle, handleWarnOnEditorTypeConversion, hasAdvancedCriteria, hasErrors, hide, hideIcon, invalidateDisplayValueCache, isCreated, isCutEvent, isDisabled, isDrawn, isFocused, isInGrid, isPasteEvent, isVisible, linkToInstanceUponCreate, mapDisplayToValue, mapValueToDisplay, mapValueToDisplay, mapValueToDisplay, redraw, redraw, setAccessKey, setAlign, setAllowExpressions, setAlwaysFetchMissingValues, setAriaRole, setAriaState, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAutoChildConstructor, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildVisibility, setAutoComplete, setBrowserInputType, setBrowserSpellCheck, setCanEdit, setCanEditCriterionPredicate, setCanEditOpaqueValues, setCanFocus, setCanTabToIcons, setCellHeight, setCellStyle, setChangeOnKeypress, setClipStaticValue, setClipTitle, setColSpan, setColSpan, setControlStyle, setCriteriaField, setCriterion, setCriterionGetter, setCriterionSetter, setCustomStateGetter, setDataPath, setDecimalPad, setDecimalPrecision, setDefaultIconSrc, setDefaultProperties, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDisabled, setDisableIconsOnReadOnly, setDisplayField, setDisplayFormat, setDisplayFormat, setEditorProperties, setEditorType, setEditorType, setEditorType, setEditorValueFormatter, setEditorValueParser, setEditPendingCSSText, setEmptyDisplayValue, setEmptyValueIcon, setEndRow, setErrorFormatter, setErrorIconHeight, setErrorIconSrc, setErrorIconWidth, setErrorMessageWidth, setErrorOrientation, setErrors, setErrors, setExportFormat, setFetchMissingValues, setFilterLocally, setForeignDisplayField, setFormat, setFormula, setGlobalTabIndex, setHeight, setHeight, setHidden, setHint, setHintStyle, setHoverAlign, setHoverDelay, setHoverHeight, setHoverOpacity, setHoverStyle, setHoverVAlign, setHoverWidth, setIconDisabled, setIconHeight, setIconHSpace, setIconPrompt, setIcons, setIconVAlign, setIconWidth, setImageURLPrefix, setImageURLSuffix, setImplicitSave, setImplicitSaveOnBlur, setInitHandler, setInputFormat, setInputTransformer, setItemHoverFormatter, setItemTitleHoverFormatter, setItemValueHoverFormatter, setJavaScriptObject, setLeft, setLoadingDisplayValue, setLocateItemBy, setMinHintWidth, setMultipleValueSeparator, setName, setNullProperty, setOperator, setOptionCriteria, setOptionDataSource, setOptionDataSource, setOptionFilterContext, setOptionOperationId, setOriginalValueMessage, setPickerIconHeight, setPickerIconName, setPickerIconPrompt, setPickerIconProperties, setPickerIconSrc, setPickerIconStyle, setPickerIconWidth, setPrintTextBoxStyle, setPrintTitleStyle, setPrompt, setProperty, setProperty, setProperty, setProperty, setProperty, setReadOnlyDisplay, setReadOnlyHover, setReadOnlyTextBoxStyle, setReadOnlyWhen, setRedrawOnChange, setRejectInvalidValueOnChange, setRequired, setRequiredMessage, setRequiredWhen, setRowSpan, setSaveOnEnter, setScClassName, setSelectOnClick, setSelectOnFocus, setShouldSaveValue, setShowClippedTitleOnHover, setShowClippedValueOnHover, setShowDeletions, setShowDisabled, setShowErrorIcon, setShowErrorStyle, setShowErrorText, setShowFocused, setShowFocusedErrorState, setShowFocusedIcons, setShowFocusedPickerIcon, setShowHint, setShowIcons, setShowIfCondition, setShowOldValueInHover, setShowOver, setShowOverIcons, setShowPending, setShowPickerIcon, setShowRTL, setShowTitle, setShowValueIconOnly, setStartRow, setStateCustomizer, setStaticHeight, setStopOnError, setSupportsCutPasteEvents, setSuppressValueIcon, setSynchronousValidation, setTabIndex, setTextAlign, setTextFormula, setTimeFormatter, setTitle, setTitleAlign, setTitleColSpan, setTitleHoverFormatter, setTitleOrientation, setTitleStyle, setTitleVAlign, setTooltip, setTop, setType, setUpdateControlOnOver, setUpdatePickerIconOnOver, setUpdateTextBoxOnOver, setUseDisabledHintStyleForReadOnly, setValidateOnChange, setValidateOnExit, setValidators, setValidOperators, setVAlign, setValue, setValue, setValue, setValue, setValue, setValue, setValueDeselectedCSSText, setValueField, setValueFormatter, setValueHoverFormatter, setValueIconHeight, setValueIconLeftPadding, setValueIconMapper, setValueIconRightPadding, setValueIcons, setValueIconSize, setValueIconWidth, setValueMap, setValueMap, setVisible, setVisibleWhen, setWarnOnEditorTypeConversion, setWarnOnEditorTypeConversionDefault, setWidth, setWidth, setWrapHintText, setWrapTitle, shouldApplyHeightToTextBox, shouldFetchMissingValue, shouldSaveOnEnter, shouldStopKeyPressBubbling, show, showIcon, showPicker, stopHover, storeValue, storeValue, updateState, validate, valueClipped
getRef, getRef, internalSetID
applyFactoryProperties, doAddHandler, fireEvent, getAttributeAsDoubleArray, getAttributeAsIntArray, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsStringArray, getAttributes, getHandlerCount, getReadOnly, isFactoryCreated, logConfiguration, setAttribute, setAttribute, setAttribute, setAttributeAsJavaObject, setFactoryCreated, setReadOnly
public StaticTextItem()
public StaticTextItem(com.google.gwt.core.client.JavaScriptObject jsObj)
public StaticTextItem(java.lang.String name)
public StaticTextItem(java.lang.String name, java.lang.String title)
public static StaticTextItem getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
public static void changeAutoChildDefaults(java.lang.String autoChildName, Canvas defaults)
autoChildName
.autoChildName
- name of an AutoChild to customize the defaults for.defaults
- Canvas defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties
.AutoChildUsage
public static void changeAutoChildDefaults(java.lang.String autoChildName, FormItem defaults)
autoChildName
.autoChildName
- name of an AutoChild to customize the defaults for.defaults
- FormItem defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties
.AutoChildUsage
public static void changePickerIconDefaults(FormItemIcon defaults)
public void setApplyAlignToText(boolean applyAlignToText)
textAlign
is unset, should the align
setting, if set, be used for this
StaticTextItem
's textAlign
?
Note : This is an advanced setting
setApplyAlignToText
in class FormItem
applyAlignToText
- Default value is trueAppearance overview and related methods
public boolean getApplyAlignToText()
textAlign
is unset, should the align
setting, if set, be used for this
StaticTextItem
's textAlign
?getApplyAlignToText
in class FormItem
Appearance overview and related methods
public void setApplyHeightToTextBox(java.lang.Boolean applyHeightToTextBox)
FormItem.height
is specified, should it be applied
to the item's text box element? Overridden to be false
for StaticTextItems by default.
See shouldApplyHeightToTextBox()
for more
information.
Note : This is an advanced setting
setApplyHeightToTextBox
in class FormItem
applyHeightToTextBox
- Default value is falsepublic java.lang.Boolean getApplyHeightToTextBox()
FormItem.height
is specified, should it be applied
to the item's text box element? Overridden to be false
for StaticTextItems by default.
See shouldApplyHeightToTextBox()
for more
information.
getApplyHeightToTextBox
in class FormItem
public void setCanSelectText(boolean canSelectText)
setCanSelectText
in class FormItem
canSelectText
- Default value is truepublic boolean getCanSelectText()
getCanSelectText
in class FormItem
public void setClipValue(java.lang.Boolean clipValue)
clipValue
- Default value is falseAppearance overview and related methods
public java.lang.Boolean getClipValue()
Appearance overview and related methods
public void setDateFormatter(DateDisplayFormat dateFormatter)
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 FormItem.editorType
as well as data type
.
The FormItem.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 DynamicForm.dateFormatter
, or for fields of type
"datetime"
DynamicForm.datetimeFormatter
. Otherwise for fields of type "date", default is to use the system-wide default short
date format, configured via Date.setShortDisplayFormat()
.
For fields of type "datetime" or for Date values in fields whose type does not inherit from the logical "date" type,
default is to use the system-wide normal date format configured via Date.setNormalDisplayFormat()
(using "toNormalDate()" on logical
"date"
type fields is not desirable as this would display the time component of the date object to the
user).
Specify any valid DateDisplayFormat
to change the format used by this
item.
Note : This is an advanced setting
setDateFormatter
in class FormItem
dateFormatter
- Default value is nullFormItem.setTimeFormatter(com.smartgwt.client.types.TimeDisplayFormat)
,
Appearance overview and related methods
public DateDisplayFormat getDateFormatter()
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 FormItem.editorType
as well as data type
.
The FormItem.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 DynamicForm.dateFormatter
, or for fields of type
"datetime"
DynamicForm.datetimeFormatter
. Otherwise for fields of type "date", default is to use the system-wide default short
date format, configured via Date.setShortDisplayFormat()
.
For fields of type "datetime" or for Date values in fields whose type does not inherit from the logical "date" type,
default is to use the system-wide normal date format configured via Date.setNormalDisplayFormat()
(using "toNormalDate()" on logical
"date"
type fields is not desirable as this would display the time component of the date object to the
user).
Specify any valid DateDisplayFormat
to change the format used by this
item.
getDateFormatter
in class FormItem
FormItem.getTimeFormatter()
,
Appearance overview and related methods
public void setEditProxyConstructor(java.lang.String editProxyConstructor)
EditProxy
for this component when the component is
first placed into edit mode
.setEditProxyConstructor
in class FormItem
editProxyConstructor
- SCClassName . Default value is "TextItemEditProxy"
public java.lang.String getEditProxyConstructor()
EditProxy
for this component when the component is
first placed into edit mode
.getEditProxyConstructor
in class FormItem
SCClassName
public void setEscapeHTML(java.lang.Boolean escapeHTML)
"<b>AAA</b>"
) is
displayed to the user rather than the interpreted HTML (for example "AAA"
)escapeHTML
- Default value is falseAppearance overview and related methods
public java.lang.Boolean getEscapeHTML()
"<b>AAA</b>"
) is
displayed to the user rather than the interpreted HTML (for example "AAA"
)Appearance overview and related methods
public void setTextBoxStyle(java.lang.String textBoxStyle)
setTextBoxStyle
in class FormItem
textBoxStyle
- FormItemBaseStyle . Default value is "staticTextItem"
,
Appearance overview and related methods
public java.lang.String getTextBoxStyle()
getTextBoxStyle
in class FormItem
FormItemBaseStyle
,
Appearance overview and related methods
public void setWrap(java.lang.Boolean wrap)
wrap
- Default value is trueAppearance overview and related methods
public java.lang.Boolean getWrap()
Appearance overview and related methods
public static void setDefaultProperties(StaticTextItem staticTextItemProperties)
Note: This method is intended for setting default attributes only and will affect all instances of the underlying class (including those automatically generated in JavaScript). This method should not be used to apply standard EventHandlers or override methods for a class - use a custom subclass instead. Calling this method after instances have been created can result in undefined behavior, since it bypasses any setters and a class instance may have already examined a particular property and not be expecting any changes through this route.
staticTextItemProperties
- properties that should be used as new defaults when instances of this class are createdSGWTProperties