CreateFeatureLayer

CreateFeatureLayer loads a feature layer into the project. A feature layer is a visual representation of a geographic data set like roads, national parks, political boundaries, and rivers using geographic objects such as points, lines, and polygons and optional corresponding annotation objects.

TerraExplorer enables you to load feature layers from remote or local databases. Various file formats are supported through a set of external plug-ins. You are always connected to the data source (local or remote), and all changes to the feature layers can be saved to the original source file. You can get the latest updates to a layer source by refreshing the layer.

TerraExplorer handles differently layers that are created by loading native feature sources (Shape and GeoDatabase files, and all server inputs) and layers that are created by loading non-native feature files (e.g., DXF, ASCII and OpenFlight files). For the former, a layer object containing the geographic objects is created in the Project Tree while for the latter the geographic objects are read and put in the TerraExplorer Project Tree as a Group.

If the source file coordinate system is not the same as the MPT file Terrain Coordinate system, you can reproject it using the ILayer6.Reproject method.

 

JavaScript
CreateFeatureLayer(       layerName,       sConnectionString,       lParentGroupID)

 

C#
ILayer6 CreateFeatureLayer(       string layerName,       string sConnectionString,       int     lParentGroupID)

 

C++
HRESULT CreateFeatureLayer(        BSTR        layerName,        BSTR        sConnectionString,        LONG_PTR    lParentGroupID,        ILayer6 **  pILayer)

Parameters:

layerName

A string representing the name of the layer.

sConnectionString

Specifies information about the data source and the means of connecting to it.

lParentGroupID

The Project Tree group in which the layer is created. If it is set to zero, the object is created under the root. You can obtain the GroupID by one of the following methods:

§   Create the group using IProjectTree6.CreateGroup.

§  Find the group, if you know the name, using IProjectTree6.FindItem.

§  Traverse the Tree using IProjectTree6 methods such as GetNextItem(), until you come to the desired GroupID.

Return Value

pILayer

An ILayer6, representing the newly created layer.

Exceptions

See: HRESULT Return Values for a list of possible values returned by the HRESULT.