EnvelopeBuilderEx Constructor(MapPoint,MapPoint,SpatialReference)

In This Topic

Creates a new instance of the EnvelopeBuilderEx class.

Syntax

C#
Visual Basic (Declaration)

public EnvelopeBuilderEx( 
   MapPoint minPoint,
   MapPoint maxPoint,
   SpatialReference spatialReference
)

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

Parameters

minPoint: Lower left corner of the envelope. Cannot be null.
maxPoint: Upper right corner of the envelope. Cannot be null.
spatialReference: (Optional) The spatial reference. The default value is null. The spatial reference of each point is ignored.

Exceptions

Exception	Description
System.ArgumentNullException	minPoint or maxPoint is null.

Remarks

The spatial references of the input points are ignored. There is no check to see if the spatial references are equal. If either point has coordinates that are outside the domain of the spatial reference, then unexpected results will occur when using the geometry.

The builder inherits attributes, Z, M and ID-values from the input points. For example, if either minPoint or maxPoint HasZ property is true, then the builder's HasZ property is true.

The resulting envelope is normalized to ensure its XMin <= XMax, YMin <= YMax. If either of the xy-coordinate values are NaN, then the envelope is set to empty.

Example

Construct an Envelope

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

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

Envelope envelope = EnvelopeBuilderEx.CreateEnvelope(minPt, maxPt);

EnvelopeBuilderEx builderEx = new EnvelopeBuilderEx(minPt, maxPt);
envelope = builderEx.ToGeometry() as Envelope;

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

EnvelopeBuilderEx Class
EnvelopeBuilderEx Members
Overload List

Send feedback