Xceed Toolkit Plus for WPF v4.6 Documentation
DataGridCreatingNewItemEventArgs Constructor


Xceed.Wpf.DataGrid Assembly > Xceed.Wpf.DataGrid Namespace > DataGridCreatingNewItemEventArgs Class : DataGridCreatingNewItemEventArgs Constructor
The DataGridCollectionView to which the item will potentially be added.
The new item to add to the collectionView. Will be a null reference (Nothing in Visual Basic) by default  (see Remarks).
true to cancel the creation of the new item; false to let the process continue.
Initializes a new instance of the DataGridCreatingNewItemEventArgs class specify the collection view to which the item will potentially be added and allowing the process to be canceled.
Syntax
'Declaration
 
Public Function New( _
   ByVal collectionView As DataGridCollectionViewBase, _
   ByVal newItem As Object, _
   ByVal cancel As Boolean _
)
'Usage
 
Dim collectionView As DataGridCollectionViewBase
Dim newItem As Object
Dim cancel As Boolean
 
Dim instance As New DataGridCreatingNewItemEventArgs(collectionView, newItem, cancel)
public DataGridCreatingNewItemEventArgs( 
   DataGridCollectionViewBase collectionView,
   object newItem,
   bool cancel
)

Parameters

collectionView
The DataGridCollectionView to which the item will potentially be added.
newItem
The new item to add to the collectionView. Will be a null reference (Nothing in Visual Basic) by default  (see Remarks).
cancel
true to cancel the creation of the new item; false to let the process continue.
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 a new item will be created by the DataGridCollectionView (if possible). An InvalidOperationException will be thrown if the Handled property is set to true but a new item is not provided.

If a new item is not provided and the event is not handled, an attempt will be made by the DataGridCollectionView to create a new item.

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

Reference

DataGridCreatingNewItemEventArgs Class
DataGridCreatingNewItemEventArgs Members