Add Method

Land Auto

Add Method

Creates a member object and adds it to the appropriate collection.

See Also | Example

Signature: Overview

l Alignments

l Boundaries

l BreakLines

l CogoPoints

l ContourItems

l DEMFiles

l DescriptionKeyFile

l DescriptionKeyFiles

l EGProfiles (Civil Engineering Feature)

l FGProfiles (Civil Engineering Feature)

l Parcels

l PointFiles

l PointGroupNames

l PointGroups

l Projects

l PVIs (Civil Engineering Feature)

l StationEquations

l Surfaces


Creates a new Alignment and adds it to the Alignments collection.

Signature

RetVal = object.Add(Name, StartingStation)

object

Alignments The object or objects this property applies to.

Name

String; input-only
New alignment name.

StartingStation

Double; input-only
The starting station.

RetVal

Alignment object
The newly added Alignment object.

Remarks

The new alignment must be saved for any changes to take affect. You can add a new alignment to the collection and then define the underlying geometry. Be advised that if you save an alignment without later adding any tangents, curves or spirals, you will not be able to edit the geometry using the alignment editor.


Adds a Boundary to the Surface.

Signature

RetVal = object.Add(Type, bIsBreakLine, Coordinates[, Description])

object

Boundaries
The object or objects this property applies to.

Type

eAeccBoundaryType enum; input-only

kBoundaryTypeShow:

Boundary is visible

kBoundaryTypeHide:

Boundary is hidden

kBoundaryTypeOuter:

Boundary is the outer most boundary

kBoundaryTypeUninit:

Boundary in not initialized.

bIsBreakLine

Boolean; input only
TRUE:  Boundary is a breakline
FALSE: Boundary is not a breakline

Coordinates

Variant (array of doubles); input-only
The points in Easting, Northing, Elevation format.

Description

String; input only; optional
The description of the Boundary.

RetVal

Boundary object
The newly added Boundary object.

Remarks

Outer boundaries are always visible and must be the first boundary defined.


Creates a new BreakLine for the Surface.

Signature

RetVal = object.Add(Coordinates[, Description])

object

BreakLines
The object or objects this property applies to.

Coordinates

Variant (array of doubles); input-only
The points in Easting, Northing, Elevation format.

Description

String; input-only; optional
The description for the BreakLine.

RetVal

BreakLine object
The newly added BreakLine object.

Remarks

Add creates the BreakLine by adding it to the Surface. It will also add the BreakLine to the BreakLines collection. Only a Standard BreakLine can be added. The Surface must be built for the change to take affect.


Creates a new CogoPoint and adds it to the collection for the project database.

Signature

RetVal = object.Add(Coordinates, Format)

object

CogoPoints
The object or objects this property applies to.

Coordinates

Variant (2 or 3 element array of doubles); input-only.
If the array has 2 elements, no elevation will be assigned.

Double[0]:

Easting, or X based on PointStyle

Double[1]:

Northing, or Y based on PointStyle

Double[2]:

Optional: Elevation or kPointNoElevation

Format

eAeccCoordinateFormat enum; input-only

kCoordinateFormatENZ:

Point is in Easting, Northing, elevation

kCoordinateFormatXYZ:

Point is in X, Y, elevation. AutoCAD coordinates

RetVal

CogoPoint object
The newly added CogoPoint object.


Adds a ContourItem to the Surface definition.

Signature

RetVal = object.Add(Coordinates)

object

ContourItems
The object or objects this property applies to.

Coordinates

Variant (array of doubles); input-only
An array of doubles representing Easting, Northing, Elevation.

RetVal

ContourItem object
The newly added ContourItem object.


Adds a Digital Elevation Model file to the Surface definition.

Signature

RetVal = object.Add(FullName, [CoordinateZone])

object

DEMFiles
The object or objects this property applies to.

FullName

String; input-only
Full name of the DEM file to be added.

CoordinateZone

String; input-only
The coordinate system syntax for the zone.

RetVal

DEMFile object
The newly added DEMFile object.


Creates a new DescriptionKey.

Signature

RetVal = object.Add(syntax)

object

DescriptionKeyFile
The object or objects this property applies to.

syntax

String; input-only
The syntax of the new DescriptionKey

RetVal

DescriptionKey object
The newly added DescriptionKey object.


Creates a new DescriptionKeyFiles and adds it to the collection for the project database.

Signature

RetVal = object.Add(Name)

object

DescriptionKeyFiles
The object or objects this property applies to.

Name

String; input-only
The name of the new DescriptionKeyFiles

RetVal

DescriptionKeyFile object
The newly added DescriptionKeyFile object.


Creates a new EGProfile and adds it to the EGProfiles collection.

Signiture

RetVal = Object.Add(Type, SurfaceName)

object

EGProfiles
The object or objects this property applies to.

Type

eAeccEGProfilesType enum; input-only
The type for the new EGProfile.

kEgCenter:

Existing ground center profile

