Xceed Logo
Shop
Xceed Toolkit Plus for WPF v5.1 Documentation
Xceed.Wpf.DataGrid.Toolkit Assembly / Xceed.Wpf.DataGrid Namespace / DataGridCreatingNewItemEventArgs Class


In This Topic
    DataGridCreatingNewItemEventArgs Class
    In This Topic
    Provides information that can be used to create a new item in the CreatingNewItem event.
    Object Model
    DataGridCreatingNewItemEventArgs ClassDataGridCollectionViewBase Class
    Syntax
    'Declaration
 

    Public Class DataGridCreatingNewItemEventArgs 
   Inherits System.ComponentModel.CancelEventArgs
    'Usage
 

    Dim instance As DataGridCreatingNewItemEventArgs
    public class DataGridCreatingNewItemEventArgs : System.ComponentModel.CancelEventArgs
    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.

    Inheritance Hierarchy

    System.Object
       System.EventArgs
          System.ComponentModel.CancelEventArgs
             Xceed.Wpf.DataGrid.DataGridCreatingNewItemEventArgs

    Public Constructors
     NameDescription
    Public ConstructorDataGridCreatingNewItemEventArgs ConstructorInitializes 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.  
    Top
    Public Properties
     NameDescription
    Public PropertyCancel (Inherited from System.ComponentModel.CancelEventArgs)
    Public PropertyCollectionViewGets the DataGridCollectionView to which the item will potentially be added.  
    Public PropertyHandledGets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing.  
    Public PropertyNewItemGets or sets the new item to add to the CollectionView.  
    Top
    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

    Reference

    DataGridCreatingNewItemEventArgs Members
    Xceed.Wpf.DataGrid Namespace

    Send Feedback