IGlobeDisplay.LocateMultiple Method

Find the object and location in the line of sight.

[Visual Basic .NET]
Public Sub LocateMultiple ( _
    ByVal pViewer As ISceneViewer, _
    ByVal xView As Integer, _
    ByVal yView As Integer, _
    ByVal bGetLocation As Boolean, _
    ByVal bGetTransformed As Boolean, _
    ByVal bGetEmptyGlobe As Boolean, _
    ByVal bFeaturesOnly As Boolean, _
    ByRef ppHits As IHit3DSet _
)

[C#]
public void LocateMultiple (
    ISceneViewer pViewer,
    int xView,
    int yView,
    bool bGetLocation,
    bool bGetTransformed,
    bool bGetEmptyGlobe,
    bool bFeaturesOnly,
    ref IHit3DSet ppHits
);

[C++]
HRESULT LocateMultiple(
  ISceneViewer* pViewer,
  long xView,
  long yView,
  VARIANT_BOOL bGetLocation,
  VARIANT_BOOL bGetTransformed,
  VARIANT_BOOL bGetEmptyGlobe,
  VARIANT_BOOL bFeaturesOnly,
  IHit3DSet** ppHits
);

[C++]
Parameters
pViewer [in]
  pViewer is a parameter of type ISceneViewer
xView [in]
  xView is a parameter of type long
yView [in]
  yView is a parameter of type long
bGetLocation [in]
  bGetLocation is a parameter of type VARIANT_BOOL
bGetTransformed [in]
  bGetTransformed is a parameter of type VARIANT_BOOL
bGetEmptyGlobe [in]
  bGetEmptyGlobe is a parameter of type VARIANT_BOOL
bFeaturesOnly [in]
  bFeaturesOnly is a parameter of type VARIANT_BOOL
ppHits [out]
  ppHits is a parameter of type IHit3DSet

Product Availability

Description

This method returns a set of objects (ppHits) hit by the line of sight from the observer location and the window coordinates xView, yView in pViewer. 

If bGetLocation = True, it indicates that the hit point coordinates must be returned. 
If both bGetLocation and bGetTransformed are True, it indicates that the returned coordinates must be in the internal geocentric coordinate system. If bGetTransformed = False, the returned hit point coordinates are in the Globe Spatial Reference: longitude, latitude and altitude in kilometers.
If bGetEmptyGlobe is True, a hit will be added for the base globe surface, even if it doesn't contain any layer.
If bFeaturesOnly is True, only hits to features will be returned (hits to elevation surfaces will not).

See Also