AddRange Method (ControlCollection)

In This Topic

Adds an array of ARControl objects to the collection.

Syntax

Visual Basic
C#

'Declaration
 
Public Sub AddRange( _
   ByVal controls() As ARControl _
)

public void AddRange( 
   ARControl[] controls
)

Parameters

controls: An array of GrapeCity.ActiveReports~GrapeCity.ActiveReports.SectionReportModel.ARControl.html objects to add to the collection.

Remarks

The GrapeCity.ActiveReports~GrapeCity.ActiveReports.SectionReportModel.ARControl.html objects in the array are appended to the end of the collection.

Example

private void SectionReport1_ReportStart(object sender, System.EventArgs eArgs)
{
    //create an array of controls
    //array initialization is one-based, while array access is zero-based
    ARControl[] arr = new ARControl[3];
    GrapeCity.ActiveReports.SectionReportModel.CheckBox c = new GrapeCity.ActiveReports.SectionReportModel.CheckBox();
    GrapeCity.ActiveReports.SectionReportModel.Label l = new GrapeCity.ActiveReports.SectionReportModel.Label();
    GrapeCity.ActiveReports.SectionReportModel.TextBox t = new GrapeCity.ActiveReports.SectionReportModel.TextBox();
    //set some properties for the controls
    c.Text = "Checkbox";
    l.Left = 1;
    l.Value = "LabelValue";
    t.Left = 2;
    t.Text = "TextBox";
    //assign the controls to the array
    arr[0] = c;
    arr[1] = l;
    arr[2] = t;
    //add the range of controls to the first section of the report
    this.Sections[0].Controls.AddRange(arr);
}

Visual Basic

Private Sub SectionReport1_ReportStart(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.ReportStart
    'create an array of controls
    Dim arr(2) As ARControl
    Dim c As New GrapeCity.ActiveReports.SectionReportModel.CheckBox
    Dim l As New GrapeCity.ActiveReports.SectionReportModel.Label
    Dim t As New GrapeCity.ActiveReports.SectionReportModel.TextBox
    'set some properties for the controls
    c.Text = "Checkbox"
    l.Left = 1
    l.Text = "Label"
    t.Left = 2
    t.Text = "TextBox"
    'assign the controls to the array
    arr(0) = c
    arr(1) = l
    arr(2) = t
    'add the range of controls to the first section of the report
    Me.Sections(0).Controls.AddRange(arr)
End Sub

Reference

ControlCollection Class
ControlCollection Members