Table (Vaadin)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.vaadin.ui
Class Table

java.lang.Object
  com.vaadin.terminal.AbstractClientConnector
      com.vaadin.ui.AbstractComponent
          com.vaadin.ui.AbstractField<Object>
              com.vaadin.ui.AbstractSelect
                  com.vaadin.ui.Table

All Implemented Interfaces:: Buffered, BufferedValidatable, Container, Container.ItemSetChangeListener, Container.ItemSetChangeNotifier, Container.Ordered, Container.PropertySetChangeListener, Container.PropertySetChangeNotifier, Container.Sortable, Container.Viewer, Property<Object>, Property.Editor, Property.ReadOnlyStatusChangeListener, Property.ReadOnlyStatusChangeNotifier, Property.ValueChangeListener, Property.ValueChangeNotifier, Property.Viewer, Validatable, Action.Container, Action.ShortcutNotifier, DragSource, DropTarget, ItemClickEvent.ItemClickNotifier, MethodEventSource, Connector, ClientConnector, RpcTarget, Sizeable, Vaadin6Component, VariableOwner, Component, Component.Focusable, Field<Object>, HasComponents, Serializable, Iterable<Component>, EventListener

Direct Known Subclasses:: TreeTable

public class Table
extends AbstractSelect
implements Action.Container, Container.Ordered, Container.Sortable, ItemClickEvent.ItemClickNotifier, DragSource, DropTarget, HasComponents
extends AbstractSelect
implements Action.Container, Container.Ordered, Container.Sortable, ItemClickEvent.ItemClickNotifier, DragSource, DropTarget, HasComponents

Table is used for representing data or components in a pageable and selectable table.

Scalability of the Table is largely dictated by the container. A table does not have a limit for the number of items and is just as fast with hundreds of thousands of items as with just a few. The current GWT implementation with scrolling however limits the number of rows to around 500000, depending on the browser and the pixel height of rows.

Components in a Table will not have their caption nor icon rendered.

Since:: 3.0
Version:: 7.0.0.alpha3
Author:: Vaadin Ltd.
See Also:: Serialized Form

Nested Class Summary
`static class`	`Table.Align`
`static interface`	`Table.CellStyleGenerator` Allow to define specific style on cells (and rows) contents.
`static interface`	`Table.ColumnGenerator` Used to create "generated columns"; columns that exist only in the Table, not in the underlying Container.
`static class`	`Table.ColumnHeaderMode`
`static class`	`Table.ColumnReorderEvent` This event is fired when a columns are reordered by the end user user.
`static interface`	`Table.ColumnReorderListener` Interface for listening to column reorder events.
`static class`	`Table.ColumnResizeEvent` This event is fired when a column is resized.
`static interface`	`Table.ColumnResizeListener` Interface for listening to column resize events.
`static class`	`Table.FooterClickEvent` Click event fired when clicking on the Table footers.
`static interface`	`Table.FooterClickListener` Interface for the listener for column footer mouse click events.
`static class`	`Table.GeneratedRow`
`static class`	`Table.HeaderClickEvent` Click event fired when clicking on the Table headers.
`static interface`	`Table.HeaderClickListener` Interface for the listener for column header mouse click events.
`static interface`	`Table.RowGenerator` Row generators can be used to replace certain items in a table with a generated string.
`static class`	`Table.RowHeaderMode`
`static class`	`Table.TableDragMode` Modes that Table support as drag sourse.
`static class`	`Table.TableDropCriterion` Lazy loading accept criterion for Table.
`class`	`Table.TableTransferable` Concrete implementation of `DataBoundTransferable` for data transferred from a table.

Nested classes/interfaces inherited from class com.vaadin.ui.AbstractSelect
`AbstractSelect.AbstractSelectTargetDetails, AbstractSelect.AcceptItem, AbstractSelect.CaptionChangeListener, AbstractSelect.DefaultNewItemHandler, AbstractSelect.Filtering, AbstractSelect.ItemCaptionMode, AbstractSelect.ItemDescriptionGenerator, AbstractSelect.MultiSelectMode, AbstractSelect.NewItemHandler, AbstractSelect.TargetItemIs, AbstractSelect.VerticalLocationIs`

Nested classes/interfaces inherited from class com.vaadin.ui.AbstractField
`AbstractField.FocusShortcut, AbstractField.ReadOnlyStatusChangeEvent`

Nested classes/interfaces inherited from class com.vaadin.ui.AbstractComponent
`AbstractComponent.ComponentErrorEvent, AbstractComponent.ComponentErrorHandler`

Nested classes/interfaces inherited from interface com.vaadin.data.Container
`Container.Editor, Container.Filter, Container.Filterable, Container.Hierarchical, Container.Indexed, Container.ItemSetChangeEvent, Container.ItemSetChangeListener, Container.ItemSetChangeNotifier, Container.Ordered, Container.PropertySetChangeEvent, Container.PropertySetChangeListener, Container.PropertySetChangeNotifier, Container.SimpleFilterable, Container.Sortable, Container.Viewer`

Nested classes/interfaces inherited from interface com.vaadin.ui.Component
`Component.ErrorEvent, Component.ErrorListener, Component.Event, Component.Focusable, Component.Listener`

Nested classes/interfaces inherited from interface com.vaadin.terminal.Sizeable
`Sizeable.Unit`

Nested classes/interfaces inherited from interface com.vaadin.terminal.VariableOwner
`VariableOwner.ErrorEvent`

Nested classes/interfaces inherited from interface com.vaadin.ui.Field
`Field.ValueChangeEvent`

Nested classes/interfaces inherited from interface com.vaadin.data.Buffered
`Buffered.SourceException`

Nested classes/interfaces inherited from interface com.vaadin.data.Property
`Property.Editor, Property.ReadOnlyException, Property.ReadOnlyStatusChangeListener, Property.ReadOnlyStatusChangeNotifier, Property.Transactional<T>, Property.ValueChangeListener, Property.ValueChangeNotifier, Property.Viewer`

Field Summary
`static Table.Align`	`ALIGN_CENTER` Deprecated. from 7.0, use `Table.Align.CENTER` instead
`static Table.Align`	`ALIGN_LEFT` Deprecated. from 7.0, use `Table.Align.LEFT` instead
`static Table.Align`	`ALIGN_RIGHT` Deprecated. from 7.0, use `Table.Align.RIGHT` instead
`protected boolean`	`alwaysRecalculateColumnWidths`
`protected static int`	`CELL_FIRSTCOL`
`protected static int`	`CELL_GENERATED_ROW`
`protected static int`	`CELL_HEADER`
`protected static int`	`CELL_ICON`
`protected static int`	`CELL_ITEMID`
`protected static int`	`CELL_KEY`
`static Table.ColumnHeaderMode`	`COLUMN_HEADER_MODE_EXPLICIT` Deprecated. from 7.0, use `Table.ColumnHeaderMode.EXPLICIT` instead
`static Table.ColumnHeaderMode`	`COLUMN_HEADER_MODE_EXPLICIT_DEFAULTS_ID` Deprecated. from 7.0, use `Table.ColumnHeaderMode.EXPLICIT_DEFAULTS_ID` instead
`static Table.ColumnHeaderMode`	`COLUMN_HEADER_MODE_HIDDEN` Deprecated. from 7.0, use `Table.ColumnHeaderMode.HIDDEN` instead
`static Table.ColumnHeaderMode`	`COLUMN_HEADER_MODE_ID` Deprecated. from 7.0, use `Table.ColumnHeaderMode.ID` instead
`static Table.RowHeaderMode`	`ROW_HEADER_MODE_EXPLICIT` Deprecated. from 7.0, use `Table.RowHeaderMode.EXPLICIT` instead
`static Table.RowHeaderMode`	`ROW_HEADER_MODE_EXPLICIT_DEFAULTS_ID` Deprecated. from 7.0, use `Table.RowHeaderMode.EXPLICIT_DEFAULTS_ID` instead
`static Table.RowHeaderMode`	`ROW_HEADER_MODE_HIDDEN` Deprecated. from 7.0, use `Table.RowHeaderMode.HIDDEN` instead
`static Table.RowHeaderMode`	`ROW_HEADER_MODE_ICON_ONLY` Deprecated. from 7.0, use `Table.RowHeaderMode.ICON_ONLY` instead
`static Table.RowHeaderMode`	`ROW_HEADER_MODE_ID` Deprecated. from 7.0, use `Table.RowHeaderMode.ID` instead
`static Table.RowHeaderMode`	`ROW_HEADER_MODE_INDEX` Deprecated. from 7.0, use `Table.RowHeaderMode.INDEX` instead
`static Table.RowHeaderMode`	`ROW_HEADER_MODE_ITEM` Deprecated. from 7.0, use `Table.RowHeaderMode.ITEM` instead
`static Table.RowHeaderMode`	`ROW_HEADER_MODE_PROPERTY` Deprecated. from 7.0, use `Table.RowHeaderMode.PROPERTY` instead

Fields inherited from class com.vaadin.ui.AbstractSelect
`ITEM_CAPTION_MODE_EXPLICIT, ITEM_CAPTION_MODE_EXPLICIT_DEFAULTS_ID, ITEM_CAPTION_MODE_ICON_ONLY, ITEM_CAPTION_MODE_ID, ITEM_CAPTION_MODE_INDEX, ITEM_CAPTION_MODE_ITEM, ITEM_CAPTION_MODE_PROPERTY, itemIdMapper, items`

Fields inherited from interface com.vaadin.terminal.Sizeable
`SIZE_UNDEFINED, UNITS_CM, UNITS_EM, UNITS_EX, UNITS_INCH, UNITS_MM, UNITS_PERCENTAGE, UNITS_PICAS, UNITS_PIXELS, UNITS_POINTS`

Constructor Summary
`Table()` Creates a new empty table.
`Table(String caption)` Creates a new empty table with caption.
`Table(String caption, Container dataSource)` Creates a new table with caption and connect it to a Container.

