DataPresenterBase Class

Base class for the XamDataGrid, XamDataCarousel and XamDataPresenter controls.

For a list of all members of this type, see DataPresenterBase members.

Object Model

Syntax

[Visual Basic]
Public MustInherit Class DataPresenterBase 
   Inherits IGControlBase
   Implements ICommandHost, IViewPanelInfo, IResizeHost, IDeferredScrollHost, ISelectionHost, IElement 

[C#]
public abstract class DataPresenterBase : IGControlBase, ICommandHost, IViewPanelInfo, IResizeHost, IDeferredScrollHost, ISelectionHost, IElement 

Remarks

The look of these controls can be easily changed by setting the Theme property. In addition, several styling points are exposed to allow fine grained control of the UI. Styles keyed by these types can be placed anywhere in the resource chain or can be specified directly through the control's object model via the properties described in the following list.

• CellPresenter is only used when labels are included with the Infragistics.Windows.DataPresenter.Cells (see FieldLayoutSettings' FieldLayoutSettings.LabelLocation). Styles for this type can be specified through the FieldSettings' FieldSettings.CellPresenterStyle or FieldSettings.CellPresenterStyleSelector properties.
• Infragistics.Windows.DataPresenter.CellValuePresenter is used to represent a Infragistics.Windows.DataPresenter.Cell's value. Styles for this type can be specified through the FieldSettings' FieldSettings.CellValuePresenterStyle or FieldSettings.CellValuePresenterStyleSelector properties.
• DataRecordCellArea is used to represent a DataRecord's cell area. Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.DataRecordCellAreaStyle or FieldLayoutSettings.DataRecordCellAreaStyleSelector properties.
• DataRecordPresenter is used to represent a DataRecord. Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.DataRecordPresenterStyle or FieldLayoutSettings.DataRecordPresenterStyleSelector properties.
• ExpandableFieldRecordPresenter is used to represent a ExpandableFieldRecord. Styles for this type can be specified through the FieldSettings' FieldSettings.ExpandableFieldRecordPresenterStyle or FieldSettings.ExpandableFieldRecordPresenterStyleSelector properties.
• ExpandedCellPresenter is used to represent a Infragistics.Windows.DataPresenter.Cell's value where its associated Infragistics.Windows.DataPresenter.Field's Field.DataType does not implement the IEnumerable interface and its Field.IsExpandable property is set to true. Styles for this type can be specified through the FieldSettings' FieldSettings.ExpandedCellStyle or FieldSettings.ExpandedCellStyleSelector properties.
• GroupByRecordPresenter is used to represent a GroupByRecord. Styles for this type can be specified through the FieldSettings' FieldSettings.GroupByRecordPresenterStyle or FieldSettings.GroupByRecordPresenterStyleSelector properties.
• GroupByArea is used to represent an area at the top or bottom of the control (based on the GroupByAreaLocation property used for grouping Infragistics.Windows.DataPresenter.Fields. Styles for this type can be specified through the GroupByAreaStyle property.
• Infragistics.Windows.DataPresenter.GroupByAreaFieldLabel is used to represent a Infragistics.Windows.DataPresenter.Field in the GroupByArea. Styles for this type can be specified through the GroupByAreaFieldLabelStyle and GroupByAreaFieldLabelStyleSelector properties.
• Infragistics.Windows.DataPresenter.GroupByAreaFieldListBox contains the Infragistics.Windows.DataPresenter.GroupByAreaFieldLabels in the GroupByArea. Styles for this type can only be specified in the resource chain.
• Infragistics.Windows.DataPresenter.HeaderPresenter is only used when labels are in a separate header (see FieldLayoutSettings' FieldLayoutSettings.LabelLocation) and is not supported by XamDataCarousel or XamDataPresenter with a View set to CarouselView. Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.HeaderPresenterStyle property.
• HeaderPrefixArea is used within a Infragistics.Windows.DataPresenter.HeaderPresenter. It represents the area analagous to record selectors in DataRecordPresenters. Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.HeaderPrefixAreaStyle property.
• HeaderLabelArea is used within a Infragistics.Windows.DataPresenter.HeaderPresenter. It contains the Infragistics.Windows.DataPresenter.LabelPresenters for each Infragistics.Windows.DataPresenter.Field and is analagous to the DataRecordCellArea in DataRecordPresenters. Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.HeaderLabelAreaStyle property.
• Infragistics.Windows.DataPresenter.LabelPresenter is used to represent a Infragistics.Windows.DataPresenter.Field's Field.Label. Labels are either with the cells or in a separate header based on the view and the Infragistics.Windows.DataPresenter.Cells (see FieldLayoutSettings' FieldLayoutSettings.LabelLocation). Styles for this type can be specified through the FieldSettings' FieldSettings.LabelPresenterStyle or FieldSettings.LabelPresenterStyleSelector properties.
• Infragistics.Windows.DataPresenter.RecordListControls are created internally to display Infragistics.Windows.DataPresenter.RecordPresenters. Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.RecordListControlStyle property.
• RecordScrollTip is used while dragging the thumb if the DataPresenterBase.ScrollingMode property is left to its default value of DeferredWithScrollTips but it is not supported in CarouselView. Styles for this type can only be specified in the resource chain.
• RecordSelector is used within a DataRecordPresenter to display the record's selection and activation status. Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.RecordSelectorStyle or FieldLayoutSettings.RecordSelectorStyleSelector properties.

In addition there are styling points that are specific to XamDataCarousel and XamDataPresenter in CarouselView. They are:

• CarouselBreadcrumbControl is used when drilling down through hierarchical data. It contains Infragistics.Windows.DataPresenter.CarouselBreadcrumbs representing the parent Infragistics.Windows.DataPresenter.Record drill down path. Styles for this type can only be specified in the resource chain.
• Infragistics.Windows.DataPresenter.CarouselBreadcrumb is used when drilling down through hierarchical data. It represents a parent Infragistics.Windows.DataPresenter.Record in the drill down path. Styles for this type can only be specified in the resource chain.
• CarouselItem wraps a Infragistics.Windows.DataPresenter.RecordPresenter. Styles for this type can only be specified in the resource chain.
• Infragistics.Windows.Controls.CarouselPanelNavigator displays buttons for navigating through the list of items. Styles for this type can be specified through the CarouselView.ViewSettings.Infragistics.Windows.Controls.CarouselViewSettings.CarouselPanelNavigatorStyle property.

Note: An instance of a Infragistics.Windows.Editors.ValueEditor derived class is normally created and positioned inside a Infragistics.Windows.DataPresenter.CellValuePresenter's visual tree within a ContentPresenter that has its name set to 'PART_EditorSite'. The type of editor to use and its style can be specified via the FieldSettings' FieldSettings.EditorType, FieldSettings.EditAsType, FieldSettings.EditorStyle and FieldSettings.EditorStyleSelector properties. These can also be specified on a cell by cell basis via the Infragistics.Windows.DataPresenter.Cell's Cell.EditAsType, Cell.EditorType and Cell.EditorStyle properties. These cell specific properties would normally be set from inside an InitializeRecord event handler.

Refer to the Theory of Operation topic in the Developer's Guide for an explanation of how this control operates.

See Also

DataPresenterBase Members  | Infragistics.Windows.DataPresenter Namespace  | XamDataCarousel Class  | XamDataGrid Class  | XamDataPresenter Class