Description

Creates a VGT system using the specified name, description and type.

Syntax

[Visual Basic .NET]
Public Function Create( _ ByVal SystemName As String, _ ByVal Description As String, _ ByVal SystemType As AgECrdnSystemType _ ) As IAgCrdnSystem

[Visual Basic .NET]

Public Function Create( _
   ByVal SystemName As String, _
   ByVal Description As String, _
   ByVal SystemType As AgECrdnSystemType _
) As IAgCrdnSystem

[C#]
public IAgCrdnSystem Create( string SystemName, string Description, AgECrdnSystemType SystemType );

[C#]

public IAgCrdnSystem Create(
   string SystemName, 
   string Description, 
   AgECrdnSystemType SystemType
);

[Managed C++]
public: IAgCrdnSystem^ Create( String __gc ^ SystemName, String __gc ^ Description, AgECrdnSystemType SystemType );

[Managed C++]

public: IAgCrdnSystem^ Create(
   String __gc ^ SystemName, 
   String __gc ^ Description, 
   AgECrdnSystemType SystemType
);

[Java]
public IAgCrdnSystem create( String SystemName, String Description, AgECrdnSystemType SystemType );

[Java]

public IAgCrdnSystem create(
   String SystemName, 
   String Description, 
   AgECrdnSystemType SystemType
);

[Unmanaged C++]
public: HRESULT Create( BSTR SystemName, BSTR Description, AgECrdnSystemType SystemType, IAgCrdnSystem ** ReturnValue );

[Unmanaged C++]

public: HRESULT Create(
   BSTR SystemName, 
   BSTR Description, 
   AgECrdnSystemType SystemType, 
   IAgCrdnSystem ** ReturnValue
);

Parameters

SystemName

Specify a component name.

Description

Specify a component description.

SystemType

Member	Value	Description
eCrdnSystemTypeUnknown	-1	Unknown or unsupported system type.
eCrdnSystemTypeAssembled	0	A system assembled from an origin point and a set of reference axes.
eCrdnSystemTypeOnSurface	1	A system with an origin on the surface of the central body with topocentric axes rotated on a clock angle.
eCrdnSystemTypeTemplate	2	Represents a VGT system created from a template. This type of system is not creatable.

Specify a component type.

Remarks

Spaces and most punctuation ( except for "-_().") cannot be used as a part of a component name when creating new components via VGT API.

Example

Create a system assembled from a point serving as its origin and a set of reference axes.

[C#] Copy Code

IAgCrdnSystemAssembled system = (IAgCrdnSystemAssembled)provider.Systems.Factory.Create( 

    "SystemName", string.Empty, AgECrdnSystemType.eCrdnSystemTypeAssembled); 

// Set the system's origin point. 

system.OriginPoint.SetPoint(OriginPoint); 

// Set the system's reference axes. 

system.ReferenceAxes.SetAxes(ReferenceAxes);