Method Summary
`void`	`addActionHandler(Action.Handler actionHandler)` Registers a new action handler for this container
`boolean`	`addContainerProperty(Object propertyId, Class<?> type, Object defaultValue)` Adds a new property to the table and show it as a visible column.
`boolean`	`addContainerProperty(Object propertyId, Class<?> type, Object defaultValue, String columnHeader, Resource columnIcon, Table.Align columnAlignment)` Adds a new property to the table and show it as a visible column.
`void`	`addGeneratedColumn(Object id, Table.ColumnGenerator generatedColumn)` Adds a generated column to the Table.
`Object`	`addItem(Object[] cells, Object itemId)` Adds the new row to table and fill the visible cells (except generated columns) with given values.
`Object`	`addItemAfter(Object previousItemId)` Adds new item after the given item.
`Item`	`addItemAfter(Object previousItemId, Object newItemId)` Adds new item after the given item.
`void`	`addListener(ItemClickEvent.ItemClickListener listener)` Register a listener to handle `ItemClickEvent`s.
`void`	`addListener(Table.ColumnReorderListener listener)` Adds a column reorder listener to the Table.
`void`	`addListener(Table.ColumnResizeListener listener)` Adds a column resize listener to the Table.
`void`	`addListener(Table.FooterClickListener listener)` Adds a footer click listener which handles the click events when the user clicks on a column footer cell in the Table.
`void`	`addListener(Table.HeaderClickListener listener)` Adds a header click listener which handles the click events when the user clicks on a column header cell in the Table.
`void`	`attach()` Notifies the component that it is connected to an application.
`protected void`	`bindPropertyToField(Object rowId, Object colId, Property property, Field field)` Binds an item property to a field generated by TableFieldFactory.
`void`	`changeVariables(Object source, Map<String,Object> variables)` Invoked when the value of a variable has changed.
`void`	`containerItemSetChange(Container.ItemSetChangeEvent event)` Container datasource item set change.
`void`	`containerPropertySetChange(Container.PropertySetChangeEvent event)` Container datasource property set change.
`void`	`detach()` Notifies the component that it is detached from the application
`protected boolean`	`disableContentRefreshing()` Go to mode where content updates are not done.
`protected void`	`enableContentRefreshing(boolean refreshContent)` Go to mode where content content refreshing has effect.
`Object`	`firstItemId()` Gets the ID of the first Item in the Container.
`protected String`	`formatPropertyValue(Object rowId, Object colId, Property<?> property)` Formats table cell property values.
`protected int`	`getAddedRowCount()` Subclass and override this to enable partial row additions, bypassing the normal caching mechanism.
`double`	`getCacheRate()`
`Table.CellStyleGenerator`	`getCellStyleGenerator()` Get the current cell style generator.
`Table.Align`	`getColumnAlignment(Object propertyId)` Gets the specified column's alignment.
`Table.Align[]`	`getColumnAlignments()` Gets the array of column alignments.
`float`	`getColumnExpandRatio(Object propertyId)`
`String`	`getColumnFooter(Object propertyId)` Gets the footer caption beneath the rows
`Table.ColumnGenerator`	`getColumnGenerator(Object columnId)` Returns the ColumnGenerator used to generate the given column.
`String`	`getColumnHeader(Object propertyId)` Gets the header for the specified column.
`Table.ColumnHeaderMode`	`getColumnHeaderMode()` Getter for property columnHeaderMode.
`String[]`	`getColumnHeaders()` Gets the headers of the columns.
`Resource`	`getColumnIcon(Object propertyId)` Gets the icon Resource for the specified column.
`Resource[]`	`getColumnIcons()` Gets the icons of the columns.
`int`	`getColumnWidth(Object propertyId)` Gets the pixel width of column
`Iterator<Component>`	`getComponentIterator()` Gets an iterator to the collection of contained components.
`Converter<String,Object>`	`getConverter(Object propertyId)` Returns the converter used to format the given propertyId.
`Object`	`getCurrentPageFirstItemId()` Getter for property currentPageFirstItem.
`int`	`getCurrentPageFirstItemIndex()` Getter for property currentPageFirstItem.
`Table.TableDragMode`	`getDragMode()`
`DropHandler`	`getDropHandler()`
`protected int`	`getFirstAddedItemIndex()` Subclass and override this to enable partial row additions, bypassing the normal caching mechanism.
`protected int`	`getFirstUpdatedItemIndex()` Subclass and override this to enable partial row updates, bypassing the normal caching and lazy loading mechanism.
`protected Object`	`getIdByIndex(int index)`
`AbstractSelect.ItemDescriptionGenerator`	`getItemDescriptionGenerator()` Get the item description generator which generates tooltips for cells and rows in the Table.
`AbstractSelect.MultiSelectMode`	`getMultiSelectMode()` Returns the select mode in which multi-select is used.
`int`	`getPageLength()` Gets the page length.
`protected Object`	`getPropertyValue(Object rowId, Object colId, Property property)` Gets the value of property.
`Table.RowGenerator`	`getRowGenerator()`
`Table.RowHeaderMode`	`getRowHeaderMode()` Gets the row header mode.
`Collection<?>`	`getSortableContainerPropertyIds()` Gets the container property IDs, which can be used to sort the item.
`Object`	`getSortContainerPropertyId()` Gets the currently sorted column property ID.
`TableFieldFactory`	`getTableFieldFactory()` Gets the TableFieldFactory that is used to create editor for table cells.
`Table.TableTransferable`	`getTransferable(Map<String,Object> rawVariables)` DragSource may convert data added by client side component to meaningful values for server side developer or add other data based on it.
`protected int`	`getUpdatedRowCount()` Subclass and override this to enable partial row updates, bypassing the normal caching and lazy loading mechanism.
`Object[]`	`getVisibleColumns()` Gets the array of visible column id:s, including generated columns.
`Collection<?>`	`getVisibleItemIds()` Returns item identifiers of the items which are currently rendered on the client.
`protected boolean`	`hasConverter(Object propertyId)` Checks if there is a converter set explicitly for the given property id.
`protected int`	`indexOfId(Object itemId)`
`boolean`	`isColumnCollapsed(Object propertyId)` Checks if the specified column is collapsed.
`boolean`	`isColumnCollapsible(Object propertyId)` Checks if the given column is collapsible.
`boolean`	`isColumnCollapsingAllowed()` Checks if column collapsing is allowed.
`boolean`	`isColumnReorderingAllowed()` Checks if column reordering is allowed.
`boolean`	`isComponentVisible(Component childComponent)` Checks if the child component is visible.
`boolean`	`isEditable()` Is table editable.
`boolean`	`isFirstId(Object itemId)` Tests if the Item corresponding to the given Item ID is the first Item in the Container.
`boolean`	`isFooterVisible()` Is the footer currently visible?
`boolean`	`isLastId(Object itemId)` Tests if the Item corresponding to the given Item ID is the last Item in the Container.
`boolean`	`isPageBufferingEnabled()` Deprecated. functionality is not needed in ajax rendering model
`protected boolean`	`isPartialRowUpdate()` Subclass and override this to enable partial row updates and additions, which bypass the normal caching mechanism.
`protected boolean`	`isRowCacheInvalidated()`
`boolean`	`isSelectable()` Getter for property selectable.
`boolean`	`isSortAscending()` Is the table currently sorted in ascending order.
`boolean`	`isSortDisabled()` Deprecated. Use `isSortEnabled()` instead
`boolean`	`isSortEnabled()` Checks if sorting is enabled.
`Iterator<Component>`	`iterator()`
`Object`	`lastItemId()` Gets the ID of the last Item in the Container.
`Object`	`nextItemId(Object itemId)` Gets the ID of the Item following the Item that corresponds to itemId.
`void`	`paintContent(PaintTarget target)` Paints the content of this component.
`protected void`	`paintRowAttributes(PaintTarget target, Object itemId)` A method where extended Table implementations may add their custom attributes for rows.
`protected void`	`paintRowHeader(PaintTarget target, Object[][] cells, int indexInRowbuffer)`
`protected void`	`paintRowIcon(PaintTarget target, Object[][] cells, int indexInRowbuffer)`
`Object`	`prevItemId(Object itemId)` Gets the ID of the Item preceding the Item that corresponds to the itemId.
`void`	`refreshCurrentPage()` Deprecated. should not need to be used
`protected void`	`refreshRenderedCells()` Refreshes the rows in the internal cache.
`void`	`refreshRowCache()` Discards and recreates the internal row cache.
`protected void`	`registerComponent(Component component)`
`void`	`removeActionHandler(Action.Handler actionHandler)` Removes a previously registered action handler for the contents of this container.
`void`	`removeAllActionHandlers()` Removes all action handlers
`boolean`	`removeAllItems()` Removes all Items from the Container.
`boolean`	`removeContainerProperty(Object propertyId)` Removes a Property specified by the given Property ID from the Container.
`boolean`	`removeGeneratedColumn(Object columnId)` Removes a generated column previously added with addGeneratedColumn.
`boolean`	`removeItem(Object itemId)` Removes the Item identified by `ItemId` from the Container.
`void`	`removeListener(ItemClickEvent.ItemClickListener listener)` Removes an ItemClickListener.
`void`	`removeListener(Table.ColumnReorderListener listener)` Removes a column reorder listener from the Table.
`void`	`removeListener(Table.ColumnResizeListener listener)` Removes a column resize listener from the Table.
`void`	`removeListener(Table.FooterClickListener listener)` Removes a footer click listener
`void`	`removeListener(Table.HeaderClickListener listener)` Removes a header click listener
`void`	`requestRepaint()` Requests that the Table should be repainted as soon as possible.
`void`	`requestRepaintAll()` Causes a repaint of this connector, and all connectors below it.
`protected void`	`resetPageBuffer()` Clears the current page buffer.
`void`	`setCacheRate(double cacheRate)` This method adjusts a possible caching mechanism of table implementation.
`void`	`setCellStyleGenerator(Table.CellStyleGenerator cellStyleGenerator)` Set cell style generator for Table.
`void`	`setColumnAlignment(Object propertyId, Table.Align alignment)` Sets the specified column's alignment.
`void`	`setColumnAlignments(Table.Align... columnAlignments)` Sets the column alignments.
`void`	`setColumnCollapsed(Object propertyId, boolean collapsed)` Sets whether the specified column is collapsed or not.
`void`	`setColumnCollapsible(Object propertyId, boolean collapsible)` Sets whether the given column is collapsible.
`void`	`setColumnCollapsingAllowed(boolean collapsingAllowed)` Sets whether column collapsing is allowed or not.
`void`	`setColumnExpandRatio(Object propertyId, float expandRatio)` Sets the column expand ratio for given column.
`void`	`setColumnFooter(Object propertyId, String footer)` Sets the column footer caption.
`void`	`setColumnHeader(Object propertyId, String header)` Sets the column header for the specified column;
`void`	`setColumnHeaderMode(Table.ColumnHeaderMode columnHeaderMode)` Setter for property columnHeaderMode.
`void`	`setColumnHeaders(String[] columnHeaders)` Sets the headers of the columns.
`void`	`setColumnIcon(Object propertyId, Resource icon)` Sets the icon Resource for the specified column.
`void`	`setColumnIcons(Resource[] columnIcons)` Sets the icons of the columns.
`void`	`setColumnReorderingAllowed(boolean columnReorderingAllowed)` Sets whether column reordering is allowed or not.
`void`	`setColumnWidth(Object propertyId, int width)` Sets columns width (in pixels).
`void`	`setContainerDataSource(Container newDataSource)` Sets the Container that serves as the data source of the viewer.
`void`	`setConverter(Object propertyId, Converter<String,?> converter)` Sets a converter for a property id.
`void`	`setCurrentPageFirstItemId(Object currentPageFirstItemId)` Setter for property currentPageFirstItemId.
`void`	`setCurrentPageFirstItemIndex(int newIndex)` Setter for property currentPageFirstItem.
`void`	`setDragMode(Table.TableDragMode newDragMode)` Sets the drag start mode of the Table.
`void`	`setDropHandler(DropHandler dropHandler)`
`void`	`setEditable(boolean editable)` Sets the editable property.
`void`	`setEnabled(boolean enabled)` Enables or disables the component.
`void`	`setFooterVisible(boolean visible)` Sets the footer visible in the bottom of the table.
`void`	`setItemDescriptionGenerator(AbstractSelect.ItemDescriptionGenerator generator)` Set the item description generator which generates tooltips for cells and rows in the Table
`void`	`setMultiSelectMode(AbstractSelect.MultiSelectMode mode)` Sets the behavior of how the multi-select mode should behave when the table is both selectable and in multi-select mode.
`void`	`setNewItemsAllowed(boolean allowNewOptions)` Adding new items is not supported.
`void`	`setPageBufferingEnabled(boolean pageBuffering)` Deprecated. functionality is not needed in ajax rendering model
`void`	`setPageLength(int pageLength)` Sets the page length.
`void`	`setRowGenerator(Table.RowGenerator generator)` Assigns a row generator to the table.
`void`	`setRowHeaderMode(Table.RowHeaderMode mode)` Sets the row header mode.
`void`	`setSelectable(boolean selectable)` Setter for property selectable.
`void`	`setSortAscending(boolean ascending)` Sets the table in ascending order.
`void`	`setSortContainerPropertyId(Object propertyId)` Sets the currently sorted column property id.
`void`	`setSortDisabled(boolean sortDisabled)` Deprecated. Use `setSortEnabled(boolean)` instead
`void`	`setSortEnabled(boolean sortEnabled)` Enables or disables sorting.
`void`	`setTableFieldFactory(TableFieldFactory fieldFactory)` Sets the TableFieldFactory that is used to create editor for table cells.
`void`	`setVisible(boolean visible)` Sets the visibility of the component.
`void`	`setVisibleColumns(Object[] visibleColumns)` Sets the array of visible column property id:s.
`protected boolean`	`shouldHideAddedRows()` Subclass and override this to enable removing of rows, bypassing the normal caching and lazy loading mechanism.
`void`	`sort()` Sorts the table by currently selected sorting column.
`void`	`sort(Object[] propertyId, boolean[] ascending)` Sorts the table.
`AbstractSelect.AbstractSelectTargetDetails`	`translateDropTargetDetails(Map<String,Object> clientVariables)` Called before the `DragAndDropEvent` is passed to `DropHandler`.
`protected void`	`unregisterComponent(Component component)` This method cleans up a Component that has been generated when Table is in editable mode.
`void`	`valueChange(Property.ValueChangeEvent event)` Notifies this listener that the Property's value has changed.

