Xceed Toolkit Plus for WPF v4.6 Documentation
CreatingNewItem Event (DataGridCollectionViewBase)


Xceed.Wpf.DataGrid Assembly > Xceed.Wpf.DataGrid Namespace > DataGridCollectionViewBase Class : CreatingNewItem Event
Raised when the AddNew method has been called to signal that a new item is about to be created.
Syntax
'Declaration
 
Public Event CreatingNewItem As EventHandler(Of DataGridCreatingNewItemEventArgs)
'Usage
 
Dim instance As DataGridCollectionViewBase
Dim handler As EventHandler(Of DataGridCreatingNewItemEventArgs)
 
AddHandler instance.CreatingNewItem, handler
public event EventHandler<DataGridCreatingNewItemEventArgs> CreatingNewItem
Event Data

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

PropertyDescription
(Inherited from System.ComponentModel.CancelEventArgs)
Gets the DataGridCollectionView to which the item will potentially be added.  
Gets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing.  
Gets or sets the new item to add to the CollectionView.  
Remarks
If the insertion of new items is to be handled manually, a new item must be provided and the Handled property set to true to indicate that the process will be handled manually. If a new item is provided but the Handled property was not set or was set to false, the item will be ignored and an attempt will be made by the DataGridCollectionView to create a new item. An InvalidOperationException will be thrown if the Handled property is set to true but a new item is not provided. 
Requirements

Target Platforms: Windows 11, Windows 10, Windows 7, 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