public class ListGrid extends VLayout implements DataBoundComponent, HasCellSavedHandlers, HasCellClickHandlers, HasCellContextClickHandlers, HasCellDoubleClickHandlers, HasCellErrorIconHoverHandlers, HasCellErrorIconOutHandlers, HasCellErrorIconOverHandlers, HasCellHoverHandlers, HasCellMouseDownHandlers, HasCellMouseUpHandlers, HasCellOutHandlers, HasCellOverHandlers, HasCellSelectionChangedHandlers, HasCellValueHoverHandlers, HasDataArrivedHandlers, HasDataChangedHandlers, HasDrawAreaChangedHandlers, HasEditCompleteHandlers, HasEditFailedHandlers, HasEditorEnterHandlers, HasEditorExitHandlers, HasFieldStateChangedHandlers, HasFilterEditorSubmitHandlers, HasFormulaUpdatedHandlers, HasGroupByCompleteHandlers, HasGroupStateChangedHandlers, HasGroupByHandlers, HasHeaderDoubleClickHandlers, HasHeaderHoverHandlers, HasHilitesChangedHandlers, HasBodyKeyPressHandlers, HasRecordCollapseHandlers, HasRecordExpandHandlers, HasHeaderClickHandlers, HasRecordClickHandlers, HasRecordDropHandlers, HasRemoveRecordClickHandlers, HasRecordDoubleClickHandlers, HasRowContextClickHandlers, HasRowEditorEnterHandlers, HasRowEditorExitHandlers, HasRowHoverHandlers, HasRowMouseDownHandlers, HasRowMouseUpHandlers, HasRowOutHandlers, HasRowOverHandlers, HasSelectionChangedHandlers, HasSelectionUpdatedHandlers, HasSetSortHandlers, HasSortChangedHandlers, HasSorterClickHandlers, HasSorterContextClickHandlers, HasViewStateChangedHandlers
DataBoundComponent
that displays a list of objects in a grid, where
each row represents one object and each cell in the row represents one property.Editing overview and related methods
config, configOnly, factoryCreated, factoryProperties, id, nativeObject, scClassName
Constructor and Description |
---|
ListGrid() |
ListGrid(DataSource dataSource) |
ListGrid(com.google.gwt.core.client.JavaScriptObject jsObj) |
Modifier and Type | Method and Description |
---|---|
com.google.gwt.event.shared.HandlerRegistration |
addBodyKeyPressHandler(BodyKeyPressHandler handler)
Add a bodyKeyPress handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellClickHandler(CellClickHandler handler)
Add a cellClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellContextClickHandler(CellContextClickHandler handler)
Add a cellContextClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellDoubleClickHandler(CellDoubleClickHandler handler)
Add a cellDoubleClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellErrorIconHoverHandler(CellErrorIconHoverHandler handler)
Add a cellErrorIconHover handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellErrorIconOutHandler(CellErrorIconOutHandler handler)
Add a cellErrorIconOut handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellErrorIconOverHandler(CellErrorIconOverHandler handler)
Add a cellErrorIconOver handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellHoverHandler(CellHoverHandler handler)
Add a cellHover handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellMouseDownHandler(CellMouseDownHandler handler)
Add a cellMouseDown handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellMouseUpHandler(CellMouseUpHandler handler)
Add a cellMouseUp handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellOutHandler(CellOutHandler handler)
Add a cellOut handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellOverHandler(CellOverHandler handler)
Add a cellOver handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellSavedHandler(CellSavedHandler handler)
Add a cellSaved handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellSelectionChangedHandler(CellSelectionChangedHandler handler)
Add a cellSelectionChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCellValueHoverHandler(CellValueHoverHandler handler)
Add a cellValueHover handler.
|
void |
addData(Record newRecord)
Perform a DataSource "add" operation to add new records to this component's DataSource.
|
void |
addData(Record newRecord,
DSCallback callback) |
void |
addData(Record newRecord,
DSCallback callback,
DSRequest requestProperties)
Perform a DataSource "add" operation to add new records to this component's DataSource.
|
com.google.gwt.event.shared.HandlerRegistration |
addDataArrivedHandler(DataArrivedHandler handler)
Add a dataArrived handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDataChangedHandler(DataChangedHandler handler)
Add a dataChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragCompleteHandler(DragCompleteHandler handler)
Add a
com.smartgwt.client.widgets.DragCompleteHandler . |
com.google.gwt.event.shared.HandlerRegistration |
addDrawAreaChangedHandler(DrawAreaChangedHandler handler)
Add a drawAreaChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDropCompleteHandler(DropCompleteHandler handler)
Add a
com.smartgwt.client.widgets.DropCompleteHandler . |
com.google.gwt.event.shared.HandlerRegistration |
addEditCompleteHandler(EditCompleteHandler handler)
Add a editComplete handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEditFailedHandler(EditFailedHandler handler)
Add a editFailed 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.
|
void |
addEmbeddedComponent(Canvas component,
ListGridRecord record)
Attaches the component to the provided record.
|
void |
addEmbeddedComponent(Canvas component,
ListGridRecord record,
java.lang.Integer rowNum) |
void |
addEmbeddedComponent(Canvas component,
ListGridRecord record,
java.lang.Integer rowNum,
java.lang.Integer colNum) |
void |
addEmbeddedComponent(Canvas component,
ListGridRecord record,
java.lang.Integer rowNum,
java.lang.Integer colNum,
EmbeddedPosition position)
Attaches the component to the provided record.
|
com.google.gwt.event.shared.HandlerRegistration |
addFetchDataHandler(FetchDataHandler handler)
Add a fetchData handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addFieldStateChangedHandler(FieldStateChangedHandler handler)
Add a fieldStateChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addFilterEditorSubmitHandler(FilterEditorSubmitHandler handler)
Add a filterEditorSubmit handler.
|
void |
addFormulaField()
Convenience method to display a
com.smartgwt.client..FormulaBuilder to create a new Formula Field. |
com.google.gwt.event.shared.HandlerRegistration |
addFormulaUpdatedHandler(FormulaUpdatedHandler handler)
Add a formulaUpdated handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addGroupByCompleteHandler(GroupByCompleteHandler handler)
Add a groupByComplete handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addGroupByHandler(GroupByHandler handler)
Add a groupBy handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addGroupStateChangedHandler(GroupStateChangedHandler handler)
Add a groupStateChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addHeaderClickHandler(HeaderClickHandler handler)
Add a headerClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addHeaderDoubleClickHandler(HeaderDoubleClickHandler handler)
Add a headerDoubleClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addHeaderHoverHandler(HeaderHoverHandler handler)
Add a headerHover handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addHilitesChangedHandler(HilitesChangedHandler handler)
Add a hilitesChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRecordClickHandler(RecordClickHandler handler)
Add a recordClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRecordCollapseHandler(RecordCollapseHandler handler)
Add a recordCollapse handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRecordDoubleClickHandler(RecordDoubleClickHandler handler)
Add a recordDoubleClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRecordDropHandler(RecordDropHandler handler)
Add a recordDrop handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRecordExpandHandler(RecordExpandHandler handler)
Add a recordExpand handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRemoveRecordClickHandler(RemoveRecordClickHandler handler)
Add a removeRecordClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRowContextClickHandler(RowContextClickHandler handler)
Add a rowContextClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRowEditorEnterHandler(RowEditorEnterHandler handler)
Add a rowEditorEnter handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRowEditorExitHandler(RowEditorExitHandler handler)
Add a rowEditorExit handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRowHoverHandler(RowHoverHandler handler)
Add a rowHover handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRowMouseDownHandler(RowMouseDownHandler handler)
Add a rowMouseDown handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRowMouseUpHandler(RowMouseUpHandler handler)
Add a rowMouseUp handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRowOutHandler(RowOutHandler handler)
Add a rowOut handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRowOverHandler(RowOverHandler handler)
Add a rowOver handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addSelectionChangedHandler(SelectionChangedHandler handler)
Add a selectionChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addSelectionUpdatedHandler(SelectionUpdatedHandler handler)
Add a selectionUpdated handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addSetSortHandler(SetSortHandler handler)
Add a setSort handler.
|
void |
addSort(SortSpecifier sortSpecifier)
Adds another
SortSpecifier to this grid's sort configuration and resorts. |
com.google.gwt.event.shared.HandlerRegistration |
addSortChangedHandler(SortChangedHandler handler)
Add a sortChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addSorterClickHandler(SorterClickHandler handler)
Add a sorterClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addSorterContextClickHandler(SorterContextClickHandler handler)
Add a sorterContextClick handler.
|
void |
addSummaryField()
Convenience method to display a
com.smartgwt.client..SummaryBuilder to create a new Summary Field. |
com.google.gwt.event.shared.HandlerRegistration |
addViewStateChangedHandler(ViewStateChangedHandler handler)
Add a viewStateChanged handler.
|
java.lang.Boolean |
anySelected()
Whether at least one item is selected
|
void |
applyCellData(RecordList cellData)
Applies a set of Records containing coordinate-based data as returned by
getSelectedCellData() and applies the data at the current
selection. |
void |
applyRecordData(RecordList recordData)
Applies a list of Records as changes to the current selection.
|
void |
applySortToData(SortSpecifier... sortSpecifiers)
Sort the grid's data to reflect the parameter sortSpecifiers.
|
void |
askForSort()
Show a dialog to configure the sorting of multiple fields on this component.
|
int |
autoFitField(java.lang.String fieldName)
Programmatically cause a field to auto-fit horizontally to it's contents or title.
|
void |
autoFitFields()
Perform a one-time horizontal auto-fit of the fields passed.
|
void |
autoFitFields(ListGridField... fields)
Perform a one-time horizontal auto-fit of the fields passed.
|
void |
cancelEditing()
Cancel the current edit without saving.
|
boolean |
canEditCell(int rowNum,
int colNum)
Can this cell be edited?
|
boolean |
canExpandRecord(ListGridRecord record,
int rowNum)
Indicates whether a given record or rowNum can be expanded.
|
boolean |
canSelectCell(int rowNum,
int colNum)
If
canSelectCells is set to true then,
whenever an end-user or programmatic cell-selection is attempted, this method is called for each cell in the selection. |
protected boolean |
canSelectRecord(ListGridRecord record)
If
selectionType is not set to "none" ,
this method will be called for each record the user attempts to select. |
java.lang.Boolean |
cellHasChanges(int rowNum,
int colNum)
If this listGrid can be edited, this method will return true if the cell passed in has been edited, but the edits have
not yet been saved to the ListGrid's data object.
|
java.lang.Boolean |
cellHasErrors(int rowNum,
int colIndex)
Given a rowNum and a colNum or fieldName, determine whether we currently have stored
validation errors for the record/field in question.
|
java.lang.Boolean |
cellHasErrors(int rowNum,
java.lang.String fieldID)
Given a rowNum and a colNum or fieldName, determine whether we currently have stored validation errors for the
record/field in question.
|
java.lang.String |
cellValueHoverHTML(ListGridRecord record,
int rowNum,
int colNum,
java.lang.String defaultHTML)
Returns the HTML that is displayed by the default cellValueHover handler.
|
java.lang.Boolean |
cellValueIsClipped(int rowNum,
int colNum)
Is the value in a given cell clipped?
|
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
Canvas defaults)
Changes the defaults for Canvas AutoChildren named
autoChildName . |
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
FormItem defaults)
Changes the defaults for FormItem AutoChildren named
autoChildName . |
FacetChart |
chartData(java.lang.String labelField)
Chart the data in this listGrid as a multi-series chart.
|
FacetChart |
chartData(java.lang.String labelField,
java.lang.String[] dataFields) |
FacetChart |
chartData(java.lang.String labelField,
java.lang.String[] dataFields,
ListGridRecord... dataRows) |
FacetChart |
chartData(java.lang.String labelField,
java.lang.String[] dataFields,
ListGridRecord[] dataRows,
FacetChart chartProperties) |
FacetChart |
chartData(java.lang.String labelField,
java.lang.String[] dataFields,
ListGridRecord[] dataRows,
FacetChart chartProperties,
boolean labelFieldFirst)
Chart the data in this listGrid as a multi-series chart.
|
void |
clearCriteria()
Clear the current criteria used to filter data.
|
void |
clearCriteria(DSCallback callback) |
void |
clearCriteria(DSCallback callback,
DSRequest requestProperties)
Clear the current criteria used to filter data.
|
void |
clearEditValue(int rowNum,
java.lang.String fieldName)
Clear a field value being tracked as an unsaved user edit.
|
void |
clearFieldError(int rowNum,
int fieldName)
Clears any validation errors for some cell.
|
void |
clearFieldError(int rowNum,
java.lang.String fieldName) |
void |
clearRowErrors(int rowNum)
Clear any stored validation errors for some row
|
void |
clearSort()
This method clears any existing sort on this grid by calling
setSort() with a null parameter. |
boolean |
closeGroup(Record record)
Closes the node represented by the "record" parameter, if it is a folder and is not already closed.
|
void |
closeRecord(ListGridRecord record)
Deprecated.
|
void |
collapseRecord(ListGridRecord record)
Collapses a given
record which has been previously expanded
using expandRecord() . |
void |
collapseRecords(ListGridRecord... records)
Collapses the passed list of expanded
records . |
void |
configureGrouping()
Open a MultiGroupDialog to configure the fields used for grouping.
|
protected com.google.gwt.core.client.JavaScriptObject |
create() |
protected Canvas |
createRecordComponent(ListGridRecord record,
java.lang.Integer colNum)
When
showRecordComponents is true, this method
is called to create per-row or per-cell embedded components to display in the grid. |
void |
deselectAllRecords()
Deselect all records
|
void |
deselectRange(int startRow,
int endRow)
Deselect a contiguous range of records by index.
|
void |
deselectRecord(int record)
Deselect a
Record passed in explicitly, or by index. |
void |
deselectRecord(Record record)
Deselect a
Record passed in explicitly, or by index. |
void |
deselectRecords(int[] records)
Deselect a list of
Record s passed in explicitly, or by index. |
void |
deselectRecords(Record[] records)
Deselect a list of
Record s passed in explicitly, or by index. |
void |
disableHilite(java.lang.String hiliteID)
Disable a hilite
|
void |
disableHiliting()
Disable all hilites.
|
void |
discardAllEdits()
Cancel outstanding edits, discarding edit values, and hiding editors for the record[s] passed in if appropriate.
|
void |
discardAllEdits(int[] rows) |
void |
discardAllEdits(int[] rows,
boolean dontHideEditor)
Cancel outstanding edits, discarding edit values, and hiding editors for the record[s] passed in if appropriate.
|
void |
discardEdits(int rowNum,
int colNum)
Cancel outstanding edits for the specified rows, discarding edit values, and hiding editors if appropriate.
|
void |
discardEdits(int rowNum,
int colNum,
java.lang.Boolean dontHideEditor)
Cancel outstanding edits for the specified rows, discarding edit values, and hiding editors if appropriate.
|
protected java.lang.Boolean |
displayHeaderContextMenu(Canvas target,
int[] position)
If
showHeaderContextMenu is true
this method is fired when the user right-clicks on the header for this grid.Default implementation will display a menu with entries derived from ListGrid.getHeaderContextMenuItems for the appropriate column. |
void |
displaySort(SortSpecifier... sortSpecifiers)
Modify the grid UI to reflect the parameter sortSpecifiers.
|
void |
editFields()
Shows a FieldPicker interface allowing end-users to rearrange the order and visibiility
of the fields in the associated DataBoundComponent.
|
void |
editHilites()
Shows a HiliteEditor interface allowing end-users to edit the data-hilites currently in use by this DataBoundComponent.
|
void |
enableHilite(java.lang.String hiliteID)
Enable / disable a
hilites
|
void |
enableHilite(java.lang.String hiliteID,
boolean enable)
Enable / disable a
hilites
|
void |
enableHiliting()
Enable all hilites.
|
void |
enableHiliting(boolean enable)
Enable all hilites.
|
void |
endEditing()
Complete the current edit by storing the value and hiding the inline editor.
|
void |
expandRecord(ListGridRecord record)
Expands a given
record by creating a subcomponent and inserting
it in to the record's grid-row. |
void |
expandRecords(ListGridRecord... records)
Expands the passed list of
records by creating a subcomponent
for each record and inserting them it in to the record's grid-row. |
void |
exportClientData()
Exports this component's data with client-side formatters applied, so is suitable for direct display to users.
|
void |
exportClientData(DSRequest requestProperties) |
void |
exportClientData(DSRequest requestProperties,
RPCCallback callback)
Exports this component's data with client-side formatters applied, so is suitable for direct display to users.
|
void |
exportData()
Uses a "fetch" operation on the current
DataSource
to retrieve data that matches the current filter and sort criteria for this component, then exports the resulting data
to a file or window in the requested format. |
void |
exportData(DSRequest requestProperties)
Uses a "fetch" operation on the current
DataSource
to retrieve data that matches the current filter and sort criteria for this component, then exports the resulting data
to a file or window in the requested format. |
void |
fetchData()
Retrieves data from the DataSource that matches the specified criteria.
|
void |
fetchData(Criteria criteria)
Retrieves data from the DataSource that matches the specified criteria.
|
void |
fetchData(Criteria criteria,
DSCallback callback)
Retrieves data from the DataSource that matches the specified criteria.
|
void |
fetchData(Criteria criteria,
DSCallback callback,
DSRequest requestProperties)
Retrieves data from the DataSource that matches the specified criteria.
|
void |
fetchRelatedData(ListGridRecord record,
Canvas schema)
Based on the relationship between the DataSource this component is bound to and the DataSource specified as the "schema"
argument, call fetchData() to retrieve records in this grid that are related to the passed-in record.
|
void |
fetchRelatedData(ListGridRecord record,
Canvas schema,
DSCallback callback) |
void |
fetchRelatedData(ListGridRecord record,
Canvas schema,
DSCallback callback,
DSRequest requestProperties)
Based on the relationship between the DataSource this component is bound to and the DataSource specified as the "schema"
argument, call fetchData() to retrieve records in this grid that are related to the passed-in record.
|
void |
fetchRelatedData(Record record,
DataSource dataSource) |
void |
fetchRelatedData(Record record,
DataSource dataSource,
DSCallback callback,
DSRequest requestProperties) |
boolean |
fieldIsEditable(int field)
Can the field be edited? This method looks at
canEdit for
the grid as well as the ListGridField.canEdit value,
to determine whether editing is actually allowed. |
boolean |
fieldIsEditable(ListGridField field)
Can the field be edited? This method looks at
canEdit for
the grid as well as the ListGridField.canEdit value,
to determine whether editing is actually allowed. |
boolean |
fieldIsEditable(java.lang.String field)
Can the field be edited? This method looks at
canEdit for
the grid as well as the ListGridField.canEdit value,
to determine whether editing is actually allowed. |
boolean |
fieldIsVisible(java.lang.String field)
Check whether a field is currently visible
|
void |
filterByEditor()
If the filter editor (
showFilterEditor ) is visible
for this grid, this method will perform a filter based on the current values in the editor. |
void |
filterData()
Retrieves data that matches the provided criteria and displays the matching data in this component.
|
void |
filterData(Criteria criteria)
Retrieves data that matches the provided criteria and displays the matching data in this component.
|
void |
filterData(Criteria criteria,
DSCallback callback)
Retrieves data that matches the provided criteria and displays the matching data in this component.
|
void |
filterData(Criteria criteria,
DSCallback callback,
DSRequest requestProperties)
Retrieves data that matches the provided criteria and displays the matching data in this component.
|
Record |
find(AdvancedCriteria adCriteria)
Filters all objects according to the AdvancedCriteria passed and returns the first matching object or null if not found
|
Record[] |
findAll(AdvancedCriteria adCriteria)
Filters all objects according to the AdvancedCriteria passed
|
int |
findIndex(AdvancedCriteria adCriteria)
Finds the index of the first Record that matches with the AdvacendCriteria passed.
|
int[] |
findNextEditCell(int rowNum,
int colNum,
boolean searchForward,
boolean stepThroughFields,
boolean checkStartingCell)
Method to find the next editable cell given a starting row/col, and a direction, either iterating through fields within each row,
or checking the same field in each row.
|
int |
findNextIndex(int startIndex,
AdvancedCriteria adCriteria)
Like
RecordList.findIndex(java.util.Map) , but considering the startIndex parameter. |
int |
findNextIndex(int startIndex,
AdvancedCriteria adCriteria,
int endIndex)
Like
RecordList.findIndex(java.util.Map) , but considering the startIndex and endIndex parameters. |
void |
focusInCell(java.lang.Integer row,
java.lang.Integer col)
Puts keyboard focus into the specified cell, showing a highlighted (roll-over style) appearance, and ensuring that
arrow-key navigation will start from the specified cell.
|
void |
focusInFilterEditor()
If the filter editor (
showFilterEditor ) is visible
for this grid, this method will explicitly put focus into the specified field in the filter editor. |
void |
focusInFilterEditor(java.lang.String fieldName)
If the filter editor (
showFilterEditor ) is visible
for this grid, this method will explicitly put focus into the specified field in the filter editor. |
void |
focusInRow(java.lang.Integer row)
Puts keyboard focus into the specified row, showing a highlighted (roll-over style) appearance, and ensuring that
arrow-key navigation will start from the specified row.
|
void |
freezeField(java.lang.Integer field)
Freeze the indicated field, so that it remains in place and visible when horizontal scrolling occurs.
|
void |
freezeField(ListGridField field)
Freeze the indicated field, so that it remains in place and visible when horizontal scrolling occurs.
|
void |
freezeField(java.lang.String field)
Freeze the indicated field, so that it remains in place and visible when horizontal scrolling occurs.
|
void |
freezeField(java.lang.String[] field)
Freeze the indicated field, so that it remains in place and visible when horizontal scrolling occurs.
|
void |
freezeFields(int[] colNums) |
void |
freezeFields(java.lang.String[] fieldNames) |
java.lang.Boolean |
getAddDropValues()
Indicates whether to add "drop values" to items dropped on this component, if both the source and target widgets are databound, either to the same DataSource or to
different DataSources that are related via a foreign key.
|
java.lang.String |
getAddFormulaFieldText()
Text for a menu item allowing users to add a formula field
|
java.lang.String |
getAddOperation()
operationId this component
should use when performing add operations. |
java.lang.String |
getAddSummaryFieldText()
Text for a menu item allowing users to add a formula field
|
int |
getAdvancedFieldPickerThreshold()
When
useAdvancedFieldPicker is set, total
number of available fields that must be present in the grid before the advanced field picker interface is used instead
of the normal columns submenu. |
int[] |
getAllEditRows()
Returns an array of every rowNum for which we have pending (unsubmitted) edits.
|
ListGridField[] |
getAllFields()
Get the complete array of fields for this ListGrid, including fields that are not currently visible or were specified
implicitly via
dataSource . |
java.lang.Boolean |
getAllowFilterExpressions()
For use with
showFilterEditor :true, allows simple
search expressions to be entered into filter fields, as though DynamicForm.allowExpressions were true. |
java.lang.Boolean |
getAllowFilterOperators()
Causes a menu item titled
"Filter using" to appear
in the headerContextMenu that allows the end
user to pick an advanced search operator to use for this field. |
java.lang.Boolean |
getAllowRowSpanning()
Should cells in this grid be allowed to span multiple rows? If set to
true , the getRowSpan() method will be called for every cell when rendering
out the listGrid to determine how many rows the cell should span. |
java.lang.String |
getAlternateBodyStyleName()
Optional css style to apply to the body if
alternateRecordStyles is true for this grid. |
int |
getAlternateFieldFrequency()
The number of consecutive columns to draw in the same style before alternating, when
alternateColumnStyles is true. |
boolean |
getAlternateFieldStyles()
Whether alternating columns should be drawn in alternating styles, in order to create a vertical "ledger" effect for
easier reading.
|
int |
getAlternateRecordFrequency()
The number of consecutive rows to draw in the same style before alternating, when
alternateRowStyles is true. |
java.lang.Boolean |
getAlternateRecordStyles()
Whether alternating rows should be drawn in alternating styles, in order to create a "ledger" effect for easier reading.
|
java.lang.Boolean |
getAlwaysShowEditors()
When this attribute is set, editors will be rendered into every row of the grid rather than showing up in a single
record at a time.
|
java.lang.Boolean |
getAlwaysShowOperatorIcon()
When
allowFilterOperators is enabled, whether
to show the operatorIcon for all filterable fields, or
only for fields where the user has explicitly chosen a search operator different from the default operator for the
field. |
AnimationAcceleration |
getAnimateFolderEffect()
When animating folder opening / closing, this property can be set to apply an animated acceleration effect.
|
java.lang.Integer |
getAnimateFolderMaxRows()
If
animateFolders is true for this grid, this number
can be set to designate the maximum number of rows to animate at a time when opening / closing a folder. |
java.lang.Boolean |
getAnimateFolders()
If true, when folders are opened / closed children will be animated into view.
|
int |
getAnimateFolderSpeed()
When animating folder opening / closing, this property designates the speed of the animation in pixels shown (or hidden)
per second.
|
int |
getAnimateFolderTime()
When animating folder opening / closing, if
TreeGrid.animateFolderSpeed is not set, this property designates the duration of the animation in ms. |
java.lang.Boolean |
getAnimateRemoveRecord()
When
canRemoveRecords is enabled, should records
be animated out of view when they are removed by the user? |
int |
getAnimateRemoveSpeed()
When
animating record removal , this property
designates the speed of the animation in pixels per second. |
int |
getAnimateRemoveTime()
When animating record removal
(see
animateRemoveRecord) , if animateRemoveSpeed is
not set, this property designates the duration of the animation in ms. |
java.lang.Boolean |
getAnimateRollOver()
If the
rollOverCanvas is enabled, setting this
property to true ensures that when the rollOverCanvas is displayed it is animated into view
via Canvas.animateShow() . |
java.lang.Boolean |
getAnimateRollUnder()
If the
rollUnderCanvas is enabled, setting this
property to true ensures that when the rollUnderCanvas is displayed it is animated into view
via Canvas.animateShow() . |
java.lang.Boolean |
getAnimateSelection()
If the
selectionCanvas is enabled, setting this
property to true ensures that when the selectionCanvas is displayed it is animated into view
via Canvas.animateShow() . |
java.lang.Boolean |
getAnimateSelectionUnder()
If the
selectionUnderCanvas is enabled,
setting this property to true ensures that when the selectionUnderCanvas is displayed it is
animated into view via Canvas.animateShow() . |
java.lang.Boolean |
getApplyFormulaAfterSummary()
If
ListGridField.userFormula is set for some
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. |
boolean |
getApplyRowNumberStyle()
|
java.lang.String |
getArrowKeyAction()
Action to perform when the listGrid has keyboard focus (but not editing focus) and a user presses the up or down arrow
key.
|
java.lang.String |
getAsynchGroupingPrompt()
The prompt to display while interactivity is blocked during
asynchronous grouping . |
AutoComplete |
getAutoComplete()
Whether to do inline autoComplete in text fields during inline editing
Overridden by ListGridField.autoComplete if specified. |
java.lang.Boolean |
getAutoConfirmSaveEdits()
For editable listGrids, outstanding unsaved edits when the user performs a new filter or sort will be discarded by
default.
|
java.lang.Boolean |
getAutoFetchAsFilter()
If
DataBoundComponent.setAutoFetchData(Boolean) is true, this attribute determines whether the initial fetch operation should be
performed via DataBoundComponent.fetchData() or DataBoundComponent.filterData() |
java.lang.Boolean |
getAutoFetchData()
If true, when this component is first drawn, automatically call
DataBoundComponent.fetchData() or DataBoundComponent.filterData() depending on
DataBoundComponent.getAutoFetchAsFilter() . |
java.lang.Boolean |
getAutoFetchDisplayMap()
If true, for fields where
ListGridField.optionDataSource is specified, a valueMap will be automatically created by making a DataSource.fetchData() call against the specified dataSource and
extracting a valueMap from the returned records based on the displayField and valueField. |
TextMatchStyle |
getAutoFetchTextMatchStyle()
If
autoFetchData is true , this attribute allows the developer to specify a textMatchStyle
for the initial DataBoundComponent.fetchData() call. |
java.lang.String |
getAutoFitAllText()
If we're showing a
headerContextMenu for this
grid, and canAutoFitFields is true, this attribute
will be shown as the menu item title for an item to perform a one-time autoFit of all visible fields via the autoFitField() method. |
java.lang.String[] |
getAutoFitClipFields()
If
autoFitFieldWidths is enabled and the
calculated field sizes are wide enough that horizontal scrolling would be introduced, this attribute may be set to an
array of fieldNames, causing those fields to be clipped rather than forcing horizontal scrollbars to appear. |
Autofit |
getAutoFitData()
Should this ListGrid automatically expand to accommodate the size of records and fields?
|
java.lang.String |
getAutoFitExpandField()
The field to expand if
autoFitFieldWidths and
autoFitFieldsFillViewport are enabled and
auto-fitting will not fill all available horizontal space. |
java.lang.Integer |
getAutoFitExtraRecords()
If
autoFitData is set to "vertical" or
"both" this property specifies the number of additional records for which the grid will expand. |
java.lang.Boolean |
getAutoFitFieldsFillViewport()
If
autoFitFieldWidths is enabled, and extra
space is available after autofitting all fields, should the grid automatically expand one field to fill the extra space. |
java.lang.String |
getAutoFitFieldText()
If we're showing a
headerContextMenu for this
grid, and user-driven auto fit of fields is enabled via ListGridField.canAutoFitWidth or canAutoFitFields , this attribute will be shown as the
menu item title for an item to perform a one-time autoFit of the field to its title or content via a call to autoFitField() . |
java.lang.Boolean |
getAutoFitFieldWidths()
Should ListGrid fields autofit their widths to titles or content? This property may be overridden on a per-field basis
via
ListGridField.autoFitWidth . |
java.lang.Boolean |
getAutoFitHeaderHeights()
If this property is set to true, header buttons for either
fields or header spans will automatically expand to
accommodate their titles vertically. |
AutoFitIconFieldType |
getAutoFitIconFields()
Smart GWT listGrids have special logic to automatically size fields that are displayed as an icon - that is fields with
type:"icon" , fields displaying only value icons , and boolean fields (which are rendered
as a checkmark type icon by default. |
int |
getAutoFitMaxColumns()
If
autoFitData is set to "horizontal" or
"both" this property provides the maximum number of columns for which the ListGrid will expand. |
java.lang.Integer |
getAutoFitMaxHeight()
If
autoFitData is set to "vertical" or
"both" this property provides an upper limit on how far the ListGrid will expand vertically to accommodate
its content. |
int |
getAutoFitMaxRecords()
If
autoFitData is set to "vertical" or
"both" this property provides the maximum number of records for which the ListGrid will expand. |
java.lang.Integer |
getAutoFitMaxWidth()
If
autoFitData is set to "horizontal" or
"both" this property provides an upper limit on how far the ListGrid will expand horizontally to
accommodate its content. |
AutoFitWidthApproach |
getAutoFitWidthApproach()
When a user requests column autofitting via the
header context menu or via a mouse gesture , what autofit approach is used. |
java.lang.Boolean |
getAutoSaveEdits()
If this ListGrid is editable, should edits be saved out when the user finishes editing a row (or a cell if
saveByCell is true). |
java.lang.Boolean |
getAutoSizeHeaderSpans()
If this listGrid has specified
headerSpans , setting
this attribute to true will cause spans to expand to accommodate long titles if necessary. |
Canvas |
getBackgroundComponent()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
java.lang.String |
getBadFormulaResultValue()
If the result of a formula evaluation is invalid (specifically, if isNaN(result)==true), badFormulaResultValue is
displayed instead.
|
java.lang.String |
getBaseStyle()
base cell style for this listGrid. |
protected java.lang.String |
getBaseStyle(ListGridRecord record,
int rowNum,
int colNum)
Return the base styleName for this cell.
|
GridRenderer |
getBody()
Returns the primary body, which, when there are frozen fields, is the
com.smartgwt.client.grid.GridRenderer
used to render the non-frozen portion of the dataset; otherwise, the primary body (the
only body) is the GridRenderer used to render the entire dataset. |
java.lang.String |
getBodyBackgroundColor()
Background color applied to the ListGrid body (that is, the area of the grid where data values are rendered).
Note that this will typically not be visible to the user unless there are few enough rows that there is visible space in the body below the last row. |
Overflow |
getBodyOverflow()
Overflow setting for the "body", that is, the area of the grid where data values are rendered.
|
java.lang.Integer |
getBodyScrollLeft()
Get the current scrollLeft for the body of this ListGrid
|
java.lang.Integer |
getBodyScrollTop()
Get the current scrollTop for the body of this ListGrid
|
java.lang.String |
getBodyStyleName()
CSS style used for the body of this grid.
|
java.lang.String |
getBooleanBaseStyle()
An optional CSS style to apply to the checkbox image.
|
java.lang.String |
getBooleanFalseImage()
Image to display for a false value in a boolean field.
|
int |
getBooleanImageHeight()
|
int |
getBooleanImageWidth()
|
java.lang.String |
getBooleanPartialImage()
Image to display for a partially true value in a boolean field (typically selection).
|
java.lang.String |
getBooleanTrueImage()
Image to display for a true value in a boolean field.
|
java.lang.Boolean |
getCanAcceptDroppedRecords()
Indicates whether records can be dropped into this listGrid.
|
java.lang.Boolean |
getCanAddFormulaFields()
Adds an item to the header context menu allowing users to launch a dialog to define a new
field based on values present in other fields, using the
com.smartgwt.client..FormulaBuilder .
|
java.lang.Boolean |
getCanAddSummaryFields()
Adds an item to the header context menu allowing users to launch a dialog to define a new
text field that can contain both user-defined text and the formatted values present in other
fields, using the
com.smartgwt.client..SummaryBuilder .
|
java.lang.Boolean |
getCanAutoFitFields()
Can the user perform one-time autofit for specific columns in this grid?
|
java.lang.String |
getCancelEditingConfirmationMessage()
If this is an editable listGrid, and
this.confirmCancelEditing is true this property is used as the message
to display in the confirmation dismissal prompt. |
java.lang.Boolean |
getCanCollapseGroup()
Can a group be collapsed/expanded? When true a collapse/expand icon is shown (
groupIcon ) and the user can collapse or expand the group by
clicking either the row as a whole or the opener icon (see collapseGroupOnRowClick ); When false the group
icon is not shown and clicking on the row does not change group state. |
java.lang.Boolean |
getCanDragRecordsOut()
Indicates whether records can be dragged from this listGrid and dropped elsewhere.
|
java.lang.Boolean |
getCanDragSelect()
If this property is true, users can drag the mouse to select several rows or cells.
|
java.lang.Boolean |
getCanDragSelectText()
If this property is true, users can drag the mouse to select text within grid rows.
|
java.lang.Boolean |
getCanDropInEmptyArea()
If set to false, dropping over an empty part of the grid body is disallowed and the no-drop indicator is displayed.
|
java.lang.Boolean |
getCanEdit()
Can the user edit cells in this listGrid? Can be set for the listGrid, and overridden for individual fields.
If 'canEdit' is false at the listGrid level, fields can never be edited - in this case the canEdit property on individual fields will be ignored. If 'canEdit' is set to true at the listGrid level, setting the 'canEdit' property to false at the field level will prevent the field from being edited inline. If 'canEdit' is not set at the listGrid level, setting 'canEdit' to true at the field level enables the field to be edited inline. |
java.lang.String |
getCanEditFieldAttribute()
If this component is bound to a dataSource, this attribute may be specified to customize what fields from the dataSource
may be edited by default.
|
boolean |
getCanEditHilites()
Adds an item to the header context menu allowing users to launch a dialog to define grid hilites using the
HiliteEditor . |
boolean |
getCanEditTitles()
If set to true, the
advanced field picker
provides an interface allowing users to modify fields' titles. |
java.lang.Boolean |
getCanExpandMultipleRecords()
When
canExpandRecords is true, this property
indicates whether multiple records can be expanded simultaneously. |
java.lang.String |
getCanExpandRecordProperty()
Property name on a record that will be checked to determine whether a record can be expanded.
|
java.lang.Boolean |
getCanExpandRecords()
When set to true, shows an additional field at the beginning of the field-list (respecting RTL) to allow users to expand
and collapse individual records.
|
boolean |
getCanFocusInEmptyGrid()
If the listGrid is empty, should the user be able to put focus into the grid body by tabbing to it?
|
java.lang.Boolean |
getCanFreezeFields()
Whether an interface should be shown to allow user is allowed to dynamically "freeze" or "unfreeze" columns with respect
to horizontally scrolling.
|
java.lang.Boolean |
getCanGroupBy()
If false, grouping via context menu will be disabled.
|
java.lang.Boolean |
getCanHover()
If true, cellHover and rowHover events will fire and then a hover will be shown (if not canceled) when the user leaves
the mouse over a row / cell unless the corresponding field has
showHover set to false. |
boolean |
getCanMultiGroup()
When true, indicates that this ListGrid supports grouping on multiple fields.
|
java.lang.Boolean |
getCanMultiSort()
When true, indicates that this ListGrid supports sorting on multiple fields.
|
java.lang.Boolean |
getCanPickFields()
Indicates whether the field picker item and submenu should be present in the header context menu.
|
java.lang.Boolean |
getCanPickOmittedFields()
If this grid has a specified
dataSource , and useAllDataSourceFields is false, setting this
property to true will cause all dataSource fields not included in the specified set of fields to show up in the field picker menu item . |
java.lang.Boolean |
getCanRemoveRecords()
If set, provide UI for the user to remove records from the grid as an additional field showing the
removeIcon , which, when clicked, will call removeRecordClick() which removes the row from the data set
(or if deferRemoval is true changes the markRecordRemoved() status for the record). |
java.lang.Boolean |
getCanReorderFields()
Indicates whether fields in this listGrid can be reordered by dragging and dropping header fields.
|
java.lang.Boolean |
getCanReorderRecords()
Indicates whether records can be reordered by dragging within this
ListGrid . |
java.lang.Boolean |
getCanResizeFields()
Indicates whether fields in this listGrid can be resized by dragging header fields.
|
java.lang.Boolean |
getCanSelectAll()
Controls whether a checkbox for selecting all records appears in the header with
selectionAppearance set to "checkbox" |
java.lang.Boolean |
getCanSelectCells()
Enables cell-level selection behavior as well as
cell-level rollover . |
boolean |
getCanSelectGroups()
Controls whether a checkbox for selecting
groups appears in
the group node if SelectionAppearance is set to "checkbox" |
java.lang.Boolean |
getCanSort()
Enables or disables interactive sorting behavior for this listGrid.
|
java.lang.Boolean |
getCanTabToHeader()
Should the header be included in the tab-order for the page? If not explicitly specified, the header will be included in
the tab order for the page if
isc.setScreenReaderMode() is
called. |
Layout |
getCellContextMenu()
The menu displayed when a cell is right clicked on.
|
protected java.lang.String |
getCellCSSText(ListGridRecord record,
int rowNum,
int colNum)
Return CSS text for styling this cell, which will be applied in addition to the CSS class for the cell, as overrides.
|
java.lang.String[] |
getCellErrors(int rowNum,
java.lang.String fieldName)
Returns the current set of errors for this cell.
|
int |
getCellHeight()
The default height of each row in pixels.
|
protected Canvas |
getCellHoverComponent(Record record,
java.lang.Integer rowNum,
java.lang.Integer colNum)
When
showHoverComponents is set, this method is
called to get the component to show as a hover for the current cell. |
int |
getCellPadding()
The amount of empty space, in pixels, surrounding each value in its cell.
|
java.lang.Integer[] |
getCellPageRect(int rowNum,
int colNum)
Returns the page offsets and size of the cell at the passed row and column.
|
int |
getCellRowSpan(int rowNum,
int colNum)
When using
row spanning , returns the number of cells
spanned by the cell at the given coordinates. |
CellSelection |
getCellSelection()
When
canSelectCells is active, returns the CellSelection object that tracks and manages the current selection. |
int |
getCellStartRow(int rowNum,
int colNum)
When using
row spanning , returns the row number where a
row-spanning cell starts. |
protected java.lang.String |
getCellStyle(ListGridRecord record,
int rowNum,
int colNum)
Return the CSS class for a cell.
|
java.lang.String |
getChartConstructor()
Name of the Smart GWT Class to be used when creating charts.
|
ChartType |
getChartType()
Default type of chart to plot.
|
java.lang.String |
getCheckboxFieldFalseImage()
If
selectionAppearance is set to
"checkbox" this property determines the image to display in the checkbox field for an unselected row. |
java.lang.Integer |
getCheckboxFieldImageHeight()
If
selectionAppearance is set to
"checkbox" this property may be set to govern the height of the checkbox image displayed to indicate
whether a row is selected. |
java.lang.Integer |
getCheckboxFieldImageWidth()
If
selectionAppearance is set to
"checkbox" this property may be set to govern the width of the checkbox image displayed to indicate whether
a row is selected. |
java.lang.String |
getCheckboxFieldPartialImage()
If
selectionAppearance is set to
"checkbox" this property determines the image to display in the checkbox field for a partially selected
row. |
java.lang.String |
getCheckboxFieldTrueImage()
If
selectionAppearance is set to
"checkbox" this property determines the image to display in the checkbox field for a selected row. |
ExpansionMode |
getChildExpansionMode()
For
expansionModes that show another grid or tree, what the child's
expansionMode should be. |
java.lang.String |
getClearAllSortingText()
If we're showing a
headerContextMenu for this
grid, this attribute will be shown as the menu item title to clear any existing sort on all fields. |
java.lang.String |
getClearFilterText()
If we're showing a
headerContextMenu for this
grid, and a filter-editor is visible, this
attribute will be shown as the menu item title to clear any existing filter. |
java.lang.String |
getClearSortFieldText()
If we're showing a
headerContextMenu for this
grid, this attribute will be shown as the menu item title to clear an existing sort on this field. |
java.lang.Boolean |
getClipHeaderTitles()
Whether the ListGrid should manage the clipping of titles of header buttons, showing ellipses if the title is clipped,
and potentially showing the full title on
hover . |
boolean |
getCollapseGroupOnRowClick()
If
canCollapseGroup is true, will a click anywhere
on the group row toggle the group's expanded state? If false, the user must click the groupIcon directly to toggle the group. |
java.lang.Integer |
getColumnLeft(java.lang.Integer colNum)
Return the left offset (in local coordinate space) of a particular column.
|
java.lang.Integer |
getColumnPageLeft(java.lang.Integer colNum)
Return the left coordinate for a given column number as a GLOBAL coordinate
|
java.lang.Integer |
getColumnWidth(int colNum)
Return the width of a particular column.
|
java.lang.String |
getConfigureGroupingText()
If we're showing a
headerContextMenu for this
grid, and multi-grouping is enabled, this attribute is used as the title for a menu item that opens a MultiGroupDialog to configure the grouping for this grid. |
java.lang.String |
getConfigureSortText()
If we're showing a
headerContextMenu for this
grid, and multi-sorting is enabled, this attribute is used as the title for a menu item that opens a MultiSortDialog to configure the sort-specification for this grid. |
java.lang.Boolean |
getConfirmCancelEditing()
If this is an editable listGrid, when the user attempts to cancel an edit, should we display a confirmation prompt
before discarding the edited values for the record?
|
java.lang.Boolean |
getConfirmDiscardEdits()
For editable listGrids, outstanding unsaved edits when the user performs a new filter or sort will be discarded.
|
java.lang.String |
getConfirmDiscardEditsMessage()
If
this.confirmDiscardEdits is true, this property can be used to customize the error message string
displayed to the user in a dialog with options to cancel the action, or save or discard pending edits in response to
sort/filter actions that would otherwise drop unsaved edit values. |
Criteria |
getCriteria()
Retrieves a copy of the current criteria for this component (may be null).
|
Canvas |
getCurrentExpansionComponent(java.lang.Integer record)
Returns the expansion component derived from
getExpansionComponent() currently visible in some record, or null if the specified record is not showing an expansion
component. |
Canvas |
getCurrentExpansionComponent(ListGridRecord record)
Returns the expansion component derived from
getExpansionComponent() currently visible in some record, or null if the specified record is not showing an expansion
component. |
java.lang.Integer[] |
getCurrentFieldWidths()
Returns an array of widths of the visible fields in this
ListGrid , in px. |
com.google.gwt.core.client.JavaScriptObject |
getDataAsJSList() |
RecordList |
getDataAsRecordList()
Return the grid data as a
RecordList . |
java.lang.Integer |
getDataFetchDelay()
Delay in milliseconds before fetching data.
|
FetchMode |
getDataFetchMode()
How to fetch and manage records retrieve from the server.
|
int |
getDataPageSize()
When using
data
paging , how many records to fetch at a time. |
DataSource |
getDataSource()
The DataSource that this component should bind to for default fields and for performing
DataSource requests . |
DateDisplayFormat |
getDateFormatter()
How should Date type values be displayed in this ListGrid by default?
|
DateDisplayFormat |
getDatetimeFormatter()
Display format to use for fields specified as type 'datetime'.
|
java.lang.Boolean |
getDeepCloneOnEdit()
Before we start editing values in this DataBoundComponent, should we perform a deep clone
of the underlying values.
|
ListGridField[] |
getDefaultFields()
An array of listGrid field configuration objects.
|
OperatorId |
getDefaultFilterOperator()
Default
filter operator to use for text-based fields in this grid's filter editor , when producing AdvancedCriteria . |
java.lang.String |
getDefaultFilterOperatorSuffix()
Text to show after the name of the default filterOperator in the
headerContextMenu when allowFilterOperators is enabled. |
java.lang.String |
getDefaultFormattedFieldValue(Record record,
ListGridField field)
Get a field value for some record with default field formatters applied.
|
java.lang.String |
getDefaultFormattedFieldValue(Record record,
ListGridField field,
int rowNum) |
java.lang.String |
getDefaultFormattedFieldValue(Record record,
ListGridField field,
int rowNum,
int colNum)
Get a field value for some record with default field formatters applied.
|
java.lang.String |
getDefaultFormattedValue(Record record,
int rowNum,
int colNum)
Get the value for some cell with default formatters applied.
|
java.lang.Boolean |
getDeferRemoval()
When enabled, the field shown by
canRemoveRecords
causes records to be marked for future removal via markRecordRemoved() instead of immediately being removed. |
java.lang.String |
getDetailDS()
If
canExpandRecords is true and listGrid.expansionMode is "related" , this property specifies the
dataSource for the related records grid to be shown embedded in expanded records. |
java.lang.String |
getDetailField()
The field whose contents to show in the expanded portion of a record when
canExpandRecords is true and listGrid.expansionMode is detailField . |
boolean |
getDiscardEditsOnHideField()
If a user is editing a
canEdit:true listGrid, and they hide
a field while the editor is showing, should we discard any edits in the edit row for the field being hidden? |
java.lang.String |
getDiscardEditsSaveButtonTitle()
If
confirmDiscardEdits is true this is the
title for the save button appearing in the lost edits confirmation dialog. |
java.lang.Object |
getDisplayValue(java.lang.String fieldName,
boolean value)
Given a field with a specified
valueMap
or displayField ,
this method will return the display value for any underlying data value. |
java.lang.Object |
getDisplayValue(java.lang.String fieldName,
java.util.Date value)
Given a field with a specified
valueMap
or displayField ,
this method will return the display value for any underlying data value. |
java.lang.Object |
getDisplayValue(java.lang.String fieldName,
float value)
Given a field with a specified
valueMap
or displayField ,
this method will return the display value for any underlying data value. |
java.lang.Object |
getDisplayValue(java.lang.String fieldName,
int value)
Given a field with a specified
valueMap
or displayField ,
this method will return the display value for any underlying data value. |
java.lang.Object |
getDisplayValue(java.lang.String fieldName,
java.lang.String value)
Given a field with a specified
valueMap
or displayField ,
this method will return the display value for any underlying data value. |
Record[] |
getDragData()
During a drag-and-drop interaction, this method returns the set of records being dragged out of the component.
|
DragDataAction |
getDragDataAction()
Indicates what to do with data dragged into another DataBoundComponent.
|
int |
getDragScrollRedrawDelay()
Like
scrollRedrawDelay , but applies when the
component is being drag-scrolled (via a scrollbar). |
DragTrackerMode |
getDragTrackerMode()
When records are being dragged from within a ListGrid, what sort of drag-tracker should be displayed?
Note that if multiple records are being dragged the displayed tracker will be based on the first selected record. |
java.lang.String |
getDragTrackerStyle()
CSS Style to apply to the drag tracker when dragging occurs on this component.
|
float |
getDrawAheadRatio()
How far should we render rows ahead of the currently visible area? This is expressed as a ratio from viewport size to
rendered area size.
|
int |
getDrawAllMaxCells()
If drawing all rows would cause less than
drawAllMaxCells cells to be rendered, the full dataset will
instead be drawn even if showAllRecords is false and
the viewport size and drawAheadRatio setting would
normally have caused incremental rendering to be used. |
java.lang.Integer[] |
getDrawArea()
Returns the extents of the rows and columns currently visible in this grid's viewport.
|
int |
getDrawnRowHeight(int rowNum)
Get the drawn height of a row.
|
java.lang.Integer[] |
getDrawnRows()
Get the rows that are currently drawn (exist in the DOM), as an array of [firstRowNum, lastRowNum].
|
java.util.Map |
getDropValues()
When an item is dropped on this component, and
addDropValues is true and both the source and
target widgets are databound, either to the same DataSource or to different DataSources that are related via a foreign key, this object provides the "drop values" that
Smart GWT will apply to the dropped object before updating it. |
java.lang.String |
getDuplicateDragMessage()
Message to show when a user attempts to transfer duplicate records into this component, and
preventDuplicates
is enabled. |
java.lang.Boolean |
getEditByCell()
Determines whether when the user edits a cell in this listGrid the entire row becomes editable, or just the cell that
received the edit event.
|
int |
getEditCol()
Returns the index of the column being edited or -1 if there is no current edit column.
|
java.lang.Object |
getEditedCell(int record,
int field)
Returns the current value of a cell.
|
java.lang.Object |
getEditedCell(int rowNum,
java.lang.String fieldName) |
java.lang.Object |
getEditedCell(Record record,
int colNum) |
java.lang.Object |
getEditedCell(Record record,
java.lang.String fieldName) |
Record |
getEditedRecord(int rowNum)
Returns the combination of unsaved edits (if any) and original values (if any) for a given row being edited.
|
ListGridEditEvent |
getEditEvent()
Event that will trigger inline editing, see
ListGridEditEvent for options. |
java.lang.String |
getEditFailedBaseStyle()
A base name for the CSS class applied to cells when editing has failed.
If this listGrid is editable, this style will be applied to any edited cells for which validation failed. As with the default 'baseStyle' property, this style will have "Dark", "Over", "Selected", or "Disabled" appended to it according to the state of the cell. If null, cells for which editing has failed will be rendered using the normal base style classNames, but with custom CSSText applied as derived from this.editFailedCSSText |
java.lang.String |
getEditFailedCSSText()
Custom CSS text to be applied to cells when editing has failed.
If this listGrid is editable, this css text will be applied to any edited cells for which validation failed, on top of the base style for the cell. For further customization of styling for cells that failed editing validation, use this.editFailedBaseStyle instead. |
FormItem |
getEditFormItem(java.lang.Integer field)
Method to retrieve a live edit form item for an
editable
ListGrid. |
FormItem |
getEditFormItem(java.lang.String field)
Method to retrieve a live edit form item for an
editable
ListGrid. |
java.lang.String |
getEditFormulaFieldText()
Text for a menu item allowing users to edit a formula field
|
java.lang.Boolean |
getEditOnF2Keypress()
Should we start editing when the widget has focus and the user presses the "f2" key (if this ListGrid supports editing)?
|
java.lang.Boolean |
getEditOnFocus()
Should we start editing when this widget receives focus (if this ListGrid supports editing)?
|
java.lang.String |
getEditPendingBaseStyle()
A base name for the CSS class applied to cells containing pending (unsaved) edits
As with the default 'baseStyle' property, this style will have "Dark", "Over", "Selected", or "Disabled" appended to it according to the state of the cell. |
java.lang.String |
getEditPendingCSSText()
Custom CSS text to be applied to cells with pending edits that have not yet been submitted.
For further customization of styling for cells with pending edits use this.editPendingBaseStyle instead. |
java.lang.String |
getEditProxyConstructor()
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode . |
int |
getEditRow()
Returns the index of the row being edited or -1 if there is no current edit row.
|
java.lang.String |
getEditSummaryFieldText()
Text for a menu item allowing users to edit the formatter for a field
|
java.lang.Object |
getEditValue(int rowNum,
int colNum)
Returns the current temporary locally stored edit value for some field within a record being edited.
|
java.lang.Object |
getEditValue(int rowNum,
java.lang.String fieldName)
Returns the current temporary locally stored edit value for some field within a record being edited.
|
java.lang.Boolean |
getEditValueAsBoolean(int rowNum,
java.lang.String fieldName)
Returns the current temporary locally stored edit value for some field within a record being edited.
|
java.util.Date |
getEditValueAsDate(int rowNum,
java.lang.String fieldName)
Returns the current temporary locally stored edit value for some field within a record being edited.
|
java.lang.Float |
getEditValueAsFloat(int rowNum,
java.lang.String fieldName)
Returns the current temporary locally stored edit value for some field within a record being edited.
|
java.lang.Integer |
getEditValueAsInt(int rowNum,
java.lang.String fieldName)
Returns the current temporary locally stored edit value for some field within a record being edited.
|
Record |
getEditValueAsRecord(int rowNum,
java.lang.String fieldName)
Returns the current temporary locally stored edit value for some field within a record being edited.
|
Record[] |
getEditValueAsRecordArray(int rowNum,
java.lang.String fieldName)
Returns the current temporary locally stored edit value for some field within a record being edited.
|
java.lang.String |
getEditValueAsString(int rowNum,
java.lang.String fieldName)
Returns the current temporary locally stored edit value for some field within a record being edited.
|
java.util.Map |
getEditValues(int rowNum)
Returns the current set of unsaved edits for a given row being edited.
|
java.util.Map |
getEditValues(Record record)
Returns the current set of unsaved edits for a given row being edited.
|
java.lang.String |
getEmptyCellValue()
The value to display for cells whose value is null or the empty string after applying
formatting and valueMap (if any). |
java.lang.String |
getEmptyMessage()
The string to display in the body of a listGrid with an empty data array, if showEmptyMessage is true.
|
java.lang.String |
getEmptyMessageStyle()
The CSS style name applied to the
emptyMessage if
displayed. |
java.lang.Boolean |
getEnforceVClipping()
For performance reasons, even when
fixedRecordHeights is set, vertical clipping is not enforced by default for some kinds of content (such as images) on
all browsers. |
EnterKeyEditAction |
getEnterKeyEditAction()
What to do when a user hits enter while editing a cell: "nextCell": start editing the next editable cell in
this record (or the first editable cell in the next record if focus is in the last editable cell in the row)
"nextRow": start editing the same field in the next row (skipping any rows where that would be a non-editable
cell.
|
java.lang.Boolean |
getEnumCriteriaAsInitialValues()
In a ListGrid that has a DataSource and has filter criteria that include values for fields declared as
type "enum" in the DataSource, by default a newly edited row will use those filter
criteria as initial values. |
java.lang.Integer |
getErrorIconHeight()
Height of the error icon, if we're showing icons when validation errors occur.
|
java.lang.String |
getErrorIconSrc()
Src of the image to show as an error icon, if we're showing icons when validation errors occur.
|
java.lang.Integer |
getErrorIconWidth()
Height of the error icon, if we're showing icons when validation errors occur.
|
EscapeKeyEditAction |
getEscapeKeyEditAction()
What to do when a user hits escape while editing a cell: "cancel": close the editor and discard the current set
of edit values "done": just close the editor (the edit is complete, but the edited values are retained).
|
int |
getEventColumn()
Returns the column number of the most recent mouse event.
|
int |
getEventColumn(java.lang.Integer x)
Returns the column number of the most recent mouse event.
|
int |
getEventRow()
Returns the row number of the most recent mouse event.
|
int |
getEventRow(java.lang.Integer y)
Returns the row number of the most recent mouse event.
|
ListGridRecord[] |
getExpandedRecords()
|
java.lang.Boolean |
getExpansionCanEdit()
For
expansionModes that show another grid or tree, is that component
editable? |
protected Canvas |
getExpansionComponent(ListGridRecord record)
Gets the embedded-component to show as a given record's expansionComponent.
|
ExpansionComponentPoolingMode |
getExpansionComponentPoolingMode()
The method of
component-pooling to employ for expansionComponents . |
HTMLFlow |
getExpansionDetailField()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
HLayout |
getExpansionDetailRelated()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
DetailViewer |
getExpansionDetails()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
DynamicForm |
getExpansionEditor()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
java.lang.Boolean |
getExpansionEditorCollapseOnSave()
When
ExpansionMode is editor, should the row be collapsed following a save
initiated by the expansion-component's save button . |
IButton |
getExpansionEditorSaveButton()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
java.lang.String |
getExpansionEditorSaveButtonTitle()
The title for the
expansionEditorSaveButton . |
java.lang.String |
getExpansionEditorSaveDialogPrompt()
When
canExpandRecords is true and expansionMode is editor, the prompt to display in a
dialog when an expanded row is collapsed while it's nested editor has changed values. |
java.lang.Boolean |
getExpansionEditorShowSaveDialog()
When
canExpandRecords is true and expansionMode is editor, whether a dialog should be
displayed when an expanded row is collapsed while it's nested editor has changed values. |
ListGridField |
getExpansionField()
The field providing the facility to expand and collapse rows.
|
java.lang.String |
getExpansionFieldFalseImage()
If
canExpandRecords is set to true ,
this property determines the image to display in the expansion field for collapsed rows. |
java.lang.Integer |
getExpansionFieldImageHeight()
If
canExpandRecords is set to true ,
this property may be set to govern the height of the expansion image displayed to indicate whether a row is expanded. |
java.lang.Integer |
getExpansionFieldImageWidth()
If
canExpandRecords is set to true ,
this property may be set to govern the width of the expansion image displayed to indicate whether a row is expanded. |
java.lang.String |
getExpansionFieldTrueImage()
If
canExpandRecords is set to true ,
this property determines the image to display in the expansion field for expanded rows. |
VLayout |
getExpansionLayout()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
ExpansionMode |
getExpansionMode()
The
ExpansionMode for records in this grid. |
ListGrid |
getExpansionRelated()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
java.lang.Boolean |
getExportAll()
Setting exportAll to true prevents the component from passing its list of fields to the
export call.
|
java.lang.String |
getExportAlternateRowBGColor()
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , background color
to use for even-numbered rows, to create a "banded" or "ledger" effect. |
java.lang.String |
getExportBGColor(int rowNum,
int colNum,
Record record)
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , background color
to use for the cell at the given rowNum and colNum. |
java.lang.String |
getExportColumnBGColor(int colNum)
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , background color
to use for the given colNum. |
java.lang.String |
getExportDefaultBGColor()
Default background color to use when exporting data to Excel/OpenOffice format using
exportData() or exportClientData() . |
boolean |
getExportFieldAlignments()
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , whether field
horizontal header alignments and data value alignments should be replicated in the resulting
spreadsheet. |
java.lang.String[] |
getExportFields()
The list of field-names to export.
|
boolean |
getExportFieldWidths()
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , whether widths
of fields should be replicated in the resulting spreadsheet. |
boolean |
getExportHeaderHeights()
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , causes the
headerHeight and headerSpan heights to be applied to the corresponding cells in
the spreadsheet. |
java.lang.Boolean |
getExportRawValues()
Dictates whether the data in this grid should be exported raw by
exportClientData() . |
java.lang.String |
getExportRowBGColor(int rowNum,
Record record)
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , background color
to use for the given rowNum. |
double |
getExportWidthScale()
Scaling factor to translate from ListGrid field widths in pixels to Excel/OpenOffice units for field width, which are
1/256th of the width of the widest digit character in the default font for the spreadsheet.
|
boolean |
getExportWrapHeaderTitles()
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , whether titles
in the ListGrid header and headerSpans should be allowed to wrap. |
int |
getFetchDelay()
If we're showing the filterEditor (
showFilterEditor is true), and we're re-filtering on every keypress (filterOnKeypress is true), this property is the delay in
milliseconds between the user changing the filter and the filter request being kicked off. |
java.lang.String |
getFetchOperation()
Operation ID this component should use when performing fetch operations.
|
ListGridField |
getField(int colNum)
Given a column number or field name, return the field definition of a field which is visible in the grid.
|
ListGridField |
getField(java.lang.String fieldName)
Given a column number or field name, return the field definition.
|
Alignment[] |
getFieldAlignments()
Returna an array of field alignments for this grid
|
ListGridField |
getFieldByName(java.lang.String fieldName)
Given a field name, return the appropriate field definition.
|
java.lang.Integer |
getFieldContentWidth(ListGridField field)
Returns the pixel width of the content of a visible field in this grid.
|
int |
getFieldCount()
Return the number of fields.
|
java.lang.String |
getFieldName(int colNum)
Given a column number or field id, return the field name of a field.
|
int |
getFieldNum(int fieldID)
Given a field or field id, return it's index in the fields array
|
int |
getFieldNum(java.lang.String fieldID)
Given a field or field id, return it's index in the fields array
|
java.lang.String[] |
getFieldPickerFieldProperties()
Names of properties on
ListGridField for which the FieldPicker should show an editing interface, for convenience. |
java.lang.Boolean |
getFieldPickerShowSampleValues()
When set to false, sample values of the FieldPicker are never shown.
|
FieldPickerWindow |
getFieldPickerWindow()
Instance of
FieldPickerWindow used if useAdvancedFieldPicker is set. |
ListGridField[] |
getFields()
An array of field objects, specifying the order, layout, formatting, and sorting behavior of each field in the listGrid
object.
|
com.google.gwt.core.client.JavaScriptObject[] |
getFieldsAsJavaScriptObjects()
Return the fields as JavaScriptObjects rather than as SmartGWT Java wrappers of the field
class type
(e.g.
|
java.lang.String |
getFieldState()
Initial
field state for the grid. |
java.lang.String |
getFieldTitle(int fieldId)
Return the title of a field, specified by name or index.
|
java.lang.String |
getFieldTitle(java.lang.String fieldId)
Return the title of a field, specified by name or index.
|
java.lang.String |
getFieldVisibilitySubmenuTitle()
If we're showing a
headerContextMenu for this
grid, and this.canPickFields is true, this attribute
will be shown as the title for the menu item which contains a submenu with items allowing the user to show and hide
fields in the grid. |
java.lang.Integer |
getFieldWidth(int fieldNum)
Returns a numeric value for the width of some field within this
ListGrid . |
java.lang.Integer |
getFieldWidth(java.lang.String fieldName)
Returns a numeric value for the width of some field within this
ListGrid . |
java.lang.String |
getFilterButtonPrompt()
The prompt to show when the mouse hovers over the Filter button in the FilterEditor.
|
Button |
getFilterButtonProperties()
If
showFilterEditor is true, this attribute may be
used to customize the filter button shown to the right of the filterEditor row. |
java.lang.Boolean |
getFilterByCell()
If we're showing the filterEditor (this.showFilterEditor is true), this property determines whether this list should be
filtered every time the user puts focus in a different field in the filter editor.
|
RecordEditor |
getFilterEditor()
If
showFilterEditor is set to true, the
filterEditor is automatically created as an AutoChild.Developers may customize the AutoChild using filterEditorProperties . |
Criteria |
getFilterEditorCriteria()
If
showFilterEditor is true, this method will
return the criteria currently displayed in the filterEditor . |
Criteria |
getFilterEditorCriteria(java.lang.Boolean omitHiddenFields)
If
showFilterEditor is true, this method will
return the criteria currently displayed in the filterEditor . |
AdvancedCriteria |
getFilterEditorCriteriaAsAdvancedCriteria()
Same as
getFilterEditorCriteria() but returns an
AdvancedCriteria . |
int |
getFilterEditorHeight()
Height for the filterEditor, if shown.
|
RecordEditor |
getFilterEditorProperties()
Properties to apply to the automatically generated
filterEditor if showFilterEditor is true. |
java.lang.Boolean |
getFilterLocalData()
Causes filtering to be performed against the local data set, even when a
dataSource is provided. |
java.lang.Boolean |
getFilterOnKeypress()
If we're showing the filterEditor (this.showFilterEditor is true), this property determines whether this list should be
filtered every time the user modifies the value in a field of the filter-editor.
|
java.lang.String |
getFilterUsingText()
Text for the menu item shown in the
headerContextMenu when allowFilterOperators
is enabled. |
java.lang.Boolean |
getFixedFieldWidths()
Should we horizontally clip cell contents, or allow columns to expand horizontally to show all contents?
|
java.lang.Boolean |
getFixedRecordHeights()
Should we vertically clip cell contents, or allow rows to expand vertically to show all contents?
|
java.lang.Integer |
getFocusRow()
Get the row that currently has keyboard focus.
|
java.lang.String |
getFormulaBuilderSpanTitleSeparator()
If this grid has specified
headerSpans , and showHeaderSpanTitlesInFormulaBuilder
is true, this string will be inserted between the headerSpan title(s) and the field title in the field chooser grid in
the FormulaBuilder and SummaryBuilder. |
java.lang.Double |
getFormulaFieldValue(ListGridField field,
Record record)
Get the computed value of a
canAddFormulaFields . |
java.lang.String |
getFreezeFieldText()
If we're showing a
headerContextMenu for this
grid and this.canFreezeFields is true, this string
will be shown as the title for the menu item to freeze a currently unfrozen field. |
java.lang.String |
getFreezeOnLeftText()
If we're showing a
headerContextMenu for this
grid and this.canFreezeFields is true, this string
will be shown as the title for the menu item to freeze fields on the left of the scrollable body. |
java.lang.String |
getFreezeOnRightText()
If we're showing a
headerContextMenu for this
grid and this.canFreezeFields is true, this string
will be shown as the title for the menu item to freeze fields on the right of the scrollable body. |
java.lang.String |
getFrozenBaseStyle()
If this listGrid contains any frozen fields, this property can be used to apply a custom baseStyle to all cells in those
frozen fields.
|
java.lang.String |
getFrozenHeaderBaseStyle()
If this listGrid contains any frozen fields, this property can be used to apply a custom headerBaseStyle to the frozen
set of fields.
|
java.lang.String |
getFrozenHeaderTitleStyle()
If this listGrid contains any frozen fields, this property can be used to apply a custom headerTitleStyle to the frozen
set of fields.
|
java.lang.Boolean |
getGenerateClickOnEnter()
If true, when the user navigates to a cell using arrow keys and hits Enter, the cell will respond to a click event.
|
java.lang.Boolean |
getGenerateClickOnSpace()
If true, when the user navigates to a cell using arrow keys and hits space, the cell will respond to a click event.
|
java.lang.Boolean |
getGenerateDoubleClickOnEnter()
If true, when the user navigates to a cell using arrow keys and hits Enter, the cell will respond to a double click
event.
|
java.lang.Boolean |
getGenerateDoubleClickOnSpace()
If true, when the user navigates to a cell using arrow keys and hits Space, the cell will respond to a double click
event.
|
ListGridComponent[] |
getGridComponents()
Array of components that make up this grid.
|
GridRenderer |
getGridRenderer()
Synonym of
getBody() . |
java.lang.Object |
getGridSummary(ListGridField field)
When
showGridSummary is true this
method is called for each field which will show a grid summary value (as described in ListGridField.showGridSummary ) to get the summary
value to display below the relevant column. |
ListGridRecord[] |
getGridSummaryData()
This method returns the data displayed in the
summaryRow when showGridSummary is true. |
java.lang.String |
getGridSummaryRecordProperty()
If
showGridSummary is true, this attribute will be
set to true on the record object representing the grid summary row. |
int |
getGroupByAsyncThreshold()
When grouping is requested with this number of records or more, an asynchronous approach is used to avoid the browser
showing a "script is running slowly.." message prompting the user to stop execution of JavaScript.
|
java.lang.String[] |
getGroupByFields()
Get the current grouping of this listGrid as an array of fieldNames.
|
java.lang.String[] |
getGroupByFieldSummaries()
If this grid is
grouped , and showGroupSummary is true, this attribute may be set to an
array of groupBy field names for which group summaries should appear. |
int |
getGroupByMaxRecords()
Maximum number of records to which a groupBy can be applied.
|
java.lang.String |
getGroupByText()
If we're showing a
headerContextMenu for this
grid and this.canGroupBy is true, this string will be
shown as the title for the menu item to toggle the group by setting for a field. |
java.lang.String |
getGroupIcon()
The URL of the base icon for the group icons in this listGrid.
|
int |
getGroupIconSize()
Default width and height of group icons for this ListGrid.
|
int |
getGroupIndentSize()
Default number of pixels by which to indent subgroups relative to parent group.
|
int |
getGroupLeadingIndent()
Default number of pixels by which to indent all groups.
|
java.lang.String |
getGroupNodeBaseStyle()
Base style for group rows. |
java.lang.String |
getGroupNodeStyle()
The CSS style that
group rows will have. |
SortDirection |
getGroupSortDirection()
When
sortByGroupFirst is active, the sorting
direction applied for implicit sorting by the field(s) used for grouping. |
java.lang.String |
getGroupState()
Initial group state for the grid.
|
ListGridRecord[] |
getGroupSummaryData(Record[] records,
GroupNode groupNode)
If this grid is
grouped , and showGroupSummary is true, this method will return the
group summary data displayed at the end of the group. |
ListGridRecord[] |
getGroupSummaryData(Record[] records,
GroupNode groupNode,
java.lang.Boolean recalculate)
If this grid is
grouped , and showGroupSummary is true, this method will return the
group summary data displayed at the end of the group. |
ListGridRecord[] |
getGroupSummaryData(Record[] records,
Record groupNode)
If this grid is
grouped , and showGroupSummary is true, this method will return the
group summary data displayed at the end of the group. |
ListGridRecord[] |
getGroupSummaryData(Record[] records,
Record groupNode,
java.lang.Boolean recalculate)
If this grid is
grouped , and showGroupSummary is true, this method will return the
group summary data displayed at the end of the group. |
java.lang.String |
getGroupSummaryRecordProperty()
If
showGroupSummary is true, this attribute will
be set to true on each record object representing a group-level summary row. |
java.lang.String |
getGroupSummaryStyle()
ListGridRecord.customStyle for the group-level
summary row displayed when showGroupSummary is
true. |
ListGridField |
getGroupTitleColumnProperties()
Custom properties for the automatically generated
groupTitleColumn . |
java.lang.String |
getGroupTitleField()
When a list grid is
grouped , each group shows under an auto
generated header node. |
Tree |
getGroupTree()
The data tree that results from a call to
groupBy() . |
ListGridRecord[] |
getGroupTreeSelection()
If this grid
is grouped , this method will return the
current selection. |
ListGridRecord[] |
getGroupTreeSelection(boolean excludePartialSelection) |
ListGridRecord[] |
getGroupTreeSelection(boolean excludePartialSelection,
boolean groupNodesOnly)
If this grid
is grouped , this method will return the
current selection. |
Layout |
getHeader()
A Toolbar used to manager the headers shown for each column of the grid.
|
AutoFitEvent |
getHeaderAutoFitEvent()
Event on a ListGrid header that triggers auto fitting to data and/or title.
|
java.lang.String |
getHeaderBackgroundColor()
BackgroundColor for the header toolbar.
|
java.lang.String |
getHeaderBarStyle()
Set the CSS style used for the header as a whole.
|
java.lang.String |
getHeaderBaseStyle()
Button.baseStyle to apply to the buttons in the header, and the
sorter, for this ListGrid. |
Button |
getHeaderButtonProperties()
Properties to apply to all header buttons.
|
Canvas |
getHeaderContextMenu()
The context menu displayed for column headers.
|
protected MenuItem[] |
getHeaderContextMenuItems(java.lang.Integer fieldNum)
If
showHeaderContextMenu is true
this method returns the menu items to be displayed in the default header context menu. |
int |
getHeaderHeight()
The height of this listGrid's header, in pixels.
|
Alignment |
getHeaderHoverAlign()
This property may be set to customize the alignment for the hover shown on
ListGrid.headerHover() . |
java.lang.Integer |
getHeaderHoverHeight()
Optional default height for the hover shown on
ListGrid.headerHover() . |
java.lang.Integer |
getHeaderHoverOpacity()
This property may be set to customize the opacity for the hover shown on
ListGrid.headerHover() . |
java.lang.String |
getHeaderHoverStyle()
This property may be set to customize the css style for the hover shown on
ListGrid.headerHover() . |
VerticalAlignment |
getHeaderHoverVAlign()
This property may be set to customize the vertical alignment for the hover shown on
ListGrid.headerHover() . |
java.lang.Integer |
getHeaderHoverWidth()
Optional default width for the hover shown on
ListGrid.headerHover() . |
java.lang.Boolean |
getHeaderHoverWrap()
This property may be set to customize the
wrap attribute for the hover shown on ListGrid.headerHover() . |
StatefulCanvas |
getHeaderMenuButton()
If
showHeaderMenuButton is true, when the user
rolls over the header buttons in this grid the headerMenuButton will be shown over the header button in question. |
int |
getHeaderMenuButtonHeight()
If
showHeaderMenuButton is true, this property
governs the height of the auto-generated headerMenuButton |
java.lang.String |
getHeaderMenuButtonIcon()
If
showHeaderMenuButton is true, this property
governs the icon shown on the auto-generated headerMenuButton |
int |
getHeaderMenuButtonIconHeight()
If
showHeaderMenuButton is true, this property
governs the height of the icon shown on the auto-generated headerMenuButton |
int |
getHeaderMenuButtonIconWidth()
If
showHeaderMenuButton is true, this property
governs the width of the icon shown on the auto-generated headerMenuButton |
int |
getHeaderMenuButtonWidth()
If
showHeaderMenuButton is true, this property
governs the width of the auto-generated headerMenuButton |
StatefulCanvas |
getHeaderSpan()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
protected MenuItem[] |
getHeaderSpanContextMenuItems(HeaderSpan headerSpan)
Return the menus items that should be shown in a menu triggered from a
headerSpan . |
java.lang.Integer |
getHeaderSpanHeight()
Default height for a
headerSpan with no height
specified. |
java.lang.String |
getHeaderTitleStyle()
StretchImgButton.titleStyle to apply to the buttons
in the header, and the sorter, for this ListGrid. |
java.lang.Boolean |
getHideEmptySummaryRow()
If true, causes the
summaryRow component to be hidden if
it has no data after summaries have been recalculated |
java.lang.Boolean |
getHiliteCanReplaceValue()
If set, end users can create advanced hiliting rules that will use the
Hilite.replacementValue feature to cause values in hilited cells to
be replaced with a user-entered value. |
java.lang.String |
getHiliteEditorSpanTitleSeparator()
If this grid has specified
headerSpans , and showHeaderSpanTitlesInHiliteEditor is
true, this string will be inserted between the headerSpan title and the field title in the hiliteEditor field chooser
grid. |
boolean |
getHiliteHTMLAfterFormat()
If set to true, custom HTML applied as part of hiliting will be applied after
formatting for each cell. |
java.lang.Integer |
getHiliteIconHeight()
Height for hilite icons for this listGrid.
|
int |
getHiliteIconLeftPadding()
How much padding should there be on the left of
hilite
icons by default? Can be overridden at the field level |
HiliteIconPosition |
getHiliteIconPosition()
When
hiliteIcons are present, where the hilite icon
will be placed relative to the field value. |
int |
getHiliteIconRightPadding()
How much padding should there be on the right of
hilite
icons by default? Can be overridden at the field level |
java.lang.String[] |
getHiliteIcons()
Specifies a list of icons that can be used in
hilites . |
int |
getHiliteIconSize()
Default width and height of
hilite icons for this
component. |
java.lang.Integer |
getHiliteIconWidth()
Width for hilite icons for this component.
|
java.lang.String |
getHiliteProperty()
Marker that can be set on a record to flag that record as hilited.
|
java.lang.String |
getHiliteReplaceValueFieldTitle()
Title used for the text box shown when
hiliteCanReplaceValue is set. |
java.lang.Boolean |
getHiliteRowOnFocus()
When the grid body gets keyboard focus, should we highlight the current focus row, using the rollover cell style?
|
Hilite[] |
getHilites()
Return the set of hilite-objects currently applied to this DataBoundComponent.
|
java.lang.String |
getHiliteState()
Get the current hilites encoded as a String, for saving.
|
HoverMode |
getHoverMode()
When
showHoverComponents is true, the builtin
mode to use when automatically creating a hover component for rows in this grid. |
java.lang.String |
getHoverStyle()
Style to apply to hovers shown over this grid.
|
java.lang.Integer |
getIconPadding()
When using
autoFitFieldWidths , padding in pixels
left on each side of fields that show images. |
int |
getImageSize()
Default size of thumbnails shown for fieldTypes image and imageFile.
|
boolean |
getIncludeHilitesInSummaryFields()
When assembling a value for a
summary field , if
a referenced field is hilited, should the hilite HTML be included in the summary field value? |
java.lang.String |
getIncludeInSummaryProperty()
Property name on a record that will be checked to determine whether a record should be included when calculating totals
for the
grid summary . |
Criteria |
getInitialCriteria()
Criteria to use when
DataBoundComponent.setAutoFetchData(Boolean) is used. |
SortSpecifier[] |
getInitialSort()
An array of
SortSpecifier objects used to set up the initial sort configuration for
this grid. |
java.lang.Boolean |
getInstantScrollTrackRedraw()
If true, if the user clicks on the scroll buttons at the end of the track or clicks once on the scroll track, there will
be an instant redraw of the grid content so that the user doesn't see any blank space.
|
java.lang.String |
getInvalidSummaryValue()
Value to display to the user if showing summary values (through
showGridSummary , showGroupSummary or listGridFieldType:"summary" ), and the summary function returns
"null" (implying it was unable to calculate a valid summary value). |
boolean |
getIsGrouped()
True if this listGrid is grouped, false otherwise
|
java.lang.String |
getIsSeparatorProperty()
If
record[this.isSeparatorProperty] is set for some record, the record will be displayed as a simple
separator row. |
java.lang.Boolean |
getLeaveScrollbarGap()
Whether to leave a gap for the vertical scrollbar, even when it's not present.
|
java.lang.String |
getLinkTextProperty()
Property name on a record that will hold the link text for that record.
|
RowEndEditAction |
getListEndEditAction()
If the user is editing the last record in this listGrid, and attempts to navigate beyond the last row either by tabbing
off the last editable field, or using the down arrow key, this property determines what action to take: "next":
start editing a new record at the end of the list.
|
java.lang.String |
getLoadingDataMessage()
The string to display in the body of a listGrid while data is being loaded.
|
java.lang.String |
getLoadingDataMessageStyle()
The CSS style name applied to the loadingDataMessage string if displayed.
|
java.lang.String |
getLoadingMessage()
If you have a databound listGrid and you scroll out of the currently loaded dataset, by default you will see blank rows
until the server returns the data for those rows.
|
java.lang.String |
getLocateColumnsBy()
When
AutoTest.getElement() is used to parse locator strings
generated by AutoTest.getLocator() for a cell in this grid, how
should the column be identified? Note that getLocator() will actually store all available information about the column in the generated string -- this attribute effects how a stored string will be parsed only. |
java.lang.String |
getLocateRowsBy()
When
AutoTest.getElement() is used to parse locator strings
generated by AutoTest.getLocator() for a cell in this grid, how
should the row be identified? Note that getLocator() will actually store all available information about the row in the generated string -- this attribute effects how a stored string will be parsed only. |
com.smartgwt.logicalstructure.core.LogicalStructureObject |
getLogicalStructure()
Getter implementing the
LogicalStructure interface,
which supports Eclipse's logical structure debugging facility. |
int |
getLongTextEditorThreshold()
When the length of the field specified by
DataSourceField.length exceeds this value, the ListGrid shows an edit field of type longTextEditorType rather than the standard text field
when the field enters inline edit mode. |
java.lang.String |
getLongTextEditorType()
When the length of the field specified by
DataSourceField.length exceeds this.longTextEditorThreshold show an edit field of this type rather than
the standard text field when the field enters inline edit mode. |
java.lang.Integer |
getMaxExpandedRecords()
When
canExpandRecords and canExpandMultipleRecords are both true, this
property dictates the number of records which can be expanded simultaneously. |
java.lang.String |
getMaxExpandedRecordsPrompt()
This is a dynamic string - text within
${...} will be evaluated as JS code when the message is
displayed. |
int |
getMinFieldWidth()
Minimum size, in pixels, for ListGrid headers.
|
java.lang.String |
getMissingSummaryFieldValue()
If a summary format string contains an invalid field reference, replace the reference with the missingSummaryFieldValue.
|
java.lang.Boolean |
getModalEditing()
If this property is true, any mouse click outside of the open cell editors will end editing mode, hiding the cell
editors and saving any changes to those cell values.
|
boolean |
getNavigateOnTab()
If
canSelectCells is true, this property allows the
user to navigate through the cells of a grid using Tab and Shift+Tab keypresses. |
java.lang.Boolean |
getNeverValidate()
If true, validation will not occur as a result of cell editing for this grid.
|
java.lang.String |
getNormalBaseStyle()
"Normal" baseStyle for this listGrid.
|
int |
getNormalCellHeight()
If
baseStyle is unset, base style will be derived from
normalBaseStyle if this grid has fixed row heights
and the specified cellHeight matches this value. |
java.lang.String |
getNullGroupTitle()
Default alias to use for groups with no value
|
java.lang.String |
getOfflineMessageStyle()
The CSS style name applied to the
offlineMessage if displayed. |
FormItemIcon |
getOperatorIcon()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
static ListGrid |
getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) |
RecordList |
getOriginalRecordList()
Return the underlying, ungrouped data of this DataBoundComponent as a
RecordList . |
ResultSet |
getOriginalResultSet()
Return the underlying, ungrouped data of this ListGrid as a
ResultSet . |
java.lang.String |
getOriginBaseStyle()
Name of a CSS Style to use as the
baseStyle for a cell
that is currently a selection origin for shifted incremental cell selection. |
Overflow |
getOverflow()
|
java.lang.Boolean |
getPoolComponentsPerColumn()
Should recycled
record components , be pooled
per column or per record. |
java.lang.Boolean |
getPreventDuplicates()
If set, detect and prevent duplicate records from being transferred to this component, either via
drag and drop or via
DataBoundComponent.transferSelectedData(com.smartgwt.client.widgets.DataBoundComponent) . |
java.lang.Boolean |
getPrintAutoFit()
Whether cell contents should wrap during printing.
|
java.lang.String |
getPrintBaseStyle()
Style for non-header cells in printed output.
|
java.lang.String |
getPrintBooleanBaseStyle()
If set, the
booleanBaseStyle to use when printing . |
java.lang.String |
getPrintBooleanFalseImage()
If set, the
booleanFalseImage to use when printing . |
java.lang.String |
getPrintBooleanPartialImage()
If set, the
booleanPartialImage to use when
printing . |
java.lang.String |
getPrintBooleanTrueImage()
If set, the
booleanTrueImage to use when printing . |
java.lang.String |
getPrintCheckboxFieldFalseImage()
If set, the
checkboxFieldFalseImage to use
when printing . |
java.lang.String |
getPrintCheckboxFieldPartialImage()
If set, the
checkboxFieldPartialImage to
use when printing . |
java.lang.String |
getPrintCheckboxFieldTrueImage()
If set, the
checkboxFieldTrueImage to use
when printing . |
java.lang.String |
getPrintHeaderStyle()
Style for header cells in printed output.
|
int |
getPrintMaxRows()
Advanced property - when generating printHTML for a large ListGrid, rows are printed in batches in order to avoid
triggering a native "script is running slowly" browser dialog.
|
java.lang.Boolean |
getPrintWrapCells()
Whether cell contents should wrap during printing.
|
java.lang.Boolean |
getProgressiveLoading()
Indicates whether or not this component will load its data
progressively |
float |
getQuickDrawAheadRatio()
Alternative to
drawAheadRatio , to be used when the
user is rapidly changing the grids viewport (for example drag scrolling through the grid). |
ListGridRecord |
getRecord(int recordNum)
Return the pointer to a particular record by record number.
|
java.lang.String |
getRecordBaseStyleProperty()
This attribute allows custom base styles to be displayed on a per-record basis.
|
java.lang.String |
getRecordCanRemoveProperty()
If set to false on a record and
canRemoveRecords
is true, removal of that record is disallowed in the UI. |
java.lang.String |
getRecordCanSelectProperty()
If set to false on a record, selection of that record is disallowed.
|
Canvas |
getRecordComponent(int rowNum)
Retrieve the
recordComponent currently being
shown at the given coordinates. |
Canvas |
getRecordComponent(int rowNum,
java.lang.Integer colNum)
Retrieve the
recordComponent currently being
shown at the given coordinates. |
java.lang.Integer |
getRecordComponentHeight()
If
showRecordComponents is true, this
attribute may be used to specify a standard height for record components. |
RecordComponentPoolingMode |
getRecordComponentPoolingMode()
The method of
component-pooling to employ for recordComponents . |
EmbeddedPosition |
getRecordComponentPosition()
if
showRecordComponents is true, how should
the component appear within the cell. |
java.lang.String |
getRecordDetailDSProperty()
The name of the ListGridRecord property that specifies the DataSource to use when
listGrid.expansionMode is "related". |
RecordDropAppearance |
getRecordDropAppearance()
If
canAcceptDroppedRecords is true for this
listGrid, this property governs whether the user can drop between, or over records within the grid. |
RecordDropPosition |
getRecordDropPosition()
Returns the
RecordDropPosition for some record drop operation. |
java.lang.String |
getRecordEditProperty()
Property name on a record that should be checked to determine whether the record may be edited.
|
java.lang.String |
getRecordEnabledProperty()
Property name on a record that will be checked to determine whether a record is enabled.
|
int |
getRecordIndex(ListGridRecord record)
Get the index of the provided record.
|
int |
getRecordIndex(Record record)
Get the index of the provided record.
|
RecordList |
getRecordList()
Return the underlying data of this DataBoundComponent as a
RecordList . |
ListGridRecord[] |
getRecords()
Returns the current set of records displayed in this grid as an array of ListGridRecord objects.
|
java.lang.String |
getRecordSummaryBaseStyle()
If showing any record summary fields (IE: fields of
type:"summary" ),
this attribute specifies a custom base style to apply to cells in the summary field |
DataSource |
getRelatedDataSource(ListGridRecord record)
Returns the
DataSource containing data related to the passed record. |
java.lang.String |
getRemovedCSSText()
Custom CSS text to be applied to records that have been
marked for removal . |
com.google.gwt.core.client.JavaScriptObject |
getRemoveFieldDefaults()
Returns a JavaScriptObject containing default
ListGridField
attributes of remove fields. |
ListGridField |
getRemoveFieldProperties()
Configuration properties for the "remove field" displayed when
canRemoveRecords is enabled. |
java.lang.String |
getRemoveFieldTitle()
The title to use for the
remove field . |
java.lang.String |
getRemoveIcon()
When
canRemoveRecords is enabled, default icon to
show in the auto-generated field that allows removing records. |
int |
getRemoveIconSize()
Default width and height of
remove icons for this
ListGrid. |
java.lang.String |
getRemoveOperation()
operationId this component
should use when performing remove operations. |
boolean |
getReselectOnUpdate()
If true, when an update operation occurs on a selected record in a
databound listGrid, ensure the updated record is re-selected
when the operation completes. |
SelectionNotificationType |
getReselectOnUpdateNotifications()
if
reselectOnUpdate is true, this property governs
what selection changed notifications should be triggered when a selected record is edited then automatically reselected
when the edited data is merged into the data set. |
boolean |
getResizeFieldsInRealTime()
If
true , the grid contents are redrawn in real time as fields are resized. |
ResultSet |
getResultSet()
Return the underlying data of this DataBoundComponent as a
ResultSet . |
java.lang.Boolean |
getReverseRTLAlign()
If a page is rendered in
RTL mode , should cell alignments specified ListGridField.cellAlign be reversed (so an
align:"right" field will have content aligned on the left and vice versa)? |
protected Canvas |
getRollOverCanvas(java.lang.Integer rowNum,
java.lang.Integer colNum)
If the
rollOverCanvas is enabled, this method will
be called to create the canvas to display over the current row or cell when a user moves their mouse over the row. |
protected Canvas |
getRollUnderCanvas(java.lang.Integer rowNum,
java.lang.Integer colNum)
If the
rollUnderCanvas is enabled, this method will
be called to create the canvas to display under the current row or cell when a user moves their mouse over the row. |
RowEndEditAction |
getRowEndEditAction()
If the user is editing a record in this listGrid, and attempts to navigate to a field beyond the end of the row, via tab
(or shift-tab off the first editable field), this property determines what action to take: "next": start editing
the next (or previous) record in the list "same": put focus back into the first editable field of the same record.
|
java.util.Map |
getRowErrors(int rowNum)
Returns any currently stored validation errors for this row in the following format:
{fieldName:[array of error messages], ...} |
int |
getRowHeight(ListGridRecord record,
int rowNum)
Return the height this row should be.
|
int |
getRowNum(ListGridRecord record)
Synonym of
getRecordIndex() . |
ListGridField |
getRowNumberField()
An automatically generated field that displays the current row number when
showRowNumbers is true. |
int |
getRowNumberStart()
The number to start the row-count from - default value is 1.
|
java.lang.String |
getRowNumberStyle()
The CSS Style name for the
rowNumberField . |
int |
getRowPageTop(int rowNum)
Returns the Y-coordinate for a given row number as a page-relative coordinate.
|
int |
getRowSpan(ListGridRecord record,
int rowNum,
int colNum)
Return how many rows this cell should span.
|
RowSpanEditMode |
getRowSpanEditMode()
If
allowRowSpanning is enabled, this property may
be used to specify editing behavior for cells that span multiple rows. |
RowSpanSelectionMode |
getRowSpanSelectionMode()
Chooses the selection mode when
useRowSpanStyling
is enabled. |
int |
getRowTop(int rowNum)
Returns the top coordinate for a given row number, relative to the top of body content.
|
java.lang.Boolean |
getSaveByCell()
Whether edits should be saved whenever the user moves between cells in the current edit row.
|
java.lang.Boolean |
getSaveLocally()
For grids with a specified
dataSource , this property can
be set to true to cause the grid directly update its local data set instead of performing an operation
against it's configured DataSource. |
DSRequest |
getSaveRequestProperties()
For editable grids with a specified
dataSource , where
saveLocally is false, this attribute may be used to
specify standard DSRequest properties to apply to all save operations performed by this grid (whether triggered by user
interaction, or explicit saveEdits or saveAllEdits call). |
java.lang.String |
getScreenReaderCellSeparator()
When
screen reader mode is enabled, this invisible separator
string is written out between each cell value. |
java.lang.String |
getScreenReaderRowSeparator()
When
screen reader mode is enabled, this invisible string will
be written out after the last cell in a row. |
int |
getScrollRedrawDelay()
While drag scrolling in an incrementally rendered grid, time in milliseconds to wait before redrawing, after the last
mouse movement by the user.
|
Alignment |
getScrollToCellXPosition()
When scrollToCell is called, this is used as defaults if xPosition weren't explicitly passed into the method.
|
VerticalAlignment |
getScrollToCellYPosition()
When scrollToCell is called, this is used as defaults if yPosition weren't explicitly passed into the method.
|
java.lang.Integer |
getScrollWheelRedrawDelay()
While scrolling an incrementally rendered grid, using the mouseWheel, time in milliseconds to wait before redrawing,
after the last mouseWheel movement by the user.
|
RecordList |
getSelectedCellData()
Returns the selected cells as a series of Records where each field value is stored under it's offset from the top-left
of the selection.
|
ListGridRecord |
getSelectedRecord()
Returns the first selected record in this grid.
|
ListGridRecord[] |
getSelectedRecords()
Returns all selected records in this grid.
|
ListGridRecord[] |
getSelectedRecords(boolean excludePartialSelections)
Returns all selected records in this grid.
|
java.lang.String |
getSelectedState()
Returns a snapshot of the current selection within this listGrid as a
ListGridSelectedState object.This object can be passed to setSelectedState() to reset this grid's selection the
current state (assuming the same data is present in the grid). |
java.lang.Boolean |
getSelectHeaderOnSort()
If true, show the field-header for the sorted field (or the first field in a
multi-sort grid) in the selected state. |
ListGridRecord[] |
getSelection()
Deprecated.
use
getSelectedRecords() instead |
ListGridRecord[] |
getSelection(boolean excludePartialSelections)
Deprecated.
use
getSelectedRecords(boolean) instead |
SelectionAppearance |
getSelectionAppearance()
How selection of rows should be presented to the user.
|
java.lang.String |
getSelectionProperty()
If specified, the selection object for this list will use this property to mark records as selected.
|
SelectionStyle |
getSelectionType()
Defines a listGrid's clickable-selection behavior.
|
java.lang.Boolean |
getSelectOnEdit()
When the user starts editing a row, should the row also be selected?
|
boolean |
getSelectOnExpandRecord()
When set to false, clicking a record's
expansion
field will not add the record to the current selection. |
java.lang.Boolean |
getShowAllColumns()
Whether all columns should be drawn all at once, or only columns visible in the viewport.
|
java.lang.Boolean |
getShowAllRecords()
Whether all rows should be drawn all at once, or only rows visible in the viewport.
|
java.lang.Boolean |
getShowAsynchGroupingPrompt()
If set to false, do not show the
asynchGroupingPrompt dialog during asynchronous grouping . |
java.lang.Boolean |
getShowBackgroundComponents()
If
true this grid will create and show per-row backgroundComponents as detailed here . |
java.lang.Boolean |
getShowCellContextMenus()
Whether to show a context menu with standard items for all context clicks on rows in the body.
|
boolean |
getShowClippedHeaderTitlesOnHover()
If true and a header button's title is clipped, then a hover containing the full field title is enabled.
|
java.lang.Boolean |
getShowClippedValuesOnHover()
If true and a cell's value is clipped, then a hover containing the full cell value is enabled.
|
java.lang.Boolean |
getShowCollapsedGroupSummary()
Should group summaries be visible when the group is collapsed?
|
java.lang.Boolean |
getShowComplexFields()
Whether to show fields of non-atomic types when a DataBoundComponent is given a
DataSource but no
component.fields .
|
java.lang.Boolean |
getShowDetailFields()
Whether to include fields marked
detail:true from this component's DataSource . |
java.lang.Boolean |
getShowEmptyMessage()
Indicates whether the text of the emptyMessage property should be displayed if no data is available.
|
boolean |
getShowErrorIcons()
If this grid is editable, and an edit has caused validation failure for some cell, should we show an icon to indicate
validation failure?
|
java.lang.Boolean |
getShowExpansionEditorSaveButton()
When
ExpansionMode is editor, should a Save button be shown below the the
expanded editor? |
boolean |
getShowFilterEditor()
Should this listGrid display a filter row.
|
java.lang.Boolean |
getShowGridSummary()
Should this ListGrid show a summary row beneath the last record of the grid.
|
java.lang.Boolean |
getShowGroupSummary()
If this listGrid supports
grouping , setting this
property will cause the grid to render an extra row at the end of each group when grouped, containing summary
information for the fields. |
java.lang.Boolean |
getShowGroupSummaryInHeader()
If this grid is
grouped , and showGroupSummary is true, setting this property causes
field summary values for each group to be displayed directly in the group header node, rather than showing up at the
bottom of each expanded group. |
java.lang.Boolean |
getShowGroupTitleColumn()
If this grid is
grouped and showGroupSummaryInHeader is true, instead of
group header nodes showing up with a single cell value spanning the full set of columns, summaries for each field will
show up in the appropriate columns of the header node. |
java.lang.Boolean |
getShowHeader()
Should we show the header for this ListGrid?
|
java.lang.Boolean |
getShowHeaderContextMenu()
Whether to show a context menu on the header with standard items for showing and hiding fields.
|
java.lang.Boolean |
getShowHeaderMenuButton()
If set to true and
showHeaderContextMenu is
true, the headerMenuButton will be displayed when
the user rolls over the header buttons in this grid. |
java.lang.Boolean |
getShowHeaderSpanTitlesInFormulaBuilder()
If this grid has specified
headerSpans , should field
titles be prefixed with the titles of the headerSpans in which they are contained when using the FormulaBuilder or
SummaryBuilder. |
java.lang.Boolean |
getShowHeaderSpanTitlesInHiliteEditor()
If this grid has specified
headerSpans , should field
titles be prefixed with the titles of the headerSpans in which they are contained when using the hilite editor . |
java.lang.Boolean |
getShowHeaderSpanTitlesInSortEditor()
If this grid has specified
headerSpans , should field
titles be prefixed with the titles of the headerSpans in which they are contained when using the multi-sort editor . |
java.lang.Boolean |
getShowHiddenFields()
Whether to show fields marked
hidden:true when a DataBoundComponent is given a
DataSource but no component.fields .
|
boolean |
getShowHilitesInGroupSummary()
Determines whether hiliting for any field in this grid is shown in a group summary.
|
java.lang.Boolean |
getShowHover()
If true, and canHover is also true, when the user hovers over a cell, hover text will pop up next to the mouse.
|
java.lang.Boolean |
getShowHoverComponents()
When set to true and canHover is also true, shows a widget hovering at the mouse point.
|
java.lang.Boolean |
getShowPartialSelection()
Should partially selected parents (in a Tree data set) be shown with special icon? This has an impact in grouped grids
where
canSelectGroups is true. |
java.lang.Boolean |
getShowRecordComponents()
When enabled,
createRecordComponent() will be
called when saved rows are being rendered, and any returned component will be displayed embedded within the row or cell. |
java.lang.Boolean |
getShowRecordComponentsByCell()
If true, shows
recordComponents in cells,
rather than just in records. |
java.lang.Boolean |
getShowRollOver()
Should we show different styling for the cell the mouse is over?
|
java.lang.Boolean |
getShowRollOverCanvas()
When enabled, when the mouse moves over a row or cell (depending on
useCellRollOvers ), an arbitrary Canvas can be shown
layered on top of the row or cell (the rollOverCanvas ), layered underneath the row or cell (the rollUnderCanvas ), or both. |
java.lang.Boolean |
getShowRollUnderCanvas()
If roll overs are enabled, should the
rollUnderCanvas be displayed? |
java.lang.Boolean |
getShowRowNumbers()
When set to true, shows an additional field at the beginning of the field-list (respecting RTL) that displays the
current rowNum for each record.
|
java.lang.Boolean |
getShowSelectedStyle()
Should the "Selected" style be applied to selected records?
|
java.lang.Boolean |
getShowSelectionCanvas()
If
selectionType is set to SelectionStyle.SINGLE , setting this property to true means selection will be
displayed to the user with the selectionCanvas
and/or selectionUnderCanvas rather than with
CSS styling. |
java.lang.Boolean |
getShowSelectionUnderCanvas()
If
selectionType is set to SelectionStyle.SINGLE , and either showSelectionCanvas is true and
showSelectionUnderCanvas is unset, or showSelectionUnderCanvas is explicitly set to
true , then selection will be displayed to the user with the selectionCanvas and/or selectionUnderCanvas rather than with CSS styling. |
SortArrow |
getShowSortArrow()
Indicates whether a sorting arrow should appear for the listGrid, and its location.
|
java.lang.Boolean |
getShowSortNumerals()
When multiple fields are sorted, set this to false to hide the sort-numeral displayed by default after the sort-arrows
in the header-buttons of sorted fields.
|
java.lang.Boolean |
getShowTreeColumnPicker()
When
headerSpans are in use, whether to show a
hierarchical column picker that includes both headerSpans and normal headers, with normal headers indented under
headerSpans similarly to how a TreeGrid displays a Tree. |
java.lang.Boolean |
getShrinkForFreeze()
If this list grid is showing any
frozen fields, and a
horizontal scrollbar is visible at the bottom of the liquid columns, should an equivalent scrollbar gap be left visible
below the frozen columns?Note that if set to true any backgroundColor or border applied to the
ListGrid will show up below the bottom row of the frozen column(s). |
java.lang.String |
getSingleCellValueProperty()
If
record[this.singleCellValueProperty] is set for some record, the record will be displayed as a single
cell spanning every column in the grid, with contents set to the value of
record[this.singleCellValueProperty] . |
java.lang.String |
getSkinImgDir()
Where do 'skin' images (those provided with the class) live?
|
SortSpecifier[] |
getSort()
Returns the current
SortSpecifiers for this ListGrid. |
ImgProperties |
getSortAscendingImage()
Image to show when sorting ascending.
|
boolean |
getSortBinaryByFileName()
For any fields of
type "binary" , should sorting be performed against the
fileName of the value for the field? For Smart GWT server backed dataSources, this is applied to the record
automatically as described in the BinaryFields overview. |
java.lang.Boolean |
getSortByGroupFirst()
If set, whenever grouping is performed by an end user or by a programmatic call to
groupBy() , data is implicitly sorted by all of the grouped columns,
in the order they were passed to groupBy. |
ImgProperties |
getSortDescendingImage()
Image to show when sorting descending.
|
SortDirection |
getSortDirection()
Sorting direction of this ListGrid.
|
java.lang.String |
getSortEditorSpanTitleSeparator()
If this grid has specified
headerSpans , and showHeaderSpanTitlesInSortEditor is true,
this string will be inserted between the headerSpan title(s) and the field title in the field chooser grid on the multi-sort editor |
java.lang.String |
getSorterButtonTitle()
The title for the corner sort button.
|
java.lang.String |
getSortField()
Specifies the field by which this grid should be initially sorted.
|
java.lang.String |
getSortFieldAscendingText()
If we're showing a
headerContextMenu for this
grid, this attribute will be shown as the menu item title to sort a field in ascending order. |
int |
getSortFieldCount()
Returns the number of fields involved in this grid's current sort configuration.
|
java.lang.String |
getSortFieldDescendingText()
If we're showing a
headerContextMenu for this
grid, this attribute will be shown as the menu item title to sort a field in descending order. |
java.lang.String |
getSortNumeralHTML(java.lang.String fieldName,
int sortIndex)
When multiple fields are sorted, this method returns the HTML for the sort-numeral that appears after the sort-arrows in
the header-buttons of sorted fields.
|
java.lang.String |
getSortNumeralStyle()
When multiple fields are sorted, the Style to apply to the numeral that appears after the sort-arrows in the
header-buttons of sorted fields.
|
SortSpecifier |
getSortSpecifier(java.lang.String fieldName)
Returns the
SortSpecifier for the passed fieldName, or null if the field is not sorted. |
java.lang.String |
getSortState()
Initial sort state for the grid.
|
Layout |
getSpanContextMenu()
The menu displayed when a cell is right clicked on.
|
java.lang.Boolean |
getStopOnErrors()
If this is an editable listGrid, this property determines how failure to save due to validation errors should be
displayed to the user.
|
java.lang.String |
getStyleName()
Default CSS class for the ListGrid as a whole.
|
java.lang.String |
getSummaryFieldValue(ListGridField field,
Record record)
Get the computed value of a
summary field . |
ListGrid |
getSummaryRow()
Automatically generated ListGrid for displaying grid summary information (see
showGridSummary ). |
Criteria |
getSummaryRowCriteria()
If
showGridSummary is true, and a summaryRowDataSource is specified this property may
be used to specify fetch criteria to apply when retrieving summary data to show in the summary row. |
DataSource |
getSummaryRowDataSource()
If
showGridSummary is true, by default summary
values are calculated on the client based on the current data-set for the grid (see getGridSummary() and getGridSummaryFunction() ). |
DSRequest |
getSummaryRowFetchRequestProperties()
If
showGridSummary is true, and a summaryRowDataSource is specified this property may
be used to customize the fetch request used when retrieving summary data to show in the summary row. |
int |
getSummaryRowHeight()
Default height for the
summary row autoChild . |
java.lang.String |
getSummaryRowStyle()
baseStyle for the summaryRow |
java.lang.String |
getTallBaseStyle()
"Tall" baseStyle for this listGrid.
|
protected ListGrid |
getTestInstance() |
java.lang.String |
getTitleField()
Method to return the fieldName which represents the "title" for records in this
Component.
If this.titleField is explicitly specified it will always be used. Otherwise, default implementation will check titleField for databound
components.For non databound components returns the first defined field name of "title" ,
"name" , or "id" . |
java.lang.String |
getTitleFieldValue(Record record)
Get the value of the titleField for the passed record
|
java.lang.String |
getToggleFreezeText(ListGridField field)
If we're showing a
headerContextMenu for this
grid and this.canFreezeFields is true, this string
will be shown as the title for the menu item to toggle whether a field is frozen or unfrozen. |
int |
getTotalRows()
Return the total number of rows in the grid.
|
java.lang.Integer |
getTouchScrollRedrawDelay()
While scrolling an incrementally rendered grid, using the inertial scrolling, time in milliseconds to wait before
redrawing, after the last touchScroll by the user.
|
ImgProperties |
getTrackerImage()
Default image to use for the dragTracker when things are dragged within or out of this list.
|
java.lang.String |
getUnfreezeFieldText()
If we're showing a
headerContextMenu for this
grid and this.canFreezeFields is true, this string
will be shown as the title for the menu item to unfreeze a currently frozen field. |
java.lang.String |
getUngroupText()
If we're showing a
headerContextMenu for this
grid, and this.isGrouped is true, this attribute will be
shown as the title for the menu item to ungroup the grid. |
java.lang.String |
getUnremoveIcon()
When
canRemoveRecords is enabled, this icon will
be shown in the auto generated field fro removing records if the record has been marked as removed via markRecordRemoved() . |
java.lang.String |
getUpdateOperation()
operationId this component
should use when performing update operations. |
java.lang.Boolean |
getUseAdvancedFieldPicker()
If set to true, an advanced field picker based on the
FieldPicker will be shown
instead of the column picker submenu if there are more fields in the grid than advancedFieldPickerThreshold . |
java.lang.Boolean |
getUseAllDataSourceFields()
If true, the set of fields given by the "default binding" (see
fields ) is used, with any fields specified in
component.fields acting as overrides that can suppress or modify the
display of individual fields, without having to list the entire set of fields that
should be shown.
|
java.lang.Boolean |
getUseCellRollOvers()
Are rollovers cell-level or row-level?
|
java.lang.Boolean |
getUseCopyPasteShortcuts()
Enables copy/paste shortcuts, provided
canSelectCells is true |
java.lang.Boolean |
getUseFlatFields()
The
useFlatFields flag causes all simple type fields anywhere in a nested
set of DataSources to be exposed as a flat list for form binding. |
java.lang.Boolean |
getUseRemoteValidators()
If
saveLocally is specified, but this grid is bound to
a DataSource which includes remote field validators, by default edits will be saved synchronously and these validators
will not be executed.Set this property to true to ensure these remote validators are called when
saving edits in saveLocally mode. |
java.lang.Boolean |
getUseRowSpanStyling()
Enables various styling behaviors that potentially make sense when
getRowSpan() has been overridden to introduce spanning cells, and
spanning is largest on the left and smaller as cells go to the right. |
java.lang.Boolean |
getValidateByCell()
Whether client-side validation checks should be performed when the user moves between cells in the current edit row.
|
java.lang.Boolean |
getValidateOnChange()
If true, validation will be performed on each edited cell when each editor's "change" handler is fired.
|
java.lang.String |
getValueIcon(ListGridField field,
java.lang.Object value,
ListGridRecord record)
Returns the appropriate valueIcon for a cell based on the field and the data value for the cell.
|
java.lang.Integer |
getValueIconHeight()
Height for value icons for this listGrid.
|
int |
getValueIconLeftPadding()
How much padding should there be on the left of valueIcons by default Can be overridden at the field level
|
int |
getValueIconRightPadding()
How much padding should there be on the right of valueIcons by default
|
int |
getValueIconSize()
Default width and height of value icons for this ListGrid.
|
java.lang.Integer |
getValueIconWidth()
Width for value icons for this listGrid.
|
java.lang.String |
getViewState()
Initial
view state for the grid. |
java.lang.Boolean |
getVirtualScrolling()
When incremental rendering is switched on and there are variable record heights, the virtual scrolling mechanism manages
the differences in scroll height calculations due to the unknown sizes of un-rendered rows to make the scrollbar and
viewport appear correctly.
|
java.lang.Integer[] |
getVisibleRows()
Get the rows that are currently visible in the viewport, as an array of [firstRowNum, lastRowNum].
|
java.lang.Boolean |
getWaitForSave()
If this is an editable listGrid, this property determines whether the user will be able to dismiss the edit form, or
navigate to another cell while the save is in process (before the asynchronous server response returns).
|
java.lang.Boolean |
getWarnOnRemoval()
If
canRemoveRecords is true, when the user clicks
the remove icon for some record, should we show a warning message (defined as warnOnRemovalMessage ) and allow the user to cancel
removal? |
java.lang.String |
getWarnOnRemovalMessage()
Warning message to show the user on a click on the 'remove' icon if
canRemoveRecords is true and warnOnRemoval is true. |
java.lang.Boolean |
getWarnOnUnmappedValueFieldChange()
If a field has
ListGridField.displayField
specified and has no ListGridField.optionDataSource , this field will display the value from the displayField of each record by
default (for more on this behavior see ListGridField.optionDataSource ). |
java.lang.Boolean |
getWrapCells()
Should content within cells be allowed to wrap?
|
java.lang.Boolean |
getWrapHeaderSpanTitles()
If
HeaderSpan.wrap is not explicitly set, should fields
wrap? If autofitting, see the docs on that property for the details of how the minimum width for a field is determined. |
java.lang.Boolean |
getWrapHeaderTitles()
If
ListGridField.wrap is not explicitly set, should
fields wrap? If autofitting, see the docs on that property for the details of how the minimum width for a field is
determined. |
void |
groupBy(java.lang.String... fields)
Display the current set of records grouped by their values for the given field or fields.
|
java.lang.Boolean |
hasChanges()
Whether the grid as a whole has any unsaved edits, in any row.
|
java.lang.Boolean |
hasErrors()
Does this grid currently have errors associated with editValues for any row in the grid.
|
java.lang.String |
headerHoverHTML(int fieldNum,
java.lang.String defaultHTML)
Returns the HTML that is displayed by the default
headerHover handler. |
boolean |
headerTitleClipped(int fieldNum)
Is the field title for the specified field clipped?
|
void |
hideField(java.lang.String field)
Force a field to be hidden.
NOTE: If a field.showIf expression exists, it will be destroyed. |
void |
hideField(java.lang.String field,
boolean suppressRelayout)
Force a field to be hidden.
NOTE: If a field.showIf expression exists, it will be destroyed. |
void |
hideFields(ListGridField... fields)
Force an array of fields to be hidden.
|
void |
hideFields(ListGridField[] fields,
boolean suppressRelayout) |
void |
hideFields(java.lang.String... fields)
Force an array of fields to be hidden.
|
void |
hideFields(java.lang.String[] fields,
boolean suppressRelayout)
Force an array of fields to be hidden.
|
void |
invalidateCache()
Invalidate the current data cache for this databound component via a call to the dataset's
invalidateCache() method, for example,
ResultSet.invalidateCache() . |
void |
invalidateRecordComponents()
Invalidates the currently visible set of
recordComponents and gets fresh ones for the visible rows in the grid according to the recordComponentPoolingMode |
java.lang.Boolean |
isCheckboxField(ListGridField field)
Identifies whether the passed-in field is the specially generated
checkboxField used when SelectionAppearance is "checkbox". |
java.lang.Boolean |
isExpanded(ListGridRecord record)
Whether a given
record is expanded or collapsed. |
java.lang.Boolean |
isExpansionField(ListGridField field)
Identifies whether the passed-in field is the specially generated
expansionField used when canExpandRecords is true. |
boolean |
isExportingClientData()
Returns true if this component is currently
exporting
client data . |
boolean |
isGrouped()
Return true if the ListGrid is grouped on a field.
|
boolean |
isGroupNode(ListGridRecord record)
If this listGrid is
grouped , is the record passed in a group
header node. |
java.lang.Boolean |
isPartiallySelected(ListGridRecord record)
When using tree-oriented selection modes like
TreeGrid.cascadeSelection , returns true if the record is considered partially selected because only some of it's
children are selected. |
java.lang.Boolean |
isRowNumberField(ListGridField field)
Identifies whether the passed-in field is the specially generated
rowNumberField used when showRowNumbers is true. |
java.lang.Boolean |
isSelected(ListGridRecord record)
Returns true if the record is selected.
|
java.lang.Boolean |
isSortField(java.lang.String fieldName)
Returns true if the passed fieldName is in the current sort-specification.
|
void |
markForRedraw()
Marks the widget as "dirty" so that it will be added to a queue for redraw.
|
void |
markForRedraw(java.lang.String reason)
Marks the widget as "dirty" so that it will be added to a queue for redraw.
|
void |
markRecordRemoved(int rowNum)
Marks a record deleted such that a later call to
saveEdits()
or saveAllEdits() will cause a "remove" DSRequest to be submitted. |
void |
markRecordsRemoved(int records)
Marks an array of records deleted such that a later call to
saveEdits() or saveAllEdits() will cause a "remove"
DSRequest to be submitted. |
void |
markRecordsRemoved(ListGridRecord... records)
Marks an array of records deleted such that a later call to
saveEdits() or saveAllEdits() will cause a "remove"
DSRequest to be submitted. |
void |
markRecordsRemoved(RecordList records)
Marks an array of records deleted such that a later call to
saveEdits() or saveAllEdits() will cause a "remove"
DSRequest to be submitted. |
void |
markSelectionRemoved()
Marks the currently selected records as removed, as though
markRecordRemoved() had been called. |
protected void |
onInit_ListGrid() |
protected void |
onInit() |
boolean |
openGroup(Record record)
Opens the node represented by the "record" parameter, if it is a folder and is not already open.
|
void |
openRecordDetailGrid(ListGridRecord record,
DataSource detailDataSource)
Deprecated.
|
void |
openRecordEditor(ListGridRecord record)
Deprecated.
|
static void |
preloadImages()
Preload primary ListGrid skin images.
|
void |
recalculateGridSummary()
Refresh the
grid summary , by either re-calculating
from already-loaded data or doing a new fetch from the summaryRowDataSource . |
void |
recalculateSummaries()
Recalculates values for fields with
summary-functions or user formulae defined and
for values displayed in the grid summary and group summary rows . |
void |
recalculateSummaries(Record... records) |
void |
recalculateSummaries(Record[] records,
ListGridField... fields)
Recalculates values for fields with
summary-functions or user formulae defined and
for values displayed in the grid summary and group summary rows . |
boolean |
recordClick(ListGrid viewer,
ListGridRecord record,
int recordNum,
ListGridField field,
int fieldNum,
java.lang.Object value,
java.lang.Object rawValue)
Executed when the listGrid receives a 'click' event on an enabled, non-separator record.
|
java.lang.Boolean |
recordMarkedAsRemoved(int rowNum)
Returns true if the specified record is marked as removed via a call to
markRecordRemoved() |
void |
redrawHeader(boolean rightNow)
Redraw just the
grid header |
void |
refreshCell(int rowNum,
int colNum)
Refresh an individual cell without redrawing the grid.
|
void |
refreshCell(int rowNum,
int colNum,
boolean refreshingRow,
boolean allowEditCellRefresh)
Refresh an individual cell without redrawing the grid.
|
void |
refreshCellStyle(int rowNum,
int colNum)
Refresh the styling of an individual cell without redrawing the grid.
|
void |
refreshData()
Unlike
invalidateCache this will perform an
asynchronous (background) refresh of this components data and then call the provided callback method on completion. |
void |
refreshData(DSCallback callback)
Unlike
invalidateCache this will perform an
asynchronous (background) refresh of this components data and then call the provided callback method on completion. |
void |
refreshFields()
Re-evaluates
ListGridField.showIf() for each field,
dynamically showing and hiding the appropriate set of fields |
void |
refreshRecordComponent(int rowNum)
Discards any
recordComponent currently
assigned to the specified record (or cell) and gets a fresh one, according to the recordComponentPoolingMode |
void |
refreshRecordComponent(int rowNum,
java.lang.Integer colNum)
Discards any
recordComponent currently
assigned to the specified record (or cell) and gets a fresh one, according to the recordComponentPoolingMode |
void |
refreshRow(int rowNum)
Refresh an entire row of cells without redrawing the grid.
|
void |
regroup()
Programmatically regroup the grid according to the current grouping configuration.
|
void |
removeData(Record data)
Remove a record from this ListGrid.
|
void |
removeData(Record data,
DSCallback callback) |
void |
removeData(Record data,
DSCallback callback,
DSRequest requestProperties)
Remove a record from this ListGrid.
|
void |
removeEmbeddedComponent(Canvas component)
Removes an embedded component from a grid.
|
void |
removeEmbeddedComponent(ListGridRecord record)
Removes an embedded component previously associated with the provided record.
|
void |
removeEmbeddedComponent(ListGridRecord record,
java.lang.Integer component)
Removes an embedded component previously associated with the provided record.
|
void |
removeRecordClick(int rowNum)
Method fired when the user clicks the "remove" icon if
canRemoveRecords is true. |
void |
removeSelectedData()
Remove the currently selected records from this component.
|
void |
removeSelectedData(DSCallback callback) |
void |
removeSelectedData(DSCallback callback,
DSRequest requestProperties)
Remove the currently selected records from this component.
|
void |
reorderField(int fieldNum,
int moveToPosition)
Reorder a particular field
|
void |
reorderFields(int start,
int end,
int moveDelta)
Reorder a set of adjacent fields, from start to end exclusive at the end, by distance moveDelta.
NOTE: start and end coordinates are in terms of the currently visible fields, not the full set of fields. |
void |
resizeField(int fieldNum,
int newWidth)
Resize a particular field to a new width.
|
void |
resort()
If a list has become unsorted due to data modification or a call to
unsort() , this method will resort the list by the previous sort-specifier array, if there is one, or by the previous sort-field
and -direction. |
void |
rowClick(ListGridRecord record,
int recordNum,
int fieldNum)
Event handler for when rows in the body are clicked upon.
|
void |
rowClick(ListGridRecord record,
int recordNum,
int fieldNum,
boolean keyboardGenerated)
Event handler for when rows in the body are clicked upon.
|
void |
rowDoubleClick(ListGridRecord record,
int recordNum,
int fieldNum)
Event handler for when a body record is double-clicked.
|
void |
rowDoubleClick(ListGridRecord record,
int recordNum,
int fieldNum,
boolean keyboardGenerated)
Event handler for when a body record is double-clicked.
|
java.lang.Boolean |
rowHasChanges(int rowNum)
If this listGrid can be edited, this method will return true if the row passed in has been edited, but the edits have
not yet been saved to the ListGrid's data object.
|
java.lang.Boolean |
rowHasErrors(int rowNum)
Does the specified row have unresolved errors?
|
boolean |
saveAllEdits()
Save a number of outstanding edits for this ListGrid.
|
boolean |
saveAllEdits(Function callback)
Save a number of outstanding edits for this ListGrid.
|
boolean |
saveAllEdits(Function callback,
int[] rows)
Save a number of outstanding edits for this ListGrid.
|
void |
saveEdits()
Validates and saves edits within the row currently being edited (or another row with unsaved edits, if indicated).
|
void |
saveEdits(EditCompletionEvent editCompletionEvent) |
void |
saveEdits(EditCompletionEvent editCompletionEvent,
java.lang.String callback) |
void |
saveEdits(EditCompletionEvent editCompletionEvent,
java.lang.String callback,
int rowNum)
Validates and saves edits within the row currently being edited (or another row with unsaved edits, if indicated).
|
void |
scrollBodyTo(java.lang.Integer left,
java.lang.Integer top)
Scroll the body of the grid to the specified coordinates.
|
void |
scrollToCell(int rowNum,
int colNum)
Will scroll the listGrid body such that the specified cell is visible close to the center of the viewport.
|
void |
scrollToCell(int rowNum,
int colNum,
Alignment xPosition) |
void |
scrollToCell(int rowNum,
int colNum,
Alignment xPosition,
VerticalAlignment yPosition)
Will scroll the listGrid body such that the specified cell is visible close to the center of the viewport.
|
void |
scrollToColumn(int colNum)
Scroll the grid to specified column such that the row appears near the center of the viewport.
|
void |
scrollToColumn(int colNum,
Alignment xPosition)
Scroll the grid to specified column such that the row appears near the center of the viewport.
|
void |
scrollToRow(int rowNum)
Scroll the grid to specified row such that the row appears near the center of the viewport, loading data if necessary.
|
void |
scrollToRow(int rowNum,
VerticalAlignment yPosition)
Scroll the grid to specified row such that the row appears near the center of the viewport, loading data if necessary.
|
void |
selectAllRecords()
Select all records
|
void |
selectRange(int startRow,
int endRow)
Select a contiguous range of records by index
|
void |
selectRange(int startRow,
int endRow,
boolean newState)
Select a contiguous range of records by index
|
void |
selectRecord(int record)
Select/deselect a
Record passed in explicitly, or by index. |
void |
selectRecord(int record,
boolean newState)
Select/deselect a
Record passed in explicitly, or by index. |
void |
selectRecord(Record record)
Select/deselect a
Record passed in explicitly, or by index. |
void |
selectRecord(Record record,
boolean newState)
Select/deselect a
Record passed in explicitly, or by index. |
void |
selectRecords(int[] records)
Select/deselect a list of
Record s passed in explicitly, or by index. |
void |
selectRecords(int[] records,
boolean newState)
Select/deselect a list of
Record s passed in explicitly, or by index. |
void |
selectRecords(Record[] records)
Select/deselect a list of
Record s passed in explicitly, or by index. |
void |
selectRecords(Record[] records,
boolean newState)
Select/deselect a list of
Record s passed in explicitly, or by index. |
void |
selectSingleRecord(int rowNum)
Select a single
Record passed in explicitly, or by index, and deselect everything else. |
void |
selectSingleRecord(Record record)
Select a single
Record passed in explicitly, or by index, and deselect everything else. |
void |
setAddDropValues(java.lang.Boolean addDropValues)
Indicates whether to add "drop values" to items dropped on this component, if both the source and target widgets are databound, either to the same DataSource or to
different DataSources that are related via a foreign key.
|
void |
setAddFormulaFieldText(java.lang.String addFormulaFieldText)
Text for a menu item allowing users to add a formula field
|
void |
setAddOperation(java.lang.String addOperation)
operationId this component
should use when performing add operations. |
void |
setAddSummaryFieldText(java.lang.String addSummaryFieldText)
Text for a menu item allowing users to add a formula field
|
void |
setAdvancedFieldPickerThreshold(int advancedFieldPickerThreshold)
When
useAdvancedFieldPicker is set, total
number of available fields that must be present in the grid before the advanced field picker interface is used instead
of the normal columns submenu. |
void |
setAllowFilterExpressions(java.lang.Boolean allowFilterExpressions)
For use with
showFilterEditor :true, allows simple
search expressions to be entered into filter fields, as though DynamicForm.allowExpressions were true. |
void |
setAllowFilterOperators(java.lang.Boolean allowFilterOperators)
Causes a menu item titled
"Filter using" to appear
in the headerContextMenu that allows the end
user to pick an advanced search operator to use for this field. |
void |
setAllowRowSpanning(java.lang.Boolean allowRowSpanning)
Should cells in this grid be allowed to span multiple rows? If set to
true , the getRowSpan() method will be called for every cell when rendering
out the listGrid to determine how many rows the cell should span. |
void |
setAlternateBodyStyleName(java.lang.String alternateBodyStyleName)
Optional css style to apply to the body if
alternateRecordStyles is true for this grid. |
void |
setAlternateFieldFrequency(int alternateFieldFrequency)
The number of consecutive columns to draw in the same style before alternating, when
alternateColumnStyles is true. |
void |
setAlternateFieldStyles(boolean alternateFieldStyles)
Whether alternating columns should be drawn in alternating styles, in order to create a vertical "ledger" effect for
easier reading.
|
void |
setAlternateRecordFrequency(int alternateRecordFrequency)
The number of consecutive rows to draw in the same style before alternating, when
alternateRowStyles is true. |
void |
setAlternateRecordStyles(java.lang.Boolean alternateRecordStyles)
Whether alternating rows should be drawn in alternating styles, in order to create a "ledger" effect for easier reading.
|
void |
setAlwaysShowEditors(java.lang.Boolean alwaysShowEditors)
When this attribute is set, editors will be rendered into every row of the grid rather than showing up in a single
record at a time.
|
void |
setAlwaysShowOperatorIcon(java.lang.Boolean alwaysShowOperatorIcon)
When
allowFilterOperators is enabled, whether
to show the operatorIcon for all filterable fields, or
only for fields where the user has explicitly chosen a search operator different from the default operator for the
field. |
void |
setAnimateFolderEffect(AnimationAcceleration animateFolderEffect)
When animating folder opening / closing, this property can be set to apply an animated acceleration effect.
|
void |
setAnimateFolderMaxRows(java.lang.Integer animateFolderMaxRows)
If
animateFolders is true for this grid, this number
can be set to designate the maximum number of rows to animate at a time when opening / closing a folder. |
void |
setAnimateFolders(java.lang.Boolean animateFolders)
If true, when folders are opened / closed children will be animated into view.
|
void |
setAnimateFolderSpeed(int animateFolderSpeed)
When animating folder opening / closing, this property designates the speed of the animation in pixels shown (or hidden)
per second.
|
void |
setAnimateFolderTime(int animateFolderTime)
When animating folder opening / closing, if
TreeGrid.animateFolderSpeed is not set, this property designates the duration of the animation in ms. |
void |
setAnimateRemoveRecord(java.lang.Boolean animateRemoveRecord)
When
canRemoveRecords is enabled, should records
be animated out of view when they are removed by the user? |
void |
setAnimateRemoveSpeed(int animateRemoveSpeed)
When
animating record removal , this property
designates the speed of the animation in pixels per second. |
void |
setAnimateRemoveTime(int animateRemoveTime)
When animating record removal
(see
animateRemoveRecord) , if animateRemoveSpeed is
not set, this property designates the duration of the animation in ms. |
void |
setAnimateRollOver(java.lang.Boolean animateRollOver)
If the
rollOverCanvas is enabled, setting this
property to true ensures that when the rollOverCanvas is displayed it is animated into view
via Canvas.animateShow() . |
void |
setAnimateRollUnder(java.lang.Boolean animateRollUnder)
If the
rollUnderCanvas is enabled, setting this
property to true ensures that when the rollUnderCanvas is displayed it is animated into view
via Canvas.animateShow() . |
void |
setAnimateSelection(java.lang.Boolean animateSelection)
If the
selectionCanvas is enabled, setting this
property to true ensures that when the selectionCanvas is displayed it is animated into view
via Canvas.animateShow() . |
void |
setAnimateSelectionUnder(java.lang.Boolean animateSelectionUnder)
If the
selectionUnderCanvas is enabled,
setting this property to true ensures that when the selectionUnderCanvas is displayed it is
animated into view via Canvas.animateShow() . |
void |
setApplyFormulaAfterSummary(java.lang.Boolean applyFormulaAfterSummary)
If
ListGridField.userFormula is set for some
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 |
setApplyRowNumberStyle(boolean applyRowNumberStyle)
|
void |
setArrowKeyAction(java.lang.String arrowKeyAction)
Action to perform when the listGrid has keyboard focus (but not editing focus) and a user presses the up or down arrow
key.
|
void |
setAsynchGroupingPrompt(java.lang.String asynchGroupingPrompt)
The prompt to display while interactivity is blocked during
asynchronous grouping . |
void |
setAutoComplete(AutoComplete autoComplete)
Whether to do inline autoComplete in text fields during inline editing
Overridden by ListGridField.autoComplete if specified. |
void |
setAutoConfirmSaveEdits(java.lang.Boolean autoConfirmSaveEdits)
For editable listGrids, outstanding unsaved edits when the user performs a new filter or sort will be discarded by
default.
|
void |
setAutoFetchAsFilter(java.lang.Boolean autoFetchAsFilter)
If
DataBoundComponent.setAutoFetchData(Boolean) is true, this attribute determines whether the initial fetch operation should be
performed via DataBoundComponent.fetchData() or DataBoundComponent.filterData() |
void |
setAutoFetchData(java.lang.Boolean autoFetchData)
If true, when this component is first drawn, automatically call
DataBoundComponent.fetchData() or DataBoundComponent.filterData() depending on
DataBoundComponent.getAutoFetchAsFilter() . |
void |
setAutoFetchDisplayMap(java.lang.Boolean autoFetchDisplayMap)
If true, for fields where
ListGridField.optionDataSource is specified, a valueMap will be automatically created by making a DataSource.fetchData() call against the specified dataSource and
extracting a valueMap from the returned records based on the displayField and valueField. |
void |
setAutoFetchTextMatchStyle(TextMatchStyle autoFetchTextMatchStyle)
If
autoFetchData is true , this attribute allows the developer to specify a textMatchStyle
for the initial DataBoundComponent.fetchData() call. |
void |
setAutoFitAllText(java.lang.String autoFitAllText)
If we're showing a
headerContextMenu for this
grid, and canAutoFitFields is true, this attribute
will be shown as the menu item title for an item to perform a one-time autoFit of all visible fields via the autoFitField() method. |
void |
setAutoFitClipFields(java.lang.String... autoFitClipFields)
If
autoFitFieldWidths is enabled and the
calculated field sizes are wide enough that horizontal scrolling would be introduced, this attribute may be set to an
array of fieldNames, causing those fields to be clipped rather than forcing horizontal scrollbars to appear. |
void |
setAutoFitData(Autofit autoFitData)
Should this ListGrid automatically expand to accommodate the size of records and fields?
|
void |
setAutoFitExpandField(java.lang.String autoFitExpandField)
The field to expand if
autoFitFieldWidths and
autoFitFieldsFillViewport are enabled and
auto-fitting will not fill all available horizontal space. |
void |
setAutoFitExtraRecords(java.lang.Integer autoFitExtraRecords)
If
autoFitData is set to "vertical" or
"both" this property specifies the number of additional records for which the grid will expand. |
void |
setAutoFitFieldsFillViewport(java.lang.Boolean autoFitFieldsFillViewport)
If
autoFitFieldWidths is enabled, and extra
space is available after autofitting all fields, should the grid automatically expand one field to fill the extra space. |
void |
setAutoFitFieldText(java.lang.String autoFitFieldText)
If we're showing a
headerContextMenu for this
grid, and user-driven auto fit of fields is enabled via ListGridField.canAutoFitWidth or canAutoFitFields , this attribute will be shown as the
menu item title for an item to perform a one-time autoFit of the field to its title or content via a call to autoFitField() . |
void |
setAutoFitFieldWidths(java.lang.Boolean autoFitFieldWidths)
Should ListGrid fields autofit their widths to titles or content? This property may be overridden on a per-field basis
via
ListGridField.autoFitWidth . |
void |
setAutoFitHeaderHeights(java.lang.Boolean autoFitHeaderHeights)
If this property is set to true, header buttons for either
fields or header spans will automatically expand to
accommodate their titles vertically. |
void |
setAutoFitIconFields(AutoFitIconFieldType autoFitIconFields)
Smart GWT listGrids have special logic to automatically size fields that are displayed as an icon - that is fields with
type:"icon" , fields displaying only value icons , and boolean fields (which are rendered
as a checkmark type icon by default. |
void |
setAutoFitMaxColumns(int autoFitMaxColumns)
If
autoFitData is set to "horizontal" or
"both" this property provides the maximum number of columns for which the ListGrid will expand. |
void |
setAutoFitMaxHeight(java.lang.Integer autoFitMaxHeight)
If
autoFitData is set to "vertical" or
"both" this property provides an upper limit on how far the ListGrid will expand vertically to accommodate
its content. |
void |
setAutoFitMaxRecords(int autoFitMaxRecords)
If
autoFitData is set to "vertical" or
"both" this property provides the maximum number of records for which the ListGrid will expand. |
void |
setAutoFitMaxWidth(java.lang.Integer autoFitMaxWidth)
If
autoFitData is set to "horizontal" or
"both" this property provides an upper limit on how far the ListGrid will expand horizontally to
accommodate its content. |
void |
setAutoFitWidth(java.lang.String fieldName,
boolean autoFit)
Setter for
ListGridField.autoFitWidth . |
void |
setAutoFitWidthApproach(AutoFitWidthApproach autoFitWidthApproach)
When a user requests column autofitting via the
header context menu or via a mouse gesture , what autofit approach is used. |
void |
setAutoSaveEdits(java.lang.Boolean autoSaveEdits)
If this ListGrid is editable, should edits be saved out when the user finishes editing a row (or a cell if
saveByCell is true). |
void |
setAutoSizeHeaderSpans(java.lang.Boolean autoSizeHeaderSpans)
If this listGrid has specified
headerSpans , setting
this attribute to true will cause spans to expand to accommodate long titles if necessary. |
void |
setBadFormulaResultValue(java.lang.String badFormulaResultValue)
If the result of a formula evaluation is invalid (specifically, if isNaN(result)==true), badFormulaResultValue is
displayed instead.
|
void |
setBaseStyle(java.lang.String baseStyle)
base cell style for this listGrid. |
void |
setBodyBackgroundColor(java.lang.String bodyBackgroundColor)
Background color applied to the ListGrid body (that is, the area of the grid where data values are rendered).
Note that this will typically not be visible to the user unless there are few enough rows that there is visible space in the body below the last row. |
void |
setBodyOverflow(Overflow bodyOverflow)
Overflow setting for the "body", that is, the area of the grid where data values are rendered.
|
void |
setBodyStyleName(java.lang.String bodyStyleName)
CSS style used for the body of this grid.
|
void |
setBooleanBaseStyle(java.lang.String booleanBaseStyle)
An optional CSS style to apply to the checkbox image.
|
void |
setBooleanFalseImage(java.lang.String booleanFalseImage)
Image to display for a false value in a boolean field.
|
void |
setBooleanImageHeight(int booleanImageHeight)
|
void |
setBooleanImageWidth(int booleanImageWidth)
|
void |
setBooleanPartialImage(java.lang.String booleanPartialImage)
Image to display for a partially true value in a boolean field (typically selection).
|
void |
setBooleanTrueImage(java.lang.String booleanTrueImage)
Image to display for a true value in a boolean field.
|
void |
setCanAcceptDroppedRecords(java.lang.Boolean canAcceptDroppedRecords)
Indicates whether records can be dropped into this listGrid.
|
void |
setCanAddFormulaFields(java.lang.Boolean canAddFormulaFields)
Adds an item to the header context menu allowing users to launch a dialog to define a new
field based on values present in other fields, using the
com.smartgwt.client..FormulaBuilder .
|
void |
setCanAddSummaryFields(java.lang.Boolean canAddSummaryFields)
Adds an item to the header context menu allowing users to launch a dialog to define a new
text field that can contain both user-defined text and the formatted values present in other
fields, using the
com.smartgwt.client..SummaryBuilder .
|
void |
setCanAutoFitFields(java.lang.Boolean canAutoFitFields)
Can the user perform one-time autofit for specific columns in this grid?
|
void |
setCancelEditingConfirmationMessage(java.lang.String cancelEditingConfirmationMessage)
If this is an editable listGrid, and
this.confirmCancelEditing is true this property is used as the message
to display in the confirmation dismissal prompt. |
void |
setCanCollapseGroup(java.lang.Boolean canCollapseGroup)
Can a group be collapsed/expanded? When true a collapse/expand icon is shown (
groupIcon ) and the user can collapse or expand the group by
clicking either the row as a whole or the opener icon (see collapseGroupOnRowClick ); When false the group
icon is not shown and clicking on the row does not change group state. |
void |
setCanDragRecordsOut(java.lang.Boolean canDragRecordsOut)
Indicates whether records can be dragged from this listGrid and dropped elsewhere.
|
void |
setCanDragSelect(java.lang.Boolean canDragSelect)
If this property is true, users can drag the mouse to select several rows or cells.
|
void |
setCanDragSelectText(java.lang.Boolean canDragSelectText)
If this property is true, users can drag the mouse to select text within grid rows.
|
void |
setCanDropInEmptyArea(java.lang.Boolean canDropInEmptyArea)
If set to false, dropping over an empty part of the grid body is disallowed and the no-drop indicator is displayed.
|
void |
setCanEdit(java.lang.Boolean canEdit)
Can the user edit cells in this listGrid? Can be set for the listGrid, and overridden for individual fields.
If 'canEdit' is false at the listGrid level, fields can never be edited - in this case the canEdit property on individual fields will be ignored. If 'canEdit' is set to true at the listGrid level, setting the 'canEdit' property to false at the field level will prevent the field from being edited inline. If 'canEdit' is not set at the listGrid level, setting 'canEdit' to true at the field level enables the field to be edited inline. |
void |
setCanEditFieldAttribute(java.lang.String canEditFieldAttribute)
If this component is bound to a dataSource, this attribute may be specified to customize what fields from the dataSource
may be edited by default.
|
void |
setCanEditHilites(boolean canEditHilites)
Adds an item to the header context menu allowing users to launch a dialog to define grid hilites using the
HiliteEditor . |
void |
setCanEditTitles(boolean canEditTitles)
If set to true, the
advanced field picker
provides an interface allowing users to modify fields' titles. |
void |
setCanExpandMultipleRecords(java.lang.Boolean canExpandMultipleRecords)
When
canExpandRecords is true, this property
indicates whether multiple records can be expanded simultaneously. |
void |
setCanExpandRecordProperty(java.lang.String canExpandRecordProperty)
Property name on a record that will be checked to determine whether a record can be expanded.
|
void |
setCanExpandRecords(java.lang.Boolean canExpandRecords)
When set to true, shows an additional field at the beginning of the field-list (respecting RTL) to allow users to expand
and collapse individual records.
|
void |
setCanFocusInEmptyGrid(boolean canFocusInEmptyGrid)
If the listGrid is empty, should the user be able to put focus into the grid body by tabbing to it?
|
void |
setCanFreezeFields(java.lang.Boolean canFreezeFields)
Whether an interface should be shown to allow user is allowed to dynamically "freeze" or "unfreeze" columns with respect
to horizontally scrolling.
|
void |
setCanGroupBy(java.lang.Boolean canGroupBy)
If false, grouping via context menu will be disabled.
|
void |
setCanHover(java.lang.Boolean canHover)
If true, cellHover and rowHover events will fire and then a hover will be shown (if not canceled) when the user leaves
the mouse over a row / cell unless the corresponding field has
showHover set to false. |
void |
setCanMultiGroup(boolean canMultiGroup)
When true, indicates that this ListGrid supports grouping on multiple fields.
|
void |
setCanMultiSort(java.lang.Boolean canMultiSort)
When true, indicates that this ListGrid supports sorting on multiple fields.
|
void |
setCanPickFields(java.lang.Boolean canPickFields)
Indicates whether the field picker item and submenu should be present in the header context menu.
|
void |
setCanPickOmittedFields(java.lang.Boolean canPickOmittedFields)
If this grid has a specified
dataSource , and useAllDataSourceFields is false, setting this
property to true will cause all dataSource fields not included in the specified set of fields to show up in the field picker menu item . |
void |
setCanRemoveRecords(java.lang.Boolean canRemoveRecords)
If set, provide UI for the user to remove records from the grid as an additional field showing the
removeIcon , which, when clicked, will call removeRecordClick() which removes the row from the data set
(or if deferRemoval is true changes the markRecordRemoved() status for the record). |
void |
setCanReorderFields(java.lang.Boolean canReorderFields)
Indicates whether fields in this listGrid can be reordered by dragging and dropping header fields.
|
void |
setCanReorderRecords(java.lang.Boolean canReorderRecords)
Indicates whether records can be reordered by dragging within this
ListGrid . |
void |
setCanResizeFields(java.lang.Boolean canResizeFields)
Indicates whether fields in this listGrid can be resized by dragging header fields.
|
void |
setCanSelectAll(java.lang.Boolean canSelectAll)
Controls whether a checkbox for selecting all records appears in the header with
selectionAppearance set to "checkbox" |
void |
setCanSelectCells(java.lang.Boolean canSelectCells)
Enables cell-level selection behavior as well as
cell-level rollover . |
void |
setCanSelectGroups(boolean canSelectGroups)
Controls whether a checkbox for selecting
groups appears in
the group node if SelectionAppearance is set to "checkbox" |
void |
setCanSort(java.lang.Boolean canSort)
Enables or disables interactive sorting behavior for this listGrid.
|
void |
setCanTabToHeader(java.lang.Boolean canTabToHeader)
Should the header be included in the tab-order for the page? If not explicitly specified, the header will be included in
the tab order for the page if
isc.setScreenReaderMode() is
called. |
void |
setCellFormatter(CellFormatter formatter)
Sets a formatter that returns the HTML to display in each cell of the grid,
given the raw cell value.
|
void |
setCellHeight(int cellHeight)
The default height of each row in pixels.
|
void |
setCellPadding(int cellPadding)
The amount of empty space, in pixels, surrounding each value in its cell.
|
void |
setCellValueHoverFormatter(CellValueHoverFormatter formatter)
Provide a custom implementation of
cellValueHoverHTML(ListGridRecord, int, int, String) . |
void |
setChartConstructor(java.lang.String chartConstructor)
Name of the Smart GWT Class to be used when creating charts.
|
void |
setChartType(ChartType chartType)
Default type of chart to plot.
|
void |
setCheckboxFieldFalseImage(java.lang.String checkboxFieldFalseImage)
If
selectionAppearance is set to
"checkbox" this property determines the image to display in the checkbox field for an unselected row. |
void |
setCheckboxFieldImageHeight(java.lang.Integer checkboxFieldImageHeight)
If
selectionAppearance is set to
"checkbox" this property may be set to govern the height of the checkbox image displayed to indicate
whether a row is selected. |
void |
setCheckboxFieldImageWidth(java.lang.Integer checkboxFieldImageWidth)
If
selectionAppearance is set to
"checkbox" this property may be set to govern the width of the checkbox image displayed to indicate whether
a row is selected. |
void |
setCheckboxFieldPartialImage(java.lang.String checkboxFieldPartialImage)
If
selectionAppearance is set to
"checkbox" this property determines the image to display in the checkbox field for a partially selected
row. |
void |
setCheckboxFieldProperties(ListGridField checkboxField)
Standard properties to apply to the automatically generated checkbox field, shown when
selectionAppearance is set to "checkbox". |
void |
setCheckboxFieldTrueImage(java.lang.String checkboxFieldTrueImage)
If
selectionAppearance is set to
"checkbox" this property determines the image to display in the checkbox field for a selected row. |
void |
setChildExpansionMode(ExpansionMode childExpansionMode)
For
expansionModes that show another grid or tree, what the child's
expansionMode should be. |
void |
setClearAllSortingText(java.lang.String clearAllSortingText)
If we're showing a
headerContextMenu for this
grid, this attribute will be shown as the menu item title to clear any existing sort on all fields. |
void |
setClearFilterText(java.lang.String clearFilterText)
If we're showing a
headerContextMenu for this
grid, and a filter-editor is visible, this
attribute will be shown as the menu item title to clear any existing filter. |
void |
setClearSortFieldText(java.lang.String clearSortFieldText)
If we're showing a
headerContextMenu for this
grid, this attribute will be shown as the menu item title to clear an existing sort on this field. |
void |
setClipHeaderTitles(java.lang.Boolean clipHeaderTitles)
Whether the ListGrid should manage the clipping of titles of header buttons, showing ellipses if the title is clipped,
and potentially showing the full title on
hover . |
void |
setCollapseGroupOnRowClick(boolean collapseGroupOnRowClick)
If
canCollapseGroup is true, will a click anywhere
on the group row toggle the group's expanded state? If false, the user must click the groupIcon directly to toggle the group. |
void |
setConfigureGroupingText(java.lang.String configureGroupingText)
If we're showing a
headerContextMenu for this
grid, and multi-grouping is enabled, this attribute is used as the title for a menu item that opens a MultiGroupDialog to configure the grouping for this grid. |
void |
setConfigureSortText(java.lang.String configureSortText)
If we're showing a
headerContextMenu for this
grid, and multi-sorting is enabled, this attribute is used as the title for a menu item that opens a MultiSortDialog to configure the sort-specification for this grid. |
void |
setConfirmCancelEditing(java.lang.Boolean confirmCancelEditing)
If this is an editable listGrid, when the user attempts to cancel an edit, should we display a confirmation prompt
before discarding the edited values for the record?
|
void |
setConfirmDiscardEdits(java.lang.Boolean confirmDiscardEdits)
For editable listGrids, outstanding unsaved edits when the user performs a new filter or sort will be discarded.
|
void |
setConfirmDiscardEditsMessage(java.lang.String confirmDiscardEditsMessage)
If
this.confirmDiscardEdits is true, this property can be used to customize the error message string
displayed to the user in a dialog with options to cancel the action, or save or discard pending edits in response to
sort/filter actions that would otherwise drop unsaved edit values. |
void |
setCriteria(Criteria criteria)
Sets this component's filter criteria.
|
void |
setData(ListGridRecord... data)
A list of ListGridRecord objects, specifying the data to be used to populate the ListGrid.
|
void |
setData(Record[] data) |
void |
setData(RecordList data) |
void |
setDataFetchDelay(java.lang.Integer dataFetchDelay)
Delay in milliseconds before fetching data.
|
void |
setDataFetchMode(FetchMode dataFetchMode)
How to fetch and manage records retrieve from the server.
|
void |
setDataPageSize(int dataPageSize)
When using
data
paging , how many records to fetch at a time. |
void |
setDataProperties(ResultSet resultSetProperties)
For databound ListGrids, this attribute can be used to customize the
ResultSet object created for this grid when data is
fetched. |
void |
setDataSource(DataSource dataSource)
The DataSource that this component should bind to for default fields and for performing
DataSource requests . |
void |
setDataSource(DataSource dataSource,
ListGridField... fields)
Bind to a DataSource.
|
void |
setDataSource(java.lang.String dataSource)
The DataSource that this component should bind to for default fields and for performing
DataSource requests . |
void |
setDateFormatter(DateDisplayFormat dateFormatter)
How should Date type values be displayed in this ListGrid by default?
|
void |
setDateInputFormat(java.lang.String dateInputFormat)
If this is an editable listGrid, this property will specify the
inputFormat applied to editors for fields of type
"date" . |
void |
setDatetimeFormatter(DateDisplayFormat datetimeFormatter)
Display format to use for fields specified as type 'datetime'.
|
void |
setDeepCloneOnEdit(java.lang.Boolean deepCloneOnEdit)
Before we start editing values in this DataBoundComponent, should we perform a deep clone
of the underlying values.
|
void |
setDefaultFields(ListGridField... defaultFields)
An array of listGrid field configuration objects.
|
void |
setDefaultFieldWidthCustomizer(DefaultFieldWidthCustomizer customizer)
Method to calculate and return the default width of a field.
|
void |
setDefaultFilterOperator(OperatorId defaultFilterOperator)
Default
filter operator to use for text-based fields in this grid's filter editor , when producing AdvancedCriteria . |
void |
setDefaultFilterOperatorSuffix(java.lang.String defaultFilterOperatorSuffix)
Text to show after the name of the default filterOperator in the
headerContextMenu when allowFilterOperators is enabled. |
static void |
setDefaultProperties(ListGrid listGridProperties)
Class level method to set the default properties of this class.
|
void |
setDeferRemoval(java.lang.Boolean deferRemoval)
When enabled, the field shown by
canRemoveRecords
causes records to be marked for future removal via markRecordRemoved() instead of immediately being removed. |
void |
setDetailDS(DataSource detailDS)
If
canExpandRecords is true and listGrid.expansionMode is "related" , this property specifies the
dataSource for the related records grid to be shown embedded in expanded records. |
void |
setDetailDS(java.lang.String detailDS)
If
canExpandRecords is true and listGrid.expansionMode is "related" , this property specifies the
dataSource for the related records grid to be shown embedded in expanded records. |
void |
setDetailField(java.lang.String detailField)
The field whose contents to show in the expanded portion of a record when
canExpandRecords is true and listGrid.expansionMode is detailField . |
void |
setDiscardEditsOnHideField(boolean discardEditsOnHideField)
If a user is editing a
canEdit:true listGrid, and they hide
a field while the editor is showing, should we discard any edits in the edit row for the field being hidden? |
void |
setDiscardEditsSaveButtonTitle(java.lang.String discardEditsSaveButtonTitle)
If
confirmDiscardEdits is true this is the
title for the save button appearing in the lost edits confirmation dialog. |
void |
setDontAutoDestroyComponent(Canvas component,
boolean dontAutoDestroy)
If
showRecordComponents is true, by default
any created record components are destroyed once they are no longer in use (for example, if the ListGrid as a whole is
destroyed). |
void |
setDragDataAction(DragDataAction dragDataAction)
Indicates what to do with data dragged into another DataBoundComponent.
|
void |
setDragScrollRedrawDelay(int dragScrollRedrawDelay)
Like
scrollRedrawDelay , but applies when the
component is being drag-scrolled (via a scrollbar). |
void |
setDragTrackerIconCustomizer(DragTrackerIconCustomizer dragTrackerIconCustomizer)
HTML to be shown in hovers over cells in the column described by this field.
|
void |
setDragTrackerMode(DragTrackerMode dragTrackerMode)
When records are being dragged from within a ListGrid, what sort of drag-tracker should be displayed?
Note that if multiple records are being dragged the displayed tracker will be based on the first selected record. |
void |
setDragTrackerStyle(java.lang.String dragTrackerStyle)
CSS Style to apply to the drag tracker when dragging occurs on this component.
|
void |
setDragTrackerTitleCustomizer(DragTrackerTitleCustomizer dragTrackerTitleCustomizer)
Return "title" HTML to display as a drag tracker when the user drags some record.
Default implementation will display the cell value for the title field (see +link{listGrid.getTitleField()}) for the record(s) being dragged (including any icons / custom formatting / styling, etc). |
void |
setDrawAheadRatio(float drawAheadRatio)
How far should we render rows ahead of the currently visible area? This is expressed as a ratio from viewport size to
rendered area size.
|
void |
setDrawAllMaxCells(int drawAllMaxCells)
If drawing all rows would cause less than
drawAllMaxCells cells to be rendered, the full dataset will
instead be drawn even if showAllRecords is false and
the viewport size and drawAheadRatio setting would
normally have caused incremental rendering to be used. |
void |
setDropValues(java.util.Map dropValues)
When an item is dropped on this component, and
addDropValues is true and both the source and
target widgets are databound, either to the same DataSource or to different DataSources that are related via a foreign key, this object provides the "drop values" that
Smart GWT will apply to the dropped object before updating it. |
void |
setDuplicateDragMessage(java.lang.String duplicateDragMessage)
Message to show when a user attempts to transfer duplicate records into this component, and
preventDuplicates
is enabled. |
void |
setEditByCell(java.lang.Boolean editByCell)
Determines whether when the user edits a cell in this listGrid the entire row becomes editable, or just the cell that
received the edit event.
|
void |
setEditEvent(ListGridEditEvent editEvent)
Event that will trigger inline editing, see
ListGridEditEvent for options. |
void |
setEditFailedBaseStyle(java.lang.String editFailedBaseStyle)
A base name for the CSS class applied to cells when editing has failed.
If this listGrid is editable, this style will be applied to any edited cells for which validation failed. As with the default 'baseStyle' property, this style will have "Dark", "Over", "Selected", or "Disabled" appended to it according to the state of the cell. If null, cells for which editing has failed will be rendered using the normal base style classNames, but with custom CSSText applied as derived from this.editFailedCSSText |
void |
setEditFailedCSSText(java.lang.String editFailedCSSText)
Custom CSS text to be applied to cells when editing has failed.
If this listGrid is editable, this css text will be applied to any edited cells for which validation failed, on top of the base style for the cell. For further customization of styling for cells that failed editing validation, use this.editFailedBaseStyle instead. |
void |
setEditFormulaFieldText(java.lang.String editFormulaFieldText)
Text for a menu item allowing users to edit a formula field
|
void |
setEditOnF2Keypress(java.lang.Boolean editOnF2Keypress)
Should we start editing when the widget has focus and the user presses the "f2" key (if this ListGrid supports editing)?
|
void |
setEditOnFocus(java.lang.Boolean editOnFocus)
Should we start editing when this widget receives focus (if this ListGrid supports editing)?
|
void |
setEditorCustomizer(ListGridEditorCustomizer customizer)
This method allows developers to dynamically customize the form item displayed in an editable grid, based
on the cell being edited.
|
void |
setEditorValueMap(java.lang.String fieldName,
java.util.LinkedHashMap valueMap)
Set a valueMap to display for this field while editing.
This method sets the +link{ListGridField.editorValueMap, field.editorValueMap} property and may be called at runtime while editing the grid. |
void |
setEditorValueMap(java.lang.String fieldName,
java.lang.String... valueMap)
Set a valueMap to display for this field while editing.
This method sets the +link{ListGridField.editorValueMap, field.editorValueMap} property and may be called at runtime while editing the grid. |
void |
setEditPendingBaseStyle(java.lang.String editPendingBaseStyle)
A base name for the CSS class applied to cells containing pending (unsaved) edits
As with the default 'baseStyle' property, this style will have "Dark", "Over", "Selected", or "Disabled" appended to it according to the state of the cell. |
void |
setEditPendingCSSText(java.lang.String editPendingCSSText)
Custom CSS text to be applied to cells with pending edits that have not yet been submitted.
For further customization of styling for cells with pending edits use this.editPendingBaseStyle instead. |
void |
setEditProxyConstructor(java.lang.String editProxyConstructor)
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode . |
void |
setEditSummaryFieldText(java.lang.String editSummaryFieldText)
Text for a menu item allowing users to edit the formatter for a field
|
void |
setEditValue(int rowNum,
int colNum,
boolean value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
java.lang.Boolean value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
java.util.Date value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
double value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
float value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
int value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
java.lang.Integer value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
com.google.gwt.core.client.JavaScriptObject value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
java.lang.Object value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
Record value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
Record[] value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
int colNum,
java.lang.String value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
boolean value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
java.lang.Boolean value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
java.util.Date value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
double value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
float value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
int value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
java.lang.Integer value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
com.google.gwt.core.client.JavaScriptObject value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
java.lang.Object value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
Record value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
Record[] value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValue(int rowNum,
java.lang.String fieldName,
java.lang.String value)
Modifies a field value being tracked as an unsaved user edit.
|
void |
setEditValues(int rowNum,
java.util.Map values)
This method sets up a set of editValues for some row / cell.
|
void |
setEmptyCellValue(java.lang.String emptyCellValue)
The value to display for cells whose value is null or the empty string after applying
formatting and valueMap (if any). |
void |
setEmptyMessage(java.lang.String emptyMessage)
The string to display in the body of a listGrid with an empty data array, if showEmptyMessage is true.
|
void |
setEmptyMessageStyle(java.lang.String emptyMessageStyle)
The CSS style name applied to the
emptyMessage if
displayed. |
void |
setEnforceVClipping(java.lang.Boolean enforceVClipping)
For performance reasons, even when
fixedRecordHeights is set, vertical clipping is not enforced by default for some kinds of content (such as images) on
all browsers. |
void |
setEnterKeyEditAction(EnterKeyEditAction enterKeyEditAction)
What to do when a user hits enter while editing a cell: "nextCell": start editing the next editable cell in
this record (or the first editable cell in the next record if focus is in the last editable cell in the row)
"nextRow": start editing the same field in the next row (skipping any rows where that would be a non-editable
cell.
|
void |
setEnumCriteriaAsInitialValues(java.lang.Boolean enumCriteriaAsInitialValues)
In a ListGrid that has a DataSource and has filter criteria that include values for fields declared as
type "enum" in the DataSource, by default a newly edited row will use those filter
criteria as initial values. |
void |
setErrorIconHeight(java.lang.Integer errorIconHeight)
Height of the error icon, if we're showing icons when validation errors occur.
|
void |
setErrorIconSrc(java.lang.String errorIconSrc)
Src of the image to show as an error icon, if we're showing icons when validation errors occur.
|
void |
setErrorIconWidth(java.lang.Integer errorIconWidth)
Height of the error icon, if we're showing icons when validation errors occur.
|
void |
setEscapeKeyEditAction(EscapeKeyEditAction escapeKeyEditAction)
What to do when a user hits escape while editing a cell: "cancel": close the editor and discard the current set
of edit values "done": just close the editor (the edit is complete, but the edited values are retained).
|
void |
setExpansionCanEdit(java.lang.Boolean expansionCanEdit)
For
expansionModes that show another grid or tree, is that component
editable? |
void |
setExpansionComponentPoolingMode(ExpansionComponentPoolingMode expansionComponentPoolingMode)
The method of
component-pooling to employ for expansionComponents . |
void |
setExpansionEditorSaveDialogPrompt(java.lang.String expansionEditorSaveDialogPrompt)
When
canExpandRecords is true and expansionMode is editor, the prompt to display in a
dialog when an expanded row is collapsed while it's nested editor has changed values. |
void |
setExpansionEditorShowSaveDialog(java.lang.Boolean expansionEditorShowSaveDialog)
When
canExpandRecords is true and expansionMode is editor, whether a dialog should be
displayed when an expanded row is collapsed while it's nested editor has changed values. |
void |
setExpansionFieldFalseImage(java.lang.String expansionFieldFalseImage)
If
canExpandRecords is set to true ,
this property determines the image to display in the expansion field for collapsed rows. |
void |
setExpansionFieldImageHeight(java.lang.Integer expansionFieldImageHeight)
If
canExpandRecords is set to true ,
this property may be set to govern the height of the expansion image displayed to indicate whether a row is expanded. |
void |
setExpansionFieldImageWidth(java.lang.Integer expansionFieldImageWidth)
If
canExpandRecords is set to true ,
this property may be set to govern the width of the expansion image displayed to indicate whether a row is expanded. |
void |
setExpansionFieldTrueImage(java.lang.String expansionFieldTrueImage)
If
canExpandRecords is set to true ,
this property determines the image to display in the expansion field for expanded rows. |
void |
setExpansionMode(ExpansionMode expansionMode)
The
ExpansionMode for records in this grid. |
void |
setExportAll(java.lang.Boolean exportAll)
Setting exportAll to true prevents the component from passing its list of fields to the
export call.
|
void |
setExportAlternateRowBGColor(java.lang.String exportAlternateRowBGColor)
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , background color
to use for even-numbered rows, to create a "banded" or "ledger" effect. |
void |
setExportDefaultBGColor(java.lang.String exportDefaultBGColor)
Default background color to use when exporting data to Excel/OpenOffice format using
exportData() or exportClientData() . |
void |
setExportFieldAlignments(boolean exportFieldAlignments)
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , whether field
horizontal header alignments and data value alignments should be replicated in the resulting
spreadsheet. |
void |
setExportFields(java.lang.String[] exportFields)
The list of field-names to export.
|
void |
setExportFieldWidths(boolean exportFieldWidths)
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , whether widths
of fields should be replicated in the resulting spreadsheet. |
void |
setExportHeaderHeights(boolean exportHeaderHeights)
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , causes the
headerHeight and headerSpan heights to be applied to the corresponding cells in
the spreadsheet. |
void |
setExportRawValues(java.lang.Boolean exportRawValues)
Dictates whether the data in this grid should be exported raw by
exportClientData() . |
void |
setExportWidthScale(double exportWidthScale)
Scaling factor to translate from ListGrid field widths in pixels to Excel/OpenOffice units for field width, which are
1/256th of the width of the widest digit character in the default font for the spreadsheet.
|
void |
setExportWrapHeaderTitles(boolean exportWrapHeaderTitles)
When exporting data to Excel/OpenOffice format using
exportData() or exportClientData() , whether titles
in the ListGrid header and headerSpans should be allowed to wrap. |
void |
setFastCellUpdates(java.lang.Boolean fastCellUpdates)
Note: This property only has an effect in Internet Explorer
|
void |
setFetchDelay(int fetchDelay)
If we're showing the filterEditor (
showFilterEditor is true), and we're re-filtering on every keypress (filterOnKeypress is true), this property is the delay in
milliseconds between the user changing the filter and the filter request being kicked off. |
void |
setFetchOperation(java.lang.String fetchOperation)
Operation ID this component should use when performing fetch operations.
|
void |
setFieldButtonProperties(java.lang.String name,
Canvas properties)
Method to update properties on a field's header button at runtime.
|
void |
setFieldCellIcon(java.lang.String fieldName,
java.lang.String cellIcon)
Change the
ListGridField.cellIcon for a field after
the grid is created |
void |
setFieldError(int rowNum,
java.lang.String fieldName,
java.lang.String errorMessage)
Set a validation error for some cell.
|
void |
setFieldError(int rowNum,
java.lang.String fieldName,
java.lang.String[] errorMessages) |
void |
setFieldHeaderBaseStyle(java.lang.String name,
java.lang.String newStyle)
Update the
ListGridField.headerBaseStyle for a
field within the grid at runtime. |
void |
setFieldHeaderTitleStyle(java.lang.String name,
java.lang.String newStyle)
Update the
ListGridField.headerTitleStyle for
a field within the grid at runtime. |
void |
setFieldIcon(java.lang.String fieldName,
java.lang.String icon)
Change the
ListGridField.icon for a field after the grid
is created |
void |
setFieldPickerFieldProperties(java.lang.String... fieldPickerFieldProperties)
Names of properties on
ListGridField for which the FieldPicker should show an editing interface, for convenience. |
void |
setFieldPickerShowSampleValues(java.lang.Boolean fieldPickerShowSampleValues)
When set to false, sample values of the FieldPicker are never shown.
|
void |
setFieldProperties(int fieldNum,
ListGridField properties)
Dynamically set properties for a particular field.
|
void |
setFieldProperties(java.lang.String fieldNum,
ListGridField properties)
Dynamically set properties for a particular field.
|
void |
setFields(com.google.gwt.core.client.JavaScriptObject... fields)
Field setter variant (alternative to
setFields(FormItem...) ,
setFields(ListGridField...) ,
etc.) that will accept an array of JavaScriptObject, rather than an array of SmartGWT
Java wrappers of the field class type (e.g. |
void |
setFields(ListGridField... fields)
An array of field objects, specifying the order, layout, formatting, and sorting behavior of each field in the listGrid
object.
|
void |
setFieldState(java.lang.String fieldState)
Initial
field state for the grid. |
void |
setFieldTitle(int fieldNum,
java.lang.String title)
Change the title of a field after the grid is created.
|
void |
setFieldTitle(java.lang.String fieldNum,
java.lang.String title)
Change the title of a field after the grid is created.
|
void |
setFieldVisibilitySubmenuTitle(java.lang.String fieldVisibilitySubmenuTitle)
If we're showing a
headerContextMenu for this
grid, and this.canPickFields is true, this attribute
will be shown as the title for the menu item which contains a submenu with items allowing the user to show and hide
fields in the grid. |
void |
setFilterButtonPrompt(java.lang.String filterButtonPrompt)
The prompt to show when the mouse hovers over the Filter button in the FilterEditor.
|
void |
setFilterButtonProperties(Button filterButtonProperties)
If
showFilterEditor is true, this attribute may be
used to customize the filter button shown to the right of the filterEditor row. |
void |
setFilterByCell(java.lang.Boolean filterByCell)
If we're showing the filterEditor (this.showFilterEditor is true), this property determines whether this list should be
filtered every time the user puts focus in a different field in the filter editor.
|
void |
setFilterEditorCriteria(Criteria criteria)
If
showFilterEditor is true, this method will
update the criteria shown in the filterEditor without performing a filter. |
void |
setFilterEditorHeight(int filterEditorHeight)
Height for the filterEditor, if shown.
|
void |
setFilterEditorProperties(ListGrid filterEditorProperties)
Deprecated.
in favor of
setFilterEditorProperties(RecordEditor) |
void |
setFilterEditorProperties(RecordEditor filterEditorProperties)
Properties to apply to the automatically generated
filterEditor if showFilterEditor is true. |
void |
setFilterLocalData(java.lang.Boolean filterLocalData)
Causes filtering to be performed against the local data set, even when a
dataSource is provided. |
void |
setFilterOnKeypress(java.lang.Boolean filterOnKeypress)
If we're showing the filterEditor (this.showFilterEditor is true), this property determines whether this list should be
filtered every time the user modifies the value in a field of the filter-editor.
|
void |
setFilterUsingText(java.lang.String filterUsingText)
Text for the menu item shown in the
headerContextMenu when allowFilterOperators
is enabled. |
void |
setFixedFieldWidths(java.lang.Boolean fixedFieldWidths)
Should we horizontally clip cell contents, or allow columns to expand horizontally to show all contents?
|
void |
setFixedRecordHeights(java.lang.Boolean fixedRecordHeights)
Should we vertically clip cell contents, or allow rows to expand vertically to show all contents?
|
void |
setFormulaBuilderSpanTitleSeparator(java.lang.String formulaBuilderSpanTitleSeparator)
If this grid has specified
headerSpans , and showHeaderSpanTitlesInFormulaBuilder
is true, this string will be inserted between the headerSpan title(s) and the field title in the field chooser grid in
the FormulaBuilder and SummaryBuilder. |
void |
setFreezeFieldText(java.lang.String freezeFieldText)
If we're showing a
headerContextMenu for this
grid and this.canFreezeFields is true, this string
will be shown as the title for the menu item to freeze a currently unfrozen field. |
void |
setFreezeOnLeftText(java.lang.String freezeOnLeftText)
If we're showing a
headerContextMenu for this
grid and this.canFreezeFields is true, this string
will be shown as the title for the menu item to freeze fields on the left of the scrollable body. |
void |
setFreezeOnRightText(java.lang.String freezeOnRightText)
If we're showing a
headerContextMenu for this
grid and this.canFreezeFields is true, this string
will be shown as the title for the menu item to freeze fields on the right of the scrollable body. |
void |
setFrozenBaseStyle(java.lang.String frozenBaseStyle)
If this listGrid contains any frozen fields, this property can be used to apply a custom baseStyle to all cells in those
frozen fields.
|
void |
setFrozenHeaderBaseStyle(java.lang.String frozenHeaderBaseStyle)
If this listGrid contains any frozen fields, this property can be used to apply a custom headerBaseStyle to the frozen
set of fields.
|
void |
setFrozenHeaderTitleStyle(java.lang.String frozenHeaderTitleStyle)
If this listGrid contains any frozen fields, this property can be used to apply a custom headerTitleStyle to the frozen
set of fields.
|
void |
setGenerateClickOnEnter(java.lang.Boolean generateClickOnEnter)
If true, when the user navigates to a cell using arrow keys and hits Enter, the cell will respond to a click event.
|
void |
setGenerateClickOnSpace(java.lang.Boolean generateClickOnSpace)
If true, when the user navigates to a cell using arrow keys and hits space, the cell will respond to a click event.
|
void |
setGenerateDoubleClickOnEnter(java.lang.Boolean generateDoubleClickOnEnter)
If true, when the user navigates to a cell using arrow keys and hits Enter, the cell will respond to a double click
event.
|
void |
setGenerateDoubleClickOnSpace(java.lang.Boolean generateDoubleClickOnSpace)
If true, when the user navigates to a cell using arrow keys and hits Space, the cell will respond to a double click
event.
|
void |
setGridComponents(ListGridComponent... gridComponents)
Array of components that make up this grid.
|
void |
setGridComponents(java.lang.Object... gridComponents)
Array of components that make up this grid.
|
void |
setGridSummaryRecordProperty(java.lang.String gridSummaryRecordProperty)
If
showGridSummary is true, this attribute will be
set to true on the record object representing the grid summary row. |
void |
setGroupByAsyncThreshold(int groupByAsyncThreshold)
When grouping is requested with this number of records or more, an asynchronous approach is used to avoid the browser
showing a "script is running slowly.." message prompting the user to stop execution of JavaScript.
|
void |
setGroupByField(java.lang.String... groupByField)
List of fields to group grid records.
|
void |
setGroupByField(java.lang.String groupByField)
List of fields to group grid records.
|
void |
setGroupByFieldSummaries(java.lang.String... groupByFieldSummaries)
If this grid is
grouped , and showGroupSummary is true, this attribute may be set to an
array of groupBy field names for which group summaries should appear. |
void |
setGroupByMaxRecords(int groupByMaxRecords)
Maximum number of records to which a groupBy can be applied.
|
void |
setGroupByText(java.lang.String groupByText)
If we're showing a
headerContextMenu for this
grid and this.canGroupBy is true, this string will be
shown as the title for the menu item to toggle the group by setting for a field. |
void |
setGroupIcon(java.lang.String groupIcon)
The URL of the base icon for the group icons in this listGrid.
|
void |
setGroupIconSize(int groupIconSize)
Default width and height of group icons for this ListGrid.
|
void |
setGroupIndentSize(int groupIndentSize)
Default number of pixels by which to indent subgroups relative to parent group.
|
void |
setGroupLeadingIndent(int groupLeadingIndent)
Default number of pixels by which to indent all groups.
|
void |
setGroupNodeBaseStyle(java.lang.String groupNodeBaseStyle)
Base style for group rows. |
void |
setGroupNodeStyle(java.lang.String groupNodeStyle)
The CSS style that
group rows will have. |
void |
setGroupSortDirection(SortDirection groupSortDirection)
When
sortByGroupFirst is active, the sorting
direction applied for implicit sorting by the field(s) used for grouping. |
void |
setGroupStartOpen(GroupStartOpen group)
Describes the default state of ListGrid groups when groupBy is called.
|
void |
setGroupStartOpen(java.lang.Object... groupValues) |
void |
setGroupState(java.lang.String groupState)
Initial group state for the grid.
|
void |
setGroupSummaryRecordProperty(java.lang.String groupSummaryRecordProperty)
If
showGroupSummary is true, this attribute will
be set to true on each record object representing a group-level summary row. |
void |
setGroupSummaryStyle(java.lang.String groupSummaryStyle)
ListGridRecord.customStyle for the group-level
summary row displayed when showGroupSummary is
true. |
void |
setGroupTitleColumnProperties(ListGridField groupTitleColumnProperties)
Custom properties for the automatically generated
groupTitleColumn . |
void |
setGroupTitleField(java.lang.String groupTitleField)
When a list grid is
grouped , each group shows under an auto
generated header node. |
void |
setHeaderAutoFitEvent(AutoFitEvent headerAutoFitEvent)
Event on a ListGrid header that triggers auto fitting to data and/or title.
|
void |
setHeaderBackgroundColor(java.lang.String headerBackgroundColor)
BackgroundColor for the header toolbar.
|
void |
setHeaderBarStyle(java.lang.String headerBarStyle)
Set the CSS style used for the header as a whole.
|
void |
setHeaderBaseStyle(java.lang.String headerBaseStyle)
Button.baseStyle to apply to the buttons in the header, and the
sorter, for this ListGrid. |
void |
setHeaderButtonProperties(Button headerButtonProperties)
Properties to apply to all header buttons.
|
void |
setHeaderHeight(int headerHeight)
The height of this listGrid's header, in pixels.
|
void |
setHeaderHoverAlign(Alignment headerHoverAlign)
This property may be set to customize the alignment for the hover shown on
ListGrid.headerHover() . |
void |
setHeaderHoverFormatter(HeaderHoverFormatter formatter)
Provide a custom implementation of
headerHoverHTML(int,java.lang.String) . |
void |
setHeaderHoverHeight(java.lang.Integer headerHoverHeight)
Optional default height for the hover shown on
ListGrid.headerHover() . |
void |
setHeaderHoverOpacity(java.lang.Integer headerHoverOpacity)
This property may be set to customize the opacity for the hover shown on
ListGrid.headerHover() . |
void |
setHeaderHoverStyle(java.lang.String headerHoverStyle)
This property may be set to customize the css style for the hover shown on
ListGrid.headerHover() . |
void |
setHeaderHoverVAlign(VerticalAlignment headerHoverVAlign)
This property may be set to customize the vertical alignment for the hover shown on
ListGrid.headerHover() . |
void |
setHeaderHoverWidth(java.lang.Integer headerHoverWidth)
Optional default width for the hover shown on
ListGrid.headerHover() . |
void |
setHeaderHoverWrap(java.lang.Boolean headerHoverWrap)
This property may be set to customize the
wrap attribute for the hover shown on ListGrid.headerHover() . |
void |
setHeaderMenuButtonHeight(int headerMenuButtonHeight)
If
showHeaderMenuButton is true, this property
governs the height of the auto-generated headerMenuButton |
void |
setHeaderMenuButtonIcon(java.lang.String headerMenuButtonIcon)
If
showHeaderMenuButton is true, this property
governs the icon shown on the auto-generated headerMenuButton |
void |
setHeaderMenuButtonIconHeight(int headerMenuButtonIconHeight)
If
showHeaderMenuButton is true, this property
governs the height of the icon shown on the auto-generated headerMenuButton |
void |
setHeaderMenuButtonIconWidth(int headerMenuButtonIconWidth)
If
showHeaderMenuButton is true, this property
governs the width of the icon shown on the auto-generated headerMenuButton |
void |
setHeaderMenuButtonWidth(int headerMenuButtonWidth)
If
showHeaderMenuButton is true, this property
governs the width of the auto-generated headerMenuButton |
void |
setHeaderSpanBaseStyle(java.lang.String name,
java.lang.String newStyle)
Update the
HeaderSpan.headerBaseStyle for a span
within the grid at runtime. |
void |
setHeaderSpanButtonProperties(java.lang.String name,
Canvas properties)
Method to update properties on a headerSpan's header button at runtime.
|
void |
setHeaderSpanHeaderTitle(java.lang.String name,
java.lang.String newTitle)
Update the headerTitle of a
headerSpan dynamically. |
void |
setHeaderSpanHeight(java.lang.Integer headerSpanHeight)
Default height for a
headerSpan with no height
specified. |
void |
setHeaderSpans(HeaderSpan... headerSpans)
Header spans are a second level of headers that appear above the normal ListGrid headers,
spanning one or more listGrid fields in a manner similar to a column-spanning cell in an
HTML table.
|
void |
setHeaderSpanTitle(java.lang.String name,
java.lang.String newTitle)
Update the title of a
headerSpan dynamically. |
void |
setHeaderSpanTitleStyle(java.lang.String name,
java.lang.String newTitle)
Update the
HeaderSpan.headerTitleStyle for a
span within the grid at runtime. |
void |
setHeaderTitleStyle(java.lang.String headerTitleStyle)
StretchImgButton.titleStyle to apply to the buttons
in the header, and the sorter, for this ListGrid. |
void |
setHideEmptySummaryRow(java.lang.Boolean hideEmptySummaryRow)
If true, causes the
summaryRow component to be hidden if
it has no data after summaries have been recalculated |
void |
setHiliteCanReplaceValue(java.lang.Boolean hiliteCanReplaceValue)
If set, end users can create advanced hiliting rules that will use the
Hilite.replacementValue feature to cause values in hilited cells to
be replaced with a user-entered value. |
void |
setHiliteEditorSpanTitleSeparator(java.lang.String hiliteEditorSpanTitleSeparator)
If this grid has specified
headerSpans , and showHeaderSpanTitlesInHiliteEditor is
true, this string will be inserted between the headerSpan title and the field title in the hiliteEditor field chooser
grid. |
void |
setHiliteHTMLAfterFormat(boolean hiliteHTMLAfterFormat)
If set to true, custom HTML applied as part of hiliting will be applied after
formatting for each cell. |
void |
setHiliteIconHeight(java.lang.Integer hiliteIconHeight)
Height for hilite icons for this listGrid.
|
void |
setHiliteIconLeftPadding(int hiliteIconLeftPadding)
How much padding should there be on the left of
hilite
icons by default? Can be overridden at the field level |
void |
setHiliteIconPosition(HiliteIconPosition hiliteIconPosition)
When
hiliteIcons are present, where the hilite icon
will be placed relative to the field value. |
void |
setHiliteIconRightPadding(int hiliteIconRightPadding)
How much padding should there be on the right of
hilite
icons by default? Can be overridden at the field level |
void |
setHiliteIcons(java.lang.String... hiliteIcons)
Specifies a list of icons that can be used in
hilites . |
void |
setHiliteIconSize(int hiliteIconSize)
Default width and height of
hilite icons for this
component. |
void |
setHiliteIconWidth(java.lang.Integer hiliteIconWidth)
Width for hilite icons for this component.
|
void |
setHiliteProperty(java.lang.String hiliteProperty)
Marker that can be set on a record to flag that record as hilited.
|
void |
setHiliteReplaceValueFieldTitle(java.lang.String hiliteReplaceValueFieldTitle)
Title used for the text box shown when
hiliteCanReplaceValue is set. |
void |
setHiliteRowOnFocus(java.lang.Boolean hiliteRowOnFocus)
When the grid body gets keyboard focus, should we highlight the current focus row, using the rollover cell style?
|
void |
setHilites(Hilite[] hilites)
Accepts an array of hilite objects and applies them to this DataBoundComponent.
|
void |
setHiliteState(java.lang.String hiliteState)
Set the current hilites based on a hiliteState String previously returned from getHilitesState.
|
void |
setHoverCustomizer(HoverCustomizer hoverCustomizer)
HTML to be shown in hovers over cells in the column described by this field.
|
void |
setHoverMode(HoverMode hoverMode)
When
showHoverComponents is true, the builtin
mode to use when automatically creating a hover component for rows in this grid. |
void |
setHoverStyle(java.lang.String hoverStyle)
Style to apply to hovers shown over this grid.
|
void |
setIconPadding(java.lang.Integer iconPadding)
When using
autoFitFieldWidths , padding in pixels
left on each side of fields that show images. |
void |
setImageSize(int imageSize)
Default size of thumbnails shown for fieldTypes image and imageFile.
|
void |
setIncludeHilitesInSummaryFields(boolean includeHilitesInSummaryFields)
When assembling a value for a
summary field , if
a referenced field is hilited, should the hilite HTML be included in the summary field value? |
void |
setIncludeInSummaryProperty(java.lang.String includeInSummaryProperty)
Property name on a record that will be checked to determine whether a record should be included when calculating totals
for the
grid summary . |
void |
setInitialCriteria(Criteria initialCriteria)
Criteria to use when
DataBoundComponent.setAutoFetchData(Boolean) is used. |
void |
setInitialSort(SortSpecifier... initialSort)
An array of
SortSpecifier objects used to set up the initial sort configuration for
this grid. |
void |
setInstantScrollTrackRedraw(java.lang.Boolean instantScrollTrackRedraw)
If true, if the user clicks on the scroll buttons at the end of the track or clicks once on the scroll track, there will
be an instant redraw of the grid content so that the user doesn't see any blank space.
|
void |
setInvalidSummaryValue(java.lang.String invalidSummaryValue)
Value to display to the user if showing summary values (through
showGridSummary , showGroupSummary or listGridFieldType:"summary" ), and the summary function returns
"null" (implying it was unable to calculate a valid summary value). |
void |
setIsSeparatorProperty(java.lang.String isSeparatorProperty)
If
record[this.isSeparatorProperty] is set for some record, the record will be displayed as a simple
separator row. |
void |
setLeaveHeaderMenuButtonSpace(java.lang.Boolean leaveHeaderMenuButtonSpace)
If
showHeaderMenuButton is true, when
auto-fitting fields to the title width via autoFitFieldWidths or ListGridField.autoFitWidth , should the button be sized such that there is enough space for the header menu button to
show without covering the field title? |
void |
setLeaveScrollbarGap(java.lang.Boolean leaveScrollbarGap)
Whether to leave a gap for the vertical scrollbar, even when it's not present.
|
void |
setLinkTextProperty(java.lang.String linkTextProperty)
Property name on a record that will hold the link text for that record.
|
void |
setListEndEditAction(RowEndEditAction listEndEditAction)
If the user is editing the last record in this listGrid, and attempts to navigate beyond the last row either by tabbing
off the last editable field, or using the down arrow key, this property determines what action to take: "next":
start editing a new record at the end of the list.
|
void |
setLoadingDataMessage(java.lang.String loadingDataMessage)
The string to display in the body of a listGrid while data is being loaded.
|
void |
setLoadingDataMessageStyle(java.lang.String loadingDataMessageStyle)
The CSS style name applied to the loadingDataMessage string if displayed.
|
void |
setLoadingMessage(java.lang.String loadingMessage)
If you have a databound listGrid and you scroll out of the currently loaded dataset, by default you will see blank rows
until the server returns the data for those rows.
|
void |
setLocateColumnsBy(java.lang.String locateColumnsBy)
When
AutoTest.getElement() is used to parse locator strings
generated by AutoTest.getLocator() for a cell in this grid, how
should the column be identified? Note that getLocator() will actually store all available information about the column in the generated string -- this attribute effects how a stored string will be parsed only. |
void |
setLocateRowsBy(java.lang.String locateRowsBy)
When
AutoTest.getElement() is used to parse locator strings
generated by AutoTest.getLocator() for a cell in this grid, how
should the row be identified? Note that getLocator() will actually store all available information about the row in the generated string -- this attribute effects how a stored string will be parsed only. |
com.smartgwt.logicalstructure.core.LogicalStructureObject |
setLogicalStructure(com.smartgwt.logicalstructure.widgets.grid.ListGridLogicalStructure s)
Setter implementing the
LogicalStructure interface,
which supports Eclipse's logical structure debugging facility. |
void |
setLongTextEditorThreshold(int longTextEditorThreshold)
When the length of the field specified by
DataSourceField.length exceeds this value, the ListGrid shows an edit field of type longTextEditorType rather than the standard text field
when the field enters inline edit mode. |
void |
setLongTextEditorType(java.lang.String longTextEditorType)
When the length of the field specified by
DataSourceField.length exceeds this.longTextEditorThreshold show an edit field of this type rather than
the standard text field when the field enters inline edit mode. |
void |
setMaxExpandedRecords(java.lang.Integer maxExpandedRecords)
When
canExpandRecords and canExpandMultipleRecords are both true, this
property dictates the number of records which can be expanded simultaneously. |
void |
setMaxExpandedRecordsPrompt(java.lang.String maxExpandedRecordsPrompt)
This is a dynamic string - text within
${...} will be evaluated as JS code when the message is
displayed. |
void |
setMinFieldWidth(int minFieldWidth)
Minimum size, in pixels, for ListGrid headers.
|
void |
setMissingSummaryFieldValue(java.lang.String missingSummaryFieldValue)
If a summary format string contains an invalid field reference, replace the reference with the missingSummaryFieldValue.
|
void |
setModalEditing(java.lang.Boolean modalEditing)
If this property is true, any mouse click outside of the open cell editors will end editing mode, hiding the cell
editors and saving any changes to those cell values.
|
void |
setMultiSortDialogDefaults(MultiSortDialog multiSortDialogDefaults)
Class level defaults to apply to the
MultiSortDialog which gets automatically
generated when askForSort.() is called. |
void |
setMultiSortDialogProperties(MultiSortDialog multiSortDialogProperties)
Properties to apply to the
MultiSortDialog which gets automatically generated when
askForSort.() is called. |
void |
setNavigateOnTab(boolean navigateOnTab)
If
canSelectCells is true, this property allows the
user to navigate through the cells of a grid using Tab and Shift+Tab keypresses. |
void |
setNeverValidate(java.lang.Boolean neverValidate)
If true, validation will not occur as a result of cell editing for this grid.
|
void |
setNormalBaseStyle(java.lang.String normalBaseStyle)
"Normal" baseStyle for this listGrid.
|
void |
setNormalCellHeight(int normalCellHeight)
If
baseStyle is unset, base style will be derived from
normalBaseStyle if this grid has fixed row heights
and the specified cellHeight matches this value. |
void |
setNullGroupTitle(java.lang.String nullGroupTitle)
Default alias to use for groups with no value
|
void |
setOfflineMessageStyle(java.lang.String offlineMessageStyle)
The CSS style name applied to the
offlineMessage if displayed. |
void |
setOriginBaseStyle(java.lang.String originBaseStyle)
Name of a CSS Style to use as the
baseStyle for a cell
that is currently a selection origin for shifted incremental cell selection. |
void |
setOverflow(Overflow overflow)
|
void |
setPoolComponentsPerColumn(java.lang.Boolean poolComponentsPerColumn)
Should recycled
record components , be pooled
per column or per record. |
void |
setPreventDuplicates(java.lang.Boolean preventDuplicates)
If set, detect and prevent duplicate records from being transferred to this component, either via
drag and drop or via
DataBoundComponent.transferSelectedData(com.smartgwt.client.widgets.DataBoundComponent) . |
void |
setPrintAutoFit(java.lang.Boolean printAutoFit)
Whether cell contents should wrap during printing.
|
void |
setPrintBaseStyle(java.lang.String printBaseStyle)
Style for non-header cells in printed output.
|
void |
setPrintBooleanBaseStyle(java.lang.String printBooleanBaseStyle)
If set, the
booleanBaseStyle to use when printing . |
void |
setPrintBooleanFalseImage(java.lang.String printBooleanFalseImage)
If set, the
booleanFalseImage to use when printing . |
void |
setPrintBooleanPartialImage(java.lang.String printBooleanPartialImage)
If set, the
booleanPartialImage to use when
printing . |
void |
setPrintBooleanTrueImage(java.lang.String printBooleanTrueImage)
If set, the
booleanTrueImage to use when printing . |
void |
setPrintCheckboxFieldFalseImage(java.lang.String printCheckboxFieldFalseImage)
If set, the
checkboxFieldFalseImage to use
when printing . |
void |
setPrintCheckboxFieldPartialImage(java.lang.String printCheckboxFieldPartialImage)
If set, the
checkboxFieldPartialImage to
use when printing . |
void |
setPrintCheckboxFieldTrueImage(java.lang.String printCheckboxFieldTrueImage)
If set, the
checkboxFieldTrueImage to use
when printing . |
void |
setPrintHeaderStyle(java.lang.String printHeaderStyle)
Style for header cells in printed output.
|
void |
setPrintMaxRows(int printMaxRows)
Advanced property - when generating printHTML for a large ListGrid, rows are printed in batches in order to avoid
triggering a native "script is running slowly" browser dialog.
|
void |
setPrintWrapCells(java.lang.Boolean printWrapCells)
Whether cell contents should wrap during printing.
|
void |
setProgressiveLoading(java.lang.Boolean progressiveLoading)
Indicates whether or not this component will load its data
progressively |
void |
setQuickDrawAheadRatio(float quickDrawAheadRatio)
Alternative to
drawAheadRatio , to be used when the
user is rapidly changing the grids viewport (for example drag scrolling through the grid). |
void |
setRecordBaseStyleProperty(java.lang.String recordBaseStyleProperty)
This attribute allows custom base styles to be displayed on a per-record basis.
|
void |
setRecordCanRemoveProperty(java.lang.String recordCanRemoveProperty)
If set to false on a record and
canRemoveRecords
is true, removal of that record is disallowed in the UI. |
void |
setRecordCanSelectProperty(java.lang.String recordCanSelectProperty)
If set to false on a record, selection of that record is disallowed.
|
void |
setRecordComponentHeight(java.lang.Integer recordComponentHeight)
If
showRecordComponents is true, this
attribute may be used to specify a standard height for record components. |
void |
setRecordComponentPoolingMode(RecordComponentPoolingMode recordComponentPoolingMode)
The method of
component-pooling to employ for recordComponents . |
void |
setRecordComponentPosition(EmbeddedPosition recordComponentPosition)
if
showRecordComponents is true, how should
the component appear within the cell. |
void |
setRecordDetailDSProperty(java.lang.String recordDetailDSProperty)
The name of the ListGridRecord property that specifies the DataSource to use when
listGrid.expansionMode is "related". |
void |
setRecordDropAppearance(RecordDropAppearance recordDropAppearance)
If
canAcceptDroppedRecords is true for this
listGrid, this property governs whether the user can drop between, or over records within the grid. |
void |
setRecordEditProperty(java.lang.String recordEditProperty)
Property name on a record that should be checked to determine whether the record may be edited.
|
void |
setRecordEnabledProperty(java.lang.String recordEnabledProperty)
Property name on a record that will be checked to determine whether a record is enabled.
|
void |
setRecords(ListGridRecord[] records)
Synonym for
setData(ListGridRecord[]) |
void |
setRecordSummaryBaseStyle(java.lang.String recordSummaryBaseStyle)
If showing any record summary fields (IE: fields of
type:"summary" ),
this attribute specifies a custom base style to apply to cells in the summary field |
void |
setRemovedCSSText(java.lang.String removedCSSText)
Custom CSS text to be applied to records that have been
marked for removal . |
void |
setRemoveFieldProperties(ListGridField removeFieldProperties)
Configuration properties for the "remove field" displayed when
canRemoveRecords is enabled. |
void |
setRemoveFieldTitle(java.lang.String removeFieldTitle)
The title to use for the
remove field . |
void |
setRemoveIcon(java.lang.String removeIcon)
When
canRemoveRecords is enabled, default icon to
show in the auto-generated field that allows removing records. |
void |
setRemoveIconSize(int removeIconSize)
Default width and height of
remove icons for this
ListGrid. |
void |
setRemoveOperation(java.lang.String removeOperation)
operationId this component
should use when performing remove operations. |
void |
setReselectOnUpdate(boolean reselectOnUpdate)
If true, when an update operation occurs on a selected record in a
databound listGrid, ensure the updated record is re-selected
when the operation completes. |
void |
setReselectOnUpdateNotifications(SelectionNotificationType reselectOnUpdateNotifications)
if
reselectOnUpdate is true, this property governs
what selection changed notifications should be triggered when a selected record is edited then automatically reselected
when the edited data is merged into the data set. |
void |
setResizeFieldsInRealTime(boolean resizeFieldsInRealTime)
If
true , the grid contents are redrawn in real time as fields are resized. |
void |
setReverseRTLAlign(java.lang.Boolean reverseRTLAlign)
If a page is rendered in
RTL mode , should cell alignments specified ListGridField.cellAlign be reversed (so an
align:"right" field will have content aligned on the left and vice versa)? |
void |
setRollOverCanvasProperties(Canvas rollOverCanvasProperties)
Properties to apply to the auto-generated
rollOverCanvas
AutoChild when its use is enabled. |
void |
setRollUnderCanvasProperties(Canvas rollUnderCanvasProperties)
Properties to apply to the auto-generated
rollUnderCanvas
AutoChild when its use is enabled. |
void |
setRowEndEditAction(RowEndEditAction rowEndEditAction)
If the user is editing a record in this listGrid, and attempts to navigate to a field beyond the end of the row, via tab
(or shift-tab off the first editable field), this property determines what action to take: "next": start editing
the next (or previous) record in the list "same": put focus back into the first editable field of the same record.
|
void |
setRowErrors(int rowNum,
java.util.Map errors)
Set the validation errors for some row (replacing any pre-existent validation errors)
|
void |
setRowErrors(int rowNum,
java.lang.Object errors)
Set the validation errors for some row (replacing any pre-existent validation errors)
|
void |
setRowNumberFieldProperties(ListGridField rowNumberFieldProperties)
Set the properties generated field that displays the current row number when
showRowNumbers is true. |
void |
setRowNumberStart(int rowNumberStart)
The number to start the row-count from - default value is 1.
|
void |
setRowNumberStyle(java.lang.String rowNumberStyle)
The CSS Style name for the
rowNumberField . |
void |
setRowSpanEditMode(RowSpanEditMode rowSpanEditMode)
If
allowRowSpanning is enabled, this property may
be used to specify editing behavior for cells that span multiple rows. |
void |
setRowSpanSelectionMode(RowSpanSelectionMode rowSpanSelectionMode)
Chooses the selection mode when
useRowSpanStyling
is enabled. |
void |
setSaveByCell(java.lang.Boolean saveByCell)
Whether edits should be saved whenever the user moves between cells in the current edit row.
|
void |
setSaveLocally(java.lang.Boolean saveLocally)
For grids with a specified
dataSource , this property can
be set to true to cause the grid directly update its local data set instead of performing an operation
against it's configured DataSource. |
void |
setSaveRequestProperties(DSRequest saveRequestProperties)
For editable grids with a specified
dataSource , where
saveLocally is false, this attribute may be used to
specify standard DSRequest properties to apply to all save operations performed by this grid (whether triggered by user
interaction, or explicit saveEdits or saveAllEdits call). |
void |
setScreenReaderCellSeparator(java.lang.String screenReaderCellSeparator)
When
screen reader mode is enabled, this invisible separator
string is written out between each cell value. |
void |
setScreenReaderRowSeparator(java.lang.String screenReaderRowSeparator)
When
screen reader mode is enabled, this invisible string will
be written out after the last cell in a row. |
void |
setScrollRedrawDelay(int scrollRedrawDelay)
While drag scrolling in an incrementally rendered grid, time in milliseconds to wait before redrawing, after the last
mouse movement by the user.
|
void |
setScrollToCellXPosition(Alignment scrollToCellXPosition)
When scrollToCell is called, this is used as defaults if xPosition weren't explicitly passed into the method.
|
void |
setScrollToCellYPosition(VerticalAlignment scrollToCellYPosition)
When scrollToCell is called, this is used as defaults if yPosition weren't explicitly passed into the method.
|
void |
setScrollWheelRedrawDelay(java.lang.Integer scrollWheelRedrawDelay)
While scrolling an incrementally rendered grid, using the mouseWheel, time in milliseconds to wait before redrawing,
after the last mouseWheel movement by the user.
|
void |
setSelectedState(java.lang.String selectedState)
Returns a snapshot of the current selection within this listGrid as a
ListGridSelectedState object.This object can be passed to setSelectedState() to reset this grid's selection the
current state (assuming the same data is present in the grid).If this method is called after the component has been drawn/initialized: Reset this grid's selection to match the ListGridSelectedState object passed in.Used to restore previous state retrieved from the grid by a call to getSelectedState() . |
void |
setSelectHeaderOnSort(java.lang.Boolean selectHeaderOnSort)
If true, show the field-header for the sorted field (or the first field in a
multi-sort grid) in the selected state. |
void |
setSelectionAppearance(SelectionAppearance selectionAppearance)
How selection of rows should be presented to the user.
|
void |
setSelectionCanvasProperties(Canvas selectionCanvasProperties)
Properties to apply to the auto-generated
selectionCanvas AutoChild when
its use is enabled. |
void |
setSelectionProperty(java.lang.String selectionProperty)
If specified, the selection object for this list will use this property to mark records as selected.
|
void |
setSelectionType(SelectionStyle selectionType)
Defines a listGrid's clickable-selection behavior.
|
void |
setSelectionUnderCanvasProperties(Canvas selectionUnderCanvasProperties)
Properties to apply to the auto-generated
selectionUnderCanvas AutoChild when
its use is enabled. |
void |
setSelectOnEdit(java.lang.Boolean selectOnEdit)
When the user starts editing a row, should the row also be selected?
|
void |
setSelectOnExpandRecord(boolean selectOnExpandRecord)
When set to false, clicking a record's
expansion
field will not add the record to the current selection. |
void |
setShowAllColumns(java.lang.Boolean showAllColumns)
Whether all columns should be drawn all at once, or only columns visible in the viewport.
|
void |
setShowAllRecords(java.lang.Boolean showAllRecords)
Whether all rows should be drawn all at once, or only rows visible in the viewport.
|
void |
setShowAsynchGroupingPrompt(java.lang.Boolean showAsynchGroupingPrompt)
If set to false, do not show the
asynchGroupingPrompt dialog during asynchronous grouping . |
void |
setShowBackgroundComponents(java.lang.Boolean showBackgroundComponents)
If
true this grid will create and show per-row backgroundComponents as detailed here . |
void |
setShowCellContextMenus(java.lang.Boolean showCellContextMenus)
Whether to show a context menu with standard items for all context clicks on rows in the body.
|
void |
setShowClippedHeaderTitlesOnHover(boolean showClippedHeaderTitlesOnHover)
If true and a header button's title is clipped, then a hover containing the full field title is enabled.
|
void |
setShowClippedValuesOnHover(java.lang.Boolean showClippedValuesOnHover)
If true and a cell's value is clipped, then a hover containing the full cell value is enabled.
|
void |
setShowCollapsedGroupSummary(java.lang.Boolean showCollapsedGroupSummary)
Should group summaries be visible when the group is collapsed?
|
void |
setShowComplexFields(java.lang.Boolean showComplexFields)
Whether to show fields of non-atomic types when a DataBoundComponent is given a
DataSource but no
component.fields .
|
void |
setShowDetailFields(java.lang.Boolean showDetailFields)
Whether to include fields marked
detail:true from this component's DataSource . |
void |
setShowEmptyMessage(java.lang.Boolean showEmptyMessage)
Indicates whether the text of the emptyMessage property should be displayed if no data is available.
|
void |
setShowErrorIcons(boolean showErrorIcons)
If this grid is editable, and an edit has caused validation failure for some cell, should we show an icon to indicate
validation failure?
|
void |
setShowFilterEditor(boolean showFilterEditor)
Should this listGrid display a filter row.
|
void |
setShowGridSummary(java.lang.Boolean showGridSummary)
Should this ListGrid show a summary row beneath the last record of the grid.
|
void |
setShowGroupSummary(java.lang.Boolean showGroupSummary)
If this listGrid supports
grouping , setting this
property will cause the grid to render an extra row at the end of each group when grouped, containing summary
information for the fields. |
void |
setShowGroupSummaryInHeader(java.lang.Boolean showGroupSummaryInHeader)
If this grid is
grouped , and showGroupSummary is true, setting this property causes
field summary values for each group to be displayed directly in the group header node, rather than showing up at the
bottom of each expanded group. |
void |
setShowGroupTitleColumn(java.lang.Boolean showGroupTitleColumn)
If this grid is
grouped and showGroupSummaryInHeader is true, instead of
group header nodes showing up with a single cell value spanning the full set of columns, summaries for each field will
show up in the appropriate columns of the header node. |
void |
setShowHeader(java.lang.Boolean showHeader)
Should we show the header for this ListGrid?
If this method is called after the component has been drawn/initialized: Show or hide the ListGrid header. |
void |
setShowHeaderContextMenu(java.lang.Boolean showHeaderContextMenu)
Whether to show a context menu on the header with standard items for showing and hiding fields.
|
void |
setShowHeaderMenuButton(java.lang.Boolean showHeaderMenuButton)
If set to true and
showHeaderContextMenu is
true, the headerMenuButton will be displayed when
the user rolls over the header buttons in this grid. |
void |
setShowHeaderSpanTitlesInFormulaBuilder(java.lang.Boolean showHeaderSpanTitlesInFormulaBuilder)
If this grid has specified
headerSpans , should field
titles be prefixed with the titles of the headerSpans in which they are contained when using the FormulaBuilder or
SummaryBuilder. |
void |
setShowHeaderSpanTitlesInHiliteEditor(java.lang.Boolean showHeaderSpanTitlesInHiliteEditor)
If this grid has specified
headerSpans , should field
titles be prefixed with the titles of the headerSpans in which they are contained when using the hilite editor . |
void |
setShowHeaderSpanTitlesInSortEditor(java.lang.Boolean showHeaderSpanTitlesInSortEditor)
If this grid has specified
headerSpans , should field
titles be prefixed with the titles of the headerSpans in which they are contained when using the multi-sort editor . |
void |
setShowHiddenFields(java.lang.Boolean showHiddenFields)
Whether to show fields marked
hidden:true when a DataBoundComponent is given a
DataSource but no component.fields .
|
void |
setShowHilitesInGroupSummary(boolean showHilitesInGroupSummary)
Determines whether hiliting for any field in this grid is shown in a group summary.
|
void |
setShowHover(java.lang.Boolean showHover)
If true, and canHover is also true, when the user hovers over a cell, hover text will pop up next to the mouse.
|
void |
setShowHoverComponents(java.lang.Boolean showHoverComponents)
When set to true and canHover is also true, shows a widget hovering at the mouse point.
|
void |
setShowPartialSelection(java.lang.Boolean showPartialSelection)
Should partially selected parents (in a Tree data set) be shown with special icon? This has an impact in grouped grids
where
canSelectGroups is true. |
void |
setShowRecordComponents(java.lang.Boolean showRecordComponents)
When enabled,
createRecordComponent() will be
called when saved rows are being rendered, and any returned component will be displayed embedded within the row or cell. |
void |
setShowRecordComponentsByCell(java.lang.Boolean showRecordComponentsByCell)
If true, shows
recordComponents in cells,
rather than just in records. |
void |
setShowRollOver(java.lang.Boolean showRollOver)
Should we show different styling for the cell the mouse is over?
|
void |
setShowRollOverCanvas(java.lang.Boolean showRollOverCanvas)
When enabled, when the mouse moves over a row or cell (depending on
useCellRollOvers ), an arbitrary Canvas can be shown
layered on top of the row or cell (the rollOverCanvas ), layered underneath the row or cell (the rollUnderCanvas ), or both. |
void |
setShowRollUnderCanvas(java.lang.Boolean showRollUnderCanvas)
If roll overs are enabled, should the
rollUnderCanvas be displayed? |
void |
setShowRowNumbers(java.lang.Boolean showRowNumbers)
When set to true, shows an additional field at the beginning of the field-list (respecting RTL) that displays the
current rowNum for each record.
|
void |
setShowSelectedStyle(java.lang.Boolean showSelectedStyle)
Should the "Selected" style be applied to selected records?
|
void |
setShowSelectionCanvas(java.lang.Boolean showSelectionCanvas)
If
selectionType is set to SelectionStyle.SINGLE , setting this property to true means selection will be
displayed to the user with the selectionCanvas
and/or selectionUnderCanvas rather than with
CSS styling. |
void |
setShowSelectionUnderCanvas(java.lang.Boolean showSelectionUnderCanvas)
If
selectionType is set to SelectionStyle.SINGLE , and either showSelectionCanvas is true and
showSelectionUnderCanvas is unset, or showSelectionUnderCanvas is explicitly set to
true , then selection will be displayed to the user with the selectionCanvas and/or selectionUnderCanvas rather than with CSS styling. |
void |
setShowSortArrow(SortArrow showSortArrow)
Indicates whether a sorting arrow should appear for the listGrid, and its location.
|
void |
setShowSortNumerals(java.lang.Boolean showSortNumerals)
When multiple fields are sorted, set this to false to hide the sort-numeral displayed by default after the sort-arrows
in the header-buttons of sorted fields.
|
void |
setShowTreeColumnPicker(java.lang.Boolean showTreeColumnPicker)
When
headerSpans are in use, whether to show a
hierarchical column picker that includes both headerSpans and normal headers, with normal headers indented under
headerSpans similarly to how a TreeGrid displays a Tree. |
void |
setShrinkForFreeze(java.lang.Boolean shrinkForFreeze)
If this list grid is showing any
frozen fields, and a
horizontal scrollbar is visible at the bottom of the liquid columns, should an equivalent scrollbar gap be left visible
below the frozen columns?Note that if set to true any backgroundColor or border applied to the
ListGrid will show up below the bottom row of the frozen column(s). |
void |
setSingleCellValueProperty(java.lang.String singleCellValueProperty)
If
record[this.singleCellValueProperty] is set for some record, the record will be displayed as a single
cell spanning every column in the grid, with contents set to the value of
record[this.singleCellValueProperty] . |
void |
setSkinImgDir(java.lang.String skinImgDir)
Where do 'skin' images (those provided with the class) live?
|
void |
setSort(SortSpecifier... sortSpecifiers)
Sort the grid on one or more fields.
|
void |
setSortAscendingImage(ImgProperties sortAscendingImage)
Image to show when sorting ascending.
|
void |
setSortBinaryByFileName(boolean sortBinaryByFileName)
For any fields of
type "binary" , should sorting be performed against the
fileName of the value for the field? For Smart GWT server backed dataSources, this is applied to the record
automatically as described in the BinaryFields overview. |
void |
setSortByGroupFirst(java.lang.Boolean sortByGroupFirst)
If set, whenever grouping is performed by an end user or by a programmatic call to
groupBy() , data is implicitly sorted by all of the grouped columns,
in the order they were passed to groupBy. |
void |
setSortDescendingImage(ImgProperties sortDescendingImage)
Image to show when sorting descending.
|
void |
setSortDirection(SortDirection sortDirection)
Sorting direction of this ListGrid.
|
void |
setSortEditorSpanTitleSeparator(java.lang.String sortEditorSpanTitleSeparator)
If this grid has specified
headerSpans , and showHeaderSpanTitlesInSortEditor is true,
this string will be inserted between the headerSpan title(s) and the field title in the field chooser grid on the multi-sort editor |
void |
setSorterButtonTitle(java.lang.String sorterButtonTitle)
The title for the corner sort button.
|
void |
setSortField(int fieldIndex)
Specifies the field by which this grid should be initially sorted.
|
void |
setSortField(java.lang.Integer sortField)
Specifies the field by which this grid should be initially sorted.
|
void |
setSortField(java.lang.String sortField)
Specifies the field by which this grid should be initially sorted.
|
void |
setSortFieldAscendingText(java.lang.String sortFieldAscendingText)
If we're showing a
headerContextMenu for this
grid, this attribute will be shown as the menu item title to sort a field in ascending order. |
void |
setSortFieldDescendingText(java.lang.String sortFieldDescendingText)
If we're showing a
headerContextMenu for this
grid, this attribute will be shown as the menu item title to sort a field in descending order. |
void |
setSortNumeralHTMLCustomizer(SortNumeralHTMLCustomizer customizer)
This customizer is called to generate the HTML for the sortNumeral displayed next to a
field's title when it is included in the current sort specification.
|
void |
setSortNumeralStyle(java.lang.String sortNumeralStyle)
When multiple fields are sorted, the Style to apply to the numeral that appears after the sort-arrows in the
header-buttons of sorted fields.
|
void |
setSortState(java.lang.String sortState)
Initial sort state for the grid.
|
void |
setStopOnErrors(java.lang.Boolean stopOnErrors)
If this is an editable listGrid, this property determines how failure to save due to validation errors should be
displayed to the user.
|
void |
setStyleName(java.lang.String styleName)
Default CSS class for the ListGrid as a whole.
|
void |
setSummaryRowCriteria(Criteria summaryRowCriteria)
If
showGridSummary is true, and a summaryRowDataSource is specified this property may
be used to specify fetch criteria to apply when retrieving summary data to show in the summary row. |
void |
setSummaryRowDataSource(DataSource summaryRowDataSource)
If
showGridSummary is true, by default summary
values are calculated on the client based on the current data-set for the grid (see getGridSummary() and getGridSummaryFunction() ). |
void |
setSummaryRowFetchRequestProperties(DSRequest summaryRowFetchRequestProperties)
If
showGridSummary is true, and a summaryRowDataSource is specified this property may
be used to customize the fetch request used when retrieving summary data to show in the summary row. |
void |
setSummaryRowHeight(int summaryRowHeight)
Default height for the
summary row autoChild . |
void |
setSummaryRowStyle(java.lang.String summaryRowStyle)
baseStyle for the summaryRow |
void |
setTallBaseStyle(java.lang.String tallBaseStyle)
"Tall" baseStyle for this listGrid.
|
void |
setTitleField(java.lang.String titleField)
Sets the best field to use for a user-visible title for an individual record from this component.
|
void |
setTouchScrollRedrawDelay(java.lang.Integer touchScrollRedrawDelay)
While scrolling an incrementally rendered grid, using the inertial scrolling, time in milliseconds to wait before
redrawing, after the last touchScroll by the user.
|
void |
setTrackerImage(ImgProperties trackerImage)
Default image to use for the dragTracker when things are dragged within or out of this list.
|
void |
setUnfreezeFieldText(java.lang.String unfreezeFieldText)
If we're showing a
headerContextMenu for this
grid and this.canFreezeFields is true, this string
will be shown as the title for the menu item to unfreeze a currently frozen field. |
void |
setUngroupText(java.lang.String ungroupText)
If we're showing a
headerContextMenu for this
grid, and this.isGrouped is true, this attribute will be
shown as the title for the menu item to ungroup the grid. |
void |
setUnremoveIcon(java.lang.String unremoveIcon)
When
canRemoveRecords is enabled, this icon will
be shown in the auto generated field fro removing records if the record has been marked as removed via markRecordRemoved() . |
void |
setUpdateOperation(java.lang.String updateOperation)
operationId this component
should use when performing update operations. |
void |
setUseAdvancedFieldPicker(java.lang.Boolean useAdvancedFieldPicker)
If set to true, an advanced field picker based on the
FieldPicker will be shown
instead of the column picker submenu if there are more fields in the grid than advancedFieldPickerThreshold . |
void |
setUseAllDataSourceFields(java.lang.Boolean useAllDataSourceFields)
If true, the set of fields given by the "default binding" (see
fields ) is used, with any fields specified in
component.fields acting as overrides that can suppress or modify the
display of individual fields, without having to list the entire set of fields that
should be shown.
|
void |
setUseCellRollOvers(java.lang.Boolean useCellRollOvers)
Are rollovers cell-level or row-level?
|
void |
setUseCopyPasteShortcuts(java.lang.Boolean useCopyPasteShortcuts)
Enables copy/paste shortcuts, provided
canSelectCells is true |
void |
setUseFlatFields(java.lang.Boolean useFlatFields)
The
useFlatFields flag causes all simple type fields anywhere in a nested
set of DataSources to be exposed as a flat list for form binding. |
void |
setUseRemoteValidators(java.lang.Boolean useRemoteValidators)
If
saveLocally is specified, but this grid is bound to
a DataSource which includes remote field validators, by default edits will be saved synchronously and these validators
will not be executed.Set this property to true to ensure these remote validators are called when
saving edits in saveLocally mode. |
void |
setUserFormula(ListGridField field)
Updates the user formula of the supplied field.
|
void |
setUserFormula(ListGridField field,
UserFormula userFormula)
Updates the user formula of the supplied field.
|
void |
setUserFormula(java.lang.String field)
Updates the user formula of the supplied field.
|
void |
setUserFormulaText(ListGridField field)
Updates the user formula text of the supplied field.
|
void |
setUserFormulaText(ListGridField field,
java.lang.String text)
Updates the user formula text of the supplied field.
|
void |
setUserFormulaText(java.lang.String field)
Updates the user formula text of the supplied field.
|
void |
setUseRowSpanStyling(java.lang.Boolean useRowSpanStyling)
Enables various styling behaviors that potentially make sense when
getRowSpan() has been overridden to introduce spanning cells, and
spanning is largest on the left and smaller as cells go to the right. |
void |
setUserSummary(ListGridField field)
Updates the user summary of the supplied field.
|
void |
setUserSummary(ListGridField field,
UserSummary userSummary)
Updates the user summary of the supplied field.
|
void |
setUserSummary(java.lang.String field)
Updates the user summary of the supplied field.
|
void |
setUserSummaryText(ListGridField field)
Updates the user summary text of the supplied field.
|
void |
setUserSummaryText(ListGridField field,
java.lang.String text)
Updates the user summary text of the supplied field.
|
void |
setUserSummaryText(java.lang.String field)
Updates the user summary text of the supplied field.
|
void |
setValidateByCell(java.lang.Boolean validateByCell)
Whether client-side validation checks should be performed when the user moves between cells in the current edit row.
|
void |
setValidateOnChange(java.lang.Boolean validateOnChange)
If true, validation will be performed on each edited cell when each editor's "change" handler is fired.
|
void |
setValueIconHeight(java.lang.Integer valueIconHeight)
Height for value icons for this listGrid.
|
void |
setValueIconLeftPadding(int valueIconLeftPadding)
How much padding should there be on the left of valueIcons by default Can be overridden at the field level
|
void |
setValueIconRightPadding(int valueIconRightPadding)
How much padding should there be on the right of valueIcons by default
|
void |
setValueIconSize(int valueIconSize)
Default width and height of value icons for this ListGrid.
|
void |
setValueIconWidth(java.lang.Integer valueIconWidth)
Width for value icons for this listGrid.
|
void |
setValueMap(java.lang.String fieldName,
java.util.LinkedHashMap valueMap)
Set the value map for a field.
See also the
setEditorValueMap(java.lang.String, java.util.LinkedHashMap)
and com.smartgwt.client.widgets.grid.ListGrid#getEditorValueMap methods which allow further
customization of the valueMap displayed while the field is in edit mode.
|
void |
setValueMap(java.lang.String fieldName,
java.lang.String... valueMap)
Set the value map for a field.
See also the
setEditorValueMap(java.lang.String, java.util.LinkedHashMap)
and com.smartgwt.client.widgets.grid.ListGrid#getEditorValueMap methods which allow further
customization of the valueMap displayed while the field is in edit mode.
|
void |
setViewState(java.lang.String viewState)
Initial
view state for the grid. |
void |
setVirtualScrolling(java.lang.Boolean virtualScrolling)
When incremental rendering is switched on and there are variable record heights, the virtual scrolling mechanism manages
the differences in scroll height calculations due to the unknown sizes of un-rendered rows to make the scrollbar and
viewport appear correctly.
|
void |
setWaitForSave(java.lang.Boolean waitForSave)
If this is an editable listGrid, this property determines whether the user will be able to dismiss the edit form, or
navigate to another cell while the save is in process (before the asynchronous server response returns).
|
void |
setWarnOnRemoval(java.lang.Boolean warnOnRemoval)
If
canRemoveRecords is true, when the user clicks
the remove icon for some record, should we show a warning message (defined as warnOnRemovalMessage ) and allow the user to cancel
removal? |
void |
setWarnOnRemovalMessage(java.lang.String warnOnRemovalMessage)
Warning message to show the user on a click on the 'remove' icon if
canRemoveRecords is true and warnOnRemoval is true. |
void |
setWarnOnUnmappedValueFieldChange(java.lang.Boolean warnOnUnmappedValueFieldChange)
If a field has
ListGridField.displayField
specified and has no ListGridField.optionDataSource , this field will display the value from the displayField of each record by
default (for more on this behavior see ListGridField.optionDataSource ). |
void |
setWrapCells(java.lang.Boolean wrapCells)
Should content within cells be allowed to wrap?
|
void |
setWrapHeaderSpanTitles(java.lang.Boolean wrapHeaderSpanTitles)
If
HeaderSpan.wrap is not explicitly set, should fields
wrap? If autofitting, see the docs on that property for the details of how the minimum width for a field is determined. |
void |
setWrapHeaderTitles(java.lang.Boolean wrapHeaderTitles)
If
ListGridField.wrap is not explicitly set, should
fields wrap? If autofitting, see the docs on that property for the details of how the minimum width for a field is
determined. |
boolean |
shouldIncludeHiliteInSummaryField(java.lang.String summaryFieldName,
java.lang.String usedFieldName)
When assembling a value for a
summary field , if
a referenced field is hilited, should the hilite HTML be included in the summary field value? |
void |
showField(java.lang.String field)
Force a field to be shown.
|
void |
showField(java.lang.String field,
boolean suppressRelayout)
Force a field to be shown.
|
void |
showFields(ListGridField... field)
Force an array of fields to be shown.
|
void |
showFields(ListGridField[] fields,
boolean suppressRelayout) |
void |
showFields(java.lang.String... field)
Force an array of fields to be shown.
|
void |
showFields(java.lang.String[] field,
boolean suppressRelayout)
Force an array of fields to be shown.
|
protected boolean |
showRecordComponent(ListGridRecord record,
java.lang.Integer colNum)
When
showRecordComponents is true, return
false from this method to prevent showRecordComponent behavior for the passed record. |
java.lang.Boolean |
sort()
Sort this grid's data, with the option to explicitly specify a single field to sort by and sort direction.
|
java.lang.Boolean |
sort(int sortCol,
SortDirection sortDirection) |
java.lang.Boolean |
sort(java.lang.String sortField) |
java.lang.Boolean |
sort(java.lang.String sortField,
SortDirection sortDirection)
Sort this grid's data, with the option to explicitly specify a single field to sort by and sort direction.
|
java.lang.Boolean |
startEditing()
Start inline editing at the provided coordinates.
|
java.lang.Boolean |
startEditing(java.lang.Integer rowNum) |
java.lang.Boolean |
startEditing(java.lang.Integer rowNum,
java.lang.Integer colNum) |
java.lang.Boolean |
startEditing(java.lang.Integer rowNum,
java.lang.Integer colNum,
java.lang.Boolean suppressFocus)
Start inline editing at the provided coordinates.
|
void |
startEditingNew()
Start editing a new row, after the last pre-existing record in the current set of data.
|
void |
startEditingNew(java.util.Map newValues) |
void |
startEditingNew(java.util.Map newValues,
java.lang.Boolean suppressFocus)
Start editing a new row, after the last pre-existing record in the current set of data.
|
void |
startEditingNew(Record defaultRecordValue)
Start editing a new row, after the last pre-existing record in the current set of data.
|
void |
stopHover()
Notification that the user is no longer hovering over some cell.
|
void |
summaryUpdated(ListGridField field,
UserSummary summary)
Notification fired when a user either creates a new summary field or edits an existing summary field.
|
void |
toggleSort(java.lang.String fieldName)
Toggles the sort-direction of the field with the passed name and resorts the grid.
|
void |
transferSelectedData(DataBoundComponent source)
Simulates a drag / drop type transfer of the selected records in some other component to this component, without requiring any user interaction.
|
void |
transferSelectedData(DataBoundComponent source,
int index)
Simulates a drag / drop type transfer of the selected records in some other component to this component, without requiring any user interaction.
|
void |
unfreezeField(java.lang.Integer field)
Unfreeze a frozen field, so that it will now scroll along with other fields when horizontal scrolling occurs.
|
void |
unfreezeField(ListGridField field)
Unfreeze a frozen field, so that it will now scroll along with other fields when horizontal scrolling occurs.
|
void |
unfreezeField(java.lang.String field)
Unfreeze a frozen field, so that it will now scroll along with other fields when horizontal scrolling occurs.
|
void |
unfreezeField(java.lang.String[] field)
Unfreeze a frozen field, so that it will now scroll along with other fields when horizontal scrolling occurs.
|
void |
unfreezeFields(int[] colNums) |
void |
unfreezeFields(java.lang.String[] fieldNames) |
void |
ungroup()
Removes the grouping from the listGrid, restoring its original data
|
void |
unmarkRecordRemoved(int rowNum)
Reverses a previous call to
markRecordRemoved() . |
void |
unsort()
Turn sorting off, typically because data has changed and is no longer sorted.
|
void |
updateData(Record updatedRecord)
Perform a DataSource "update" operation to update existing records in this component's DataSource.
|
void |
updateData(Record updatedRecord,
DSCallback callback) |
void |
updateData(Record updatedRecord,
DSCallback callback,
DSRequest requestProperties)
Perform a DataSource "update" operation to update existing records in this component's DataSource.
|
Canvas |
updateRecordComponent(ListGridRecord record,
java.lang.Integer colNum,
Canvas component,
boolean recordChanged)
When
showRecordComponents is true, this method
is called to update components created by createRecordComponent() when they are to be applied to a different record in the grid. |
void |
userSelectAllRecords()
Selects every user-selectable record in the grid.
|
java.lang.Boolean |
validateCell(int rowNum,
int colIndex)
Validate the current edit value for the cell in question.
|
java.lang.Boolean |
validateCell(int rowNum,
java.lang.String fieldName)
Validate the current edit value for the cell in question.
|
java.lang.Boolean |
validateRow(int rowNum)
Validate the current set of edit values for the row in question.
|
java.lang.Boolean |
willAcceptDrop()
This method overrides
Canvas.willAcceptDrop() and works as follows:If Canvas.willAcceptDrop() (the superclass definition) returns false, this method
always returns false. |
java.lang.Boolean |
willFetchData(Criteria newCriteria)
Compares the specified criteria with the current criteria applied to this component's data object and determines whether
the new criteria could be satisfied from the currently cached set of data, or if a new filter/fetch operation will be
required.
|
java.lang.Boolean |
willFetchData(Criteria newCriteria,
TextMatchStyle textMatchStyle)
Compares the specified criteria with the current criteria applied to this component's data object and determines whether
the new criteria could be satisfied from the currently cached set of data, or if a new filter/fetch operation will be
required.
|
setDefaultProperties, setLogicalStructure
addMember, addMember, addMember, addMember, addMemberPostCreate, addMemberPostCreate, addMemberPreCreate, addMemberPreCreate, addMembers, addMembers, addMembersChangedHandler, getAnimateMembers, getAnimateMemberTime, getCanDropComponents, getDefaultResizeBars, getDropComponent, getDropLine, getDropLineThickness, getDropPosition, getEnforcePolicy, getHPolicy, getLayoutBottomMargin, getLayoutLeftMargin, getLayoutMargin, getLayoutRightMargin, getLayoutTopMargin, getLocateMembersBy, getLocateMembersType, getManagePercentBreadth, getMember, getMember, getMemberDefaultBreadth, getMemberNumber, getMemberNumber, getMemberOverlap, getMembers, getMembersLength, getMembersMargin, getMinMemberLength, getMinMemberSize, getPaddingAsLayoutMargin, getResizeBar, getResizeBarClass, getResizeBarSize, getReverseOrder, getShowDragPlaceHolder, getShowDropLines, getStackZIndex, getVertical, getVPolicy, hasMember, hideDropLine, hideMember, hideMember, layoutIsDirty, onInit_Layout, reflow, reflow, reflowNow, removeMember, removeMembers, removeMembers, reorderMember, reorderMembers, setAlign, setAlign, setAnimateMembers, setAnimateMemberTime, setCanDropComponents, setDefaultLayoutAlign, setDefaultLayoutAlign, setDefaultProperties, setDefaultResizeBars, setDropLineProperties, setDropLineThickness, setEnforcePolicy, setHPolicy, setLayoutBottomMargin, setLayoutLeftMargin, setLayoutMargin, setLayoutRightMargin, setLayoutTopMargin, setLocateMembersBy, setLocateMembersType, setLogicalStructure, setManagePercentBreadth, setMemberOverlap, setMembers, setMembersMargin, setMinBreadthMember, setMinBreadthMember, setMinBreadthMember, setMinMemberLength, setMinMemberSize, setPaddingAsLayoutMargin, setPlaceHolderDefaults, setPlaceHolderProperties, setResizeBarClass, setResizeBarSize, setReverseOrder, setShowDragPlaceHolder, setShowDropLines, setStackZIndex, setVertical, setVisibleMember, setVPolicy, showMember, showMember
addChild, addChild, addChild, addChild, addChild, addClickHandler, addDoubleClickHandler, addDragMoveHandler, addDragRepositionMoveHandler, addDragRepositionStartHandler, addDragRepositionStopHandler, addDragResizeMoveHandler, addDragResizeStartHandler, addDragResizeStopHandler, addDragStartHandler, addDragStopHandler, addDropHandler, addDropMoveHandler, addDropOutHandler, addDropOverHandler, addFocusChangedHandler, addHoverHandler, addHoverHiddenHandler, addKeyDownHandler, addKeyPressHandler, addMouseDownHandler, addMouseMoveHandler, addMouseOutHandler, addMouseOverHandler, addMouseStillDownHandler, addMouseUpHandler, addMouseWheelHandler, addMovedHandler, addParentMovedHandler, addPeer, addPeer, addPeer, addPeer, addResizedHandler, addRightMouseDownHandler, addRuleContextChangedHandler, addScrolledHandler, addShowContextMenuHandler, addSnapAlignCandidate, addStyleName, addVisibilityChangedHandler, adjustForContent, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateHide, animateHide, animateHide, animateMove, animateMove, animateMove, animateMove, animateRect, animateRect, animateRect, animateRect, animateResize, animateResize, animateResize, animateResize, animateScroll, animateScroll, animateScroll, animateScroll, animateScroll, animateScroll, animateShow, animateShow, animateShow, animateShow, animateShow, animateShow, asSGWTComponent, blur, bringToFront, clear, clickMaskUp, clickMaskUp, contains, contains, containsEvent, containsFocus, containsPoint, containsPoint, deparent, depeer, disable, enable, encloses, focus, focusInNextTabElement, focusInPreviousTabElement, getAbsoluteLeft, getAbsoluteTop, getAccessKey, getAdaptiveHeightPriority, getAdaptiveWidthPriority, getAlwaysShowScrollbars, getAnimateAcceleration, getAnimateFadeTime, getAnimateHideAcceleration, getAnimateHideTime, getAnimateMoveAcceleration, getAnimateMoveTime, getAnimateRectAcceleration, getAnimateRectTime, getAnimateResizeAcceleration, getAnimateResizeTime, getAnimateScrollAcceleration, getAnimateScrollTime, getAnimateShowAcceleration, getAnimateShowEffect, getAnimateShowTime, getAnimateTime, getAppImgDir, getAriaRole, getAutoDraw, getAutoMaskComponents, getAutoParent, getAutoShowParent, getBackgroundColor, getBackgroundImage, getBackgroundPosition, getBackgroundRepeat, getBorder, getBottom, getByLocalId, getCanAcceptDrop, getCanAdaptHeight, getCanAdaptWidth, getCanDrag, getCanDragReposition, getCanDragResize, getCanDragScroll, getCanDrop, getCanDropBefore, getCanFocus, getCanSelectText, getCanvasAutoChild, getCanvasItem, getChildren, getChildrenResizeSnapAlign, getChildrenSnapAlign, getChildrenSnapCenterAlign, getChildrenSnapEdgeAlign, getChildrenSnapResizeToGrid, getChildrenSnapToGrid, getClassName, getComponentMask, getComponentMaskDefaults, getContentElement, getContents, getContextMenu, getCursor, getDataPath, getDefaultHeight, getDefaultWidth, getDestroyed, getDestroying, getDisabled, getDisabledCursor, getDisableTouchScrollingForDrag, getDoubleClickDelay, getDragAppearance, getDragIntersectStyle, getDragMaskType, getDragMaxHeight, getDragMaxWidth, getDragMinHeight, getDragMinWidth, getDragOpacity, getDragRepositionAppearance, getDragRepositionCursor, getDragResizeAppearance, getDragScrollDelay, getDragStartDistance, getDragTarget, getDragType, getDropTypes, getDropTypesAsString, getDynamicContents, getEdgeBackgroundColor, getEdgeCenterBackgroundColor, getEdgeImage, getEdgeMarginSize, getEdgeOffset, getEdgeOpacity, getEdgeShowCenter, getEdgeSize, getEditNode, getEditProxy, getElement, getElement, getEnableWhen, getEventEdge, getEventEdge, getExtraSpace, getFacetId, getFormItemAutoChild, getFullDataPath, getGroupBorderCSS, getGroupLabelBackgroundColor, getGroupLabelStyleName, getGroupTitle, getHeight, getHeightAsString, getHideUsingDisplayNone, getHoverAlign, getHoverAutoDestroy, getHoverComponent, getHoverDelay, getHoverHeight, getHoverHTML, getHoverMoveWithMouse, getHoverOpacity, getHoverVAlign, getHoverWidth, getHoverWrap, getHSnapOrigin, getHSnapOrigin, getHSnapPosition, getHSnapPosition, getHtmlElement, getHtmlPosition, getImage, getImgURL, getImgURL, getInnerContentHeight, getInnerContentWidth, getInnerHeight, getInnerWidth, getIsGroup, getIsPrinting, getIsRuleScope, getIsSnapAlignCandidate, getKeepInParentRect, getLayoutAlign, getLeavePageSpace, getLeft, getLeftAsString, getLocalId, getLocateChildrenBy, getLocateChildrenType, getLocatePeersBy, getLocatePeersType, getMargin, getMasterCanvas, getMasterElement, getMatchElement, getMaxHeight, getMaxWidth, getMenuConstructor, getMinHeight, getMinNonEdgeSize, getMinWidth, getMomentumScrollMinSpeed, getMouseStillDownDelay, getMouseStillDownInitialDelay, getNextZIndex, getNoDoubleClicks, getNoDropCursor, getOffsetHeight, getOffsetWidth, getOffsetX, getOffsetY, getOpacity, getOuterElement, getPadding, getPageBottom, getPageLeft, getPageRect, getPageRight, getPageTop, getPanelContainer, getParentCanvas, getParentElement, getPeers, getPercentBox, getPercentSource, getPosition, getPrefix, getPrintChildrenAbsolutelyPositioned, getPrintHTML, getPrintHTML, getPrompt, getProportionalResizeModifiers, getProportionalResizing, getRect, getRedrawOnResize, getResizeBarTarget, getResizeFrom, getRight, getRuleContext, getRuleContext, getRuleScope, getScrollbarSize, getScrollBottom, getScrollHeight, getScrollLeft, getScrollRight, getScrollTop, getScrollWidth, getShadowDepth, getShadowImage, getShadowOffset, getShadowSoftness, getShouldPrint, getShowCustomScrollbars, getShowDragShadow, getShowEdges, getShowResizeBar, getShowShadow, getShowSnapGrid, getShrinkElementOnHide, getSnapAlignCandidates, getSnapAlignCenterLineStyle, getSnapAlignEdgeLineStyle, getSnapAxis, getSnapEdge, getSnapHDirection, getSnapHGap, getSnapOffsetLeft, getSnapOffsetTop, getSnapOnDrop, getSnapPosition, getSnapPosition, getSnapResizeToAlign, getSnapResizeToGrid, getSnapTo, getSnapToAlign, getSnapToCenterAlign, getSnapToEdgeAlign, getSnapToGrid, getSnapVDirection, getSnapVGap, getTabIndex, getTitle, getTooltip, getTop, getTopAsString, getTopElement, getUseBackMask, getUseDragMask, getUseNativeDrag, getUseOpacityFilter, getUseTouchScrolling, getValuesManager, getViewportHeight, getViewportWidth, getVisibility, getVisibleHeight, getVisibleWhen, getVisibleWidth, getVSnapOrigin, getVSnapOrigin, getVSnapPosition, getVSnapPosition, getWidth, getWidthAsString, getZIndex, getZIndex, handleHover, hide, hideClickMask, hideClickMask, hideComponentMask, hideComponentMask, hideContextMenu, imgHTML, imgHTML, imgHTML, intersects, isDirty, isDisabled, isDrawn, isFocused, isVisible, keyUp, layoutChildren, linkHTML, linkHTML, linkHTML, linkHTML, linkHTML, linkHTML, markForDestroy, moveAbove, moveBelow, moveBy, moveTo, onAttach, onDetach, pageScrollDown, pageScrollUp, parentResized, placeNear, placeNear, placeNear, printComponents, provideRuleContext, provideRuleContext, redraw, redraw, removeChild, removeChild, removePeer, removePeer, removeSnapAlignCandidate, resizeBy, resizeControls, resizeFonts, resizeFonts, resizeTo, resizeTo, revealChild, revealChild, scrollBy, scrollByPercent, scrollTo, scrollTo, scrollTo, scrollToBottom, scrollToLeft, scrollToPercent, scrollToRight, scrollToTop, sendToBack, setAccessKey, setAdaptHeightByCustomizer, setAdaptiveHeightPriority, setAdaptiveWidthPriority, setAdaptWidthByCustomizer, setAllowExternalFilters, setAlwaysShowScrollbars, setAnimateAcceleration, setAnimateFadeTime, setAnimateHideAcceleration, setAnimateHideTime, setAnimateMoveAcceleration, setAnimateMoveTime, setAnimateRectAcceleration, setAnimateRectTime, setAnimateResizeAcceleration, setAnimateResizeTime, setAnimateScrollAcceleration, setAnimateScrollTime, setAnimateShowAcceleration, setAnimateShowEffect, setAnimateShowTime, setAnimateTime, setAppImgDir, setAriaRole, setAriaState, setAutoChildConstructor, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildVisibility, setAutoDraw, setAutoHeight, setAutoMaskComponents, setAutoParent, setAutoShowParent, setAutoWidth, setBackgroundColor, setBackgroundImage, setBackgroundPosition, setBackgroundRepeat, setBorder, setBottom, setCanAcceptDrop, setCanAdaptHeight, setCanAdaptWidth, setCanDrag, setCanDragReposition, setCanDragResize, setCanDragScroll, setCanDrop, setCanDropBefore, setCanFocus, setCanSelectText, setChildren, setChildrenResizeSnapAlign, setChildrenSnapAlign, setChildrenSnapCenterAlign, setChildrenSnapEdgeAlign, setChildrenSnapResizeToGrid, setChildrenSnapToGrid, setComponentMaskDefaults, setContents, setContextMenu, setCursor, setDataPath, setDefaultHeight, setDefaultPageSpace, setDefaultProperties, setDefaultWidth, setDisabled, setDisabledCursor, setDisableTouchScrollingForDrag, setDoubleClickDelay, setDragAppearance, setDragIntersectStyle, setDragMaskType, setDragMaxHeight, setDragMaxWidth, setDragMinHeight, setDragMinWidth, setDragOpacity, setDragRepositionAppearance, setDragRepositionCursor, setDragResizeAppearance, setDragScrollDelay, setDragStartDistance, setDragTarget, setDragType, setDropTypes, setDropTypes, setDynamicContents, setEdgeBackgroundColor, setEdgeCenterBackgroundColor, setEdgeImage, setEdgeMarginSize, setEdgeOffset, setEdgeOpacity, setEdgeShowCenter, setEdgeSize, setEditMode, setEditMode, setEditMode, setElement, setEnableWhen, setExtraSpace, setFacetId, setGroupBorderCSS, setGroupLabelBackgroundColor, setGroupLabelStyleName, setGroupTitle, setHeight, setHeight, setHeight, setHeight100, setHideUsingDisplayNone, setHoverAlign, setHoverAutoDestroy, setHoverDelay, setHoverHeight, setHoverMoveWithMouse, setHoverOpacity, setHoverVAlign, setHoverWidth, setHoverWrap, setHtmlElement, setHtmlPosition, setImage, setImage, setInitHandler, setIsGroup, setIsRuleScope, setIsSnapAlignCandidate, setKeepInParentRect, setKeepInParentRect, setKeepInParentRect, setLayoutAlign, setLayoutAlign, setLeavePageSpace, setLeft, setLeft, setLocateChildrenBy, setLocateChildrenType, setLocatePeersBy, setLocatePeersType, setLogicalStructure, setMargin, setMatchElement, setMaxHeight, setMaxWidth, setMenuConstructor, setMinHeight, setMinNonEdgeSize, setMinWidth, setMomentumScrollMinSpeed, setMouseStillDownDelay, setMouseStillDownInitialDelay, setNeverUseFilters, setNoDoubleClicks, setNoDropCursor, setOpacity, setPadding, setPageLeft, setPageTop, setParentCanvas, setParentElement, setPeers, setPercentBox, setPercentSource, setPosition, setPrefix, setPrintChildrenAbsolutelyPositioned, setPrompt, setProportionalResizeModifiers, setProportionalResizing, setRect, setRect, setRedrawOnResize, setResizeBarTarget, setResizeFrom, setResizeFrom, setRight, setRuleScope, setScrollbarConstructor, setScrollbarSize, setShadowDepth, setShadowImage, setShadowOffset, setShadowSoftness, setShouldPrint, setShowCustomScrollbars, setShowDragShadow, setShowEdges, setShowResizeBar, setShowShadow, setShowSnapGrid, setShrinkElementOnHide, setSmoothFade, setSnapAlignCandidates, setSnapAlignCenterLineStyle, setSnapAlignEdgeLineStyle, setSnapAxis, setSnapEdge, setSnapHDirection, setSnapHGap, setSnapOffsetLeft, setSnapOffsetTop, setSnapOnDrop, setSnapResizeToAlign, setSnapResizeToGrid, setSnapTo, setSnapToAlign, setSnapToCenterAlign, setSnapToEdgeAlign, setSnapToGrid, setSnapVDirection, setSnapVGap, setTabIndex, setTitle, setTooltip, setTop, setTop, setUseBackMask, setUseDragMask, setUseNativeDrag, setUseOpacityFilter, setUseTouchScrolling, setValuesManager, setVisibility, setVisible, setVisibleWhen, setWidth, setWidth, setWidth, setWidth100, setZIndex, shouldDragScroll, show, showClickMask, showComponentMask, showComponentMask, showNextTo, showNextTo, showNextTo, showNextTo, showPrintPreview, showPrintPreview, showPrintPreview, showPrintPreview, showRecursively, updateEditNode, updateHover, updateHover, updateShadow, visibleAtPoint
addDrawHandler, applyFactoryProperties, completeCreation, destroy, doAddHandler, doInit, doOnRender, draw, equals, error, errorIfNotCreated, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDateArray, getAttributeAsDouble, getAttributeAsElement, getAttributeAsFloat, getAttributeAsFloatArray, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsMap, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getById, getByJSObject, getConfig, getDOM, getHandlerCount, getID, getInnerHTML, getJsObj, getOrCreateJsObj, getRef, getScClassName, hasAutoAssignedID, hashCode, initNativeObject, internalSetID, internalSetID, isConfigOnly, isCreated, isFactoryCreated, onBind, onDestroy, onDraw, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setConfig, setConfigOnly, setDefaultProperties, setDragTracker, setFactoryCreated, setID, setJavaScriptObject, setLogicalStructure, setLogicalStructure, setNullProperty, setPosition, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setScClassName, toString
addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getLayoutData, getParent, isAttached, isOrWasAttached, onBrowserEvent, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents
addStyleDependentName, ensureDebugId, ensureDebugId, ensureDebugId, getStyleElement, getStyleName, getStylePrimaryName, getStylePrimaryName, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setVisible, sinkBitlessEvent
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
getOrCreateJsObj
public ListGrid()
public ListGrid(com.google.gwt.core.client.JavaScriptObject jsObj)
public ListGrid(DataSource dataSource)
public static ListGrid getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
protected ListGrid getTestInstance()
getTestInstance
in class Canvas
public static void changeAutoChildDefaults(java.lang.String autoChildName, Canvas defaults)
autoChildName
.autoChildName
- name of an AutoChild to customize the defaults for.defaults
- Canvas defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties
.AutoChildUsage
public static void changeAutoChildDefaults(java.lang.String autoChildName, FormItem defaults)
autoChildName
.autoChildName
- name of an AutoChild to customize the defaults for.defaults
- FormItem defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties
.AutoChildUsage
protected com.google.gwt.core.client.JavaScriptObject create()
public void setAdvancedFieldPickerThreshold(int advancedFieldPickerThreshold) throws java.lang.IllegalStateException
useAdvancedFieldPicker
is set, total
number of available fields that must be present in the grid before the advanced field picker interface is used instead
of the normal columns submenu. Set to 0 to have the advanced picker always used (when useAdvancedFieldPicker is true).
advancedFieldPickerThreshold
- Default value is 25java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getAdvancedFieldPickerThreshold()
useAdvancedFieldPicker
is set, total
number of available fields that must be present in the grid before the advanced field picker interface is used instead
of the normal columns submenu. Set to 0 to have the advanced picker always used (when useAdvancedFieldPicker is true).
public void setAllowFilterExpressions(java.lang.Boolean allowFilterExpressions) throws java.lang.IllegalStateException
showFilterEditor
:true, allows simple
search expressions to be entered into filter fields, as though DynamicForm.allowExpressions
were true. This
attribute can also be set at the field
level
.
allowFilterExpressions
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getAllowFilterExpressions()
showFilterEditor
:true, allows simple
search expressions to be entered into filter fields, as though DynamicForm.allowExpressions
were true. This
attribute can also be set at the field
level
.
public void setAllowFilterOperators(java.lang.Boolean allowFilterOperators) throws java.lang.IllegalStateException
"Filter using"
to appear
in the headerContextMenu
that allows the end
user to pick an advanced search operator
to use for this field. Once an
operator has been chosen, the active operator is indicated by an operatorIcon
placed within the field (you can alternatively
cause the icon to always be present
). The
operatorIcon
shows the same textual representation of the search operator as is used by the FormItem.allowExpressions
feature. Clicking on
the icon provides a second way to modify the search operator.
This feature is enabled by default if DataSource.supportsAdvancedCriteria()
is true, for all
fields where it is normally possible to filter by typing in a search string. This excludes field types such as "date"
or "boolean" which show specialized filter controls. Use ListGridField.allowFilterOperators
to disable
this interface for individual fields, or set DataSourceField.canFilter
to false to disallow filtering entirely for a field.
Note that this feature is similar
to allowFilterExpressions
, which allows the
end users to directly type in characters such as ">" to control filtering. allowFilterOperators
is
easier to use and more discoverable than allowFilterExpressions
, and also avoids the drawback where special
characters like ">" cannot be used in filter values. However, allowFilterExpressions
allows users to
make use of certain operators that allowFilterOperators
does not support, such as using the
"betweenInclusive" operator by typing "5...10".
When both allowfilterExpressions
and
allowFilterOperators
are set, filter expressions entered in to the edit-area are parsed and the operator
automatically applied to the operatorIcon
.
allowFilterOperators
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getAllowFilterOperators()
"Filter using"
to appear
in the headerContextMenu
that allows the end
user to pick an advanced search operator
to use for this field. Once an
operator has been chosen, the active operator is indicated by an operatorIcon
placed within the field (you can alternatively
cause the icon to always be present
). The
operatorIcon
shows the same textual representation of the search operator as is used by the FormItem.allowExpressions
feature. Clicking on
the icon provides a second way to modify the search operator.
This feature is enabled by default if DataSource.supportsAdvancedCriteria()
is true, for all
fields where it is normally possible to filter by typing in a search string. This excludes field types such as "date"
or "boolean" which show specialized filter controls. Use ListGridField.allowFilterOperators
to disable
this interface for individual fields, or set DataSourceField.canFilter
to false to disallow filtering entirely for a field.
Note that this feature is similar
to allowFilterExpressions
, which allows the
end users to directly type in characters such as ">" to control filtering. allowFilterOperators
is
easier to use and more discoverable than allowFilterExpressions
, and also avoids the drawback where special
characters like ">" cannot be used in filter values. However, allowFilterExpressions
allows users to
make use of certain operators that allowFilterOperators
does not support, such as using the
"betweenInclusive" operator by typing "5...10".
When both allowfilterExpressions
and
allowFilterOperators
are set, filter expressions entered in to the edit-area are parsed and the operator
automatically applied to the operatorIcon
.
public void setAllowRowSpanning(java.lang.Boolean allowRowSpanning) throws java.lang.IllegalStateException
true
, the getRowSpan()
method will be called for every cell when rendering
out the listGrid to determine how many rows the cell should span. See getRowSpan()
for more details
allowRowSpanning
- Default value is falsejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getAllowRowSpanning()
true
, the getRowSpan()
method will be called for every cell when rendering
out the listGrid to determine how many rows the cell should span. See getRowSpan()
for more details
public void setAlternateBodyStyleName(java.lang.String alternateBodyStyleName)
alternateRecordStyles
is true for this grid. If unset bodyStyleName
will be used to style the body regardless of the alternateRecordStyles
setting.
alternateBodyStyleName
for this listGrid.
Note : This is an advanced setting
alternateBodyStyleName
- new body style name when showing alternateRecordStylesCSSStyleName . Default value is null
public java.lang.String getAlternateBodyStyleName()
alternateRecordStyles
is true for this grid. If unset bodyStyleName
will be used to style the body regardless of the alternateRecordStyles
setting.CSSStyleName
public void setAlternateFieldFrequency(int alternateFieldFrequency)
alternateColumnStyles
is true.alternateFieldFrequency
- Default value is 1public int getAlternateFieldFrequency()
alternateColumnStyles
is true.public void setAlternateFieldStyles(boolean alternateFieldStyles)
alternateFieldStyles
- Default value is falsepublic boolean getAlternateFieldStyles()
public void setAlternateRecordFrequency(int alternateRecordFrequency)
alternateRowStyles
is true.alternateRecordFrequency
- Default value is 1public int getAlternateRecordFrequency()
alternateRowS