Methods inherited from class com.vaadin.ui.AbstractSelect
addItem, addItem, addListener, addListener, containsId, fireItemSetChange, firePropertySetChange, getCaptionChangeListener, getContainerDataSource, getContainerProperty, getContainerPropertyIds, getItem, getItemCaption, getItemCaptionMode, getItemCaptionPropertyId, getItemIcon, getItemIconPropertyId, getItemIds, getListeners, getNewItemHandler, getNullSelectionItemId, getType, getType, getValue, isEmpty, isMultiSelect, isNewItemsAllowed, isNullSelectionAllowed, isSelected, paintItem, removeListener, removeListener, select, setItemCaption, setItemCaptionMode, setItemCaptionPropertyId, setItemIcon, setItemIconPropertyId, setMultiSelect, setNewItemHandler, setNullSelectionAllowed, setNullSelectionItemId, setValue, setValue, size, unselect

Methods inherited from class com.vaadin.ui.AbstractSelect

addItem, addItem, addListener, addListener, containsId, fireItemSetChange, firePropertySetChange, getCaptionChangeListener, getContainerDataSource, getContainerProperty, getContainerPropertyIds, getItem, getItemCaption, getItemCaptionMode, getItemCaptionPropertyId, getItemIcon, getItemIconPropertyId, getItemIds, getListeners, getNewItemHandler, getNullSelectionItemId, getType, getType, getValue, isEmpty, isMultiSelect, isNewItemsAllowed, isNullSelectionAllowed, isSelected, paintItem, removeListener, removeListener, select, setItemCaption, setItemCaptionMode, setItemCaptionPropertyId, setItemIcon, setItemIconPropertyId, setMultiSelect, setNewItemHandler, setNullSelectionAllowed, setNullSelectionItemId, setValue, setValue, size, unselect

Methods inherited from class com.vaadin.ui.AbstractField
addListener, addListener, addValidator, commit, discard, fireReadOnlyStatusChange, fireValueChange, focus, getConversionError, getConversionError, getConvertedValue, getConverter, getCurrentBufferedSourceException, getErrorMessage, getInternalValue, getPropertyDataSource, getRequiredError, getState, getTabIndex, getValidators, isBuffered, isInvalidAllowed, isInvalidCommitted, isModified, isReadOnly, isReadThrough, isRequired, isValid, isValidationVisible, isWriteThrough, readOnlyStatusChange, removeAllValidators, removeListener, removeListener, removeValidator, setBuffered, setConversionError, setConvertedValue, setConverter, setConverter, setCurrentBufferedSourceException, setInternalValue, setInvalidAllowed, setInvalidCommitted, setPropertyDataSource, setReadOnly, setReadThrough, setRequired, setRequiredError, setTabIndex, setValidationVisible, setWriteThrough, shouldHideErrors, toString, updateState, validate, validate

Methods inherited from class com.vaadin.ui.AbstractField

addListener, addListener, addValidator, commit, discard, fireReadOnlyStatusChange, fireValueChange, focus, getConversionError, getConversionError, getConvertedValue, getConverter, getCurrentBufferedSourceException, getErrorMessage, getInternalValue, getPropertyDataSource, getRequiredError, getState, getTabIndex, getValidators, isBuffered, isInvalidAllowed, isInvalidCommitted, isModified, isReadOnly, isReadThrough, isRequired, isValid, isValidationVisible, isWriteThrough, readOnlyStatusChange, removeAllValidators, removeListener, removeListener, removeValidator, setBuffered, setConversionError, setConvertedValue, setConverter, setConverter, setCurrentBufferedSourceException, setInternalValue, setInvalidAllowed, setInvalidCommitted, setPropertyDataSource, setReadOnly, setReadThrough, setRequired, setRequiredError, setTabIndex, setValidationVisible, setWriteThrough, shouldHideErrors, toString, updateState, validate, validate

Methods inherited from class com.vaadin.ui.AbstractComponent
addListener, addListener, addListener, addListener, addShortcutListener, addStyleName, findAncestor, fireComponentErrorEvent, fireComponentEvent, fireEvent, getActionManager, getApplication, getCaption, getComponentError, getData, getDebugId, getDescription, getErrorHandler, getHeight, getHeightUnits, getIcon, getLocale, getParent, getRoot, getStyle, getStyleName, getWidth, getWidthUnits, handleError, hasListeners, isConnectorEnabled, isEnabled, isImmediate, isVisible, removeListener, removeListener, removeListener, removeListener, removeListener, removeShortcutListener, removeStyleName, setCaption, setComponentError, setData, setDebugId, setDescription, setErrorHandler, setHeight, setHeight, setIcon, setImmediate, setLocale, setParent, setSizeFull, setSizeUndefined, setStyle, setStyleName, setWidth, setWidth

Methods inherited from class com.vaadin.ui.AbstractComponent

addListener, addListener, addListener, addListener, addShortcutListener, addStyleName, findAncestor, fireComponentErrorEvent, fireComponentEvent, fireEvent, getActionManager, getApplication, getCaption, getComponentError, getData, getDebugId, getDescription, getErrorHandler, getHeight, getHeightUnits, getIcon, getLocale, getParent, getRoot, getStyle, getStyleName, getWidth, getWidthUnits, handleError, hasListeners, isConnectorEnabled, isEnabled, isImmediate, isVisible, removeListener, removeListener, removeListener, removeListener, removeListener, removeShortcutListener, removeStyleName, setCaption, setComponentError, setData, setDebugId, setDescription, setErrorHandler, setHeight, setHeight, setIcon, setImmediate, setLocale, setParent, setSizeFull, setSizeUndefined, setStyle, setStyleName, setWidth, setWidth

Methods inherited from class com.vaadin.terminal.AbstractClientConnector
`addExtension, addMethodInvocationToQueue, createState, getAllChildrenIterable, getConnectorId, getExtensions, getRpcManager, getRpcProxy, getStateType, registerRpc, registerRpc, removeExtension, retrievePendingRpcCalls`

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

Methods inherited from interface com.vaadin.data.Container
`addItem, addItem, containsId, getContainerProperty, getContainerPropertyIds, getItem, getItemIds, getType, size`

Methods inherited from interface com.vaadin.ui.Component
`addListener, addStyleName, getApplication, getCaption, getDebugId, getIcon, getLocale, getParent, getRoot, getState, getStyleName, isEnabled, isReadOnly, isVisible, removeListener, removeStyleName, setCaption, setDebugId, setIcon, setReadOnly, setStyleName, updateState`

