Add(String,String,Rectangle) Method

Adds a field to a C1Report.Fields collection.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Function Add( _
   ByVal name As String, _
   ByVal text As String, _
   ByVal rc As Rectangle _
) As Field

public Field Add( 
   string name,
   string text,
   Rectangle rc
)

Parameters

name: Contains the name of the new field. You should use a consistent naming scheme for the fields and avoid using duplicate names for report fields and database fields. Using repeated names is legal but will cause VBScript expressions that use repeated field names to yield unexpected results.
text: Contains the value for the new field's Field.Text property. This value may be treated as a literal or as a VBScript expression, depending on the setting of the field's Field.Calculated property. By default, Field.Calculated is set to false and the text is rendered as-is.
rc: Defines the position of the field, in twips, with respect to its containing section.

Return Value

A reference to the newly added field.

Remarks

If you add a field to a section's Section.Fields collection, the new field is automatically assigned to that section.

If you add a field to the control's C1Report.Fields collection, the new field is not assigned to any sections. In this case, you must set the field's Field.Section property or it will not be rendered in the report.

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

FieldCollection Class
FieldCollection Members
Overload List