AssigningFieldLayoutToItem Event

Occurs when an item from the DataSource is being associated with a FieldLayout that will define the layout of cells for this item within the DataPresenterBase.
Public Event AssigningFieldLayoutToItem As EventHandler(Of AssigningFieldLayoutToItemEventArgs)
public event EventHandler<AssigningFieldLayoutToItemEventArgs> AssigningFieldLayoutToItem
Event Data

The event handler receives an argument of type AssigningFieldLayoutToItemEventArgs containing data related to this event. The following AssigningFieldLayoutToItemEventArgs properties provide information specific to this event.

ContainingList The container of the item (read-only)
FieldLayout Gets/sets the FieldLayout assigned to this item
Handled (Inherited from System.Windows.RoutedEventArgs)Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
IsAddRecord True if this is a template add record about to be initialized (read-only)
Item The item (read-only)
OriginalSource (Inherited from System.Windows.RoutedEventArgs)Gets the original reporting source as determined by pure hit testing, before any possible System.Windows.RoutedEventArgs.Source adjustment by a parent class.
ParentExpandableFieldRecord Returns the parent Infragistics.Windows.DataPresenter.ExpandableFieldRecord or null (read-only).
RoutedEvent (Inherited from System.Windows.RoutedEventArgs)Gets or sets the System.Windows.RoutedEventArgs.RoutedEvent associated with this System.Windows.RoutedEventArgs instance.
Source (Inherited from System.Windows.RoutedEventArgs)Gets or sets a reference to the object that raised the event.

DataRecords are created lazily as each item in the DataSource is requested. When a DataRecord is created the FieldLayouts collection is searched for an existing FieldLayout whose FieldLayout.Fields match the DataRecord.DataItem's properties. If one is not found then a new FieldLayout is created, in which case the FieldLayoutInitializing and FieldLayoutInitialized events will be raised.

Note: If the new FieldLayout's FieldLayout.AutoGenerateFieldsResolved property returns true then the FieldLayout.Fields collection is automatically populated with a Field for every public property on the data item. This is done between the FieldLayoutInitializing and FieldLayoutInitialized events.

In any case the AssigningFieldLayoutToItem event is raised to allow a different FieldLayout to be assigned to the DataRecord. Finally the InitializeRecord event is raised.

Refer to the Fields topic in the Developer's Guide for an explanation of fields.

Refer to the Field Layout topic in the Developer's Guide for an explanation of the FieldLayout object.

Refer to the Theory of Operation topic in the Developer's Guide for an explanation of how everything works together.


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

See Also