Methods inherited from interface com.vaadin.terminal.gwt.server.ClientConnector
`getExtensions, getStateType, isConnectorEnabled, removeExtension, retrievePendingRpcCalls, setParent`

Methods inherited from interface com.vaadin.terminal.gwt.client.Connector
`getConnectorId`

Methods inherited from interface com.vaadin.terminal.gwt.server.RpcTarget
`getRpcManager`

Methods inherited from interface com.vaadin.terminal.Sizeable
`getHeight, getHeightUnits, getWidth, getWidthUnits, setHeight, setHeight, setSizeFull, setSizeUndefined, setWidth, setWidth`

Methods inherited from interface com.vaadin.terminal.VariableOwner
`isEnabled, isImmediate`

Methods inherited from interface com.vaadin.event.Action.ShortcutNotifier
`addShortcutListener, removeShortcutListener`

Field Detail

CELL_KEY

protected static final int CELL_KEY

See Also:: Constant Field Values

CELL_HEADER

protected static final int CELL_HEADER

See Also:: Constant Field Values

CELL_ICON

protected static final int CELL_ICON

See Also:: Constant Field Values

CELL_ITEMID

protected static final int CELL_ITEMID

See Also:: Constant Field Values

CELL_GENERATED_ROW

protected static final int CELL_GENERATED_ROW

See Also:: Constant Field Values

CELL_FIRSTCOL

protected static final int CELL_FIRSTCOL

See Also:: Constant Field Values

ALIGN_LEFT

@Deprecated
public static final Table.Align ALIGN_LEFT

Deprecated. from 7.0, use Table.Align.LEFT instead

ALIGN_CENTER

@Deprecated
public static final Table.Align ALIGN_CENTER

Deprecated. from 7.0, use Table.Align.CENTER instead

ALIGN_RIGHT

@Deprecated
public static final Table.Align ALIGN_RIGHT

Deprecated. from 7.0, use Table.Align.RIGHT instead

COLUMN_HEADER_MODE_HIDDEN

@Deprecated
public static final Table.ColumnHeaderMode COLUMN_HEADER_MODE_HIDDEN

Deprecated. from 7.0, use Table.ColumnHeaderMode.HIDDEN instead

COLUMN_HEADER_MODE_ID

@Deprecated
public static final Table.ColumnHeaderMode COLUMN_HEADER_MODE_ID

Deprecated. from 7.0, use Table.ColumnHeaderMode.ID instead

COLUMN_HEADER_MODE_EXPLICIT

@Deprecated
public static final Table.ColumnHeaderMode COLUMN_HEADER_MODE_EXPLICIT

Deprecated. from 7.0, use Table.ColumnHeaderMode.EXPLICIT instead

COLUMN_HEADER_MODE_EXPLICIT_DEFAULTS_ID

@Deprecated
public static final Table.ColumnHeaderMode COLUMN_HEADER_MODE_EXPLICIT_DEFAULTS_ID

Deprecated. from 7.0, use Table.ColumnHeaderMode.EXPLICIT_DEFAULTS_ID instead

ROW_HEADER_MODE_HIDDEN

@Deprecated
public static final Table.RowHeaderMode ROW_HEADER_MODE_HIDDEN

Deprecated. from 7.0, use Table.RowHeaderMode.HIDDEN instead

ROW_HEADER_MODE_ID

@Deprecated
public static final Table.RowHeaderMode ROW_HEADER_MODE_ID

Deprecated. from 7.0, use Table.RowHeaderMode.ID instead

ROW_HEADER_MODE_ITEM

@Deprecated
public static final Table.RowHeaderMode ROW_HEADER_MODE_ITEM

Deprecated. from 7.0, use Table.RowHeaderMode.ITEM instead

ROW_HEADER_MODE_INDEX

@Deprecated
public static final Table.RowHeaderMode ROW_HEADER_MODE_INDEX

Deprecated. from 7.0, use Table.RowHeaderMode.INDEX instead

ROW_HEADER_MODE_EXPLICIT_DEFAULTS_ID

@Deprecated
public static final Table.RowHeaderMode ROW_HEADER_MODE_EXPLICIT_DEFAULTS_ID

Deprecated. from 7.0, use Table.RowHeaderMode.EXPLICIT_DEFAULTS_ID instead

ROW_HEADER_MODE_EXPLICIT

@Deprecated
public static final Table.RowHeaderMode ROW_HEADER_MODE_EXPLICIT

Deprecated. from 7.0, use Table.RowHeaderMode.EXPLICIT instead

ROW_HEADER_MODE_ICON_ONLY

@Deprecated
public static final Table.RowHeaderMode ROW_HEADER_MODE_ICON_ONLY

Deprecated. from 7.0, use Table.RowHeaderMode.ICON_ONLY instead

ROW_HEADER_MODE_PROPERTY

@Deprecated
public static final Table.RowHeaderMode ROW_HEADER_MODE_PROPERTY

Deprecated. from 7.0, use Table.RowHeaderMode.PROPERTY instead

alwaysRecalculateColumnWidths

protected boolean alwaysRecalculateColumnWidths

Constructor Detail

Table

public Table()

Creates a new empty table.

Table

public Table(String caption)

Creates a new empty table with caption.

Parameters:: caption -

Table

public Table(String caption,
             Container dataSource)

Creates a new table with caption and connect it to a Container.

Parameters:: caption -; dataSource -

Method Detail

getVisibleColumns

public Object[] getVisibleColumns()

Gets the array of visible column id:s, including generated columns.

The columns are show in the order of their appearance in this array.

Returns:: an array of currently visible propertyIds and generated column ids.

setVisibleColumns

public void setVisibleColumns(Object[] visibleColumns)

Sets the array of visible column property id:s.

The columns are show in the order of their appearance in this array.

Parameters:: visibleColumns - the Array of shown property id:s.

getColumnHeaders

public String[] getColumnHeaders()

Gets the headers of the columns.

The headers match the property id:s given my the set visible column headers. The table must be set in either COLUMN_HEADER_MODE_EXPLICIT or COLUMN_HEADER_MODE_EXPLICIT_DEFAULTS_ID mode to show the headers. In the defaults mode any nulls in the headers array are replaced with id.toString().

Returns:: the Array of column headers.

setColumnHeaders

public void setColumnHeaders(String[] columnHeaders)

Sets the headers of the columns.

Parameters:: columnHeaders - the Array of column headers that match the getVisibleColumns() method.

getColumnIcons

public Resource[] getColumnIcons()

Gets the icons of the columns.

The icons in headers match the property id:s given my the set visible column headers. The table must be set in either COLUMN_HEADER_MODE_EXPLICIT or COLUMN_HEADER_MODE_EXPLICIT_DEFAULTS_ID mode to show the headers with icons.

Returns:: the Array of icons that match the getVisibleColumns().

setColumnIcons

public void setColumnIcons(Resource[] columnIcons)

Sets the icons of the columns.

Parameters:: columnIcons - the Array of icons that match the getVisibleColumns() .

getColumnAlignments

public Table.Align[] getColumnAlignments()

Gets the array of column alignments.

The items in the array must match the properties identified by getVisibleColumns(). The possible values for the alignments include:

Table.Align.LEFT: Left alignment
Table.Align.CENTER: Centered
Table.Align.RIGHT: Right alignment

The alignments default to Table.Align.LEFT: any null values are rendered as align lefts.

Returns:: the Column alignments array.

setColumnAlignments

public void setColumnAlignments(Table.Align... columnAlignments)

Sets the column alignments.

The amount of items in the array must match the amount of properties identified by getVisibleColumns(). The possible values for the alignments include:

Table.Align.LEFT: Left alignment
Table.Align.CENTER: Centered
Table.Align.RIGHT: Right alignment

The alignments default to Table.Align.LEFT

Parameters:: columnAlignments - the Column alignments array.

setColumnWidth

public void setColumnWidth(Object propertyId,
                           int width)

Sets columns width (in pixels). Theme may not necessary respect very small or very big values. Setting width to -1 (default) means that theme will make decision of width.

Column can either have a fixed width or expand ratio. The latter one set is used. See @link setColumnExpandRatio(Object, float).

Parameters:: propertyId - colunmns property id; width - width to be reserved for colunmns content
Since:: 4.0.3

setColumnExpandRatio

public void setColumnExpandRatio(Object propertyId,
                                 float expandRatio)

Sets the column expand ratio for given column.

Expand ratios can be defined to customize the way how excess space is divided among columns. Table can have excess space if it has its width defined and there is horizontally more space than columns consume naturally. Excess space is the space that is not used by columns with explicit width (see setColumnWidth(Object, int)) or with natural width (no width nor expand ratio).

By default (without expand ratios) the excess space is divided proportionally to columns natural widths.

Only expand ratios of visible columns are used in final calculations.

Column can either have a fixed width or expand ratio. The latter one set is used.

A column with expand ratio is considered to be minimum width by default (if no excess space exists). The minimum width is defined by terminal implementation.

If terminal implementation supports re-sizable columns the column becomes fixed width column if users resizes the column.

Parameters:: propertyId - columns property id; expandRatio - the expandRatio used to divide excess space for this column

getColumnExpandRatio

public float getColumnExpandRatio(Object propertyId)

getColumnWidth

public int getColumnWidth(Object propertyId)

Gets the pixel width of column

Parameters:: propertyId -
Returns:: width of column or -1 when value not set

getPageLength

public int getPageLength()

Gets the page length.

Setting page length 0 disables paging.

Returns:: the Length of one page.

setPageLength

public void setPageLength(int pageLength)

Sets the page length.

Setting page length 0 disables paging. The page length defaults to 15.

