CreateByCropping Method (Database, String, ObjectId, Point3dCollection)

Creates a new TinSurface by cropping from an existing source TinSurface, and then inserts the new surface into another drawing. You must specify at least 3 points as the cropped area.

Namespace: Autodesk.Civil.DatabaseServices
Assembly: AeccDbMgd (in AeccDbMgd.dll) Version: 13.4.208.0

Syntax

C#

public static ObjectId CreateByCropping(
	Database destDatabase,
	string surfaceName,
	ObjectId srcSurfaceId,
	Point3dCollection points
)

Visual Basic

Public Shared Function CreateByCropping ( _
	destDatabase As Database, _
	surfaceName As String, _
	srcSurfaceId As ObjectId, _
	points As Point3dCollection _
) As ObjectId

Visual C++

public:
static ObjectId CreateByCropping(
	Database^ destDatabase, 
	String^ surfaceName, 
	ObjectId srcSurfaceId, 
	Point3dCollection^ points
)

Parameters

destDatabase
Type: Database
The database to insert the new TinSurface into.
surfaceName
Type: System.String
The new surface name.
srcSurfaceId
Type: ObjectId
The ObjectId of the source surface.
points
Type: Point3dCollection
The points that specify the cropped area.

Remarks

You need to lock the destDatabase and then set it as the current document before you call this method.

Exceptions

ExceptionCondition
System.ArgumentException Thrown when:
  1. The surfaceName is empty.
  2. srcSurfaceId is invalid or its type is not Autodesk.Civil.DatabaseServices.TinSurface.
  3. The points' count is less than 3.
  4. The srcSurfaceId and objects are not in the same database.
System.InvalidOperationException Thrown when srcSurfaceId is in destDatabase.
Autodesk.Civil.SurfaceException Thrown when this operation failed.

See Also