DataPresenterBase Class

Base class for the XamDataGrid, XamDataCarousel and XamDataPresenter controls.

Syntax

Visual Basic

'Declaration
 
Public MustInherit Class DataPresenterBase 
   Inherits Infragistics.Windows.Controls.IGControlBase
   Implements IViewPanelInfo, Infragistics.Windows.Reporting.IEmbeddedVisualPaginatorFactory, Infragistics.Windows.Resizing.IAutoResizeHost, Infragistics.Windows.Resizing.IResizeHost, Infragistics.Windows.Scrolling.IDeferredScrollHost, Infragistics.Windows.Selection.ISelectionHost 

C#

public abstract class DataPresenterBase : Infragistics.Windows.Controls.IGControlBase, IViewPanelInfo, Infragistics.Windows.Reporting.IEmbeddedVisualPaginatorFactory, Infragistics.Windows.Resizing.IAutoResizeHost, Infragistics.Windows.Resizing.IResizeHost, Infragistics.Windows.Scrolling.IDeferredScrollHost, Infragistics.Windows.Selection.ISelectionHost  

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 Cells (see FieldLayoutSettings' FieldLayoutSettings.LabelLocation). Styles for this type can be specified through the FieldSettings' FieldSettings.CellPresenterStyle or FieldSettings.CellPresenterStyleSelector properties.
• CellValuePresenter is used to represent a 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 Cell's value where its associated Field's Field.DataType does not implement the System.Collections.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.
• FixedFieldButton is used within a LabelPresenter to fix a Field to the near or far edge of the display. (see FieldSettings' FieldSettings.AllowFixing and FieldLayoutSettings' FieldLayoutSettings.FixedFieldUIType properties).
• FixedRecordButton is used within a RecordSelector to fix a Record to the top or bottom of the list. (see FieldLayoutSettings' FieldLayoutSettings.AllowRecordFixing and FieldLayoutSettings.FixedRecordUIType 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 Fields when the GroupByAreaMode property is set to DefaultFieldLayoutOnly.
• GroupByAreaFieldLabel is used to represent a Field in the GroupByArea. Styles for this type can be specified through the GroupByAreaFieldLabelStyle and GroupByAreaFieldLabelStyleSelector properties.
• GroupByAreaFieldListBox contains the GroupByAreaFieldLabels in the GroupByArea. Styles for this type can only be specified in the resource chain.
• GroupByAreaMulti is used to represent an area at the top or bottom of the control (based on the GroupByAreaLocation property used for grouping Fields when the GroupByAreaMode property is set to MultipleFieldLayoutsFull or MultipleFieldLayoutsCompact.
• 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 XamDataPresenter.View set to CarouselView. Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.HeaderPresenterStyle property.
• HeaderPrefixArea is used within a 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 HeaderPresenter. It contains the LabelPresenters for each Field and is analagous to the DataRecordCellArea in DataRecordPresenters. Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.HeaderLabelAreaStyle property.
• LabelPresenter is used to represent a Field's FieldItem.Label. Labels are either with the cells or in a separate header based on the view and the Cells (see FieldLayoutSettings' FieldLayoutSettings.LabelLocation). Styles for this type can be specified through the FieldSettings' FieldSettings.LabelPresenterStyle or FieldSettings.LabelPresenterStyleSelector properties.
• RecordListControls are created internally to display RecordPresenters. Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.RecordListControlStyle property.
• RecordScrollTip is used while dragging the thumb if the 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.
• RecordSelectorNumber is used within a RecordSelector to display the record's number (see FieldLayoutSettings.RecordSelectorNumberFormat, FieldLayoutSettings.RecordSelectorNumberStart and FieldLayoutSettings.RecordSelectorNumberType properties). Styles for this type can be specified through the FieldLayoutSettings' FieldLayoutSettings.RecordSelectorNumberStyle or FieldLayoutSettings.RecordSelectorNumberStyleSelector 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 CarouselBreadcrumbs representing the parent Record drill down path. Styles for this type can only be specified in the resource chain.
• CarouselBreadcrumb is used when drilling down through hierarchical data. It represents a parent Record in the drill down path. Styles for this type can only be specified in the resource chain.
• CarouselItem wraps a 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 CellValuePresenter's visual tree within a System.Windows.Controls.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 Cell's EditAsType, EditorType and 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.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2