If Table has width set (#setWidth(float, int) ) the client side may update the page length automatically the correct value.

Parameters:: pageLength - the length of one page.

setCacheRate

public void setCacheRate(double cacheRate)

This method adjusts a possible caching mechanism of table implementation.

Table component may fetch and render some rows outside visible area. With complex tables (for example containing layouts and components), the client side may become unresponsive. Setting the value lower, UI will become more responsive. With higher values scrolling in client will hit server less frequently.

The amount of cached rows will be cacheRate multiplied with pageLength ( setPageLength(int) both below and above visible area..

Parameters:: cacheRate - a value over 0 (fastest rendering time). Higher value will cache more rows on server (smoother scrolling). Default value is 2.

getCacheRate

public double getCacheRate()

Returns:: the current cache rate value
See Also:: setCacheRate(double)

getCurrentPageFirstItemId

public Object getCurrentPageFirstItemId()

Getter for property currentPageFirstItem.

Returns:: the Value of property currentPageFirstItem.

getIdByIndex

protected Object getIdByIndex(int index)

setCurrentPageFirstItemId

public void setCurrentPageFirstItemId(Object currentPageFirstItemId)

Setter for property currentPageFirstItemId.

Parameters:: currentPageFirstItemId - the New value of property currentPageFirstItemId.

indexOfId

protected int indexOfId(Object itemId)

getColumnIcon

public Resource getColumnIcon(Object propertyId)

Gets the icon Resource for the specified column.

Parameters:: propertyId - the propertyId indentifying the column.
Returns:: the icon for the specified column; null if the column has no icon set, or if the column is not visible.

setColumnIcon

public void setColumnIcon(Object propertyId,
                          Resource icon)

Sets the icon Resource for the specified column.

Throws IllegalArgumentException if the specified column is not visible.

Parameters:: propertyId - the propertyId identifying the column.; icon - the icon Resource to set.

getColumnHeader

public String getColumnHeader(Object propertyId)

Gets the header for the specified column.

Parameters:: propertyId - the propertyId identifying the column.
Returns:: the header for the specified column if it has one.

setColumnHeader

public void setColumnHeader(Object propertyId,
                            String header)

Sets the column header for the specified column;

Parameters:: propertyId - the propertyId identifying the column.; header - the header to set.

getColumnAlignment

public Table.Align getColumnAlignment(Object propertyId)

Gets the specified column's alignment.

Parameters:: propertyId - the propertyID identifying the column.
Returns:: the specified column's alignment if it as one; null otherwise.

setColumnAlignment

public void setColumnAlignment(Object propertyId,
                               Table.Align alignment)

Sets the specified column's alignment.

Throws IllegalArgumentException if the alignment is not one of the following: Table.Align.LEFT, Table.Align.CENTER or Table.Align.RIGHT

Parameters:: propertyId - the propertyID identifying the column.; alignment - the desired alignment.

isColumnCollapsed

public boolean isColumnCollapsed(Object propertyId)

Checks if the specified column is collapsed.

Parameters:: propertyId - the propertyID identifying the column.
Returns:: true if the column is collapsed; false otherwise;

setColumnCollapsed

public void setColumnCollapsed(Object propertyId,
                               boolean collapsed)
                        throws IllegalStateException

Sets whether the specified column is collapsed or not.

Parameters:: propertyId - the propertyID identifying the column.; collapsed - the desired collapsedness.
Throws:: IllegalStateException - if column collapsing is not allowed

isColumnCollapsingAllowed

public boolean isColumnCollapsingAllowed()

Checks if column collapsing is allowed.

Returns:: true if columns can be collapsed; false otherwise.

setColumnCollapsingAllowed

public void setColumnCollapsingAllowed(boolean collapsingAllowed)

Sets whether column collapsing is allowed or not.

Parameters:: collapsingAllowed - specifies whether column collapsing is allowed.

setColumnCollapsible

public void setColumnCollapsible(Object propertyId,
                                 boolean collapsible)

Sets whether the given column is collapsible. Note that collapsible columns can only be actually collapsed (via UI or with setColumnCollapsed()) if isColumnCollapsingAllowed() is true. By default all columns are collapsible.

Parameters:: propertyId - the propertyID identifying the column.; collapsible - true if the column should be collapsible, false otherwise.

isColumnCollapsible

public boolean isColumnCollapsible(Object propertyId)

Checks if the given column is collapsible. Note that even if this method returns true, the column can only be actually collapsed (via UI or with setColumnCollapsed()) if isColumnCollapsingAllowed() is also true.

Returns:: true if the column can be collapsed; false otherwise.

isColumnReorderingAllowed

public boolean isColumnReorderingAllowed()

Checks if column reordering is allowed.

Returns:: true if columns can be reordered; false otherwise.

setColumnReorderingAllowed

public void setColumnReorderingAllowed(boolean columnReorderingAllowed)

Sets whether column reordering is allowed or not.

Parameters:: columnReorderingAllowed - specifies whether column reordering is allowed.

getCurrentPageFirstItemIndex

public int getCurrentPageFirstItemIndex()

Getter for property currentPageFirstItem.

Returns:: the Value of property currentPageFirstItem.

setCurrentPageFirstItemIndex

public void setCurrentPageFirstItemIndex(int newIndex)

Setter for property currentPageFirstItem.

Parameters:: newIndex - the New value of property currentPageFirstItem.

isPageBufferingEnabled

@Deprecated
public boolean isPageBufferingEnabled()

Deprecated. functionality is not needed in ajax rendering model

Getter for property pageBuffering.

Returns:: the Value of property pageBuffering.

setPageBufferingEnabled

@Deprecated
public void setPageBufferingEnabled(boolean pageBuffering)

Deprecated. functionality is not needed in ajax rendering model

Setter for property pageBuffering.

Parameters:: pageBuffering - the New value of property pageBuffering.

isSelectable

public boolean isSelectable()

Getter for property selectable.

The table is not selectable by default.

Returns:: the Value of property selectable.

setSelectable

public void setSelectable(boolean selectable)

Setter for property selectable.

The table is not selectable by default.

Parameters:: selectable - the New value of property selectable.

getColumnHeaderMode

public Table.ColumnHeaderMode getColumnHeaderMode()

Getter for property columnHeaderMode.

Returns:: the Value of property columnHeaderMode.

setColumnHeaderMode

public void setColumnHeaderMode(Table.ColumnHeaderMode columnHeaderMode)

Setter for property columnHeaderMode.

Parameters:: columnHeaderMode - the New value of property columnHeaderMode.

refreshRenderedCells

protected void refreshRenderedCells()

Refreshes the rows in the internal cache. Only if resetPageBuffer() is called before this then all values are guaranteed to be recreated.

requestRepaint

public void requestRepaint()

Requests that the Table should be repainted as soon as possible. Note that a Table does not necessarily repaint its contents when this method has been called. See refreshRowCache() for forcing an update of the contents.

Specified by:: requestRepaint in interface ClientConnector
Overrides:: requestRepaint in class AbstractComponent

requestRepaintAll

public void requestRepaintAll()

Description copied from interface: ClientConnector

Causes a repaint of this connector, and all connectors below it. This should only be used in special cases, e.g when the state of a descendant depends on the state of an ancestor.

Specified by:: requestRepaintAll in interface ClientConnector
Overrides:: requestRepaintAll in class AbstractClientConnector

registerComponent

protected void registerComponent(Component component)

unregisterComponent

protected void unregisterComponent(Component component)

This method cleans up a Component that has been generated when Table is in editable mode. The component needs to be detached from its parent and if it is a field, it needs to be detached from its property data source in order to allow garbage collection to take care of removing the unused component from memory. Override this method and getPropertyValue(Object, Object, Property) with custom logic if you need to deal with buffered fields.

Parameters:: oldVisibleComponents - a set of components that should be unregistered.
See Also:: getPropertyValue(Object, Object, Property)

refreshCurrentPage

@Deprecated
public void refreshCurrentPage()

Deprecated. should not need to be used

Refreshes the current page contents.

setRowHeaderMode

public void setRowHeaderMode(Table.RowHeaderMode mode)

Sets the row header mode.

The mode can be one of the following ones:

ROW_HEADER_MODE_HIDDEN: The row captions are hidden.
ROW_HEADER_MODE_ID: Items Id-objects toString() is used as row caption.
ROW_HEADER_MODE_ITEM: Item-objects toString() is used as row caption.
ROW_HEADER_MODE_PROPERTY: Property set with AbstractSelect.setItemCaptionPropertyId(Object) is used as row header.
ROW_HEADER_MODE_EXPLICIT_DEFAULTS_ID: Items Id-objects toString() is used as row header. If caption is explicitly specified, it overrides the id-caption.
ROW_HEADER_MODE_EXPLICIT: The row headers must be explicitly specified.
ROW_HEADER_MODE_INDEX: The index of the item is used as row caption. The index mode can only be used with the containers implementing Container.Indexed interface.

The default value is ROW_HEADER_MODE_HIDDEN

Parameters:: mode - the One of the modes listed above.

getRowHeaderMode

public Table.RowHeaderMode getRowHeaderMode()

Gets the row header mode.

Returns:: the Row header mode.
See Also:: #setRowHeaderMode(int)

addItem

public Object addItem(Object[] cells,
                      Object itemId)
               throws UnsupportedOperationException

Adds the new row to table and fill the visible cells (except generated columns) with given values.

Parameters:: cells - the Object array that is used for filling the visible cells new row. The types must be settable to visible column property types.; itemId - the Id the new row. If null, a new id is automatically assigned. If given, the table cant already have a item with given id.
Returns:: Returns item id for the new row. Returns null if operation fails.
Throws:: UnsupportedOperationException

refreshRowCache

public void refreshRowCache()

Discards and recreates the internal row cache. Call this if you make changes that affect the rows but the information about the changes are not automatically propagated to the Table.

Do not call this e.g. if you have updated the data model through a Property. These types of changes are automatically propagated to the Table.

A typical case when this is needed is if you update a generator (e.g. CellStyleGenerator) and want to ensure that the rows are redrawn with new styles.

Note that calling this method is not cheap so avoid calling it unnecessarily.

Since:: 6.7.2

setContainerDataSource

public void setContainerDataSource(Container newDataSource)

Description copied from class: AbstractSelect

Sets the Container that serves as the data source of the viewer. As a side-effect the fields value (selection) is set to null due old selection not necessary exists in new Container.

Specified by:: setContainerDataSource in interface Container.Viewer
Overrides:: setContainerDataSource in class AbstractSelect

Parameters:: newDataSource - the new data source.
See Also:: Container.Viewer.setContainerDataSource(Container)

changeVariables

public void changeVariables(Object source,
                            Map<String,Object> variables)

Invoked when the value of a variable has changed.

Specified by:: changeVariables in interface VariableOwner
Overrides:: changeVariables in class AbstractSelect

Parameters:: source - the Source of the variable change. This is the origin of the event. For example in Web Adapter this is the request.; variables - the Mapping from variable names to new variable values.
See Also:: Select.changeVariables(java.lang.Object, java.util.Map)

disableContentRefreshing

protected boolean disableContentRefreshing()

Go to mode where content updates are not done. This is due we want to bypass expensive content for some reason (like when we know we may have other content changes on their way).

Returns:: true if content refresh flag was enabled prior this call

enableContentRefreshing

protected void enableContentRefreshing(boolean refreshContent)

Go to mode where content content refreshing has effect.

Parameters:: refreshContent - true if content refresh needs to be done

paintContent

public void paintContent(PaintTarget target)
                  throws PaintException

Description copied from class: AbstractSelect

Paints the content of this component.

Specified by:: paintContent in interface Vaadin6Component
Overrides:: paintContent in class AbstractSelect

Parameters:: target - the Paint Event.
Throws:: PaintException - if the paint operation failed.

isRowCacheInvalidated

protected boolean isRowCacheInvalidated()

isPartialRowUpdate

protected boolean isPartialRowUpdate()

Subclass and override this to enable partial row updates and additions, which bypass the normal caching mechanism. This is useful for e.g. TreeTable.

Returns:: true if this update is a partial row update, false if not. For plain Table it is always false.

getFirstAddedItemIndex

protected int getFirstAddedItemIndex()

Subclass and override this to enable partial row additions, bypassing the normal caching mechanism. This is useful for e.g. TreeTable, where expanding a node should only fetch and add the items inside of that node.

Returns:: The index of the first added item. For plain Table it is always 0.

getAddedRowCount

protected int getAddedRowCount()

Returns:: the number of rows to be added, starting at the index returned by getFirstAddedItemIndex(). For plain Table it is always 0.

shouldHideAddedRows

protected boolean shouldHideAddedRows()

Subclass and override this to enable removing of rows, bypassing the normal caching and lazy loading mechanism. This is useful for e.g. TreeTable, when you need to hide certain rows as a node is collapsed. This should return true if the rows pointed to by getFirstAddedItemIndex() and getAddedRowCount() should be hidden instead of added.

Returns:: whether the rows to add (see getFirstAddedItemIndex() and getAddedRowCount()) should be added or hidden. For plain Table it is always false.

getFirstUpdatedItemIndex

protected int getFirstUpdatedItemIndex()

Subclass and override this to enable partial row updates, bypassing the normal caching and lazy loading mechanism. This is useful for updating the state of certain rows, e.g. in the TreeTable the collapsed state of a single node is updated using this mechanism.

Returns:: the index of the first item to be updated. For plain Table it is always 0.

getUpdatedRowCount

protected int getUpdatedRowCount()

Returns:: the number of rows to update, starting at the index returned by getFirstUpdatedItemIndex(). For plain table it is always 0.

paintRowHeader

protected void paintRowHeader(PaintTarget target,
                              Object[][] cells,
                              int indexInRowbuffer)
                       throws PaintException

Throws:: PaintException

paintRowIcon

protected void paintRowIcon(PaintTarget target,
                            Object[][] cells,
                            int indexInRowbuffer)
                     throws PaintException

Throws:: PaintException

paintRowAttributes

protected void paintRowAttributes(PaintTarget target,
                                  Object itemId)
                           throws PaintException

A method where extended Table implementations may add their custom attributes for rows.

Parameters:: target -; itemId -
Throws:: PaintException

getPropertyValue

protected Object getPropertyValue(Object rowId,
                                  Object colId,
                                  Property property)

Gets the value of property. By default if the table is editable the fieldFactory is used to create editors for table cells. Otherwise formatPropertyValue is used to format the value representation.

Parameters:: rowId - the Id of the row (same as item Id).; colId - the Id of the column.; property - the Property to be presented.
Returns:: Object Either formatted value or Component for field.
See Also:: setTableFieldFactory(TableFieldFactory)

bindPropertyToField

protected void bindPropertyToField(Object rowId,
                                   Object colId,
                                   Property property,
                                   Field field)

Binds an item property to a field generated by TableFieldFactory. The default behavior is to bind property straight to Field. If Property.Viewer type property (e.g. PropertyFormatter) is already set for field, the property is bound to that Property.Viewer.

Parameters:: rowId -; colId -; property -; field -
Since:: 6.7.3

formatPropertyValue

protected String formatPropertyValue(Object rowId,
                                     Object colId,
                                     Property<?> property)

Formats table cell property values. By default the property.toString() and return a empty string for null properties.

Parameters:: rowId - the Id of the row (same as item Id).; colId - the Id of the column.; property - the Property to be formatted.
Returns:: the String representation of property and its value.
Since:: 3.1

addActionHandler

public void addActionHandler(Action.Handler actionHandler)

Registers a new action handler for this container

Specified by:: addActionHandler in interface Action.Container

Parameters:: actionHandler - the new handler to be added.
See Also:: Action.Container.addActionHandler(Action.Handler)

removeActionHandler

public void removeActionHandler(Action.Handler actionHandler)

Removes a previously registered action handler for the contents of this container.

Specified by:: removeActionHandler in interface Action.Container

Parameters:: actionHandler - the handler to be removed.
See Also:: Action.Container.removeActionHandler(Action.Handler)

removeAllActionHandlers

public void removeAllActionHandlers()

Removes all action handlers

valueChange

public void valueChange(Property.ValueChangeEvent event)

Notifies this listener that the Property's value has changed. Also listens changes in rendered items to refresh content area.

Specified by:: valueChange in interface Property.ValueChangeListener
Overrides:: valueChange in class AbstractField<Object>

Parameters:: event - the value change event telling the data source contents have changed.
See Also:: Property.ValueChangeListener.valueChange(Property.ValueChangeEvent)

resetPageBuffer

protected void resetPageBuffer()

Clears the current page buffer. Call this before refreshRenderedCells() to ensure that all content is updated from the properties.

attach

public void attach()

Notifies the component that it is connected to an application.

Specified by:: attach in interface ClientConnector
Specified by:: attach in interface Component
Overrides:: attach in class AbstractSelect

See Also:: Component.attach()

detach

public void detach()

Notifies the component that it is detached from the application

Specified by:: detach in interface ClientConnector
Overrides:: detach in class AbstractSelect

See Also:: ClientConnector.detach()

removeAllItems

public boolean removeAllItems()

Removes all Items from the Container.

Specified by:: removeAllItems in interface Container
Overrides:: removeAllItems in class AbstractSelect

Returns:: True if the operation succeeded.
See Also:: Container.removeAllItems()

removeItem

public boolean removeItem(Object itemId)

Removes the Item identified by ItemId from the Container.

Specified by:: removeItem in interface Container
Overrides:: removeItem in class AbstractSelect

Parameters:: itemId - ID of the Item to remove
Returns:: true if the operation succeeded, false if not
See Also:: Container.removeItem(Object)

removeContainerProperty

public boolean removeContainerProperty(Object propertyId)
                                throws UnsupportedOperationException

Removes a Property specified by the given Property ID from the Container.

Specified by:: removeContainerProperty in interface Container
Overrides:: removeContainerProperty in class AbstractSelect

Parameters:: propertyId - ID of the Property to remove
Returns:: True if the operation succeeded.
Throws:: UnsupportedOperationException - if the container does not support removing container properties
See Also:: Container.removeContainerProperty(Object)

addContainerProperty

public boolean addContainerProperty(Object propertyId,
                                    Class<?> type,
                                    Object defaultValue)
                             throws UnsupportedOperationException

Adds a new property to the table and show it as a visible column.

Specified by:: addContainerProperty in interface Container
Overrides:: addContainerProperty in class AbstractSelect

Parameters:: propertyId - the Id of the proprty.; type - the class of the property.; defaultValue - the default value given for all existing items.
Returns:: True if the operation succeeded.
Throws:: UnsupportedOperationException - if the container does not support explicitly adding container properties
See Also:: Container.addContainerProperty(Object, Class, Object)

addContainerProperty

public boolean addContainerProperty(Object propertyId,
                                    Class<?> type,
                                    Object defaultValue,
                                    String columnHeader,
                                    Resource columnIcon,
                                    Table.Align columnAlignment)
                             throws UnsupportedOperationException

Adds a new property to the table and show it as a visible column.

Parameters:: propertyId - the Id of the proprty; type - the class of the property; defaultValue - the default value given for all existing items; columnHeader - the Explicit header of the column. If explicit header is not needed, this should be set null.; columnIcon - the Icon of the column. If icon is not needed, this should be set null.; columnAlignment - the Alignment of the column. Null implies align left.
Throws:: UnsupportedOperationException - if the operation is not supported.
See Also:: Container.addContainerProperty(Object, Class, Object)

addGeneratedColumn

public void addGeneratedColumn(Object id,
                               Table.ColumnGenerator generatedColumn)

Adds a generated column to the Table.

A generated column is a column that exists only in the Table, not as a property in the underlying Container. It shows up just as a regular column.

A generated column will override a property with the same id, so that the generated column is shown instead of the column representing the property. Note that getContainerProperty() will still get the real property.

Table will not listen to value change events from properties overridden by generated columns. If the content of your generated column depends on properties that are not directly visible in the table, attach value change listener to update the content on all depended properties. Otherwise your UI might not get updated as expected.

Also note that getVisibleColumns() will return the generated columns, while getContainerPropertyIds() will not.

Parameters:: id - the id of the column to be added; generatedColumn - the Table.ColumnGenerator to use for this column

getColumnGenerator

public Table.ColumnGenerator getColumnGenerator(Object columnId)
                                         throws IllegalArgumentException

Returns the ColumnGenerator used to generate the given column.

Parameters:: columnId - The id of the generated column
Returns:: The ColumnGenerator used for the given columnId or null.
Throws:: IllegalArgumentException

removeGeneratedColumn

public boolean removeGeneratedColumn(Object columnId)

Removes a generated column previously added with addGeneratedColumn.

Parameters:: columnId - id of the generated column to remove
Returns:: true if the column could be removed (existed in the Table)

getVisibleItemIds

public Collection<?> getVisibleItemIds()

Returns item identifiers of the items which are currently rendered on the client.

Note, that some due to historical reasons the name of the method is bit misleading. Some items may be partly or totally out of the viewport of the table's scrollable area. Actually detecting rows which can be actually seen by the end user may be problematic due to the client server architecture. Using getCurrentPageFirstItemId() combined with getPageLength() may produce good enough estimates in some situations.

Overrides:: getVisibleItemIds in class AbstractSelect

See Also:: AbstractSelect.getVisibleItemIds()

containerItemSetChange

public void containerItemSetChange(Container.ItemSetChangeEvent event)

Container datasource item set change. Table must flush its buffers on change.

Specified by:: containerItemSetChange in interface Container.ItemSetChangeListener
Overrides:: containerItemSetChange in class AbstractSelect

Parameters:: event - change event text
See Also:: Container.ItemSetChangeListener.containerItemSetChange(com.vaadin.data.Container.ItemSetChangeEvent)

containerPropertySetChange

public void containerPropertySetChange(Container.PropertySetChangeEvent event)

Container datasource property set change. Table must flush its buffers on change.

Specified by:: containerPropertySetChange in interface Container.PropertySetChangeListener
Overrides:: containerPropertySetChange in class AbstractSelect

Parameters:: event - Change event.
See Also:: Container.PropertySetChangeListener.containerPropertySetChange(com.vaadin.data.Container.PropertySetChangeEvent)

setNewItemsAllowed

public void setNewItemsAllowed(boolean allowNewOptions)
                        throws UnsupportedOperationException

Adding new items is not supported.

Overrides:: setNewItemsAllowed in class AbstractSelect

Parameters:: allowNewOptions - the New value of property allowNewOptions.
Throws:: UnsupportedOperationException - if set to true.
See Also:: AbstractSelect.setNewItemsAllowed(boolean)

nextItemId

public Object nextItemId(Object itemId)

Gets the ID of the Item following the Item that corresponds to itemId.

Specified by:: nextItemId in interface Container.Ordered

Parameters:: itemId - ID of a visible Item in the Container
Returns:: ID of the next visible Item or null
See Also:: Container.Ordered.nextItemId(java.lang.Object)

prevItemId

public Object prevItemId(Object itemId)

Gets the ID of the Item preceding the Item that corresponds to the itemId.

Specified by:: prevItemId in interface Container.Ordered

Parameters:: itemId - ID of a visible Item in the Container
Returns:: ID of the previous visible Item or null
See Also:: Container.Ordered.prevItemId(java.lang.Object)

firstItemId

public Object firstItemId()

Gets the ID of the first Item in the Container.

Specified by:: firstItemId in interface Container.Ordered

Returns:: ID of the first visible Item in the Container
See Also:: Container.Ordered.firstItemId()

lastItemId

public Object lastItemId()

Gets the ID of the last Item in the Container.

Specified by:: lastItemId in interface Container.Ordered

Returns:: ID of the last visible Item in the Container
See Also:: Container.Ordered.lastItemId()

isFirstId

public boolean isFirstId(Object itemId)

Tests if the Item corresponding to the given Item ID is the first Item in the Container.

Specified by:: isFirstId in interface Container.Ordered

Parameters:: itemId - ID of an Item in the Container
Returns:: true if the Item is first visible item in the Container, false if not
See Also:: Container.Ordered.isFirstId(java.lang.Object)

isLastId

public boolean isLastId(Object itemId)

Tests if the Item corresponding to the given Item ID is the last Item in the Container.

Specified by:: isLastId in interface Container.Ordered

Returns:: true if the Item is last visible item in the Container, false if not
See Also:: Container.Ordered.isLastId(java.lang.Object)

addItemAfter

public Object addItemAfter(Object previousItemId)
                    throws UnsupportedOperationException

Adds new item after the given item.

Specified by:: addItemAfter in interface Container.Ordered

Parameters:: previousItemId - Id of the visible item in ordered container after which to insert the new item.
Returns:: item id the the created new item or null if the operation fails.
Throws:: UnsupportedOperationException - if the operation is not supported by the container
See Also:: Container.Ordered.addItemAfter(java.lang.Object)

addItemAfter

public Item addItemAfter(Object previousItemId,
                         Object newItemId)
                  throws UnsupportedOperationException

Adds new item after the given item.

Specified by:: addItemAfter in interface Container.Ordered

Parameters:: previousItemId - Id of the visible item in ordered container after which to insert the new item.; newItemId - Id of the new item to be added.
Returns:: new item or null if the operation fails.
Throws:: UnsupportedOperationException - if the operation is not supported by the container
See Also:: Container.Ordered.addItemAfter(java.lang.Object, java.lang.Object)

setTableFieldFactory

public void setTableFieldFactory(TableFieldFactory fieldFactory)

Sets the TableFieldFactory that is used to create editor for table cells. The TableFieldFactory is only used if the Table is editable. By default the DefaultFieldFactory is used.

Parameters:: fieldFactory - the field factory to set.
See Also:: isEditable(), DefaultFieldFactory

getTableFieldFactory

public TableFieldFactory getTableFieldFactory()

Gets the TableFieldFactory that is used to create editor for table cells. The FieldFactory is only used if the Table is editable.

Returns:: TableFieldFactory used to create the Field instances.
See Also:: isEditable()

isEditable

public boolean isEditable()

Is table editable. If table is editable a editor of type Field is created for each table cell. The assigned FieldFactory is used to create the instances. To provide custom editors for table cells create a class implementins the FieldFactory interface, and assign it to table, and set the editable property to true.

Returns:: true if table is editable, false oterwise.
See Also:: Field, FieldFactory

setEditable

public void setEditable(boolean editable)

Sets the editable property. If table is editable a editor of type Field is created for each table cell. The assigned FieldFactory is used to create the instances. To provide custom editors for table cells create a class implementins the FieldFactory interface, and assign it to table, and set the editable property to true.

Parameters:: editable - true if table should be editable by user.
See Also:: Field, FieldFactory

sort

public void sort(Object[] propertyId,
                 boolean[] ascending)
          throws UnsupportedOperationException

Sorts the table.

Specified by:: sort in interface Container.Sortable

Parameters:: propertyId - Array of container property IDs, whose values are used to sort the items in container as primary, secondary, ... sorting criterion. All of the item IDs must be in the collection returned by Container.Sortable.getSortableContainerPropertyIds(); ascending - Array of sorting order flags corresponding to each property ID used in sorting. If this array is shorter than propertyId array, ascending order is assumed for items where the order is not specified. Use true to sort in ascending order, false to use descending order.
Throws:: UnsupportedOperationException - if the container data source does not implement Container.Sortable
See Also:: Container.Sortable.sort(java.lang.Object[], boolean[])

sort

public void sort()

Sorts the table by currently selected sorting column.

Throws:: UnsupportedOperationException - if the container data source does not implement Container.Sortable

getSortableContainerPropertyIds

public Collection<?> getSortableContainerPropertyIds()

Gets the container property IDs, which can be used to sort the item.

Note that the isSortEnabled() state affects what this method returns. Disabling sorting causes this method to always return an empty collection.

Specified by:: getSortableContainerPropertyIds in interface Container.Sortable

Returns:: the IDs of the properties that can be used for sorting the container
See Also:: Container.Sortable.getSortableContainerPropertyIds()

getSortContainerPropertyId

public Object getSortContainerPropertyId()

Gets the currently sorted column property ID.

Returns:: the Container property id of the currently sorted column.

setSortContainerPropertyId

public void setSortContainerPropertyId(Object propertyId)

Sets the currently sorted column property id.

Parameters:: propertyId - the Container property id of the currently sorted column.

isSortAscending

public boolean isSortAscending()

Is the table currently sorted in ascending order.

Returns:: true if ascending, false if descending.

setSortAscending

public void setSortAscending(boolean ascending)

Sets the table in ascending order.

Parameters:: ascending - true if ascending, false if descending.

isSortDisabled

@Deprecated
public boolean isSortDisabled()

Deprecated. Use isSortEnabled() instead

Is sorting disabled altogether. True iff no sortable columns are given even in the case where data source would support this.

Returns:: True iff sorting is disabled.

isSortEnabled

public boolean isSortEnabled()

Checks if sorting is enabled.

Returns:: true if sorting by the user is allowed, false otherwise

setSortDisabled

@Deprecated
public void setSortDisabled(boolean sortDisabled)

Deprecated. Use setSortEnabled(boolean) instead

Disables the sorting by the user altogether.

Parameters:: sortDisabled - True iff sorting is disabled.

setSortEnabled

public void setSortEnabled(boolean sortEnabled)

Enables or disables sorting.

Setting this to false disallows sorting by the user. It is still possible to call sort().

Parameters:: sortEnabled - true to allow the user to sort the table, false to disallow it

setCellStyleGenerator

public void setCellStyleGenerator(Table.CellStyleGenerator cellStyleGenerator)

Set cell style generator for Table.

Parameters:: cellStyleGenerator - New cell style generator or null to remove generator.

getCellStyleGenerator

public Table.CellStyleGenerator getCellStyleGenerator()

Get the current cell style generator.

addListener

public void addListener(ItemClickEvent.ItemClickListener listener)

Description copied from interface: ItemClickEvent.ItemClickNotifier

Specified by:: addListener in interface ItemClickEvent.ItemClickNotifier

Parameters:: listener - ItemClickListener to be registered

removeListener

public void removeListener(ItemClickEvent.ItemClickListener listener)

Description copied from interface: ItemClickEvent.ItemClickNotifier

Removes an ItemClickListener.

Specified by:: removeListener in interface ItemClickEvent.ItemClickNotifier

Parameters:: listener - ItemClickListener to be removed

setEnabled

public void setEnabled(boolean enabled)

Description copied from interface: Component

Enables or disables the component. The user can not interact disabled components, which are shown with a style that indicates the status, usually shaded in light gray color. Components are enabled by default.

 Button enabled = new Button("Enabled");
 enabled.setEnabled(true); // The default
 layout.addComponent(enabled);
 
 Button disabled = new Button("Disabled");
 disabled.setEnabled(false);
 layout.addComponent(disabled);

This method will trigger a RepaintRequestEvent for the component and, if it is a ComponentContainer, for all its children recursively.

Specified by:: setEnabled in interface Component
Overrides:: setEnabled in class AbstractComponent

Parameters:: enabled - a boolean value specifying if the component should be enabled or not

setDragMode

public void setDragMode(Table.TableDragMode newDragMode)

Sets the drag start mode of the Table. Drag start mode controls how Table behaves as a drag source.

Parameters:: newDragMode -

getDragMode

public Table.TableDragMode getDragMode()

Returns:: the current start mode of the Table. Drag start mode controls how Table behaves as a drag source.

getTransferable

public Table.TableTransferable getTransferable(Map<String,Object> rawVariables)

Description copied from interface: DragSource

DragSource may convert data added by client side component to meaningful values for server side developer or add other data based on it.

For example Tree converts item identifiers to generated string keys for the client side. Vaadin developer don't and can't know anything about these generated keys, only about item identifiers. When tree node is dragged client puts that key to Transferables client side counterpart. In Tree.getTransferable(Map) the key is converted back to item identifier that the server side developer can use.

Specified by:: getTransferable in interface DragSource

Parameters:: rawVariables - the data that client side initially included in Transferables client side counterpart.
Returns:: the Transferable instance that will be passed to DropHandler (and/or AcceptCriterion)

getDropHandler

public DropHandler getDropHandler()

Specified by:: getDropHandler in interface DropTarget

Returns:: the drop hanler that will receive the dragged data or null if drops are not currently accepted

setDropHandler

public void setDropHandler(DropHandler dropHandler)

translateDropTargetDetails

public AbstractSelect.AbstractSelectTargetDetails translateDropTargetDetails(Map<String,Object> clientVariables)

Description copied from interface: DropTarget

Called before the DragAndDropEvent is passed to DropHandler. Implementation may for example translate the drop target details provided by the client side (drop target) to meaningful server side values. If null is returned the terminal implementation will automatically create a TargetDetails with raw client side data.

Specified by:: translateDropTargetDetails in interface DropTarget

Parameters:: clientVariables - data passed from the DropTargets client side counterpart.
Returns:: A DropTargetDetails object with the translated data or null to use a default implementation.
See Also:: DragSource.getTransferable(Map)

setMultiSelectMode

public void setMultiSelectMode(AbstractSelect.MultiSelectMode mode)

Sets the behavior of how the multi-select mode should behave when the table is both selectable and in multi-select mode.

Note, that on some clients the mode may not be respected. E.g. on touch based devices CTRL/SHIFT base selection method is invalid, so touch based browsers always use the MultiSelectMode#SIMPLE.

Parameters:: mode - The select mode of the table

getMultiSelectMode

public AbstractSelect.MultiSelectMode getMultiSelectMode()

Returns the select mode in which multi-select is used.

Returns:: The multi select mode

addListener

public void addListener(Table.HeaderClickListener listener)

Adds a header click listener which handles the click events when the user clicks on a column header cell in the Table.

The listener will receive events which contain information about which column was clicked and some details about the mouse event.

Parameters:: listener - The handler which should handle the header click events.

removeListener

public void removeListener(Table.HeaderClickListener listener)

Removes a header click listener

Parameters:: listener - The listener to remove.

addListener

public void addListener(Table.FooterClickListener listener)

Adds a footer click listener which handles the click events when the user clicks on a column footer cell in the Table.

The listener will receive events which contain information about which column was clicked and some details about the mouse event.

Parameters:: listener - The handler which should handle the footer click events.

removeListener

public void removeListener(Table.FooterClickListener listener)

Removes a footer click listener

Parameters:: listener - The listener to remove.

getColumnFooter

public String getColumnFooter(Object propertyId)

Gets the footer caption beneath the rows

Parameters:: propertyId - The propertyId of the column *
Returns:: The caption of the footer or NULL if not set

setColumnFooter

public void setColumnFooter(Object propertyId,
                            String footer)

Sets the column footer caption. The column footer caption is the text displayed beneath the column if footers have been set visible.

Parameters:: propertyId - The properyId of the column; footer - The caption of the footer

setFooterVisible

public void setFooterVisible(boolean visible)

Sets the footer visible in the bottom of the table.

The footer can be used to add column related data like sums to the bottom of the Table using setColumnFooter(Object propertyId, String footer).

Parameters:: visible - Should the footer be visible

isFooterVisible

public boolean isFooterVisible()

Is the footer currently visible?

Returns:: Returns true if visible else false

addListener

public void addListener(Table.ColumnResizeListener listener)

Adds a column resize listener to the Table. A column resize listener is called when a user resizes a columns width.

Parameters:: listener - The listener to attach to the Table

removeListener

public void removeListener(Table.ColumnResizeListener listener)

Removes a column resize listener from the Table.

Parameters:: listener - The listener to remove

addListener

public void addListener(Table.ColumnReorderListener listener)

Adds a column reorder listener to the Table. A column reorder listener is called when a user reorders columns.

Parameters:: listener - The listener to attach to the Table

removeListener

public void removeListener(Table.ColumnReorderListener listener)

Removes a column reorder listener from the Table.

Parameters:: listener - The listener to remove

setItemDescriptionGenerator

public void setItemDescriptionGenerator(AbstractSelect.ItemDescriptionGenerator generator)

Set the item description generator which generates tooltips for cells and rows in the Table

Parameters:: generator - The generator to use or null to disable

getItemDescriptionGenerator

public AbstractSelect.ItemDescriptionGenerator getItemDescriptionGenerator()

Get the item description generator which generates tooltips for cells and rows in the Table.

setRowGenerator

public void setRowGenerator(Table.RowGenerator generator)

Assigns a row generator to the table. The row generator will be able to replace rows in the table when it is rendered.

Parameters:: generator - the new row generator

getRowGenerator

public Table.RowGenerator getRowGenerator()

Returns:: the current row generator

setConverter

public void setConverter(Object propertyId,
                         Converter<String,?> converter)

Sets a converter for a property id.

The converter is used to format the the data for the given property id before displaying it in the table.

Parameters:: propertyId - The propertyId to format using the converter; converter - The converter to use for the property id

hasConverter

protected boolean hasConverter(Object propertyId)

Checks if there is a converter set explicitly for the given property id.

Parameters:: propertyId - The propertyId to check
Returns:: true if a converter has been set for the property id, false otherwise

getConverter

public Converter<String,Object> getConverter(Object propertyId)

Returns the converter used to format the given propertyId.

Parameters:: propertyId - The propertyId to check
Returns:: The converter used to format the propertyId or null if no converter has been set

setVisible

public void setVisible(boolean visible)

Description copied from interface: Component

Sets the visibility of the component.

Visible components are drawn in the user interface, while invisible ones are not. The effect is not merely a cosmetic CSS change - no information about an invisible component will be sent to the client. The effect is thus the same as removing the component from its parent.

 TextField readonly = new TextField("Read-Only");
 readonly.setValue("You can't see this!");
 readonly.setVisible(false);
 layout.addComponent(readonly);

A component is visible only if all of its parents are also visible. If a component is explicitly set to be invisible, changes in the visibility of its parents will not change the visibility of the component.

Specified by:: setVisible in interface Component
Overrides:: setVisible in class AbstractComponent

Parameters:: visible - the boolean value specifying if the component should be visible after the call or not.
See Also:: Component.isVisible()

iterator

public Iterator<Component> iterator()

Specified by:: iterator in interface Iterable<Component>

getComponentIterator

public Iterator<Component> getComponentIterator()

Description copied from interface: HasComponents

Gets an iterator to the collection of contained components. Using this iterator it is possible to step through all components contained in this container.

Specified by:: getComponentIterator in interface HasComponents

Returns:: the component iterator.

isComponentVisible

public boolean isComponentVisible(Component childComponent)

Description copied from interface: HasComponents

Checks if the child component is visible. This method allows hiding a child component from updates and communication to and from the client. This is useful for components that show only a limited number of its children at any given time and want to allow updates only for the children that are visible (e.g. TabSheet has one tab open at a time).

Note that this will prevent updates from reaching the child even though the child itself is set to visible. Also if a child is set to invisible this will not force it to be visible.

Specified by:: isComponentVisible in interface HasComponents

Parameters:: childComponent - The child component to check
Returns:: true if the child component is visible to the user, false otherwise

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.vaadin.ui Class Table

CELL_KEY

CELL_HEADER

CELL_ICON

CELL_ITEMID

CELL_GENERATED_ROW

CELL_FIRSTCOL

ALIGN_LEFT

ALIGN_CENTER

ALIGN_RIGHT

COLUMN_HEADER_MODE_HIDDEN

COLUMN_HEADER_MODE_ID

COLUMN_HEADER_MODE_EXPLICIT

COLUMN_HEADER_MODE_EXPLICIT_DEFAULTS_ID

ROW_HEADER_MODE_HIDDEN

ROW_HEADER_MODE_ID

ROW_HEADER_MODE_ITEM

ROW_HEADER_MODE_INDEX

ROW_HEADER_MODE_EXPLICIT_DEFAULTS_ID

ROW_HEADER_MODE_EXPLICIT

ROW_HEADER_MODE_ICON_ONLY

ROW_HEADER_MODE_PROPERTY

alwaysRecalculateColumnWidths

Table

Table

Table

getVisibleColumns

setVisibleColumns

getColumnHeaders

setColumnHeaders

getColumnIcons

setColumnIcons

getColumnAlignments

setColumnAlignments

setColumnWidth

setColumnExpandRatio

getColumnExpandRatio

getColumnWidth

getPageLength

setPageLength

setCacheRate

getCacheRate

getCurrentPageFirstItemId

getIdByIndex

setCurrentPageFirstItemId

indexOfId

getColumnIcon

setColumnIcon

getColumnHeader

setColumnHeader

getColumnAlignment

setColumnAlignment

isColumnCollapsed

setColumnCollapsed

isColumnCollapsingAllowed

setColumnCollapsingAllowed

setColumnCollapsible

isColumnCollapsible

isColumnReorderingAllowed

setColumnReorderingAllowed

getCurrentPageFirstItemIndex

setCurrentPageFirstItemIndex

isPageBufferingEnabled

setPageBufferingEnabled

isSelectable

setSelectable

getColumnHeaderMode

setColumnHeaderMode

refreshRenderedCells

requestRepaint

requestRepaintAll

registerComponent

unregisterComponent

refreshCurrentPage

setRowHeaderMode

getRowHeaderMode

addItem

refreshRowCache

setContainerDataSource

changeVariables

com.vaadin.ui
Class Table