IKMLLayer80

This interface gives access to actions that can be performed on a KML layer. KML layers loaded into a project are always read directly from the local or remote data source.

 

	Properties
	Editable	Gets a Boolean indicating whether the layer is editable.
	ID	Gets the ID of the layer. (Inherited from ITerraExplorerObject80)
	ObjectType	Gets an enum that identifies the type of the object. (Inherited from ITerraExplorerObject80)
	Path	Gets the full path of the KML file.
	SaveInFlyFile	Gets and sets a Boolean that determines whether the layer is saved in the Fly file. (Inherited from ITerraExplorerObject80)
	TreeItem	An ITreeItem80 representing details about the representation of the layer in the Project Tree.
	Methods
	GetClientData	Gets an array of text strings assigned to each object global namespace. (Inherited from ITerraExplorerObject80)
	GetNetworkLink	Returns an interface to to the INetworkLink80 object based on the specified ID.
	GetParam	Reserved. Currently not used. (Inherited from ITerraExplorerObject80)
	Refresh	Refreshes the layer.
	Save	Saves layer changes to the data source.
	SaveAs	Saves layer changes to a file with a specified name.
	SetClientData	Sets an array of text strings assigned to each object global namespace. (Inherited from ITerraExplorerObject80)
	SetParam	Reserved. Currently not used. (Inherited from ITerraExplorerObject80)

 

Editable

Gets a Boolean indicating whether the layer is editable.

JavaScript
Editable

 

C#
bool Editable { get; }

 

C++
HRESULT Editable(        [out, retval] VARIANT_BOOL* pVal)

 

Path

Gets the full path of the KML file.

JavaScript
Path

 

C#
string Path { get; }

 

C++
HRESULT Path(        [out, retval] BSTR* pVal)

 

GetNetworkLink

Returns an interface to to the INetworkLink80 object based on the specified ID.

 

JavaScript
GetNetworkLink (        ObjectID)

 

C#
void GetNetworkLink (        string ObjectID)

 

C++
HRESULT GetNetworkLink (        BSTR ObjectID,        INetworkLink80** pINetworkLink)

Parameters

ObjectID

The ID of the network link item requested. It must be a child element of the IKMLLayer it is called on.  

Return Value

pINetworkLink

An INetworkLink80 representing the network link object.

 

Exceptions

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

Refresh

Refreshes the layer.

 

JavaScript
Refresh

 

C#
void Refresh()

 

C++
HRESULT Refresh()

Exceptions

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

 

Save

Saves layer changes to the data source.

 

JavaScript
Save()

 

C#
void Save()

 

C++
HRESULT Save()

Exceptions

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

SaveAs 

Saves the layer changes to a file with a specified name. For security reasons the file is saved to a predefined “Skyline\TerraExplorer” folder in the “Application Data” space of the current user. The full path of the saved file is provided in the method’s return value. You can also use %APPDATA% in Windows Explorer to locate the path on your computer.

Note:    If the folder contains a file by the same name, the existing file is overwritten without a prompt.

Note:    The Application Data folder path changes between different users and different Windows operating systems. To find the path used by your client look at the %APPDATA% environment variable.

 

JavaScript
SaveAs(        KmlName)

 

C#
string SaveAs(        string KmlName))

 

C++
HRESULT SaveAs(        BSTR KmlName,        BSTR* pVal)

Parameters

KmlName

The name for the layer file.
Note: A file name with a full path cannot be used here.

Return Value

pVal

A full path of the layer file being created.

Exceptions

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