[This is preliminary documentation and is subject to change.]

Determines if the user can Insert a new row, while in [!:Box.Activity.Update]Activity.

Namespace:  Firefly.Box
Assembly:  Firefly.Box (in Firefly.Box.dll) Version: (


public bool AllowInsertInUpdateActivity { get; set; }
Visual Basic (Declaration)
Public Property AllowInsertInUpdateActivity As Boolean
Visual C++
property bool AllowInsertInUpdateActivity {
	bool get ();
	void set (bool value);


When this property is set to true, and the AllowInsert property is set to true, the user can insert rows while in [!:Box.Activity.Update]Activity in one of the following methods:


Insert in Update Activity
This example is based on test data. The code for the entities included in this test data can be found in the documentation of Entity
This example uses automatic tools to generate parts of the user interface. Those tools can be found in the example of the documentation of Form
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using Firefly.Box;

namespace TestFirefly.Box.Documentation
    class InsertInUpdate
        public void Run()
            var jobs = new Pubs.Jobs();

            var uic = new UIController
                From = jobs,
                AllowInsert = true,//the default
                AllowInsertInUpdateActivity = true,//the default
                View = UITools.GenerateFormWithGridFor(
                    "Insert In Update Demo",
                    "To insert a new row, click on the \"Insert Row\" button,\n or navigate to the " +
                    "last row, and then press the down key.",

            var allowInsertCB = new CheckBox()
                Text = "Allow Insert",
                Checked = uic.AllowInsert,
                Width = 100

            allowInsertCB.CheckedChanged +=
                (a, b) => uic.AllowInsert = allowInsertCB.Checked;

            var allowInsertInUpdateCB = new CheckBox()
                Text = "Allow Insert In Update Activity",
                Checked = uic.AllowInsertInUpdateActivity,
                Width = 200

            allowInsertInUpdateCB.CheckedChanged +=
                (a, b) => uic.AllowInsertInUpdateActivity = allowInsertInUpdateCB.Checked;

            var insertRowButton = new Button()
                Text = "Insert Row"
            insertRowButton.Click += (a, b) => uic.Raise(Command.InsertRow);

            var switchToInsert = new Button
                Text = "Switch to Insert Activity",
                Width = 150
            switchToInsert.Click += (a, b) => uic.Raise(Command.SwitchToInsertActivity);

            var switchToUpdate = new Button
                Text = "Switch To Update Activity",
                Width = 150
            switchToUpdate.Click += (a, b) => uic.Raise(Command.SwitchToUpdateActivity);

            UITools.AddControlsToForm(uic.View, allowInsertCB, allowInsertInUpdateCB);
            UITools.AddControlsToForm(uic.View, insertRowButton,switchToInsert,switchToUpdate);


See Also