IGlobeDisplay.Locate Method

Find the object and location in the line of sight.

[Visual Basic .NET]
Public Sub Locate ( _
    ByVal pViewer As ISceneViewer, _
    ByVal xView As Integer, _
    ByVal yView As Integer, _
    ByVal bGetTransformed As Boolean, _
    ByVal bGetEmptyGlobe As Boolean, _
    ByRef ppPoint As IPoint, _
    ByRef ppOwner As Object, _
    ByRef ppObject As Object _
)

[C#]
public void Locate (
    ISceneViewer pViewer,
    int xView,
    int yView,
    bool bGetTransformed,
    bool bGetEmptyGlobe,
    ref IPoint ppPoint,
    ref object ppOwner,
    ref object ppObject
);

[C++]
HRESULT Locate(
  ISceneViewer* pViewer,
  long xView,
  long yView,
  VARIANT_BOOL bGetTransformed,
  VARIANT_BOOL bGetEmptyGlobe,
  IPoint** ppPoint,
  LPUNKNOWN* ppOwner,
  LPUNKNOWN* ppObject
);

[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
bGetTransformed [in]
  bGetTransformed is a parameter of type VARIANT_BOOL
bGetEmptyGlobe [in]
  bGetEmptyGlobe is a parameter of type VARIANT_BOOL
ppPoint [out]

  ppPoint is a parameter of type IPoint
ppOwner [out]
  ppOwner is a parameter of type LPUNKNOWN
ppObject [out]
  ppObject is a parameter of type LPUNKNOWN

Product Availability

Description

This method returns the closest object (ppObject) hit by the line of sight from the observer location in the window coordinates xView, yView in the viewer, pViewer.

ppPoint is a point representing the hit location coordinates.

If bGetTransformed is 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 are in kilometers.

If bGetEmptyGlobe is True, a hit will be added for the base globe surface, even if it doesn't contain any layer.

See Also

.NET Snippets

.NET Samples