kEgLeft:

Existing ground left profile

kEgNone:

Existing ground none

kEgRight:

Existing ground right profile

String

String; input-only
The name of the surface.

RetVal

EGProfile object
The newly added EGProfile object.


Adds a Finished Grade Profile to the project

Signiture

RetVal = Object.Add(Type)

object

FGProfiles
The object or objects this property applies to.

Type

eAeccFGProfileType enum; input-only
The type of finished grade profile to add.

kFgCenter:

Finished grade center profile

kFgDitchLeft:

Finished grade left ditch profile

kFgDitchRight:

Finished grade right ditch profile

kFgLeft1:

Finished grade left 1 profile

kFgLeft2:

Finished grade left 2 profile

kFgLeft3:

Finished grade left 3 profile

kFgLeft4:

Finished grade left 4 profile

kFgLeft5:

Finished grade left 5 profile

kFgLeft6:

Finished grade left 6 profile

kFgLeft7:

Finished grade left 7 profile

kFgLeft8:

Finished grade left 8 profile

kFgNone:

Finished grade none

kFgRight1:

Finished grade right 1 profile

kFgRight2:

Finished grade right 2 profile

kFgRight3:

Finished grade right 3 profile

kFgRight4:

Finished grade right 4 profile

kFgRight5:

Finished grade right 5 profile

kFgRight6:

Finished grade right 6 profile

kFgRight7:

Finished grade right 7 profile

kFgRight8:

Finished grade right 8 profile

RetVal

FGProfile object
The newly added FGProfile object.

Remarks

A Finished Grade Profile can not start or end with a Vertical Curve.


Creates a new Parcel and adds it to the ExistingParcelAligns collection.

Signiture

RetVal = Object.Add(Name)

object

Parcels
The object or objects this property applies to.

Name

String; input-only
The name of the parcel.

RetVal

Parcel object
The newly added Parcels object.


Adds a point file to the PointFiles collection.

Signature

RetVal = object.Add(FullName)

object

PointFiles
The object or objects this property applies to.

FullName

String; input-only
Full name of the point file to be added.

RetVal

PointFile object
The newly added PointFile object.

Remarks

PointFile.Add does not check for the existence of the file. The new PointFile will use the default file format of Point Number, Easting, Northing, Elevation (space-delimited). Each field in the point file must be seperated with a single space.


Adds a new PointGroupName to the PointGroupNames collection.

Signature

RetVal = object.Add(Name)

object

PointGroupNames
The object or objects this property applies to.

Name

String; input-only
Name of the PointGroupName to add.

RetVal

PointGroupName object
The newly added PointGroupName object.


Add a new point group to the project database.

Signature

RetVal = object.Add(Name, PointList)

object

PointGroups
The object or objects this property applies to.

GroupName

String; input-only
The new point group name.

PointList

String; input-only
The point list.

RetVal

PointGroup object
The newly added PointGroup object.


Creates a new project.

Signature

RetVal = object.Add(ProjectName, PrototypeName[, CreatePDb])

object

Projects
The object or objects this property applies to.

ProjectName

String; input-only
The name of the project to delete.

PrototypeName

String; input-only
The name of the prototype to use for the project.

CreatePDb

Boolean; input-only; optional
True:  The Cogo Point database will be created (default).
False: The Cogo Point database will not be created

RetVal

Project object
The newly added Project object.

Remarks

The new project is created at the ProjectPath directory. The default subfolder to save drawings in is the \dwg subfolder.

If CreatePDb is True, the Cogo Point database will be created. The Description field size will be 32 characters. Point Names will be enable with a size of 16 characters. The default value for CreatePDb is True.


Adds a PVI.

Signiture

RetVal = Object.Add(Station, Elevation, Curvelength)

object

PVIs
The object or objects this property applies to.

Station

Double; input-only
The Station for the new PVI.

Elevation

Double; input-only
The Elevation for the new PVI.

CurveLength

Double; input-only
The CurveLength for the new PVI.

RetVal

PVI object
The newly added PVI object.


Adds a station equation into the alignment.

Signature

RetVal = object.Add(StationBack, StationAhead, Type)

object

StationEquations
The object or objects this property applies to.

StationBack

Double; input-only
The back station for the station equation.

StationAhead

Double; input-only
The ahead station for the station equation.

Type

eAeccStationEquationType enum; input-only

kIncreasing:

Station numbers increase along the alignment

kDecreasing:

Station numbers decrease along the alignment

RetVal

StationEquation object
The newly added StationEquation object.


Creates a new Surface and adds it to the Surfaces collection.

Signature

RetVal object.Add(SurfaceName)

object

Surfaces
The object or objects this property applies to.

SurfaceName

String; input-only
New surface name.

RetVal

Surface object
The newly added Surface object.

Remarks

If the name of the surface is blank, then a temporary surface will be created. A temporary surface is useful for generating a surface in an AutoCAD drawing. A temporary surface can not be saved.