This document is archived and information here might be outdated.  Recommended version.


IGlobeDisplay.LocateMultiple Method (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (GlobeCore)  

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

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

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

IGlobeDisplay Interface