Package com.smartgwt.client.docs

# Interface DsSpecialFields

public interface DsSpecialFields
A DataSource allows you to declare that certain fields are the most important fields to show to a user in situations where space is limited, and only one or a few fields can be reasonably shown.

In the table below these special fields are summarized, along with their meaning, and examples of which field would be most appropriate from several example DataSources.

Attribute | Example DataSource field | Meaning
employee | emailMessage | stockItem
titleField | name | subject | itemName | primary label for the record as a while
infoField | job | sender | category | second most pertinent piece of textual information
dataField | salary | date | price | most pertinent numeric, date or enum (eg status) field
descriptionField | bio | messageBody | description | descriptive long text field
iconField | photo | statusIcon | thumbnail | an image or icon to accompany the title field

Examples of the use of these fields include the `TileGrid`'s default choice of fields, and the `drag tracker` that follows the mouse cursor when data is being dragged between grids.

See Also:
  - `DataSource.getTitleField()`
  - `DataSource.getIconField()`
  - `DataSource.getInfoField()`
  - `DataSource.getDataField()`
  - `DataSource.getDescriptionField()`