public class ListGridField extends DataClass implements HasCellSavedHandlers, HasChangeHandlers, HasChangedHandlers, HasEditorEnterHandlers, HasEditorExitHandlers, HasRecordClickHandlers
ListGrid
.Constructor and Description |
---|
ListGridField() |
ListGridField(com.google.gwt.core.client.JavaScriptObject jsObj) |
ListGridField(java.lang.String name) |
ListGridField(java.lang.String name,
int width) |
ListGridField(java.lang.String name,
java.lang.String title) |
ListGridField(java.lang.String name,
java.lang.String title,
int width) |
Modifier and Type | Method and Description |
---|---|
com.google.gwt.event.shared.HandlerRegistration |
addCellSavedHandler(CellSavedHandler handler)
Add a cellSaved handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addChangedHandler(ChangedHandler handler)
Add a changed handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addChangeHandler(ChangeHandler handler)
Add a change handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEditorEnterHandler(EditorEnterHandler handler)
Add a editorEnter handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEditorExitHandler(EditorExitHandler handler)
Add a editorExit handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRecordClickHandler(RecordClickHandler handler)
Add a recordClick handler.
|
void |
addSummaryFunction(SummaryFunction summaryFunction)
If
showGridSummary or showGroupSummary is true,
this method can be used to specify a SummaryFunction
for calculating the summary value to display. |
void |
addSummaryFunction(SummaryFunctionType summaryFunction)
If
showGridSummary or showGroupSummary is true,
this method can be used to specify a SummaryFunctionType
for calculating the summary value to display. |
Alignment |
getAlign()
Horizontal alignment for field's column header: "left", "right" or "center".
|
java.lang.Boolean |
getApplyAfterSummary()
If
field.userFormula is set for this field, and
this grid is showing group summaries or a grid summary , this property determines what field value
should be present in those summary rows. |
java.lang.Boolean |
getAutoFetchDisplayMap()
If true, automatically fetches records and derives a valueMap from
optionDataSource . |
java.lang.Boolean |
getAutoFitWidth()
Enables autofitting to values or titles for this field..
|
AutoFitWidthApproach |
getAutoFitWidthApproach()
When a user requests column autofitting via the
header contextmenu or via a mouse gesture , what autofit approach is used. |
java.lang.Boolean |
getAutoFreeze()
Whether this field should be automatically frozen when other fields are frozen.
|
java.lang.String |
getBaseStyle()
Custom base style to apply to all cells in this field instead of
baseStyle To override the baseStyle at the row level, use
record[listGrid.recordBaseStyleProperty]
instead. |
java.lang.Boolean |
getCanDragResize()
Whether this field can be dragResized using the mouse.
|
java.lang.Boolean |
getCanEdit()
Can this field be edited? May be overridden by setting the 'canEdit' property at the listGrid level.
|
java.lang.Boolean |
getCanExport()
Dictates whether the data in this field be exported.
|
java.lang.Boolean |
getCanFilter()
If showing a filter row for this ListGrid, should the filter criteria for this field be editable
|
java.lang.Boolean |
getCanFreeze()
Whether this field should display freezing/unfreezing options in its header context menu.
|
java.lang.Boolean |
getCanGroupBy()
Determines whether this field will be groupable in the header context menu.
|
java.lang.Boolean |
getCanHide()
Whether this field can be hidden via the header context menu.
|
java.lang.Boolean |
getCanHilite()
Determines whether this field can be hilited.
|
java.lang.Boolean |
getCanReorder()
Whether this field can be reordered using the mouse.
|
java.lang.Boolean |
getCanSort()
Enables or disables sorting by this column.
|
java.lang.Boolean |
getCanSortClientOnly()
When true, this field can only be used for sorting if the data is entirely client-side.
|
java.lang.Boolean |
getCanToggle()
Allows a boolean or valueMapped field to be edited without going into edit mode.
|
Alignment |
getCellAlign()
Horizontal alignment for cells in this field's column: "left", "right" or "center".
If null, alignment is derived from align . |
java.lang.String |
getCellIcon()
For a field of type:"icon" only, set the icon that appears in body cells.
|
java.lang.String |
getDataPath()
dataPath for this field.
|
DateDisplayFormat |
getDateFormatter()
Display format to use for date type values within this field.
|
java.lang.Integer |
getDecimalPad()
Applies only to fields of type "float" and enforces a minimum number of digits shown after the decimal point.
|
java.lang.Integer |
getDecimalPrecision()
Applies only to fields of type "float" and affects how many significant digits are shown.
|
java.lang.String |
getDefaultGroupingMode()
Default groupingMode used when the user does not specify a mode or grouping is triggered programmatically and
field.groupingMode is unset. |
java.lang.String |
getDefaultIconSrc()
If this field is editable, this property will be passed to editors displayed for cells within this field as
defaultIconSrc . |
java.lang.String |
getDisplayField()
Specifies the
optionDataSource field used to
retrieve the display values that are to be mapped from the internal values specified by valueField . |
java.lang.Boolean |
getDisplayValueFromRecord()
If a
displayField is set, should this field show
record values from the displayField ? |
java.lang.Integer |
getEditorIconHeight()
If this field is editable, this property will be passed to editors displayed for cells within this field as
iconHeight .If this property unset, the iconHeight property from the editor can be picked up from iconHeight instead. |
java.lang.Integer |
getEditorIconWidth()
|
java.lang.String |
getEditorImageURLPrefix()
When some cell in this field is being edited, this property can be used to apply an explicit
imageURLPrefix to the editor in question. |
java.lang.String |
getEditorImageURLSuffix()
When some cell in this field is being edited, this property can be used to apply an explicit
imageURLSuffix to the editor in question. |
java.lang.Integer |
getEditorValueIconHeight()
When some cell in this field is being edited, setting this property will specify the height for value icons in the
cell's editor.
|
java.lang.Integer |
getEditorValueIconWidth()
When some cell in this field is being edited, setting this property will specify the width for value icons in the cell's
editor.
|
java.lang.String |
getEmptyCellValue()
The value to display for a cell whose value is null or the empty string after applying formatCellValue and valueMap (if
any).
|
EnterKeyEditAction |
getEnterKeyEditAction()
What to do when a user hits enter while editing this field?
Overrides the enterKeyEditAction as
specified at the listGrid level while focus is in this field. |
java.lang.Boolean |
getEscapeHTML()
By default HTML values in ListGrid cells will be interpreted by the browser.
|
EscapeKeyEditAction |
getEscapeKeyEditAction()
What to do when a user hits escape while editing this field?
Overrides the escapeKeyEditAction as
specified at the listGrid level while focus is in this field. |
java.lang.Boolean |
getExportRawValues()
Dictates whether the data in this field should be exported raw by
exportClientData() . |
java.lang.String |
getFieldTitle(ListGrid viewer,
int fieldNum)
If your derivation of the field title is more complex than specifying a static string, you can specify a getFieldTitle()
method on your field to return the title string.
|
java.lang.Boolean |
getFilterOnKeypress()
If we're showing the filterEditor (listGrid.showFilterEditor is true), this property determines whether this list should
be filtered every time the user edits the value of the filter editor for this field.
|
OperatorId |
getFilterOperator()
With the
FilterEditor showing, the Operator to use
when matching values for this field. |
java.lang.Boolean |
getFrozen()
Whether this field should be "frozen" for the purposes of horizontal scrolling.
|
java.lang.Integer |
getGroupGranularity()
Granularity of grouping for numeric fields.
|
java.lang.String |
getGroupingMode()
For a field that allows multiple
grouping modes ,
the current grouping mode. |
java.util.Map |
getGroupingModes()
If set, provides several possible styles of grouping that are valid for this field.
|
java.lang.Integer |
getGroupPrecision()
For fields of type:"float" or derived from float, number of digits after the decimal point to consider when grouping.
|
java.lang.String |
getHeaderBaseStyle()
Custom base style to apply to this field's header button instead of
headerBaseStyle .Note that depending on the header button constructor, you may have to override headerTitleStyle as well. |
java.lang.String |
getHeaderTitle()
Optional title for the header button for this field.
|
java.lang.String |
getHeaderTitleStyle()
Custom titleStyle to apply to this field's header button instead of
headerTitleStyle .Note that this will typically only have an effect if headerButtonConstructor
is set to StretchImgButton or a subclass thereof. |
java.lang.Integer |
getHiliteIconHeight()
Height for hilite icons for this field.
|
java.lang.Integer |
getHiliteIconLeftPadding()
How much padding should there be on the left of
hilite icons for this field? Overrides hiliteIconLeftPadding |
HiliteIconPosition |
getHiliteIconPosition()
When
hiliteIcons are present, where the hilite icon
will be placed relative to the field value. |
java.lang.Integer |
getHiliteIconRightPadding()
How much padding should there be on the right of
hilite icons for this field? Overrides hiliteIconRightPadding |
java.lang.Integer |
getHiliteIconSize()
Default width and height of
hilite icons in this field. |
java.lang.Integer |
getHiliteIconWidth()
Width for hilite icons for this field.
|
java.lang.String |
getIcon()
Optional icon to show next to the title for this field.
|
java.lang.Integer |
getIconHeight()
If
icon is specified, this property can be used to
specify the height of the icon to be displayed in the ListGrid header button. |
java.lang.String |
getIconOrientation()
If this field is showing an icon, should it appear to the left or right of the title?
Valid options are "left" or "right" |
java.lang.Integer |
getIconSize()
If
icon is specified, this property can be used to
specify the size of the icon to be displayed in the ListGrid header button. |
int |
getIconSpacing()
Pixels between icon and title text.
|
java.lang.String |
getIconVAlign()
If this field is editable, this property will be passed to editors displayed for cells within this field as
iconVAlign . |
java.lang.Integer |
getIconWidth()
If
icon is specified, this property can be used to
specify the width of the icon to be displayed in the ListGrid header button. |
java.lang.Boolean |
getIgnoreKeyboardClicks()
If the user is navigating through the grid using the keyboard, record click or double click events may be generated via
keyboard interactions (see
generateClickOnSpace , generateClickOnEnter ,
generateDoubleClickOnSpace , generateDoubleClickOnEnter and arrowKeyAction ). |
int |
getImageHeight()
Height of image shown for fieldTypes image and imageFile in this field.
|
int |
getImageSize()
Size of images shown for fieldTypes image and imageFile in this field.
|
java.lang.String |
getImageURLPrefix()
If this field has type [
ListGridFieldType ] set to "image" and the URL for
the image displayed is not absolute, the path of the URL will be relative to this stringAlternatively, if this field displays any valueIcons, this prefix will be applied to the beginning of any valueIcons when determining the URL for the image. |
java.lang.String |
getImageURLSuffix()
If any cells in this field are showing a value icon (see:
valueIcons ) or this is has ListGridFieldType set to "image" , this the value of this property will be
appended to the end of the URL for the icon displayed.Typical usage might be to append a file type such as ".gif" to the filename of the image.For editable fields, this property will also be passed through to any editors as imageURLSuffix . |
int |
getImageWidth()
Width of images shown for fieldTypes image and imageFile in this field.
|
java.lang.String |
getIncludeFrom()
Indicates this field's values should be fetched from another, related DataSource.
|
java.lang.Boolean |
getIncludeInRecordSummary()
If a listGrid is showing a field of type summary, should this field be passed to the recordSummaryFunction when
calculating the summary value to display.
|
java.lang.Boolean |
getIsRemoveField()
If set to true and
canRemoveRecords is true, this
field will be rendered as the remove-field for this grid. |
java.lang.String |
getLinkText()
The HTML to display in cells of this field if the fieldType is set to link.
|
java.lang.String |
getLinkTextProperty()
Name of the property in a ListGridRecord that holds the HTML to display in cells of this field if the fieldType is set
to "link".
|
java.lang.String |
getLinkURLPrefix()
If this field has type [
ListGridFieldType ] set to "link" , setting this
property will apply a standard prefix to the link URL for cells in this field. |
java.lang.String |
getLinkURLSuffix()
If this field has type [
ListGridFieldType ] set to "link" , setting this
property will apply a standard suffix to the link URL for cells in this field. |
java.lang.Boolean |
getMultiple()
Indicates that this field should always be Array-valued.
|
java.lang.String |
getName()
Name of this field.
|
Criteria |
getOptionCriteria()
If
optionDataSource is set for this
ListGridField, criteria specified in this attribute will be passed to the dataSource when performing the fetch operation
to determine data-value to display-value mappings |
DSRequest |
getOptionFilterContext()
If this field has an optionDataSource specified and
autoFetchDisplayMap is set, this attribute
provides a way to customize the dataSource request issued to fetch the display map from
the option dataSource. |
java.lang.String |
getOptionOperationId()
If this field has an optionDataSource specified and
autoFetchDisplayMap is set, this attribute
provides a way to customize the operationId passed to
dataSource.fetchData() when retrieving the display map from the option dataSource. |
TextMatchStyle |
getOptionTextMatchStyle()
For fields with an
optionDataSource , where
autoFetchDisplayMap is true, this property
will govern the textMatchStyle attribute of the DSRequest parameter passed
to DataSource.fetchData when retrieving the remote data set to be
used as a basis for this field's valueMap. |
static ListGridField |
getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) |
java.lang.Boolean |
getPartialSummary()
Only applies to fields of type
"summary" . |
java.lang.String |
getPrompt()
Causes a tooltip hover to appear on the header generated for this field (effectively sets
prompt for the header). |
RecordSummaryFunctionType |
getRecordSummaryFunction()
Only applies to fields of type
"summary" . |
java.lang.Boolean |
getRequired()
When the user edits cells in this field, is this value required to be non-empty in order for validation to pass.
Note: for databound listGrids, this property may be specified on the DataSourceField ,
enabling both client and server side validation. |
java.lang.Boolean |
getShouldPrint()
Whether this field should be included in the printable representation of the grid.
|
java.lang.Boolean |
getShowAlternateStyle()
When set to false, don't apply alternate-row styling to this field.
|
java.lang.Boolean |
getShowDefaultContextMenu()
When set to false, this field will not show a context menu in its header.
|
java.lang.Boolean |
getShowDisabledIcon()
If using an icon for this button, whether to switch the icon image if the button becomes disabled.
|
java.lang.Boolean |
getShowDownIcon()
If using an icon for this button, whether to switch the icon image when the mouse goes down on the button.
|
java.lang.Boolean |
getShowFileInline()
For a field of type:"imageFile", indicates whether to stream the image and display it inline or to display the View and
Download icons.
|
java.lang.Boolean |
getShowFocusedIcon()
If using an icon for this button, whether to switch the icon image when the button receives focus.
|
java.lang.Boolean |
getShowGridSummary()
If
showGridSummary is true, should this field show
a summary value. |
java.lang.Boolean |
getShowGroupSummary()
If
showGroupSummary is true, should this field
show a summary value in a summary row when the grid is grouped? If unset, this field will show a summary value in the
summary row if an explicit summaryFunction is
specified or if a default summary function is
defined for the specified field type. |
java.lang.Boolean |
getShowHilitesInGroupSummary()
Determines whether hiliting for this field is shown in a group summary.
|
java.lang.Boolean |
getShowHover()
Whether to show hovers for this field.
|
java.lang.Boolean |
getShowRollOverIcon()
If using an icon for this button, whether to switch the icon image on mouse rollover.
|
java.lang.Boolean |
getShowSelectedIcon()
If using an icon for this button, whether to switch the icon image when the button becomes selected.
|
java.lang.Boolean |
getShowTitle()
This property may be set to
false to explicitly suppress display of the field title in the column header
button for the field. |
java.lang.Boolean |
getShowValueIconOnly()
If this field has a valueIcons property specified, setting this property causes the valueIcon for each value to be
displayed in the cell without also showing the record's value for the field.
|
java.lang.Boolean |
getSortByDisplayField()
For a field with
displayField configured, should client-side sorting be performed on the display field
value? Unless explicitly set to false the display field value is used. |
java.lang.Boolean |
getSortByMappedValue()
If
valueMap is set, and the grid is sorted by this field, should the data be sorted by the underlying
data value or the mapped display value. |
SortDirection |
getSortDirection()
Specifies the default sorting direction for this column.
|
java.lang.String |
getSummaryTitle()
Deprecated.
Rather than customizing the summaryTitle developers should typically use the
headerTitle attribute to show a different title in the
column header button than the title used elsewhere. |
java.lang.String |
getSummaryValue()
The value to display for a ListGridField when it appears in the
summaryRow . |
java.lang.String |
getSummaryValueTitle()
If
showGridSummary or showGroupSummary is true and the summaryFunction is set to "title" , this
attribute may be set to a string to display in the group and/or grid summary. |
java.lang.Boolean |
getSuppressValueIcon()
If this field has a valueIcons property specified, setting this property to true will prevent the valueIcon being
written out into this field's cells.
|
java.lang.String |
getTarget()
By default, clicking a link rendered by this item opens it in a new browser window.
|
TimeDisplayFormat |
getTimeFormatter()
Time-format to apply to date type values within this field.
|
java.lang.String |
getTitle()
A title for this field, to display in the header for the field and in other contexts such as the
menu for picking visible fields . |
ListGridFieldType |
getType()
ListGrids picks a renderer for the view and edit mode of a field based on this attribute.
|
UserFormula |
getUserFormula()
Formula definition for this field.
|
UserSummary |
getUserSummary()
Summary definition for this field.
|
java.lang.Boolean |
getValidateOnChange()
If set to true, any
validators for this field will
be run whenever the value of the field is changed. |
java.lang.String |
getValueField()
Specifies the
optionDataSource field used to
retrieve the stored values that are to be mapped to the display values (specified by displayField ). |
java.lang.Integer |
getValueIconHeight()
Height for value icons for this listGrid field.
|
java.lang.Integer |
getValueIconLeftPadding()
How much padding should there be on the left of valueIcons for this field Overrides
valueIconLeftPadding |
java.lang.String |
getValueIconOrientation()
If we're showing a valueIcon for this field should it appear to the left or the right of the text? By default the icon
will appear to the left of the textual value - set this to "right" to show the icon on the right of the text.
|
java.lang.Integer |
getValueIconRightPadding()
How much padding should there be on the right of valueIcons for this field Overrides
valueIconRightPadding |
java.lang.Integer |
getValueIconSize()
Default width and height of value icons in this field.
|
java.lang.Integer |
getValueIconWidth()
Width for value icons for this listGrid field.
|
java.lang.String |
getWidth()
Return the width of the field.
|
java.lang.Boolean |
getWrap()
Should the field title wrap if there is not enough space horizontally to accomodate it.
|
void |
setAlign(Alignment align)
Horizontal alignment for field's column header: "left", "right" or "center".
|
void |
setApplyAfterSummary(java.lang.Boolean applyAfterSummary)
If
field.userFormula is set for this field, and
this grid is showing group summaries or a grid summary , this property determines what field value
should be present in those summary rows. |
void |
setAutoFetchDisplayMap(java.lang.Boolean autoFetchDisplayMap)
If true, automatically fetches records and derives a valueMap from
optionDataSource . |
void |
setAutoFitWidth(java.lang.Boolean autoFitWidth)
Enables autofitting to values or titles for this field..
|
void |
setAutoFitWidthApproach(AutoFitWidthApproach autoFitWidthApproach)
When a user requests column autofitting via the
header contextmenu or via a mouse gesture , what autofit approach is used. |
void |
setAutoFreeze(java.lang.Boolean autoFreeze)
Whether this field should be automatically frozen when other fields are frozen.
|
void |
setBaseStyle(java.lang.String baseStyle)
Custom base style to apply to all cells in this field instead of
baseStyle To override the baseStyle at the row level, use
record[listGrid.recordBaseStyleProperty]
instead. |
void |
setCanDragResize(java.lang.Boolean canDragResize)
Whether this field can be dragResized using the mouse.
|
void |
setCanEdit(java.lang.Boolean canEdit)
Can this field be edited? May be overridden by setting the 'canEdit' property at the listGrid level.
|
void |
setCanExport(java.lang.Boolean canExport)
Dictates whether the data in this field be exported.
|
void |
setCanFilter(java.lang.Boolean canFilter)
If showing a filter row for this ListGrid, should the filter criteria for this field be editable
|
void |
setCanFreeze(java.lang.Boolean canFreeze)
Whether this field should display freezing/unfreezing options in its header context menu.
|
void |
setCanGroupBy(java.lang.Boolean canGroupBy)
Determines whether this field will be groupable in the header context menu.
|
void |
setCanHide(java.lang.Boolean canHide)
Whether this field can be hidden via the header context menu.
|
void |
setCanHilite(java.lang.Boolean canHilite)
Determines whether this field can be hilited.
|
void |
setCanReorder(java.lang.Boolean canReorder)
Whether this field can be reordered using the mouse.
|
void |
setCanSort(java.lang.Boolean canSort)
Enables or disables sorting by this column.
|
void |
setCanSortClientOnly(java.lang.Boolean canSortClientOnly)
When true, this field can only be used for sorting if the data is entirely client-side.
|
void |
setCanToggle(java.lang.Boolean canToggle)
Allows a boolean or valueMapped field to be edited without going into edit mode.
|
void |
setCellAlign(Alignment cellAlign)
Horizontal alignment for cells in this field's column: "left", "right" or "center".
If null, alignment is derived from align . |
void |
setCellFormatter(CellFormatter formatter)
Return the HTML to display in cells of this field.
|
void |
setCellIcon(java.lang.String cellIcon)
For a field of type:"icon" only, set the icon that appears in body cells.
|
void |
setDataPath(java.lang.String dataPath)
dataPath for this field.
|
void |
setDateFormatter(DateDisplayFormat dateFormatter)
Display format to use for date type values within this field.
|
void |
setDecimalPad(java.lang.Integer decimalPad)
Applies only to fields of type "float" and enforces a minimum number of digits shown after the decimal point.
|
void |
setDecimalPrecision(java.lang.Integer decimalPrecision)
Applies only to fields of type "float" and affects how many significant digits are shown.
|
void |
setDefaultFilterValue(java.lang.Boolean defaultFilterValue)
If this ListGrid is showing a filter row, this property can be used to apply a default value to show in the filter editor for this field.
|
void |
setDefaultFilterValue(java.util.Date defaultFilterValue)
If this ListGrid is showing a filter row, this property can be used to apply a default value to show in the filter editor for this field.
|
void |
setDefaultFilterValue(java.lang.Float defaultFilterValue)
If this ListGrid is showing a filter row, this property can be used to apply a default value to show in the filter editor for this field.
|
void |
setDefaultFilterValue(java.lang.Integer defaultFilterValue)
If this ListGrid is showing a filter row, this property can be used to apply a default value to show in the filter editor for this field.
|
void |
setDefaultFilterValue(java.lang.String defaultFilterValue)
If this ListGrid is showing a filter row, this property can be used to apply a default value to show in the filter editor for this field.
|
void |
setDefaultGroupingMode(java.lang.String defaultGroupingMode)
Default groupingMode used when the user does not specify a mode or grouping is triggered programmatically and
field.groupingMode is unset. |
void |
setDefaultIconSrc(java.lang.String defaultIconSrc)
If this field is editable, this property will be passed to editors displayed for cells within this field as
defaultIconSrc . |
void |
setDefaultValue(java.lang.Boolean defaultValue) |
void |
setDefaultValue(java.util.Date defaultValue) |
void |
setDefaultValue(java.lang.Float defaultValue) |
void |
setDefaultValue(java.lang.Integer defaultValue) |
void |
setDefaultValue(java.lang.String defaultValue) |
void |
setDisplayField(java.lang.String displayField)
Specifies the
optionDataSource field used to
retrieve the display values that are to be mapped from the internal values specified by valueField . |
void |
setDisplayValueFromRecord(java.lang.Boolean displayValueFromRecord)
If a
displayField is set, should this field show
record values from the displayField ? |
void |
setEditorIconHeight(java.lang.Integer editorIconHeight)
If this field is editable, this property will be passed to editors displayed for cells within this field as
iconHeight .If this property unset, the iconHeight property from the editor can be picked up from iconHeight instead. |
void |
setEditorIconWidth(java.lang.Integer editorIconWidth)
|
void |
setEditorImageURLPrefix(java.lang.String editorImageURLPrefix)
When some cell in this field is being edited, this property can be used to apply an explicit
imageURLPrefix to the editor in question. |
void |
setEditorImageURLSuffix(java.lang.String editorImageURLSuffix)
When some cell in this field is being edited, this property can be used to apply an explicit
imageURLSuffix to the editor in question. |
void |
setEditorProperties(FormItem editorProperties)
FormItem properties to use as a template for the form item created to edit this field.
|
void |
setEditorType(java.lang.Class<? extends FormItem> editorType)
The
FormItem class to be used when this field is edited. |
void |
setEditorType(FormItem editorType)
Deprecated.
Renamed to
setEditorProperties(FormItem) . You can also consider using
setEditorType(Class) or setEditorType(String) instead. |
void |
setEditorType(java.lang.String editorType)
The
FormItem class to be used when this field is edited. |
void |
setEditorValueIconHeight(java.lang.Integer editorValueIconHeight)
When some cell in this field is being edited, setting this property will specify the height for value icons in the
cell's editor.
|
void |
setEditorValueIcons(java.util.Map<java.lang.String,java.lang.String> editorValueIcons)
When some cell in this field is being edited, setting this property will specify the value icons to display in
the cell's editor.
|
void |
setEditorValueIconWidth(java.lang.Integer editorValueIconWidth)
When some cell in this field is being edited, setting this property will specify the width for value icons in the cell's
editor.
|
void |
setEditorValueMap(java.util.Map editorValueMap)
A valueMap to use for editors shown for this field.
|
void |
setEditorValueMapFunction(EditorValueMapFunction editorValueMapFunction)
This function method will be called from ListGrid.getEditorValueMap() and the resulting valueMap will be used instead of any static specified valueMap for the field.
|
void |
setEditValueFormatter(CellEditValueFormatter formatter)
Return the value to display in cells of this field which are being edited.
|
void |
setEditValueParser(CellEditValueParser parser)
Method used to convert the value displayed in an editor for some cell in this field into a raw value for saving.
|
void |
setEmptyCellValue(java.lang.String emptyCellValue)
The value to display for a cell whose value is null or the empty string after applying formatCellValue and valueMap (if
any).
|
void |
setEnterKeyEditAction(EnterKeyEditAction enterKeyEditAction)
What to do when a user hits enter while editing this field?
Overrides the enterKeyEditAction as
specified at the listGrid level while focus is in this field. |
void |
setEscapeHTML(java.lang.Boolean escapeHTML)
By default HTML values in ListGrid cells will be interpreted by the browser.
|
void |
setEscapeKeyEditAction(EscapeKeyEditAction escapeKeyEditAction)
What to do when a user hits escape while editing this field?
Overrides the escapeKeyEditAction as
specified at the listGrid level while focus is in this field. |
void |
setExportRawValues(java.lang.Boolean exportRawValues)
Dictates whether the data in this field should be exported raw by
exportClientData() . |
void |
setFilterEditorProperties(FormItem filterEditorProperties)
If this ListGrid is showing a filter row (showFilterEditor : true), this
property can be used to specify properties for the appropriate filter
form item.
|
void |
setFilterEditorType(java.lang.Class<? extends FormItem> editorType)
If this ListGrid is showing a filter row, this property can be used to specify the
FormItem class to use
for the filter form item associated with this field. |
void |
setFilterEditorType(FormItem filterEditorType)
Deprecated.
Renamed to
setFilterEditorProperties(FormItem) . You can also consider using
setFilterEditorType(Class) or setFilterEditorType(String) instead. |
void |
setFilterEditorType(java.lang.String editorType)
If this ListGrid is showing a filter row, this property can be used to specify the
FormItem class to use
for the filter form item associated with this field. |
void |
setFilterEditorValueMap(java.util.Map filterEditorValueMap)
If this listGrid is showing a filter row, this property can be used to specify a mapping of internal data to/from display
values to be in the appropriate filter row form item.
|
void |
setFilterOnKeypress(java.lang.Boolean filterOnKeypress)
If we're showing the filterEditor (listGrid.showFilterEditor is true), this property determines whether this list should
be filtered every time the user edits the value of the filter editor for this field.
|
void |
setFilterOperator(OperatorId filterOperator)
With the
FilterEditor showing, the Operator to use
when matching values for this field. |
void |
setFrozen(java.lang.Boolean frozen)
Whether this field should be "frozen" for the purposes of horizontal scrolling.
|
void |
setGridSummaryCustomizer(GridSummaryCustomizer gridSummaryCustomizer) |
void |
setGroupGranularity(java.lang.Integer groupGranularity)
Granularity of grouping for numeric fields.
|
void |
setGroupingMode(java.lang.String groupingMode)
For a field that allows multiple
grouping modes ,
the current grouping mode. |
void |
setGroupingModes(java.util.Map groupingModes)
If set, provides several possible styles of grouping that are valid for this field.
|
void |
setGroupPrecision(java.lang.Integer groupPrecision)
For fields of type:"float" or derived from float, number of digits after the decimal point to consider when grouping.
|
void |
setGroupSummaryCustomizer(GroupSummaryCustomizer groupSummaryCustomizer) |
void |
setGroupTitleRenderer(GroupTitleRenderer groupTitleRenderer)
Renderer that returns the title that should be shown to the user for the group with the groupValue passed as a parameter.
|
void |
setGroupValueFunction(GroupValueFunction groupValueFunction)
Function that returns the value which records should be grouped by.
|
void |
setHeaderBaseStyle(java.lang.String headerBaseStyle)
Custom base style to apply to this field's header button instead of
headerBaseStyle .Note that depending on the header button constructor, you may have to override headerTitleStyle as well. |
void |
setHeaderButtonProperties(Canvas buttonProperties)
Set the properties of the header button used for this field.
|
void |
setHeaderTitle(java.lang.String headerTitle)
Optional title for the header button for this field.
|
void |
setHeaderTitleStyle(java.lang.String headerTitleStyle)
Custom titleStyle to apply to this field's header button instead of
headerTitleStyle .Note that this will typically only have an effect if headerButtonConstructor
is set to StretchImgButton or a subclass thereof. |
void |
setHidden(boolean hidden)
Marks a field as initially hidden for this ListGrid.
|
void |
setHiliteIconHeight(java.lang.Integer hiliteIconHeight)
Height for hilite icons for this field.
|
void |
setHiliteIconLeftPadding(java.lang.Integer hiliteIconLeftPadding)
How much padding should there be on the left of
hilite icons for this field? Overrides hiliteIconLeftPadding |
void |
setHiliteIconPosition(HiliteIconPosition hiliteIconPosition)
When
hiliteIcons are present, where the hilite icon
will be placed relative to the field value. |
void |
setHiliteIconRightPadding(java.lang.Integer hiliteIconRightPadding)
How much padding should there be on the right of
hilite icons for this field? Overrides hiliteIconRightPadding |
void |
setHiliteIconSize(java.lang.Integer hiliteIconSize)
Default width and height of
hilite icons in this field. |
void |
setHiliteIconWidth(java.lang.Integer hiliteIconWidth)
Width for hilite icons for this field.
|
void |
setHoverCustomizer(HoverCustomizer hoverCustomizer)
* HTML to be shown in hovers over cells in the column described by this field.
|
void |
setIcon(java.lang.String icon)
Optional icon to show next to the title for this field.
|
void |
setIconHeight(java.lang.Integer iconHeight)
If
icon is specified, this property can be used to
specify the height of the icon to be displayed in the ListGrid header button. |
void |
setIconOrientation(java.lang.String iconOrientation)
If this field is showing an icon, should it appear to the left or right of the title?
Valid options are "left" or "right" |
void |
setIcons(FormItemIcon... icons)
If this field is editable, this property can be used to specify
icons to be displayed in the editors displayed for this field |
void |
setIconSize(java.lang.Integer iconSize)
If
icon is specified, this property can be used to
specify the size of the icon to be displayed in the ListGrid header button. |
void |
setIconSpacing(int iconSpacing)
Pixels between icon and title text.
|
void |
setIconVAlign(java.lang.String iconVAlign)
If this field is editable, this property will be passed to editors displayed for cells within this field as
iconVAlign . |
void |
setIconWidth(java.lang.Integer iconWidth)
If
icon is specified, this property can be used to
specify the width of the icon to be displayed in the ListGrid header button. |
void |
setIgnoreKeyboardClicks(java.lang.Boolean ignoreKeyboardClicks)
If the user is navigating through the grid using the keyboard, record click or double click events may be generated via
keyboard interactions (see
generateClickOnSpace , generateClickOnEnter ,
generateDoubleClickOnSpace , generateDoubleClickOnEnter and arrowKeyAction ). |
void |
setImageHeight(int imageHeight)
Height of image shown for fieldTypes image and imageFile in this field.
|
void |
setImageSize(int imageSize)
Size of images shown for fieldTypes image and imageFile in this field.
|
void |
setImageURLPrefix(java.lang.String imageURLPrefix)
If this field has type [
ListGridFieldType ] set to "image" and the URL for
the image displayed is not absolute, the path of the URL will be relative to this stringAlternatively, if this field displays any valueIcons, this prefix will be applied to the beginning of any valueIcons when determining the URL for the image. |
void |
setImageURLSuffix(java.lang.String imageURLSuffix)
If any cells in this field are showing a value icon (see:
valueIcons ) or this is has ListGridFieldType set to "image" , this the value of this property will be
appended to the end of the URL for the icon displayed.Typical usage might be to append a file type such as ".gif" to the filename of the image.For editable fields, this property will also be passed through to any editors as imageURLSuffix . |
void |
setImageWidth(int imageWidth)
Width of images shown for fieldTypes image and imageFile in this field.
|
void |
setImgDir(java.lang.String imgDir) |
void |
setIncludeFrom(java.lang.String includeFrom)
Indicates this field's values should be fetched from another, related DataSource.
|
void |
setIncludeInRecordSummary(java.lang.Boolean includeInRecordSummary)
If a listGrid is showing a field of type summary, should this field be passed to the recordSummaryFunction when
calculating the summary value to display.
|
void |
setIsRemoveField(java.lang.Boolean isRemoveField)
If set to true and
canRemoveRecords is true, this
field will be rendered as the remove-field for this grid. |
void |
setJavaScriptObject(com.google.gwt.core.client.JavaScriptObject jsObj) |
void |
setLeaveHeaderMenuButtonSpace(java.lang.Boolean leaveHeaderMenuButtonSpace)
If
showHeaderMenuButton is true, when
auto-fitting fields to the title width via autoFitFieldWidths or autoFitWidth , should the
button be sized such that there is enough space for the heeader menu button to show without covering the field title? |
void |
setLinkText(java.lang.String linkText)
The HTML to display in cells of this field if the fieldType is set to link.
|
void |
setLinkTextProperty(java.lang.String linkTextProperty)
Name of the property in a ListGridRecord that holds the HTML to display in cells of this field if the fieldType is set
to "link".
|
void |
setLinkURLPrefix(java.lang.String linkURLPrefix)
If this field has type [
ListGridFieldType ] set to "link" , setting this
property will apply a standard prefix to the link URL for cells in this field. |
void |
setLinkURLSuffix(java.lang.String linkURLSuffix)
If this field has type [
ListGridFieldType ] set to "link" , setting this
property will apply a standard suffix to the link URL for cells in this field. |
void |
setMultiple(java.lang.Boolean multiple)
Indicates that this field should always be Array-valued.
|
void |
setName(java.lang.String name)
Name of this field.
|
void |
setOptionCriteria(Criteria optionCriteria)
If
optionDataSource is set for this
ListGridField, criteria specified in this attribute will be passed to the dataSource when performing the fetch operation
to determine data-value to display-value mappings |
void |
setOptionDataSource(DataSource optionDataSource)
Derive a ValueMap by fetching records from another DataSource and extracting the
valueField and
displayField in the loaded records,
to derive one valueMap entry per record loaded from the optionDataSource. |
void |
setOptionFilterContext(DSRequest optionFilterContext)
If this field has an optionDataSource specified and
autoFetchDisplayMap
is set, this attribute
provides a way to customize the dataSource request issued to
fetch the display map from
the option dataSource. |
void |
setOptionOperationId(java.lang.String optionOperationId)
If this field has an optionDataSource specified and
autoFetchDisplayMap is set, this attribute
provides a way to customize the operationId passed to
dataSource.fetchData() when retrieving the display map from the option dataSource. |
void |
setOptionTextMatchStyle(TextMatchStyle optionTextMatchStyle)
For fields with an
optionDataSource , where
autoFetchDisplayMap is true, this property
will govern the textMatchStyle attribute of the DSRequest parameter passed
to DataSource.fetchData when retrieving the remote data set to be
used as a basis for this field's valueMap. |
void |
setPartialSummary(java.lang.Boolean partialSummary)
Only applies to fields of type
"summary" . |
void |
setPrompt(java.lang.String prompt)
Causes a tooltip hover to appear on the header generated for this field (effectively sets
prompt for the header). |
void |
setRecordSummaryFunction(RecordSummaryFunction recordSummaryFunction)
Only applies to fields of type
"summary" . |
void |
setRecordSummaryFunction(RecordSummaryFunctionType recordSummaryFunction)
Only applies to fields of type
"summary" . |
void |
setRequired(java.lang.Boolean required)
When the user edits cells in this field, is this value required to be non-empty in order for validation to pass.
Note: for databound listGrids, this property may be specified on the DataSourceField ,
enabling both client and server side validation. |
void |
setShouldPrint(java.lang.Boolean shouldPrint)
Whether this field should be included in the printable representation of the grid.
|
void |
setShowAlternateStyle(java.lang.Boolean showAlternateStyle)
When set to false, don't apply alternate-row styling to this field.
|
void |
setShowDefaultContextMenu(java.lang.Boolean showDefaultContextMenu)
When set to false, this field will not show a context menu in its header.
|
void |
setShowDisabledIcon(java.lang.Boolean showDisabledIcon)
If using an icon for this button, whether to switch the icon image if the button becomes disabled.
|
void |
setShowDownIcon(java.lang.Boolean showDownIcon)
If using an icon for this button, whether to switch the icon image when the mouse goes down on the button.
|
void |
setShowFileInline(java.lang.Boolean showFileInline)
For a field of type:"imageFile", indicates whether to stream the image and display it inline or to display the View and
Download icons.
|
void |
setShowFocusedIcon(java.lang.Boolean showFocusedIcon)
If using an icon for this button, whether to switch the icon image when the button receives focus.
|
void |
setShowGridSummary(java.lang.Boolean showGridSummary)
If
showGridSummary is true, should this field show
a summary value. |
void |
setShowGroupSummary(java.lang.Boolean showGroupSummary)
If
showGroupSummary is true, should this field
show a summary value in a summary row when the grid is grouped? If unset, this field will show a summary value in the
summary row if an explicit summaryFunction is
specified or if a default summary function is
defined for the specified field type. |
void |
setShowHilitesInGroupSummary(java.lang.Boolean showHilitesInGroupSummary)
Determines whether hiliting for this field is shown in a group summary.
|
void |
setShowHover(java.lang.Boolean showHover)
Whether to show hovers for this field.
|
void |
setShowIfCondition(ListGridFieldIfFunction showIf)
A function, if provided, is evaluated to conditionally determine whether this field should be displayed.
|
void |
setShowRollOverIcon(java.lang.Boolean showRollOverIcon)
If using an icon for this button, whether to switch the icon image on mouse rollover.
|
void |
setShowSelectedIcon(java.lang.Boolean showSelectedIcon)
If using an icon for this button, whether to switch the icon image when the button becomes selected.
|
void |
setShowTitle(java.lang.Boolean showTitle)
This property may be set to
false to explicitly suppress display of the field title in the column header
button for the field. |
void |
setShowValueIconOnly(java.lang.Boolean showValueIconOnly)
If this field has a valueIcons property specified, setting this property causes the valueIcon for each value to be
displayed in the cell without also showing the record's value for the field.
|
void |
setSortByDisplayField(java.lang.Boolean sortByDisplayField)
For a field with
displayField configured, should client-side sorting be performed on the display field
value? Unless explicitly set to false the display field value is used. |
void |
setSortByMappedValue(java.lang.Boolean sortByMappedValue)
If
valueMap is set, and the grid is sorted by this field, should the data be sorted by the underlying
data value or the mapped display value. |
void |
setSortDirection(SortDirection sortDirection)
Specifies the default sorting direction for this column.
|
void |
setSortNormalizer(SortNormalizer normalizer)
Optional function to return the value that should be used when sorting this field.
|
void |
setSummaryFunction(java.lang.String summaryFunction)
If
showGridSummary or showGroupSummary is true,
this method can be used to
specify the name of a summary function registered via com.smartgwt.client.data.SimpleType#registerSummaryFunction()
for calculating the summary value to display. |
void |
setSummaryFunction(SummaryFunction summaryFunction)
If
showGridSummary or showGroupSummary is true,
this method can be used to
specify a SummaryFunction
for calculating the summary value to display. |
void |
setSummaryFunction(SummaryFunctionType summaryFunction)
If
showGridSummary or showGroupSummary is true,
this method can be used to
specify a SummaryFunctionType
for calculating the summary value to display. |
void |
setSummaryTitle(java.lang.String summaryTitle)
Deprecated.
Rather than customizing the summaryTitle developers should typically use the
headerTitle attribute to show a different title in the
column header button than the title used elsewhere. |
void |
setSummaryValue(java.lang.String summaryValue)
The value to display for a ListGridField when it appears in the
summaryRow . |
void |
setSummaryValueTitle(java.lang.String summaryValueTitle)
If
showGridSummary or showGroupSummary is true and the summaryFunction is set to "title" , this
attribute may be set to a string to display in the group and/or grid summary. |
void |
setSuppressValueIcon(java.lang.Boolean suppressValueIcon)
If this field has a valueIcons property specified, setting this property to true will prevent the valueIcon being
written out into this field's cells.
|
void |
setTarget(java.lang.String target)
By default, clicking a link rendered by this item opens it in a new browser window.
|
void |
setTimeFormatter(TimeDisplayFormat timeFormatter)
Time-format to apply to date type values within this field.
|
void |
setTitle(java.lang.String title)
A title for this field, to display in the header for the field and in other contexts such as the
menu for picking visible fields . |
void |
setType(ListGridFieldType type)
ListGrids picks a renderer for the view and edit mode of a field based on this attribute.
|
void |
setUserFormula(UserFormula userFormula)
Formula definition for this field.
|
void |
setUserSummary(UserSummary userSummary)
Summary definition for this field.
|
void |
setValidateOnChange(java.lang.Boolean validateOnChange)
If set to true, any
validators for this field will
be run whenever the value of the field is changed. |
void |
setValidators(Validator... validators)
Array of
Validator objects for this field. |
void |
setValueField(java.lang.String valueField)
Specifies the
optionDataSource field used to
retrieve the stored values that are to be mapped to the display values (specified by displayField ). |
void |
setValueIconHeight(java.lang.Integer valueIconHeight)
Height for value icons for this listGrid field.
|
void |
setValueIconLeftPadding(java.lang.Integer valueIconLeftPadding)
How much padding should there be on the left of valueIcons for this field Overrides
valueIconLeftPadding |
void |
setValueIconOrientation(java.lang.String valueIconOrientation)
If we're showing a valueIcon for this field should it appear to the left or the right of the text? By default the icon
will appear to the left of the textual value - set this to "right" to show the icon on the right of the text.
|
void |
setValueIconRightPadding(java.lang.Integer valueIconRightPadding)
How much padding should there be on the right of valueIcons for this field Overrides
valueIconRightPadding |
void |
setValueIcons(java.util.Map<java.lang.String,java.lang.String> valueIcons)
This property is a mapping between data values and URLs of icons to display.
|
void |
setValueIconSize(java.lang.Integer valueIconSize)
Default width and height of value icons in this field.
|
void |
setValueIconWidth(java.lang.Integer valueIconWidth)
Width for value icons for this listGrid field.
|
void |
setValueMap(java.util.Map valueMap)
|
void |
setValueMap(java.lang.String... valueMap)
|
void |
setWidth(int width)
The width of this field, specified as either an absolute number of pixels, a percentage of the remaining space,
or "*" to allocate an equal portion of the remaining space.
|
void |
setWidth(java.lang.String width)
The width of this field, specified as either an absolute number of pixels, a percentage of the remaining space,
or "*" to allocate an equal portion of the remaining space.
|
void |
setWrap(boolean wrap)
Control the list grid fields header wrap properties
|
void |
setWrap(java.lang.Boolean wrap)
Should the field title wrap if there is not enough space horizontally to accomodate it.
|
doAddHandler, fireEvent, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsDoubleArray, getAttributeAsFloat, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getAttributes, getHandlerCount, getJsObj, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttributeAsJavaObject
equals, hashCode, isCreated, setJsObj
public ListGridField()
public ListGridField(com.google.gwt.core.client.JavaScriptObject jsObj)
public ListGridField(java.lang.String name)
public ListGridField(java.lang.String name, int width)
public ListGridField(java.lang.String name, java.lang.String title)
public ListGridField(java.lang.String name, java.lang.String title, int width)
public static ListGridField getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
public void setJavaScriptObject(com.google.gwt.core.client.JavaScriptObject jsObj)
public void setApplyAfterSummary(java.lang.Boolean applyAfterSummary)
field.userFormula
is set for this field, and
this grid is showing group summaries
or a grid summary
, this property determines what field value
should be present in those summary rows. Should the field apply the user-formula to the calculated summary row, or
should it apply a standard grid or group summary to the user-formula values displayed in the grid? Default behavior
may be specified at the grid level via applyFormulaAfterSummary
applyAfterSummary
- applyAfterSummary Default value is nullpublic java.lang.Boolean getApplyAfterSummary()
field.userFormula
is set for this field, and
this grid is showing group summaries
or a grid summary
, this property determines what field value
should be present in those summary rows. Should the field apply the user-formula to the calculated summary row, or
should it apply a standard grid or group summary to the user-formula values displayed in the grid? Default behavior
may be specified at the grid level via applyFormulaAfterSummary
public void setAutoFetchDisplayMap(java.lang.Boolean autoFetchDisplayMap)
optionDataSource
. Same as autoFetchDisplayMap
, but defined on a per-field basis.
autoFetchDisplayMap
- autoFetchDisplayMap Default value is nullListGrid.setAutoFetchDisplayMap(java.lang.Boolean)
public java.lang.Boolean getAutoFetchDisplayMap()
optionDataSource
. Same as autoFetchDisplayMap
, but defined on a per-field basis.
ListGrid.getAutoFetchDisplayMap()
public void setAutoFitWidth(java.lang.Boolean autoFitWidth)
autoFitFieldWidths
attribute on a per-field basis.autoFitWidth
- autoFitWidth Default value is nullpublic java.lang.Boolean getAutoFitWidth()
autoFitFieldWidths
attribute on a per-field basis.public void setAutoFitWidthApproach(AutoFitWidthApproach autoFitWidthApproach)
header contextmenu
or via a mouse gesture
, what autofit approach is used. If
set, this setting overrides the autoFitWidthApproach specified at the ListGrid level.autoFitWidthApproach
- autoFitWidthApproach Default value is nullpublic AutoFitWidthApproach getAutoFitWidthApproach()
header contextmenu
or via a mouse gesture
, what autofit approach is used. If
set, this setting overrides the autoFitWidthApproach specified at the ListGrid level.public void setAutoFreeze(java.lang.Boolean autoFreeze)
checkbox
, expansion
and rowNumber
fields are examples of fields that specify
autoFreeze: true
. You can control the position of this field in the array of frozen fields by providing
a ListGridField.getAutoFreezePosition
implementation.
autoFreeze
- autoFreeze Default value is nullFrozenFields overview and related methods
public java.lang.Boolean getAutoFreeze()
checkbox
, expansion
and rowNumber
fields are examples of fields that specify
autoFreeze: true
. You can control the position of this field in the array of frozen fields by providing
a ListGridField.getAutoFreezePosition
implementation.
FrozenFields overview and related methods
public void setBaseStyle(java.lang.String baseStyle)
baseStyle
To override the baseStyle at the row level, use
record[listGrid.recordBaseStyleProperty]
instead.baseStyle
- . See CSSClass
. Default value is nullListGrid.setRecordBaseStyleProperty(java.lang.String)
,
Appearance overview and related methods
,
Grid cells Examplepublic java.lang.String getBaseStyle()
baseStyle
To override the baseStyle at the row level, use
record[listGrid.recordBaseStyleProperty]
instead.CSSClass
ListGrid.getRecordBaseStyleProperty()
,
Appearance overview and related methods
,
Grid cells Examplepublic void setCanDragResize(java.lang.Boolean canDragResize)
canResizeFields
.canDragResize
- canDragResize Default value is nullpublic java.lang.Boolean getCanDragResize()
canResizeFields
.public void setCanEdit(java.lang.Boolean canEdit)
canEditFieldAttribute
may be used to set default
editability at the field level. For more dynamic control over whether fields can be edited, see ListGrid.canEditCell
.
canEdit
- canEdit Default value is nullListGrid.setCanEdit(java.lang.Boolean)
,
ListGrid.setRecordEditProperty(java.lang.String)
,
ListGrid.canEditCell(int, int)
,
Editing overview and related methods
,
Disable editing Examplepublic java.lang.Boolean getCanEdit()
canEditFieldAttribute
may be used to set default
editability at the field level. For more dynamic control over whether fields can be edited, see ListGrid.canEditCell
.
public void setCanExport(java.lang.Boolean canExport)
dataSourceField
is explicitly set to
canExport: false.canExport
- canExport Default value is nullpublic java.lang.Boolean getCanExport()
dataSourceField
is explicitly set to
canExport: false.public void setCanFilter(java.lang.Boolean canFilter)
canFilter
- canFilter Default value is nullpublic java.lang.Boolean getCanFilter()
public void setCanFreeze(java.lang.Boolean canFreeze)
FrozenFields
.canFreeze
- canFreeze Default value is nullListGrid.getHeaderContextMenuItems(java.lang.Integer)
,
FrozenFields overview and related methods
public java.lang.Boolean getCanFreeze()
FrozenFields
.ListGrid.getHeaderContextMenuItems(java.lang.Integer)
,
FrozenFields overview and related methods
public void setCanGroupBy(java.lang.Boolean canGroupBy)
canGroupBy
- canGroupBy Default value is trueListGrid.groupBy(java.lang.String...)
public java.lang.Boolean getCanGroupBy()
ListGrid.groupBy(java.lang.String...)
public void setCanHide(java.lang.Boolean canHide)
canHide
- canHide Default value is nullListGrid.getHeaderContextMenuItems(java.lang.Integer)
,
Appearance overview and related methods
public java.lang.Boolean getCanHide()
ListGrid.getHeaderContextMenuItems(java.lang.Integer)
,
Appearance overview and related methods
public void setCanHilite(java.lang.Boolean canHilite)
canHilite
- canHilite Default value is nullpublic java.lang.Boolean getCanHilite()
public void setCanReorder(java.lang.Boolean canReorder)
canReorderFields
. Note that setting this property to
false
will lock this field from being moved - that is, the user is prevented from moving this field
directly by dragging with the mouse, or by dropping another field onto this field. However, unless this field is at the
extreme edge of the grid, or all fields between it and the extreme edge of the grid are also canReorder:
false
, (ie, if there are unlocked fields on either side of this field), then it is possible that this locked
field may be reordered automatically, as a result of the user dragging one unlocked field onto another unlocked field.canReorder
- canReorder Default value is nullpublic java.lang.Boolean getCanReorder()
canReorderFields
. Note that setting this property to
false
will lock this field from being moved - that is, the user is prevented from moving this field
directly by dragging with the mouse, or by dropping another field onto this field. However, unless this field is at the
extreme edge of the grid, or all fields between it and the extreme edge of the grid are also canReorder:
false
, (ie, if there are unlocked fields on either side of this field), then it is possible that this locked
field may be reordered automatically, as a result of the user dragging one unlocked field onto another unlocked field.public void setCanSort(java.lang.Boolean canSort)
sort()
or setSort()
will work as expected.canSort
- canSort Default value is trueListGrid.sort()
,
ListGrid.setCanSort(java.lang.Boolean)
public java.lang.Boolean getCanSort()
sort()
or setSort()
will work as expected.ListGrid.sort()
,
ListGrid.getCanSort()
public void setCanSortClientOnly(java.lang.Boolean canSortClientOnly)
canSortClientOnly
- canSortClientOnly Default value is falsepublic java.lang.Boolean getCanSortClientOnly()
public void setCanToggle(java.lang.Boolean canToggle)
true
and false
, and
for valueMapped fields, advancing the value to the next option in the valueMap. To enable this feature, canEdit
must be set to true. For boolean type fields
canToggle
is true by default, meaning setting canEdit
to true implies the user can toggle the
value via a single click without going into edit mode. You can disable this by explicitly setting canToggle
to false for a boolean field.
Note that you can enable toggling only (without allowing the user to edit other
fields) by just setting grid.editEvent:"none"
.
If
editEvent
is set to "click", when the user clicks on the
field, the value will be toggled, and inline editing will be triggered as usual. Otherwise the toggled value will be
saved immediately to the server, or if autoSaveEdits
has been set to false, will be stored as an edit value for the record.
Note : This is an advanced setting
canToggle
- canToggle Default value is variesEditing overview and related methods
public java.lang.Boolean getCanToggle()
true
and false
, and
for valueMapped fields, advancing the value to the next option in the valueMap. To enable this feature, canEdit
must be set to true. For boolean type fields
canToggle
is true by default, meaning setting canEdit
to true implies the user can toggle the
value via a single click without going into edit mode. You can disable this by explicitly setting canToggle
to false for a boolean field.
Note that you can enable toggling only (without allowing the user to edit other
fields) by just setting grid.editEvent:"none"
.
If
editEvent
is set to "click", when the user clicks on the
field, the value will be toggled, and inline editing will be triggered as usual. Otherwise the toggled value will be
saved immediately to the server, or if autoSaveEdits
has been set to false, will be stored as an edit value for the record.
Editing overview and related methods
public void setCellAlign(Alignment cellAlign)
align
. If this field is editable, the alignment of
cells in the body will also be reflected in any editors for the field.cellAlign
- cellAlign Default value is nullAppearance overview and related methods
public Alignment getCellAlign()
align
. If this field is editable, the alignment of
cells in the body will also be reflected in any editors for the field.Appearance overview and related methods
public void setCellIcon(java.lang.String cellIcon)
field.icon
, setting field.cellIcon will not show an icon in the
header. To change this property after fields have been passed to ListGrid.setFields
, use ListGrid.setFieldCellIcon
.
cellIcon
- . See SCImgURL
. Default value is nullpublic java.lang.String getCellIcon()
field.icon
, setting field.cellIcon will not show an icon in the
header. To change this property after fields have been passed to ListGrid.setFields
, use ListGrid.setFieldCellIcon
.
SCImgURL
public void setDataPath(java.lang.String dataPath)
Note : This is an advanced setting
dataPath
- . See String
. Default value is nullpublic java.lang.String getDataPath()
String
public void setDateFormatter(DateDisplayFormat dateFormatter)
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 a field, for fields specified as type "time"
the timeFormatter
will be used,
otherwise the dateFormatter
If field.dateFormatter
and field.timeFormatter
is
unspecified, date display format may be defined at the component level via ListGrid.dateFormatter
, or for fields of type
"datetime"
ListGrid.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.
If this field is editable the
dateFormatter will also be passed to the editor created to edit this field. Note that you can also specify an explicit
inputFormat
which will be passed through to the
editor as well, though this is not typically required as the input format should be automatically derived by the Smart
GWT system for standard DateDisplayFormats.
dateFormatter
- dateFormatter Default value is nullListGrid.setDateFormatter(com.smartgwt.client.types.DateDisplayFormat)
,
ListGrid.setDatetimeFormatter(com.smartgwt.client.types.DateDisplayFormat)
,
setTimeFormatter(com.smartgwt.client.types.TimeDisplayFormat)
public DateDisplayFormat getDateFormatter()
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 a field, for fields specified as type "time"
the timeFormatter
will be used,
otherwise the dateFormatter
If field.dateFormatter
and field.timeFormatter
is
unspecified, date display format may be defined at the component level via ListGrid.dateFormatter
, or for fields of type
"datetime"
ListGrid.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.
If this field is editable the
dateFormatter will also be passed to the editor created to edit this field. Note that you can also specify an explicit
inputFormat
which will be passed through to the
editor as well, though this is not typically required as the input format should be automatically derived by the Smart
GWT system for standard DateDisplayFormats.
ListGrid.getDateFormatter()
,
ListGrid.getDatetimeFormatter()
,
getTimeFormatter()
public void setDecimalPad(java.lang.Integer decimalPad)
For example, a field value of 343.1, 343.104 and 343.09872677 would all be shown as 343.10 if decimalPad is 2.
The original unpadded value is always shown when the value is edited.
decimalPad
- decimalPad Default value is nullAppearance overview and related methods
public java.lang.Integer getDecimalPad()
For example, a field value of 343.1, 343.104 and 343.09872677 would all be shown as 343.10 if decimalPad is 2.
The original unpadded value is always shown when the value is edited.
Appearance overview and related methods
public void setDecimalPrecision(java.lang.Integer decimalPrecision)
For example, with decimalPrecision 3, if the field value is 343.672677, 343.673 is shown.
If the value is 125.2, 125.2 is shown -
decimalPrecision will not cause extra zeros to be added. Use decimalPad
for this.
A number is always shown with its original precision when edited.
decimalPrecision
- decimalPrecision Default value is nullAppearance overview and related methods
public java.lang.Integer getDecimalPrecision()
For example, with decimalPrecision 3, if the field value is 343.672677, 343.673 is shown.
If the value is 125.2, 125.2 is shown -
decimalPrecision will not cause extra zeros to be added. Use decimalPad
for this.
A number is always shown with its original precision when edited.
Appearance overview and related methods
public void setDefaultGroupingMode(java.lang.String defaultGroupingMode)
field.groupingMode
is unset. See field.groupingModes
.defaultGroupingMode
- . See String
. Default value is nullpublic java.lang.String getDefaultGroupingMode()
field.groupingMode
is unset. See field.groupingModes
.String
public void setDefaultIconSrc(java.lang.String defaultIconSrc)
defaultIconSrc
.
Note : This is an advanced setting
defaultIconSrc
- . See String
. Default value is nullsetIcons(com.smartgwt.client.widgets.form.fields.FormItemIcon...)
,
Editing overview and related methods
public java.lang.String getDefaultIconSrc()
defaultIconSrc
.String
com.smartgwt.client.widgets.grid.ListGridField#getIcons
,
Editing overview and related methods
public void setDisplayField(java.lang.String displayField)
optionDataSource
field used to
retrieve the display values that are to be mapped from the internal values specified by valueField
. If no optionDataSource
is
defined for the field, the cell will display the displayField value for the current record instead of the underlying
value for this field. This approach can be used for situations where field values need a stored value to displayed
value mapping, but the set of all possible values is too large to load as a ValueMap - see optionDataSource
for more details on this approach.
Note that if this field is editable this will also be applied to this field's editors. This sample illustrates
this approach achieved via a server-side SQL join.
The display value for a record with a specified
displayField
can be picked up via ListGrid.getDisplayValue
.
displayField
- . See String
. Default value is nullpublic java.lang.String getDisplayField()
optionDataSource
field used to
retrieve the display values that are to be mapped from the internal values specified by valueField
. If no optionDataSource
is
defined for the field, the cell will display the displayField value for the current record instead of the underlying
value for this field. This approach can be used for situations where field values need a stored value to displayed
value mapping, but the set of all possible values is too large to load as a ValueMap - see optionDataSource
for more details on this approach.
Note that if this field is editable this will also be applied to this field's editors. This sample illustrates
this approach achieved via a server-side SQL join.
The display value for a record with a specified
displayField
can be picked up via ListGrid.getDisplayValue
.
String
public void setDisplayValueFromRecord(java.lang.Boolean displayValueFromRecord)
displayField
is set, should this field show
record values from the displayField
? If displayField
is specified, and there is no separate
optionDataSource
, by default we will show
display-field values from the same record. Setting this property to false would disable this behavior.
Alternatively, if there is a optionDataSource
(and autoFetchDisplayMap
is false), the
displayField would be ignored for the field and the underlying record[fieldName] value
would be displayed to the user. This
property may be set to true to override this behavior and pick up values from the displayField
for display
in this field even when there is an optionDataSource set.
Note that this property has no effect on fields with an
explicitly specified valueMap, or with an optionDataSource where autoFetchDisplayMap
is true.
Note : This is an advanced setting
displayValueFromRecord
- displayValueFromRecord Default value is nullpublic java.lang.Boolean getDisplayValueFromRecord()
displayField
is set, should this field show
record values from the displayField
? If displayField
is specified, and there is no separate
optionDataSource
, by default we will show
display-field values from the same record. Setting this property to false would disable this behavior.
Alternatively, if there is a optionDataSource
(and autoFetchDisplayMap
is false), the
displayField would be ignored for the field and the underlying record[fieldName] value
would be displayed to the user. This
property may be set to true to override this behavior and pick up values from the displayField
for display
in this field even when there is an optionDataSource set.
Note that this property has no effect on fields with an
explicitly specified valueMap, or with an optionDataSource where autoFetchDisplayMap
is true.
public void setEditorIconHeight(java.lang.Integer editorIconHeight)
iconHeight
.iconHeight
instead.
Note : This is an advanced setting
editorIconHeight
- editorIconHeight Default value is nullsetIcons(com.smartgwt.client.widgets.form.fields.FormItemIcon...)
,
Editing overview and related methods
public java.lang.Integer getEditorIconHeight()
iconHeight
.iconHeight
instead.com.smartgwt.client.widgets.grid.ListGridField#getIcons
,
Editing overview and related methods
public void setEditorIconWidth(java.lang.Integer editorIconWidth)
iconWidth
.iconWidth
instead.
Note : This is an advanced setting
editorIconWidth
- editorIconWidth Default value is nullsetIcons(com.smartgwt.client.widgets.form.fields.FormItemIcon...)
,
Editing overview and related methods
public java.lang.Integer getEditorIconWidth()
iconWidth
.iconWidth
instead.com.smartgwt.client.widgets.grid.ListGridField#getIcons
,
Editing overview and related methods
public void setEditorImageURLPrefix(java.lang.String editorImageURLPrefix)
imageURLPrefix
to the editor in question. This can
be used to modify the valueIcons within the editor.imageURLPrefix
is specified, that will be used
instead.
Note : This is an advanced setting
editorImageURLPrefix
- . See String
. Default value is nullEditing overview and related methods
public java.lang.String getEditorImageURLPrefix()
imageURLPrefix
to the editor in question. This can
be used to modify the valueIcons within the editor.imageURLPrefix
is specified, that will be used
instead.String
Editing overview and related methods
public void setEditorImageURLSuffix(java.lang.String editorImageURLSuffix)
imageURLSuffix
to the editor in question. This can
be used to modify the valueIcons within the editor.imageURLPrefix
is specified, that will be used
instead.
Note : This is an advanced setting
editorImageURLSuffix
- . See String
. Default value is nullEditing overview and related methods
public java.lang.String getEditorImageURLSuffix()
imageURLSuffix
to the editor in question. This can
be used to modify the valueIcons within the editor.imageURLPrefix
is specified, that will be used
instead.String
Editing overview and related methods
public void setEditorValueIconHeight(java.lang.Integer editorValueIconHeight)
editorValueIconHeight
- editorValueIconHeight Default value is nullImageColumns overview and related methods
public java.lang.Integer getEditorValueIconHeight()
ImageColumns overview and related methods
public void setEditorValueIconWidth(java.lang.Integer editorValueIconWidth)
editorValueIconWidth
- editorValueIconWidth Default value is nullImageColumns overview and related methods
public java.lang.Integer getEditorValueIconWidth()
ImageColumns overview and related methods
public void setEmptyCellValue(java.lang.String emptyCellValue)
This is the field-specific attribute. You may also set the emptyCellValue at the grid level to define the emptyCellValue for all empty fields in the grid.
emptyCellValue
- . See HTMLString
. Default value is "&nbsp;"ListGrid.setEmptyCellValue(java.lang.String)
,
Empty values Examplepublic java.lang.String getEmptyCellValue()
This is the field-specific attribute. You may also set the emptyCellValue at the grid level to define the emptyCellValue for all empty fields in the grid.
HTMLString
ListGrid.getEmptyCellValue()
,
Empty values Examplepublic void setEnterKeyEditAction(EnterKeyEditAction enterKeyEditAction)
enterKeyEditAction
as
specified at the listGrid level while focus is in this field.enterKeyEditAction
- enterKeyEditAction Default value is "done"Editing overview and related methods
public EnterKeyEditAction getEnterKeyEditAction()
enterKeyEditAction
as
specified at the listGrid level while focus is in this field.Editing overview and related methods
public void setEscapeHTML(java.lang.Boolean escapeHTML)
"<b>AAA</b>"
) is
displayed to the user rather than the interpreted HTML (for example "AAA"
)escapeHTML
- escapeHTML Default value is nullpublic java.lang.Boolean getEscapeHTML()
"<b>AAA</b>"
) is
displayed to the user rather than the interpreted HTML (for example "AAA"
)public void setEscapeKeyEditAction(EscapeKeyEditAction escapeKeyEditAction)
escapeKeyEditAction
as
specified at the listGrid level while focus is in this field.escapeKeyEditAction
- escapeKeyEditAction Default value is "cancel"Editing overview and related methods
public EscapeKeyEditAction getEscapeKeyEditAction()
escapeKeyEditAction
as
specified at the listGrid level while focus is in this field.Editing overview and related methods
public void setExportRawValues(java.lang.Boolean exportRawValues)
exportClientData()
. If set to true for a field, the
values in the field-formatters will not be executed for data in this field. Decreases the time taken for large exports.exportRawValues
- exportRawValues Default value is nullpublic java.lang.Boolean getExportRawValues()
exportClientData()
. If set to true for a field, the
values in the field-formatters will not be executed for data in this field. Decreases the time taken for large exports.public void setFilterOnKeypress(java.lang.Boolean filterOnKeypress)
Note : This is an advanced setting
filterOnKeypress
- filterOnKeypress Default value is nullpublic java.lang.Boolean getFilterOnKeypress()
public void setFilterOperator(OperatorId filterOperator)
FilterEditor
showing, the Operator to use
when matching values for this field. Note that you can set all FilterEditor fields to default to either substring or
exact match via autoFetchAsFilter
, but if you
want a mix of exact vs substring match on different fields, you need to use this property, and your ListGrid will
produce AdvancedCriteria
rather than the simpler Criteria
format. This is automatically and transparently handled by the Smart GWT Server's
SQLDataSource and HibernateDataSource in Power Edition or above, but if you have your own filtering implementation, it
will need to be able to handle AdvancedCriteria.
filterOperator
- filterOperator Default value is nullpublic OperatorId getFilterOperator()
FilterEditor
showing, the Operator to use
when matching values for this field. Note that you can set all FilterEditor fields to default to either substring or
exact match via autoFetchAsFilter
, but if you
want a mix of exact vs substring match on different fields, you need to use this property, and your ListGrid will
produce AdvancedCriteria
rather than the simpler Criteria
format. This is automatically and transparently handled by the Smart GWT Server's
SQLDataSource and HibernateDataSource in Power Edition or above, but if you have your own filtering implementation, it
will need to be able to handle AdvancedCriteria.
public void setFrozen(java.lang.Boolean frozen)
FrozenFields
.frozen
- frozen Default value is nullFrozenFields overview and related methods
public java.lang.Boolean getFrozen()
FrozenFields
.FrozenFields overview and related methods
public void setGroupGranularity(java.lang.Integer groupGranularity)
Groups will be formed based on ranges of values of size
groupGranularity
. For example, if groupGranularity were 1000, groups would be 0-1000, 1000-2000, etc.
groupGranularity
- groupGranularity Default value is nullpublic java.lang.Integer getGroupGranularity()
Groups will be formed based on ranges of values of size
groupGranularity
. For example, if groupGranularity were 1000, groups would be 0-1000, 1000-2000, etc.
public void setGroupingMode(java.lang.String groupingMode)
grouping modes
,
the current grouping mode. This property is set when a user chooses a particular grouping mode, and may be set on ListGrid creation to affect the initial grouping.
groupingMode
- . See String
. Default value is nullpublic java.lang.String getGroupingMode()
grouping modes
,
the current grouping mode. This property is set when a user chooses a particular grouping mode, and may be set on ListGrid creation to affect the initial grouping.
String
public void setGroupingModes(java.util.Map groupingModes)
If groupingModes
are present and grouping is enabled
, the menu for this field includes a submenu
of possible grouping modes generated from the groupingModes
valueMap. When the user selects a particular
grouping mode, field.groupingMode
is set to the
user's chosen mode, and this choice can be detected via the field
parameter to ListGridField.getGroupValue
in order to provide different
modes of grouping.
The user may also choose to group records without specifying a grouping mode, in this case, the
defaultGroupingMode
is used.
Note that
getGroupValue
, groupingModes
et al can be specified on SimpleType
declarations, and the different grouping modes that are offered automatically for
various common types are defined this way.
groupingModes
- groupingModes Default value is nullpublic java.util.Map getGroupingModes()
If groupingModes
are present and grouping is enabled
, the menu for this field includes a submenu
of possible grouping modes generated from the groupingModes
valueMap. When the user selects a particular
grouping mode, field.groupingMode
is set to the
user's chosen mode, and this choice can be detected via the field
parameter to ListGridField.getGroupValue
in order to provide different
modes of grouping.
The user may also choose to group records without specifying a grouping mode, in this case, the
defaultGroupingMode
is used.
Note that
getGroupValue
, groupingModes
et al can be specified on SimpleType
declarations, and the different grouping modes that are offered automatically for
various common types are defined this way.
public void setGroupPrecision(java.lang.Integer groupPrecision)
For example, groupPrecision:2
indicates that 45.238 and 45.231 group together, but 45.22 and 45.27 are
separate.
See also groupGranularity
for
grouping by broader ranges.
groupPrecision
- groupPrecision Default value is nullpublic java.lang.Integer getGroupPrecision()
For example, groupPrecision:2
indicates that 45.238 and 45.231 group together, but 45.22 and 45.27 are
separate.
See also groupGranularity
for
grouping by broader ranges.
public void setHeaderBaseStyle(java.lang.String headerBaseStyle)
headerBaseStyle
.headerTitleStyle
as well.headerBaseStyle
- . See CSSClass
. Default value is nullAppearance overview and related methods
public java.lang.String getHeaderBaseStyle()
headerBaseStyle
.headerTitleStyle
as well.CSSClass
Appearance overview and related methods
public void setHeaderTitle(java.lang.String headerTitle)
title
or name
. Set to an empty string to suppress the title in the header
button entirely.headerTitle
- . See String
. Default value is nullsetTitle(java.lang.String)
,
Appearance overview and related methods
public java.lang.String getHeaderTitle()
title
or name
. Set to an empty string to suppress the title in the header
button entirely.String
getTitle()
,
Appearance overview and related methods
public void setHeaderTitleStyle(java.lang.String headerTitleStyle)
headerTitleStyle
.headerButtonConstructor
is set to StretchImgButton
or a subclass thereof.headerTitleStyle
- . See CSSClass
. Default value is nullAppearance overview and related methods
public java.lang.String getHeaderTitleStyle()
headerTitleStyle
.headerButtonConstructor
is set to StretchImgButton
or a subclass thereof.CSSClass
Appearance overview and related methods
public void setHiliteIconHeight(java.lang.Integer hiliteIconHeight)
hiliteIconSize
, hiliteIconHeight
, and hiliteIconSize
.hiliteIconHeight
- hiliteIconHeight Default value is nullHiliting overview and related methods
public java.lang.Integer getHiliteIconHeight()
hiliteIconSize
, hiliteIconHeight
, and hiliteIconSize
.Hiliting overview and related methods
public void setHiliteIconLeftPadding(java.lang.Integer hiliteIconLeftPadding)
hilite icons
for this field? Overrides hiliteIconLeftPadding
hiliteIconLeftPadding
- hiliteIconLeftPadding Default value is nullHiliting overview and related methods
public java.lang.Integer getHiliteIconLeftPadding()
hilite icons
for this field? Overrides hiliteIconLeftPadding
Hiliting overview and related methods
public void setHiliteIconPosition(HiliteIconPosition hiliteIconPosition)
hiliteIcons
are present, where the hilite icon
will be placed relative to the field value. See HiliteIconPosition
. Overrides hiliteIconPosition
.hiliteIconPosition
- hiliteIconPosition Default value is nullHiliting overview and related methods
public HiliteIconPosition getHiliteIconPosition()
hiliteIcons
are present, where the hilite icon
will be placed relative to the field value. See HiliteIconPosition
. Overrides hiliteIconPosition
.Hiliting overview and related methods
public void setHiliteIconRightPadding(java.lang.Integer hiliteIconRightPadding)
hilite icons
for this field? Overrides hiliteIconRightPadding
hiliteIconRightPadding
- hiliteIconRightPadding Default value is nullHiliting overview and related methods
public java.lang.Integer getHiliteIconRightPadding()
hilite icons
for this field? Overrides hiliteIconRightPadding
Hiliting overview and related methods
public void setHiliteIconSize(java.lang.Integer hiliteIconSize)
hilite icons
in this field.
Takes precedence over hiliteIconWidth, hiliteIconHeight and hiliteIconSize specified at the component level. Can be
overridden via hiliteIconWidth
and hiliteIconHeight
hiliteIconSize
- hiliteIconSize Default value is nullListGrid.setHiliteIconSize(int)
,
setHiliteIconWidth(java.lang.Integer)
,
setHiliteIconHeight(java.lang.Integer)
,
Hiliting overview and related methods
public java.lang.Integer getHiliteIconSize()
hilite icons
in this field.
Takes precedence over hiliteIconWidth, hiliteIconHeight and hiliteIconSize specified at the component level. Can be
overridden via hiliteIconWidth
and hiliteIconHeight
ListGrid.getHiliteIconSize()
,
getHiliteIconWidth()
,
getHiliteIconHeight()
,
Hiliting overview and related methods
public void setHiliteIconWidth(java.lang.Integer hiliteIconWidth)
hiliteIconSize
, hiliteIconWidth
, and hiliteIconSize
.hiliteIconWidth
- hiliteIconWidth Default value is nullHiliting overview and related methods
public java.lang.Integer getHiliteIconWidth()
hiliteIconSize
, hiliteIconWidth
, and hiliteIconSize
.Hiliting overview and related methods
public void setIcon(java.lang.String icon)
If field.type
is
set to "icon", this icon will also be shown in every cell of this field - see also field.cellIcon
.
To change this property after fields
have been passed to ListGrid.setFields
, use ListGrid.setFieldIcon
.
icon
- . See SCImgURL
. Default value is nullpublic java.lang.String getIcon()
If field.type
is
set to "icon", this icon will also be shown in every cell of this field - see also field.cellIcon
.
To change this property after fields
have been passed to ListGrid.setFields
, use ListGrid.setFieldIcon
.
SCImgURL
public void setIconHeight(java.lang.Integer iconHeight)
icon
is specified, this property can be used to
specify the height of the icon to be displayed in the ListGrid header button. (See iconHeight
)editorIconHeight
is unset, this property will be
passed onto the editors for this field as iconWidth
, which will effect the default size for icons
displayed in the editor.iconHeight
- iconHeight Default value is nullsetIcon(java.lang.String)
,
setIcons(com.smartgwt.client.widgets.form.fields.FormItemIcon...)
public java.lang.Integer getIconHeight()
icon
is specified, this property can be used to
specify the height of the icon to be displayed in the ListGrid header button. (See iconHeight
)editorIconHeight
is unset, this property will be
passed onto the editors for this field as iconWidth
, which will effect the default size for icons
displayed in the editor.getIcon()
,
com.smartgwt.client.widgets.grid.ListGridField#getIcons
public void setIconOrientation(java.lang.String iconOrientation)
"left"
or "right"
iconOrientation
- . See String
. Default value is "left"setIcon(java.lang.String)
public java.lang.String getIconOrientation()
"left"
or "right"
String
getIcon()
public void setIconSize(java.lang.Integer iconSize)
icon
is specified, this property can be used to
specify the size of the icon to be displayed in the ListGrid header button. (See iconSize
)iconSize
- iconSize Default value is nullsetIcon(java.lang.String)
public java.lang.Integer getIconSize()
icon
is specified, this property can be used to
specify the size of the icon to be displayed in the ListGrid header button. (See iconSize
)getIcon()
public void setIconSpacing(int iconSpacing)
iconSpacing
- iconSpacing Default value is 6setIcon(java.lang.String)
,
ButtonIcon overview and related methods
public int getIconSpacing()
getIcon()
,
ButtonIcon overview and related methods
public void setIconVAlign(java.lang.String iconVAlign)
iconVAlign
.
Note : This is an advanced setting
iconVAlign
- . See String
. Default value is nullsetIcons(com.smartgwt.client.widgets.form.fields.FormItemIcon...)
,
Editing overview and related methods
public java.lang.String getIconVAlign()
iconVAlign
.String
com.smartgwt.client.widgets.grid.ListGridField#getIcons
,
Editing overview and related methods
public void setIconWidth(java.lang.Integer iconWidth)
icon
is specified, this property can be used to
specify the width of the icon to be displayed in the ListGrid header button. (See iconWidth
)editorIconWidth
is unset, this property will be
passed onto the editors for this field as iconWidth
, which will effect the default size for icons
displayed in the editor.iconWidth
- iconWidth Default value is nullsetIcon(java.lang.String)
,
setIcons(com.smartgwt.client.widgets.form.fields.FormItemIcon...)
public java.lang.Integer getIconWidth()
icon
is specified, this property can be used to
specify the width of the icon to be displayed in the ListGrid header button. (See iconWidth
)editorIconWidth
is unset, this property will be
passed onto the editors for this field as iconWidth
, which will effect the default size for icons
displayed in the editor.getIcon()
,
com.smartgwt.client.widgets.grid.ListGridField#getIcons
public void setIgnoreKeyboardClicks(java.lang.Boolean ignoreKeyboardClicks)
generateClickOnSpace
, generateClickOnEnter
,
generateDoubleClickOnSpace
, generateDoubleClickOnEnter
and arrowKeyAction
). These synthetic events have both a target row and column. Setting this flag to true ensures that this field will never be considered the target for a keyboard click event.
ignoreKeyboardClicks
- ignoreKeyboardClicks Default value is nullpublic java.lang.Boolean getIgnoreKeyboardClicks()
generateClickOnSpace
, generateClickOnEnter
,
generateDoubleClickOnSpace
, generateDoubleClickOnEnter
and arrowKeyAction
). These synthetic events have both a target row and column. Setting this flag to true ensures that this field will never be considered the target for a keyboard click event.
public void setImageHeight(int imageHeight)
If set to a String, assumed to be a property
on each record that specifies the image height. For example, if field.imageHeight
is "logoHeight",
record.logoHeight
will control the height of the image.
imageHeight
- imageHeight Default value is 16ListGrid.setImageSize(int)
,
setImageSize(int)
,
setImageWidth(int)
,
ImageColumns overview and related methods
public int getImageHeight()
If set to a String, assumed to be a property
on each record that specifies the image height. For example, if field.imageHeight
is "logoHeight",
record.logoHeight
will control the height of the image.
ListGrid.getImageSize()
,
getImageSize()
,
getImageWidth()
,
ImageColumns overview and related methods
public void setImageSize(int imageSize)
imageSize
. If set to a String, assumed to be
a property on each record that specifies the image height. For example, if field.imageSize
is "logoSize",
record.logoSize
will control the size of the image.
imageSize
- imageSize Default value is 16setImageWidth(int)
,
setImageHeight(int)
,
ImageColumns overview and related methods
public int getImageSize()
imageSize
. If set to a String, assumed to be
a property on each record that specifies the image height. For example, if field.imageSize
is "logoSize",
record.logoSize
will control the size of the image.
getImageWidth()
,
getImageHeight()
,
ImageColumns overview and related methods
public void setImageURLPrefix(java.lang.String imageURLPrefix)
ListGridFieldType
] set to "image"
and the URL for
the image displayed is not absolute, the path of the URL will be relative to this stringvalueIcons
when determining the URL for the image.
Note : This is an advanced setting
imageURLPrefix
- . See String
. Default value is nullImageColumns overview and related methods
,
Image Examplepublic java.lang.String getImageURLPrefix()
ListGridFieldType
] set to "image"
and the URL for
the image displayed is not absolute, the path of the URL will be relative to this stringvalueIcons
when determining the URL for the image.String
ImageColumns overview and related methods
,
Image Examplepublic void setImageURLSuffix(java.lang.String imageURLSuffix)
valueIcons
) or this is has ListGridFieldType
set to "image"
, this the value of this property will be
appended to the end of the URL for the icon displayed.".gif"
to the filename of the image.imageURLSuffix
.
Note : This is an advanced setting
imageURLSuffix
- . See String
. Default value is nullImageColumns overview and related methods
,
Image Examplepublic java.lang.String getImageURLSuffix()
valueIcons
) or this is has ListGridFieldType
set to "image"
, this the value of this property will be
appended to the end of the URL for the icon displayed.".gif"
to the filename of the image.imageURLSuffix
.String
ImageColumns overview and related methods
,
Image Examplepublic void setImageWidth(int imageWidth)
If set to a String, assumed to be a property
on each record that specifies the image width. For example, if field.imageWidth
is "logoWidth",
record.logoWidth
will control the width of the image.
imageWidth
- imageWidth Default value is 16ListGrid.setImageSize(int)
,
setImageSize(int)
,
setImageHeight(int)
,
ImageColumns overview and related methods
public int getImageWidth()
If set to a String, assumed to be a property
on each record that specifies the image width. For example, if field.imageWidth
is "logoWidth",
record.logoWidth
will control the width of the image.
ListGrid.getImageSize()
,
getImageSize()
,
getImageHeight()
,
ImageColumns overview and related methods
public void setIncludeFrom(java.lang.String includeFrom)
field.type
and field.title
from the related DataSource just like fields from
the primary DataSource. When fetchData
is
called, the automatically created DSRequest
will specify additionalOutputs
requesting the field, and any Criteria
generated by the component will likewise refer to the field from the related
DataSource.
It's an error to use this property if the ListGrid does not have a DataSource at all. The related DataSource must be loaded or a warning will be logged and the field definition ignored.
This value is expected to be
set to the following format dataSourceID.fieldName
where dataSourceID is the ID of the related
dataSource and fieldName is the name of the field from that dataSource from which you wish to retrieve values.
Note that if this property is set and name is not explicitly specified, this field's name
will default to
the fieldName value from this property.
Note about automatic cache updates: "update" and "add" operations
submitted automatically by this ListGrid will include dsRequest.additionalOutputs
to ensure all data
necessary for cache updates is returned by the server.
If your grid shows data that can be edited elsewhere in the
UI (not by inline editing), to avoid problems with ResultSet
automatic cache
synchronization, you may need to switch from using listGridField.includeFrom
to
dataSourceField.includeFrom
. This is because server responses to "add" and "update" operations which are
initiated outside of this grid do not know about the listGridField.includeFrom
setting, and so will not
automatically return data for fields included in this way. Switching to dataSourceField.includeFrom
ensures the field is always included in server responses, avoiding the issue.
includeFrom
- . See String
. Default value is nullpublic java.lang.String getIncludeFrom()
field.type
and field.title
from the related DataSource just like fields from
the primary DataSource. When fetchData
is
called, the automatically created DSRequest
will specify additionalOutputs
requesting the field, and any Criteria
generated by the component will likewise refer to the field from the related
DataSource.
It's an error to use this property if the ListGrid does not have a DataSource at all. The related DataSource must be loaded or a warning will be logged and the field definition ignored.
This value is expected to be
set to the following format dataSourceID.fieldName
where dataSourceID is the ID of the related
dataSource and fieldName is the name of the field from that dataSource from which you wish to retrieve values.
Note that if this property is set and name is not explicitly specified, this field's name
will default to
the fieldName value from this property.
Note about automatic cache updates: "update" and "add" operations
submitted automatically by this ListGrid will include dsRequest.additionalOutputs
to ensure all data
necessary for cache updates is returned by the server.
If your grid shows data that can be edited elsewhere in the
UI (not by inline editing), to avoid problems with ResultSet
automatic cache
synchronization, you may need to switch from using listGridField.includeFrom
to
dataSourceField.includeFrom
. This is because server responses to "add" and "update" operations which are
initiated outside of this grid do not know about the listGridField.includeFrom
setting, and so will not
automatically return data for fields included in this way. Switching to dataSourceField.includeFrom
ensures the field is always included in server responses, avoiding the issue.
String
public void setIncludeInRecordSummary(java.lang.Boolean includeInRecordSummary)
includeInRecordSummaryFields
.includeInRecordSummary
- includeInRecordSummary Default value is nullpublic java.lang.Boolean getIncludeInRecordSummary()
includeInRecordSummaryFields
.public void setIsRemoveField(java.lang.Boolean isRemoveField)
canRemoveRecords
is true, this
field will be rendered as the remove-field for this grid. In most common usage scenarios this field will essentially be
a placeholder indicating where the remove field should be rendered, meaning properties other than
isRemoveField
, such as name
or title
, may be left unset.
Note : This is an advanced setting
isRemoveField
- isRemoveField Default value is nullListGrid.setCanRemoveRecords(java.lang.Boolean)
public java.lang.Boolean getIsRemoveField()
canRemoveRecords
is true, this
field will be rendered as the remove-field for this grid. In most common usage scenarios this field will essentially be
a placeholder indicating where the remove field should be rendered, meaning properties other than
isRemoveField
, such as name
or title
, may be left unset.ListGrid.getCanRemoveRecords()
public void setLeaveHeaderMenuButtonSpace(java.lang.Boolean leaveHeaderMenuButtonSpace)
showHeaderMenuButton
is true, when
auto-fitting fields to the title width via autoFitFieldWidths
or autoFitWidth
, should the
button be sized such that there is enough space for the heeader menu button to show without covering the field title?
May be explicitly specified at the field level
or at the grid level
. If not explicitly specified space
will be left for fields with align
set to
"left"
or "right"
, but not for fields with align set to "center"
.
Note : This is an advanced setting
leaveHeaderMenuButtonSpace
- leaveHeaderMenuButtonSpace Default value is nullpublic void setLinkText(java.lang.String linkText)
This property sets linkText that will be
the same for all records. You can set linkText on a per-record basis via linkText
.
linkText
- . See String
. Default value is nullListGridFieldType
,
FieldType
,
ListGridRecord.setLinkText(java.lang.String)
,
ListGrid.setLinkTextProperty(java.lang.String)
,
setLinkTextProperty(java.lang.String)
,
Link (image) Examplepublic java.lang.String getLinkText()
This property sets linkText that will be
the same for all records. You can set linkText on a per-record basis via linkText
.
String
ListGridFieldType
,
FieldType
,
ListGridRecord.getLinkText()
,
ListGrid.getLinkTextProperty()
,
getLinkTextProperty()
,
Link (image) Examplepublic void setLinkTextProperty(java.lang.String linkTextProperty)
linkTextProperty
- . See String
. Default value is nullListGridFieldType
,
FieldType
,
ListGridRecord.setLinkText(java.lang.String)
,
setLinkText(java.lang.String)
,
ListGrid.setLinkTextProperty(java.lang.String)
public java.lang.String getLinkTextProperty()
String
ListGridFieldType
,
FieldType
,
ListGridRecord.getLinkText()
,
getLinkText()
,
ListGrid.getLinkTextProperty()
public void setLinkURLPrefix(java.lang.String linkURLPrefix)
ListGridFieldType
] set to "link"
, setting this
property will apply a standard prefix to the link URL for cells in this field.
Note : This is an advanced setting
linkURLPrefix
- . See String
. Default value is nullpublic java.lang.String getLinkURLPrefix()
ListGridFieldType
] set to "link"
, setting this
property will apply a standard prefix to the link URL for cells in this field.String
public void setLinkURLSuffix(java.lang.String linkURLSuffix)
ListGridFieldType
] set to "link"
, setting this
property will apply a standard suffix to the link URL for cells in this field.
Note : This is an advanced setting
linkURLSuffix
- . See String
. Default value is nullpublic java.lang.String getLinkURLSuffix()
ListGridFieldType
] set to "link"
, setting this
property will apply a standard suffix to the link URL for cells in this field.String
public void setMultiple(java.lang.Boolean multiple)
valueMap
is set, the
default editor will be a SelectItem
with multiple
set to true. Note that for databound grids
it typically makes sense to set multiple
rather than
setting the property directly on the ListGridField object.
multiple
- multiple Default value is nullEditing overview and related methods
public java.lang.Boolean getMultiple()
valueMap
is set, the
default editor will be a SelectItem
with multiple
set to true. Note that for databound grids
it typically makes sense to set multiple
rather than
setting the property directly on the ListGridField object.
Editing overview and related methods
public void setName(java.lang.String name)
The name of field is also the property in each record which holds the value for that field.
If a
dataSource
is specified and the DataSource has a field
with the same name, the ListGridField and DataSourceField are merged so that properties on the ListGridField
name
- . See String
. Default value is nullpublic java.lang.String getName()
The name of field is also the property in each record which holds the value for that field.
If a
dataSource
is specified and the DataSource has a field
with the same name, the ListGridField and DataSourceField are merged so that properties on the ListGridField
String
public void setOptionCriteria(Criteria optionCriteria)
optionDataSource
is set for this
ListGridField, criteria specified in this attribute will be passed to the dataSource when performing the fetch operation
to determine data-value to display-value mappingsoptionCriteria
- optionCriteria Default value is nullpublic Criteria getOptionCriteria()
optionDataSource
is set for this
ListGridField, criteria specified in this attribute will be passed to the dataSource when performing the fetch operation
to determine data-value to display-value mappingspublic void setOptionOperationId(java.lang.String optionOperationId)
autoFetchDisplayMap
is set, this attribute
provides a way to customize the operationId
passed to
dataSource.fetchData()
when retrieving the display map from the option dataSource.optionOperationId
- . See String
. Default value is nullpublic java.lang.String getOptionOperationId()
autoFetchDisplayMap
is set, this attribute
provides a way to customize the operationId
passed to
dataSource.fetchData()
when retrieving the display map from the option dataSource.String
public void setOptionTextMatchStyle(TextMatchStyle optionTextMatchStyle)
optionDataSource
, where
autoFetchDisplayMap
is true, this property
will govern the textMatchStyle
attribute of the DSRequest
parameter passed
to DataSource.fetchData
when retrieving the remote data set to be
used as a basis for this field's valueMap.optionTextMatchStyle
- optionTextMatchStyle Default value is nullpublic TextMatchStyle getOptionTextMatchStyle()
optionDataSource
, where
autoFetchDisplayMap
is true, this property
will govern the textMatchStyle
attribute of the DSRequest
parameter passed
to DataSource.fetchData
when retrieving the remote data set to be
used as a basis for this field's valueMap.public void setPartialSummary(java.lang.Boolean partialSummary)
"summary"
. This attribute is set on a summary field, when calculating the
summary value from some record, the summary function will only be passed the fields before this summary field. This may
be useful for displaying running totals across a record. Note that this feature would typically be used with canReorderFields:false
partialSummary
- partialSummary Default value is nullpublic java.lang.Boolean getPartialSummary()
"summary"
. This attribute is set on a summary field, when calculating the
summary value from some record, the summary function will only be passed the fields before this summary field. This may
be useful for displaying running totals across a record. Note that this feature would typically be used with canReorderFields:false
public void setPrompt(java.lang.String prompt)
prompt
for the header).prompt
- . See String
. Default value is nullpublic java.lang.String getPrompt()
prompt
for the header).String
public void setRequired(java.lang.Boolean required)
DataSourceField
,
enabling both client and server side validation.required
- required Default value is nullsetValidators(com.smartgwt.client.widgets.form.validator.Validator...)
,
GridValidation overview and related methods
public java.lang.Boolean getRequired()
DataSourceField
,
enabling both client and server side validation.com.smartgwt.client.widgets.grid.ListGridField#getValidators
,
GridValidation overview and related methods
public void setShouldPrint(java.lang.Boolean shouldPrint)
shouldPrint
- shouldPrint Default value is nullPrinting overview and related methods
public java.lang.Boolean getShouldPrint()
Printing overview and related methods
public void setShowAlternateStyle(java.lang.Boolean showAlternateStyle)
Note : This is an advanced setting
showAlternateStyle
- showAlternateStyle Default value is nullpublic java.lang.Boolean getShowAlternateStyle()
public void setShowDefaultContextMenu(java.lang.Boolean showDefaultContextMenu)
showDefaultContextMenu
- showDefaultContextMenu Default value is truepublic java.lang.Boolean getShowDefaultContextMenu()
public void setShowDisabledIcon(java.lang.Boolean showDisabledIcon)
showDisabledIcon
- showDisabledIcon Default value is truesetIcon(java.lang.String)
,
ButtonIcon overview and related methods
public java.lang.Boolean getShowDisabledIcon()
getIcon()
,
ButtonIcon overview and related methods
public void setShowDownIcon(java.lang.Boolean showDownIcon)
showDownIcon
- showDownIcon Default value is falsesetIcon(java.lang.String)
,
ButtonIcon overview and related methods
public java.lang.Boolean getShowDownIcon()
getIcon()
,
ButtonIcon overview and related methods
public void setShowFileInline(java.lang.Boolean showFileInline)
showFileInline
- showFileInline Default value is nullpublic java.lang.Boolean getShowFileInline()
public void setShowFocusedIcon(java.lang.Boolean showFocusedIcon)
If showFocusedAsOver
is true, the "Over"
icon
will be displayed when the canvas has focus, otherwise a separate "Focused"
icon will be displayed
showFocusedIcon
- showFocusedIcon Default value is falsesetIcon(java.lang.String)
,
ButtonIcon overview and related methods
public java.lang.Boolean getShowFocusedIcon()
If showFocusedAsOver
is true, the "Over"
icon
will be displayed when the canvas has focus, otherwise a separate "Focused"
icon will be displayed
getIcon()
,
ButtonIcon overview and related methods
public void setShowGridSummary(java.lang.Boolean showGridSummary)
showGridSummary
is true, should this field show
a summary value. If unset, this field will show a summary value in the summary row if an explicit summaryFunction
is specified or if a default summary function
is defined for the specified
field type.showGridSummary
- showGridSummary Default value is nullpublic java.lang.Boolean getShowGridSummary()
showGridSummary
is true, should this field show
a summary value. If unset, this field will show a summary value in the summary row if an explicit summaryFunction
is specified or if a default summary function
is defined for the specified
field type.public void setShowGroupSummary(java.lang.Boolean showGroupSummary)
showGroupSummary
is true, should this field
show a summary value in a summary row when the grid is grouped? If unset, this field will show a summary value in the
summary row if an explicit summaryFunction
is
specified or if a default summary function
is
defined for the specified field type.showGroupSummary
- showGroupSummary Default value is nullpublic java.lang.Boolean getShowGroupSummary()
showGroupSummary
is true, should this field
show a summary value in a summary row when the grid is grouped? If unset, this field will show a summary value in the
summary row if an explicit summaryFunction
is
specified or if a default summary function
is
defined for the specified field type.public void setShowHilitesInGroupSummary(java.lang.Boolean showHilitesInGroupSummary)
All hilites in group summary rows can be controlled with the showHilitesInGroupSummary
property.
showHilitesInGroupSummary
- showHilitesInGroupSummary Default value is nullpublic java.lang.Boolean getShowHilitesInGroupSummary()
All hilites in group summary rows can be controlled with the showHilitesInGroupSummary
property.
public void setShowHover(java.lang.Boolean showHover)
field.hoverHTML()
. canHover
can be set to true to cause hovers to be shown for all
fields by default. In this case, field.showHover
can be set to false to suppress hovers for an individual
field.
All hovers can be disabled, regardless of other settings, by setting showHover
to false.
showHover
- showHover Default value is nullpublic java.lang.Boolean getShowHover()
field.hoverHTML()
. canHover
can be set to true to cause hovers to be shown for all
fields by default. In this case, field.showHover
can be set to false to suppress hovers for an individual
field.
All hovers can be disabled, regardless of other settings, by setting showHover
to false.
public void setShowRollOverIcon(java.lang.Boolean showRollOverIcon)
showRollOverIcon
- showRollOverIcon Default value is falsesetIcon(java.lang.String)
,
ButtonIcon overview and related methods
public java.lang.Boolean getShowRollOverIcon()
getIcon()
,
ButtonIcon overview and related methods
public void setShowSelectedIcon(java.lang.Boolean showSelectedIcon)
showSelectedIcon
- showSelectedIcon Default value is falsesetIcon(java.lang.String)
,
ButtonIcon overview and related methods
public java.lang.Boolean getShowSelectedIcon()
getIcon()
,
ButtonIcon overview and related methods
public void setShowTitle(java.lang.Boolean showTitle)
false
to explicitly suppress display of the field title in the column header
button for the field.showTitle
- showTitle Default value is nullpublic java.lang.Boolean getShowTitle()
false
to explicitly suppress display of the field title in the column header
button for the field.public void setShowValueIconOnly(java.lang.Boolean showValueIconOnly)
If unset the default behavior is to show the icon only if an explicit valueMap is specified as well in addition to a valueIcons map, otherwise show both the valueIcon and value for the cell.
Note that if this field is editable showValueIconOnly
will be passed through to
editors displayed in this field.
showValueIconOnly
- showValueIconOnly Default value is nullsetValueIcons(java.util.Map<java.lang.String, java.lang.String>)
,
setSuppressValueIcon(java.lang.Boolean)
,
ImageColumns overview and related methods
public java.lang.Boolean getShowValueIconOnly()
If unset the default behavior is to show the icon only if an explicit valueMap is specified as well in addition to a valueIcons map, otherwise show both the valueIcon and value for the cell.
Note that if this field is editable showValueIconOnly
will be passed through to
editors displayed in this field.
com.smartgwt.client.widgets.grid.ListGridField#getValueIcons
,
getSuppressValueIcon()
,
ImageColumns overview and related methods
public void setSortByDisplayField(java.lang.Boolean sortByDisplayField)
displayField
configured, should client-side sorting be performed on the display field
value? Unless explicitly set to false
the display field value is used.sortByDisplayField
- sortByDisplayField Default value is nullpublic java.lang.Boolean getSortByDisplayField()
displayField
configured, should client-side sorting be performed on the display field
value? Unless explicitly set to false
the display field value is used.public void setSortByMappedValue(java.lang.Boolean sortByMappedValue)
valueMap
is set, and the grid is sorted
by this field, should the data be sorted by the underlying
data value or the mapped display value. If unset, will sort by display value. Set to false
to sort by
underlying data value. Note that this has no effect if a ListGridField.sortNormalizer
has been specified.sortByMappedValue
- sortByMappedValue Default value is nullpublic java.lang.Boolean getSortByMappedValue()
valueMap
is set, and the grid is sorted
by this field, should the data be sorted by the underlying
data value or the mapped display value. If unset, will sort by display value. Set to false
to sort by
underlying data value. Note that this has no effect if a ListGridField.sortNormalizer
has been specified.public void setSortDirection(SortDirection sortDirection)
default sort field
for the listGrid, sorting occurs
automatically, otherwise this will be the default direction when the user clicks the field header, or calls ListGrid.sort
without specifying an explicit sort direction. Overrides ListGrid.sortDirection
sortDirection
- sortDirection Default value is nullSortDirection
public SortDirection getSortDirection()
default sort field
for the listGrid, sorting occurs
automatically, otherwise this will be the default direction when the user clicks the field header, or calls ListGrid.sort
without specifying an explicit sort direction. Overrides ListGrid.sortDirection
SortDirection
public void setSummaryTitle(java.lang.String summaryTitle)
headerTitle
attribute to show a different title in the
column header button than the title used elsewhere.title
. This gives the developer an option to use a very short,
or empty title for the ListGrid column (where space may be a factor), but have a longer value available to be used
elsewhere.Note : This is an advanced setting
summaryTitle
- . See String
. Default value is nullsetTitle(java.lang.String)
,
Appearance overview and related methods
public java.lang.String getSummaryTitle()
headerTitle
attribute to show a different title in the
column header button than the title used elsewhere.title
. This gives the developer an option to use a very short,
or empty title for the ListGrid column (where space may be a factor), but have a longer value available to be used
elsewhere.String
getTitle()
,
Appearance overview and related methods
public void setSummaryValue(java.lang.String summaryValue)
summaryRow
. The default for normal fields is null and for
special fields, like the checkboxField
, the
default is to show a blank value (a non-breaking space).summaryValue
- . See HTMLString
. Default value is nullpublic java.lang.String getSummaryValue()
summaryRow
. The default for normal fields is null and for
special fields, like the checkboxField
, the
default is to show a blank value (a non-breaking space).HTMLString
public void setSummaryValueTitle(java.lang.String summaryValueTitle)
showGridSummary
or showGroupSummary
is true and the summaryFunction
is set to "title"
, this
attribute may be set to a string to display in the group and/or grid summary. If unspecified the title
will show up in the summary.summaryValueTitle
- . See String
. Default value is nullpublic java.lang.String getSummaryValueTitle()
showGridSummary
or showGroupSummary
is true and the summaryFunction
is set to "title"
, this
attribute may be set to a string to display in the group and/or grid summary. If unspecified the title
will show up in the summary.String
public void setSuppressValueIcon(java.lang.Boolean suppressValueIcon)
Note this property may also be set to false to avoid showing the standard
booleanTrueImage
and booleanFalseImage
for fields of type
boolean
.
suppressValueIcon
- suppressValueIcon Default value is nullsetValueIcons(java.util.Map<java.lang.String, java.lang.String>)
,
setShowValueIconOnly(java.lang.Boolean)
,
ImageColumns overview and related methods
public java.lang.Boolean getSuppressValueIcon()
Note this property may also be set to false to avoid showing the standard
booleanTrueImage
and booleanFalseImage
for fields of type
boolean
.
com.smartgwt.client.widgets.grid.ListGridField#getValueIcons
,
getShowValueIconOnly()
,
ImageColumns overview and related methods
public void setTarget(java.lang.String target)
target
attribute of
the anchor tag used to render the link. If you set listGridField.target to "javascript", the default behavior is to
catch and consume mouse-clicks that would result in the link being followed. Instead, the ListGrid.cellClick
event is fired for the containing
cell.
target
- . See String
. Default value is "_blank"public java.lang.String getTarget()
target
attribute of
the anchor tag used to render the link. If you set listGridField.target to "javascript", the default behavior is to
catch and consume mouse-clicks that would result in the link being followed. Instead, the ListGrid.cellClick
event is fired for the containing
cell.
String
public void setTimeFormatter(TimeDisplayFormat timeFormatter)
"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"
.
If this field is editable, the timeFormatter will also be passed to the
editor created to edit this field as timeFormatter
.
Note : This is an advanced setting
timeFormatter
- timeFormatter Default value is nullAppearance overview and related methods
public TimeDisplayFormat getTimeFormatter()
"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"
.
If this field is editable, the timeFormatter will also be passed to the
editor created to edit this field as timeFormatter
.
Appearance overview and related methods
public void setTitle(java.lang.String title)
menu for picking visible fields
. Note: if you want
to use HTML tags to affect the display of the header, you should do so via headerTitle
instead so that other places where the title
appears in the UI are not affected. For example, you might set headerTitle
to an empty string to suppress
the header title on a narrow column, but you would retain the normal title in the title
property to avoid a
blank menu item in the field picker menu, hilite
editor
and other contexts.
Alternately you can specify a ListGridField.getFieldTitle
method on the field to return
the HTML for the field title.
title
- . See String
. Default value is nullgetFieldTitle(com.smartgwt.client.widgets.grid.ListGrid, int)
,
Appearance overview and related methods
public java.lang.String getTitle()
menu for picking visible fields
. Note: if you want
to use HTML tags to affect the display of the header, you should do so via headerTitle
instead so that other places where the title
appears in the UI are not affected. For example, you might set headerTitle
to an empty string to suppress
the header title on a narrow column, but you would retain the normal title in the title
property to avoid a
blank menu item in the field picker menu, hilite
editor
and other contexts.
Alternately you can specify a ListGridField.getFieldTitle
method on the field to return
the HTML for the field title.
String
getFieldTitle(com.smartgwt.client.widgets.grid.ListGrid, int)
,
Appearance overview and related methods
public void setType(ListGridFieldType type)
ListGridFieldType
for a summary of how types are rendered.type
- type Default value is "text"ListGridFieldType
,
FieldType
,
Appearance overview and related methods
public ListGridFieldType getType()
ListGridFieldType
for a summary of how types are rendered.ListGridFieldType
,
FieldType
,
Appearance overview and related methods
public void setUserFormula(UserFormula userFormula)
Advanced applications that wish to save formulas separately from a grid's viewState
can provide a UserFormula
as part of the field definition, and may subsequently access the formula is
updated via the ListGrid.formulaUpdated
notification.
userFormula
- userFormula Default value is nullpublic UserFormula getUserFormula()
Advanced applications that wish to save formulas separately from a grid's viewState
can provide a UserFormula
as part of the field definition, and may subsequently access the formula is
updated via the ListGrid.formulaUpdated
notification.
public void setUserSummary(UserSummary userSummary)
Advanced applications that wish to save summarys separately from a grid's viewState
can provide a UserSummary
as part of the field definition, and may subsequently access the summary is
updated via the ListGrid.summaryUpdated
notification.
userSummary
- userSummary Default value is nullpublic UserSummary getUserSummary()
Advanced applications that wish to save summarys separately from a grid's viewState
can provide a UserSummary
as part of the field definition, and may subsequently access the summary is
updated via the ListGrid.summaryUpdated
notification.
public void setValidateOnChange(java.lang.Boolean validateOnChange)
validators
for this field will
be run whenever the value of the field is changed. Analogous to the validateOnChange
property.
validateOnChange
- validateOnChange Default value is nullGridValidation overview and related methods
public java.lang.Boolean getValidateOnChange()
validators
for this field will
be run whenever the value of the field is changed. Analogous to the validateOnChange
property.
GridValidation overview and related methods
public void setValueField(java.lang.String valueField)
optionDataSource
field used to
retrieve the stored values that are to be mapped to the display values (specified by displayField
). Note that if this field is editable this
will also be applied to this field's editors.valueField
- . See String
. Default value is nullpublic java.lang.String getValueField()
optionDataSource
field used to
retrieve the stored values that are to be mapped to the display values (specified by displayField
). Note that if this field is editable this
will also be applied to this field's editors.String
public void setValueIconHeight(java.lang.Integer valueIconHeight)
valueIconSize
, valueIconHeight
, and valueIconSize
.valueIconHeight
- valueIconHeight Default value is nullImageColumns overview and related methods
public java.lang.Integer getValueIconHeight()
valueIconSize
, valueIconHeight
, and valueIconSize
.ImageColumns overview and related methods
public void setValueIconLeftPadding(java.lang.Integer valueIconLeftPadding)
valueIconLeftPadding
valueIconLeftPadding
- valueIconLeftPadding Default value is nullsetValueIcons(java.util.Map<java.lang.String, java.lang.String>)
,
ImageColumns overview and related methods
public java.lang.Integer getValueIconLeftPadding()
valueIconLeftPadding
com.smartgwt.client.widgets.grid.ListGridField#getValueIcons
,
ImageColumns overview and related methods
public void setValueIconOrientation(java.lang.String valueIconOrientation)
showValueIconOnly
is truevalueIconOrientation
- . See String
. Default value is nullImageColumns overview and related methods
public java.lang.String getValueIconOrientation()
showValueIconOnly
is trueString
ImageColumns overview and related methods
public void setValueIconRightPadding(java.lang.Integer valueIconRightPadding)
valueIconRightPadding
valueIconRightPadding
- valueIconRightPadding Default value is nullsetValueIcons(java.util.Map<java.lang.String, java.lang.String>)
,
ImageColumns overview and related methods
public java.lang.Integer getValueIconRightPadding()
valueIconRightPadding
com.smartgwt.client.widgets.grid.ListGridField#getValueIcons
,
ImageColumns overview and related methods
public void setValueIconSize(java.lang.Integer valueIconSize)
valueIconWidth
and {ListGridField.valueIconHeight}valueIconSize
- valueIconSize Default value is nullListGrid.setValueIconSize(int)
,
setValueIconWidth(java.lang.Integer)
,
setValueIconHeight(java.lang.Integer)
,
ImageColumns overview and related methods
public java.lang.Integer getValueIconSize()
valueIconWidth
and {ListGridField.valueIconHeight}ListGrid.getValueIconSize()
,
getValueIconWidth()
,
getValueIconHeight()
,
ImageColumns overview and related methods
public void setValueIconWidth(java.lang.Integer valueIconWidth)
valueIconSize
, valueIconWidth
, and valueIconSize
.valueIconWidth
- valueIconWidth Default value is nullImageColumns overview and related methods
public java.lang.Integer getValueIconWidth()
valueIconSize
, valueIconWidth
, and valueIconSize
.ImageColumns overview and related methods
public void setWrap(java.lang.Boolean wrap)
wrap
- wrap Default value is nullpublic java.lang.Boolean getWrap()
public com.google.gwt.event.shared.HandlerRegistration addEditorEnterHandler(EditorEnterHandler handler)
Callback fired when the user first starts editing a cell.
This callback is typically used to establish dynamic
default values via ListGrid.setEditValue
or ListGrid.setEditValues
.
addEditorEnterHandler
in interface HasEditorEnterHandlers
handler
- the editorEnter handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEditorExitHandler(EditorExitHandler handler)
Callback fired when the user attempts to navigate away from the current edit cell, or complete the current edit.
Call EditorExitEvent.cancel()
from within EditorExitHandler.onEditorExit(com.smartgwt.client.widgets.grid.events.EditorExitEvent)
from this method to cancel the default behavior (Saving / cancelling the current edit /
moving to the next edit cell)
addEditorExitHandler
in interface HasEditorExitHandlers
handler
- the editorExit handlerHandlerRegistration
used to remove this handlerpublic java.lang.String getFieldTitle(ListGrid viewer, int fieldNum)
title
attribute on the field to specify the title. You can
use setFieldProperties()
to dynamically update the
title.
viewer
- pointer back to the ListGridfieldNum
- index of this field in the grid's fields array.getTitle()
,
Appearance overview and related methods
public com.google.gwt.event.shared.HandlerRegistration addRecordClickHandler(RecordClickHandler handler)
Executed when this field is clicked on. Note that if ListGrid.recordClick
is also defined, it will be fired for fields that define a recordClick handler if the field-level
handler returns true. Call RecordClickEvent.cancel()
from within RecordClickHandler.onRecordClick(com.smartgwt.client.widgets.grid.events.RecordClickEvent)
to prevent the grid-level handler from firing.
addRecordClickHandler
in interface HasRecordClickHandlers
handler
- the recordClick handlerHandlerRegistration
used to remove this handlerpublic void setDefaultFilterValue(java.lang.String defaultFilterValue)
defaultFilterValue
- the default filter valuepublic void setDefaultFilterValue(java.lang.Integer defaultFilterValue)
defaultFilterValue
- the default filter valuepublic void setDefaultFilterValue(java.lang.Float defaultFilterValue)
defaultFilterValue
- the default filter valuepublic void setDefaultFilterValue(java.lang.Boolean defaultFilterValue)
defaultFilterValue
- the default filter valuepublic void setDefaultFilterValue(java.util.Date defaultFilterValue)
defaultFilterValue
- the default filter valuepublic void setIcons(FormItemIcon... icons)
icons
to be displayed in the editors displayed for this field Note : This is an advanced setting
icons
- icons Default value is nullpublic void setCellFormatter(CellFormatter formatter)
Given the raw value for this field as taken from the record Formatter to apply to the static values displayed in cells for this field.
Example usage:
formatting a currency value stored in cents (so "100" to "$1.00")
The value passed to this method is the raw
value for the cell.
Takes precedence over formatCellValue
defined at the grid level for cells in
this field.
Note: this formatter will not be applied to the values displayed in cells being edited. The
setEditValueFormatter(com.smartgwt.client.widgets.grid.CellEditValueFormatter)
is provided for that purpose.
formatter
- the formatterpublic void setEditValueFormatter(CellEditValueFormatter formatter)
Example usage: converting a stored value in cents (100) to a dollar-and-cents value in the editor (1.00)
The value passed to this method is the raw value for the cell.
To convert the formatted value displayed within an editor back to a raw value, implement com.smartgwt.client.widgets.grid.ListGridField#setEditorValueParser
as well.
formatter
- the CellEditValueFormatterEditing overview and related methods
public void setEditValueParser(CellEditValueParser parser)
parser
- the CellEditValueParserEditing overview and related methods
public void setSortNormalizer(SortNormalizer normalizer)
Note that, if the dataset
exceeds dataPageSize
and hence paging is
introduced, the grid relies on the server to provide sorting, and the sortNormalizer will no longer be called.
normalizer
- the sort normalizerpublic void setHoverCustomizer(HoverCustomizer hoverCustomizer)
hoverCustomizer
- the hover customizerpublic void setGroupSummaryCustomizer(GroupSummaryCustomizer groupSummaryCustomizer)
groupSummaryCustomizer
- the group summary customizerpublic void setGridSummaryCustomizer(GridSummaryCustomizer gridSummaryCustomizer)
gridSummaryCustomizer
- the grid summary customizerpublic void setAlign(Alignment align)
cellAlign
.align
- align Default value is nullpublic Alignment getAlign()
cellAlign
.public void setWidth(int width)
width
- width Default value is "*"public void setWidth(java.lang.String width)
width
- width Default value is "*"public java.lang.String getWidth()
public void setWrap(boolean wrap)
wrap
- true to wrappublic void setHidden(boolean hidden)
To mark a field as completely hidden (not shown to a user at all, in any component), set dataSourceField.hidden
instead.
hidden
- true to mark the field as initially hiddenpublic void setImgDir(java.lang.String imgDir)
public void setDefaultValue(java.lang.String defaultValue)
public void setDefaultValue(java.lang.Integer defaultValue)
public void setDefaultValue(java.lang.Boolean defaultValue)
public void setDefaultValue(java.lang.Float defaultValue)
public void setDefaultValue(java.util.Date defaultValue)
public void setEditorProperties(FormItem editorProperties)
The ListGrid.setEditorCustomizer(ListGridEditorCustomizer)
API allows the developer to supply dynamic properties for the
item based on the row as well as the field being edited.
Note: The FormItem passed to setEditorProperties() is used as a "template" to create a FormItem whenever
the ListGrid needs to show an interface for editing this field. See
DataSourceField.setEditorProperties(FormItem)
for a discussion of the limitations this
pattern imposes upon event handling within the passed in item.
As an alternative, you can use setEditorType(String)
or
setEditorType(Class)
to avoid these limitations, if you register
the FormItem subclass with the reflection mechanism
.
editorProperties
- the editor propertiespublic void setEditorType(FormItem editorType)
setEditorProperties(FormItem)
. You can also consider using
setEditorType(Class)
or setEditorType(String)
instead.setEditorProperties(FormItem)
.editorType
- FormItem with default properties to be applied when editingpublic void setEditorType(java.lang.String editorType)
FormItem
class to be used when this field is edited.
If unset, a FormItem will be automatically chosen.
By using the reflection mechanism
,
this method avoids the limitations described in setEditorProperties(FormItem)
.
editorType
- the fully-qualified class name of a FormItem
subclass, which must have been registered with the
reflection mechanism
.java.lang.IllegalArgumentException
- if the editorType class has not beeen registered for use with the
reflection mechanism
,
or if it does not inherit from
FormItem
.public void setEditorType(java.lang.Class<? extends FormItem> editorType)
FormItem
class to be used when this field is edited.
If unset, a FormItem will be automatically chosen.
By using the reflection mechanism
,
this method avoids the limitations described in setEditorProperties(FormItem)
.
editorType
- a FormItem
subclass, which must have been registered with the
reflection mechanism
.java.lang.IllegalArgumentException
- if the editorType class has not beeen registered for use with the
reflection mechanism
,
or if it does not inherit from
FormItem
.public void setFilterEditorType(FormItem filterEditorType)
setFilterEditorProperties(FormItem)
. You can also consider using
setFilterEditorType(Class)
or setFilterEditorType(String)
instead.setFilterEditorProperties(FormItem)
.filterEditorType
- FormItem with default properties to be applied when editing in the filter rowpublic void setFilterEditorType(java.lang.String editorType)
FormItem
class to use
for the filter form item associated with this field. (Only used if this field is not canFilter:false).
Note: If this is not specified, the edit-form item type may be derived from the 'editorType' property, typically inherited from datasource fields, or from the 'type' of the field (showing the appropriate form item for the data-type).
By using the reflection mechanism
,
this method avoids the limitations described in setFilterEditorProperties(FormItem)
.
editorType
- the fully-qualified class name of a FormItem
subclass, which must have been registered with the
reflection mechanism
.java.lang.IllegalArgumentException
- if the editorType class has not beeen registered for use with the
reflection mechanism
,
or if it does not inherit from
FormItem
.public void setFilterEditorType(java.lang.Class<? extends FormItem> editorType)
FormItem
class to use
for the filter form item associated with this field. (Only used if this field is not canFilter:false).
Note: If this is not specified, the edit-form item type may be derived from the 'editorType' property, typically inherited from datasource fields, or from the 'type' of the field (showing the appropriate form item for the data-type).
By using the reflection mechanism
,
this method avoids the limitations described in setFilterEditorProperties(FormItem)
.
editorType
- a FormItem
subclass, which must have been registered with the
reflection mechanism
.java.lang.IllegalArgumentException
- if the editorType class has not beeen registered for use with the
reflection mechanism
,
or if it does not inherit from
FormItem
.public void setFilterEditorProperties(FormItem filterEditorProperties)
Note: The FormItem passed to setFilterEditorProperties() is used
as a "template" to create a FormItem whenever the ListGrid needs to show
an interface for editing this field. See
DataSourceField.setEditorProperties(FormItem)
for a discussion of the limitations this pattern imposes upon event
handling within the passed in item. As an alternative, you can use
setFilterEditorType(String)
or setFilterEditorType(Class)
to avoid
these limitations, if you register the FormItem subclass with the
reflection mechanism
.
filterEditorProperties
- the filter editor propertiespublic void setFilterEditorValueMap(java.util.Map filterEditorValueMap)
filterEditorValueMap
- the filter editor value mappublic void setEditorValueMap(java.util.Map editorValueMap)
editorValueMap
- the editor value mappublic void setValidators(Validator... validators)
Validator
objects for this field. When the user
edits cells in this field, these validators will be applied to the edited value.DataSourceField
, enabling both
client and server side validation.validators
- validators Default value is nullpublic void setValueMap(java.util.Map valueMap)
canEdit
, canEdit
), editors displayed for this
field will pick up their valueMap either from this value or from editorValueMap
. See also valueMap
.
valueMap
- valueMap Default value is nullpublic void setValueMap(java.lang.String... valueMap)
canEdit
, canEdit
), editors displayed for this
field will pick up their valueMap either from this value or from editorValueMap
. See also valueMap
.
valueMap
- valueMap Default value is nullpublic void setValueIcons(java.util.Map<java.lang.String,java.lang.String> valueIcons)
editorValueIcons
.editor_
attributes:valueIconWidth
valueIconHeight
valueIconSize
valueIconLeftPadding
valueIconRightPadding
imageURLPrefix
imageURLSuffix
valueIcons
- valueIcons Default value is nullpublic void setEditorValueIcons(java.util.Map<java.lang.String,java.lang.String> editorValueIcons)
editorValueIcons
- editorValueIcons Default value is nullpublic void setOptionDataSource(DataSource optionDataSource)
valueField
and
displayField
in the loaded records,
to derive one valueMap entry per record loaded from the optionDataSource. Unlike the similar use of
optionDataSource
for
pickLists used during editing or filtering, listGridField.optionDataSource
causes the entire set of
records from the optionDataSource to be fetched, without paging. Hence listGridField.optionDataSource is
appropriate only for smaller valueMaps. For very large valueMap situations, such as an accountId field that should be
displayed as an accountName where there are thousands of accounts, the recommended approach is:
displayField
attribute on the data field to the
name of the display field. Note that it is key that the server
return both the underlying stored value and the display value, as suggested above, because this approach allows the
optionDataSource
property to be used to provide paged valueMaps during inline
editing and showFilterEditor
. Note that pickList.optionDataSource
is a distinct setting from listGridField.optionDataSource, settable via editorProperties
(for editing) and filterEditorProperties
(for filtering).
optionDataSource
- optionDataSource Default value is nullpublic void setShowIfCondition(ListGridFieldIfFunction showIf)
showIf
- showIf criteriapublic void setOptionFilterContext(DSRequest optionFilterContext)
autoFetchDisplayMap
is set, this attribute
provides a way to customize the dataSource request issued to
fetch the display map from
the option dataSource.optionFilterContext
- optionFilterContext Default value is nullpublic DSRequest getOptionFilterContext()
autoFetchDisplayMap
is set, this attribute
provides a way to customize the dataSource request issued to fetch the display map from
the option dataSource.public com.google.gwt.event.shared.HandlerRegistration addCellSavedHandler(CellSavedHandler handler)
Same signature as com.smartgwt.client.widgets.grid.ListGrid#addCellChangedHandler
, but defined on a per-field basis.
addCellSavedHandler
in interface HasCellSavedHandlers
handler
- the cellSaved handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addChangeHandler(ChangeHandler handler)
If this field is editable, any change
handler
specified on the ListGridField will be passed onto the editors for this field.
Note that if canToggle
is true, the user may change the value of a
boolean field without going into edit mode by single clicking on the field. In this case the ListGridField.change
and ListGridField.changed
handlers will fire but the
form
and item
parameters will be null.
addChangeHandler
in interface HasChangeHandlers
handler
- the change handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addChangedHandler(ChangedHandler handler)
If this field is editable, any changed
handler specified on the ListGridField will be passed onto the editors for this field. Note that if canToggle
is true, the user may change the value of a
boolean field without going into edit mode by single clicking on the field. In this case the ListGridField.change
and ListGridField.changed
handlers will fire but the
form
and item
parameters will be null.
addChangedHandler
in interface HasChangedHandlers
handler
- the changed handlerHandlerRegistration
used to remove this handlerpublic void setGroupTitleRenderer(GroupTitleRenderer groupTitleRenderer)
groupTitleRenderer
- the group title rendererpublic void setGroupValueFunction(GroupValueFunction groupValueFunction)
GroupTitleRenderer.getGroupTitle(Object, GroupNode, ListGridField, String, ListGrid)
may be implemented to map a numeric group value into a
legible string.groupValueFunction
- the group value functionpublic void setEditorValueMapFunction(EditorValueMapFunction editorValueMapFunction)
editorValueMapFunction
- the editor value map functionpublic void setHeaderButtonProperties(Canvas buttonProperties)
buttonProperties
- the header button properties.public void setSummaryFunction(SummaryFunctionType summaryFunction)
showGridSummary
or showGroupSummary
is true,
this method can be used to
specify a SummaryFunctionType
for calculating the summary value to display.summaryFunction
- summaryFunctionpublic void setSummaryFunction(java.lang.String summaryFunction)
showGridSummary
or showGroupSummary
is true,
this method can be used to
specify the name of a summary function registered via com.smartgwt.client.data.SimpleType#registerSummaryFunction()
for calculating the summary value to display.summaryFunction
- summaryFunctionpublic void setSummaryFunction(SummaryFunction summaryFunction)
showGridSummary
or showGroupSummary
is true,
this method can be used to
specify a SummaryFunction
for calculating the summary value to display.summaryFunction
- summaryFunctiopublic void addSummaryFunction(SummaryFunction summaryFunction)
showGridSummary
or showGroupSummary
is true,
this method can be used to specify a SummaryFunction
for calculating the summary value to display.
Note that by calling this method repeatedly, you can apply more than one summary function to a field. This allows
the developer to set up multi-line summaries - each specified summary function result will show up in a separate
summary row (either at the bottom of the grid or at the end of each group).
Note also that multiple-line summary functions are not compatible with the
com.smartgwt.client.widgets.grid.ListGrid#setShowGroupSummaryInHeader()
feature. If this property is set only the
first summary value will be visible to the user (displayed in the group header node).
summaryFunction
- public void addSummaryFunction(SummaryFunctionType summaryFunction)
showGridSummary
or showGroupSummary
is true,
this method can be used to specify a SummaryFunctionType
for calculating the summary value to display.
Note that by calling this method repeatedly, you can apply more than one summary function to a field. This allows
the developer to set up multi-line summaries - each specified summary function result will show up in a separate
summary row (either at the bottom of the grid or at the end of each group).
Note also that multiple-line summary functions are not compatible with the
com.smartgwt.client.widgets.grid.ListGrid#setShowGroupSummaryInHeader()
feature. If this property is set only the
first summary value will be visible to the user (displayed in the group header node).
summaryFunction
- public void setRecordSummaryFunction(RecordSummaryFunctionType recordSummaryFunction)
"summary"
. Fields of this type will display a calculated value based on the
other field values within the current record. This attribute specifies how the summary field value will be
calculated. See RecordSummaryFunctionType
for valid options.
A subset of the
ListGrid's fields will be passed to the RecordSummaryFunction. Which fields to include is determined based on includeInRecordSummary
If showGridSummary
or showGroupSummary
is true, this field's value in the
summary row[s] will still be calculated by calling this method. In this case, the record object passed in will contain
summary values for each field. If custom handling is required for this case, it may be detected by checking the record
object's isGroupSummary
and isGridSummary
attributes.
recordSummaryFunction
- recordSummaryFunction Default value is nullpublic void setRecordSummaryFunction(RecordSummaryFunction recordSummaryFunction)
"summary"
. Fields of this type will display a calculated value based on the
other field values within the current record. This attribute specifies how the summary field value will be
calculated. See RecordSummaryFunctionType
for valid options.
A subset of the
ListGrid's fields will be passed to the RecordSummaryFunction. Which fields to include is determined based on includeInRecordSummary
If showGridSummary
or showGroupSummary
is true, this field's value in the
summary row[s] will still be calculated by calling this method. In this case, the record object passed in will contain
summary values for each field. If custom handling is required for this case, it may be detected by checking the record
object's isGroupSummary
and isGridSummary
attributes.
recordSummaryFunction
- recordSummaryFunction Default value is nullpublic RecordSummaryFunctionType getRecordSummaryFunction()
"summary"
. Fields of this type will display a calculated value based on the
other field values within the current record. This attribute specifies how the summary field value will be
calculated. See RecordSummaryFunctionType
for valid options.
A subset of the
ListGrid's fields will be passed to the RecordSummaryFunction. Which fields to include is determined based on includeInRecordSummary
If showGridSummary
or showGroupSummary
is true, this field's value in the
summary row[s] will still be calculated by calling this method. In this case, the record object passed in will contain
summary values for each field. If custom handling is required for this case, it may be detected by checking the record
object's isGroupSummary
and isGridSummary
attributes.