AllowUserToAddRows Property

Gets or sets a value that indicates whether the user is allowed to add rows to the GcMultiRow control with a UI action.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<DefaultValueAttribute()>
<FeatureAttribute(Name="AutoAddDeleteRow", Version="v5.0")>
<SRDescriptionAttribute("Indicates whether the option to add rows is displayed to the user.")>
<SRCategoryAttribute("Behavior")>
Public Property AllowUserToAddRows As Boolean

Dim instance As GcMultiRow
Dim value As Boolean
 
instance.AllowUserToAddRows = value
 
value = instance.AllowUserToAddRows

[DefaultValue()]
[Feature(Name="AutoAddDeleteRow", Version="v5.0")]
[SRDescription("Indicates whether the option to add rows is displayed to the user.")]
[SRCategory("Behavior")]
public bool AllowUserToAddRows {get; set;}

Property Value

true if the user is allowed to add rows; otherwise, false. The default value is true.

Remarks

If the GcMultiRow control is bound to data, the user is allowed to add rows if both this property and the data source's System.ComponentModel.IBindingList.AllowNew property are set to true.

If the GcMultiRow control is bound to data and the user is allowed to add rows, the GcMultiRow RowCount property always equals the data source row count minus 1 when the current cell is not on the last row.

Example

This example sets the AllowUserToAddRows property.

GrapeCity.Win.MultiRow.TextBoxCell text1 = new GrapeCity.Win.MultiRow.TextBoxCell();
GrapeCity.Win.MultiRow.TextBoxCell text2 = new GrapeCity.Win.MultiRow.TextBoxCell();
text1.Name = "text1";
text2.Name = "text2";
GrapeCity.Win.MultiRow.Template template1 = GrapeCity.Win.MultiRow.Template.CreateGridTemplate(new GrapeCity.Win.MultiRow.Cell[] { text1, text2 }, 160, GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.ColumnHeader | GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.RowHeaderAutoNumber);
template1.ColumnHeaders[0].Cells[0].Value = "Column1";
template1.ColumnHeaders[0].Cells[1].Value = "Column2";
gcMultiRow1.Template = template1;
gcMultiRow1.RowCount = 3;
gcMultiRow1.AllowUserToAddRows = true;
// Double-click between column header
gcMultiRow1.AllowUserToAutoFitColumns = true;
// Use Ctrl + Delete
gcMultiRow1.AllowUserToDeleteRows = true;

VB.NET

Dim text1 As New GrapeCity.Win.MultiRow.TextBoxCell()
Dim text2 As New GrapeCity.Win.MultiRow.TextBoxCell()
text1.Name = "text1"
text2.Name = "text2"
Dim template1 As GrapeCity.Win.MultiRow.Template = GrapeCity.Win.MultiRow.Template.CreateGridTemplate(New GrapeCity.Win.MultiRow.Cell() {text1, text2}, 160, GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.ColumnHeader Or GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.RowHeaderAutoNumber)
template1.ColumnHeaders(0).Cells(0).Value = "Column1"
template1.ColumnHeaders(0).Cells(1).Value = "Column2"
GcMultiRow1.Template = template1
GcMultiRow1.RowCount = 3
GcMultiRow1.AllowUserToAddRows = True
' Double-click between column header
GcMultiRow1.AllowUserToAutoFitColumns = True
' Use Ctrl + Delete
GcMultiRow1.AllowUserToDeleteRows = True

Requirements

Target Platforms: 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

Reference

GcMultiRow Class
GcMultiRow Members
AllowUserToDeleteRows Property