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


IPageLayoutControl.LocateFrontElement Method (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Controls > ESRI ArcGIS Controls > Interfaces > IP > IPageLayoutControl Interface > IPageLayoutControl.LocateFrontElement Method
ArcGIS Developer Help

IPageLayoutControl.LocateFrontElement Method

Locates an element at the given page co-ordinates. If more than one element is at the location the element nearest the front is returned.

[Visual Basic .NET]
Public Function LocateFrontElement ( _
    ByVal pageX As Double, _
    ByVal pageY As Double, _
    [ByVal Tolerance As Double] _
) As IElement
[C#]
public IElement LocateFrontElement (
    double pageX,
    double pageY,
    double Tolerance
);
[C++]
HRESULT LocateFrontElement(
  double pageX,
  double pageY,
  double Tolerance
);
[C++]
Parameters
pageX [in]

pageX is a parameter of type double pageY [in]
pageY is a parameter of type double Tolerance [in, optional, defaultvalue()]
Tolerance is a parameter of type double

Product Availability

Available with ArcGIS Engine.

Description

LocateFrontElement is typically used within the IPageLayoutControlEvents::OnMouseDown event to retrieve an element at the given page coordinates. If more than one element exists at the given page coordinates, the element located at the front is returned.

See Also

IPageLayoutControl Interface | IPageLayoutControl.AddElement Method | IPageLayoutControl.FindElementByName Method