By default, the DetectAddNew property is False. The DetectAddNew property detects adding new records to a recordset. Use the DataSource property to bound the control to a table. If the DetectAddNew property is True, and user adds a new record to the bounded recordset, the control automatically adds a new item to the control  ( ADO, ADODB recordset only ). The /COM version of the component provides the DataSource property, which can be used to bound the control's view to a DAO recordset. By default, once you set the DataSource property to a recordset, all changes you do on the control will be updated in the associated recordset. Because the DAO object does not provide any notifications or events the control is not able to detect any AddNew or Delete method that has been called. Instead, the control provides the AddItem and RemoveItem events that notifies your application once a new item is added to the control, or when an item is deleted. Based on these events, you will be able to manipulate the DAO recordset appropriate as in the following samples. In addition, the control fires the Error event in case any error occurs when handling the ADO or DAO recordsets, For instance, trying to update a read-only field.  In conclusion, if user changes a cell/value in the control, the associated field in the recordset is automatically updated. If any error occurs on updating the associated record, the Error event is fired which describes the error.

Handling the AddNew method in the control, using the DAO recordset on MS Access

• Insert a Button and the Control to a form, and name them as cmdAddNew and Grid1
• Add the Form_Load event of the form with the following code:

  Private Sub Form_Load()
      With Grid1
          .BeginUpdate
              .DataSource = CurrentDb.OpenRecordset("Employees")
              .DetectAddNew = True
          .EndUpdate
      End With
  End Sub 

The code binds the control to a DAO recordset. Please notice, that the DetectAddNew property is set after calling the DataSource method. Setting the DetectAddNew property on True, makes the control associate new items with new records added during the AddItem event as shown bellow.

• Add the Click event of the cmdAddNew button with the following code

Private Sub cmdAddNew_Click()
    With Grid1.Items
        .EnsureVisibleItem .AddItem
    End With
End Sub 

The code adds a new item to the control and ensures that the new item fits the control's client area. The Items.AddItem call makes the control to fire the AddItem event, which will actually add the new record to the database, as in the following code

• Add the AddItem event of the Control with the following code:

  Private Sub Grid1_AddItem(ByVal Item As Long)
      With Grid1
          If .DetectAddNew Then
              With .DataSource
                  .AddNew
                  !Lastname = "new"
                  !FirstName = "new"
                  .Update
              End With
          End If
      End With
  End Sub

The code adds a new record to the bounded recordset. Here you need to insert or update the required fields so the new record is added to the DAO recordset. Once the event is finished, the new item is associated with the new record in the database, so from now on, any change to the item will be reflected in the recordset.

Handling the AddNew method in the control, using the ADO recordset in VB

• Insert a Button and the Control to a form, and name them as cmdAddNew and Grid1
• Add the Form_Load event of the form with the following code:

  Private Sub Form_Load()
      With Grid1
          Set rs = CreateObject("ADOR.Recordset")
          With rs
              .Open "Employees", "Provider=Microsoft.ACE.OLEDB.12.0;Data Source=\sample.accdb", 3, 3
          End With
          .DataSource = rs
          .DetectAddNew = True
      End With
  End Sub

The code binds the control to an ADO recordset.

• Add the Click event of the cmdAddNew button with the following code

Private Sub cmdAddNew_Click()
    With Grid1.DataSource
        .AddNew Array("FirstName", "LastName"), Array("new", "new")
        .Update
    End With
End Sub 

The code adds a new record to the attached recordset, and the control will add a new associated item, because the DetectAddNew method is True.