Xceed Toolkit Plus for WPF v5.1 Documentation
Xceed.Wpf.DataGrid.Toolkit 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.


In This Topic
    DataGridCreatingNewItemEventArgs Constructor
    In This Topic
    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.

    Supported Frameworks

    .NET: net5.0, net5.0-windows, net6.0, net6.0-macos, net6.0-windows, net7.0, net7.0-macos, net7.0-windows, net8.0, net8.0-browser, net8.0-macos, net8.0-windows, net9.0, net9.0-browser, net9.0-macos, net9.0-windows, net10.0, net10.0-browser, net10.0-macos, net10.0-windows.

    .NET Framework: net40, net403, net45, net451, net452, net46, net461, net462, net463, net47, net471, net472, net48, net481.

    See Also