TSL3DMapQuery Class Reference

Detailed Description

Query class for 3D and 2D data layer entities.

This is very similar to the TSLMapQuery method but returns the common TSLEntityBase class rather than the TSLEntity class.

The TSL3DMapQuery object allows the user to traverse any TSLEntityBase instances held in memory by a data layer. A map tile consists of a single TSLEntitySet or TSL3DEntitySet which may contain further entities

A TSL3DMapQuery object may only be created indirectly via other API calls and should be deleted by the user using the destroy method.

A TSLStandardDataLayer component will only have one TSLEntitySet which will always be held in memory. A TSLMapDataLayer component may have a number of TSLEntitySets held in memory which may change as the view of the map changes. A TSLMapQuery component created from a TSLMapDataLayer component is only valid within the user function in which it is created. This is because the set of models held in memory may change due to modification to the TSLDrawingSurface.

A TSL3DStandardDataLayer component will only have one TS3DEntitySet which will always be held in memory. A TS3DLMapDataLayer component may have a number of TSLEntitySets and TSL3DEntitySets held in memory which may change as the view of the map changes. A TSL3DMapQuery component created from a TSL3DMapDataLayer component is only valid within the user function in which it is created. This is because the set of models held in memory may change due to modification to the TSL3DDrawingSurface.

Deprecated

Deprecated as of MapLink 11.1. Advised to use MapLink Earth SDK instead.

Public Member Functions
void	destroy ()
const TSLEntityBase *	operator[] (int index) const
int	size () const

Member Function Documentation

destroy()

void TSL3DMapQuery::destroy

(

)

Destroy TSL3DMapQuery object.

This method should be called by the user as soon as the query is not required. A query should not be held open across calls to TSL3DDrawing Surface since any change in view may cause the map tile cache to be flushed.

operator[]()

const TSLEntityBase * TSL3DMapQuery::operator[]

(

int

index

)

const

Query a particular TSLEntityBase.

TSLEntityBase objects obtained from a Map Data Layer are read-only. The user should not delete the TSLEntityBase objects returned by the query, since they are embedded within the Data Layer.

Parameters

index

Index into list of required TSLEntityBase

Returns

NULL if index is out of range, TSLEntityBase otherwise.

size()

int TSL3DMapQuery::size

(

)

const

Query the number of TSLEntityBase derived objects contained in the query.