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


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.

    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