EnvelopeBuilder Constructor(MapPoint,MapPoint)

Initializes a new instance of the EnvelopeBuilder class. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public EnvelopeBuilder( 
   MapPoint minPoint,
   MapPoint maxPoint
)

Public Function New( _
   ByVal minPoint As MapPoint, _
   ByVal maxPoint As MapPoint _
)

Parameters

minPoint: Lower left corner of the envelope.
maxPoint: Upper right corner of the envelope.

Exceptions

Exception	Description
NullGeometryObjectException	Indicates the geometry is null or empty.
System.InvalidOperationException	Incompatible spatial references. The spatial references of the MapPoints do not match.
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentNullException	minPoint or maxPoint is null.

Remarks

The spatial references of the two points must be the same or null.The resulting envelope is normalized to ensure its XMin <= XMax, YMin <= YMax, ZMin <= ZMax and MMin <= MMax. If any of the xy-coordinate values are NaN, then the envelope is set to empty.

Example

// Use a builder convenience method or use a builder constructor.

MapPoint minPt = MapPointBuilder.CreateMapPoint(1.0, 1.0);
MapPoint maxPt = MapPointBuilder.CreateMapPoint(2.0, 2.0);

// Builder convenience methods don't need to run on the MCT.
Envelope envelope = EnvelopeBuilder.CreateEnvelope(minPt, maxPt);

// Builder constructors need to run on the MCT.
ArcGIS.Desktop.Framework.Threading.Tasks.QueuedTask.Run(() =>
{
  using (EnvelopeBuilder builder = new EnvelopeBuilder(minPt, maxPt))
  {
    // do something with the builder

    envelope = builder.ToGeometry();
  }
});

// builderEx constructors don't need to run on the MCT.
EnvelopeBuilderEx builderEx = new EnvelopeBuilderEx(minPt, maxPt);
envelope = builderEx.ToGeometry() as Envelope;

// builderEx convenience methods don't need to run on the MCT
envelope = EnvelopeBuilderEx.CreateEnvelope(minPt, maxPt);

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

EnvelopeBuilder Class
EnvelopeBuilder Members
Overload List