ArcObjects Library Reference (Geometry)  

IEnvelope Interface

Provides access to methods and properties of envelopes. Note: the IEnvelope interface has been superseded byIEnvelope2. Please consider using the more recent version.

Product Availability

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


Envelopes are the rectangular window that contain a specific element.  All Geometry objects have an envelope defined by the XMin, XMax, YMin, and YMax of the object.  Envelopes can also serve as the viewing area for a particular view screen or data frame.


Method CenterAt Moves this envelope so it is centered at p.
Method DefineFromPoints Defines the envelope to cover all the points.
Read/write property Depth The depth of the envelope.
Read-only property Dimension The topological dimension of this geometry.
Read-only property Envelope Creates a copy of this geometry's envelope and returns it.
Method Expand Moves the X and Y coordinates of the sides toward or away from each other.
Method ExpandM Moves the measure of the sides toward or away from each other.
Method ExpandZ Moves the Z attribute of the sides toward or away from each other.
Read-only property GeometryType The type of this geometry.
Method GeoNormalize Shifts longitudes, if need be, into a continuous range of 360 degrees.
Method GeoNormalizeFromLongitude Normalizes longitudes into a continuous range containing the longitude. This method is obsolete.
Read/write property Height The height of the envelope.
Method Intersect Adjusts to include only the area also included by inEnvelope.
Read-only property IsEmpty Indicates whether this geometry contains any points.
Read/write property LowerLeft The lower left corner.
Read/write property LowerRight The lower right corner.
Read/write property MMax The maximum measure value in the area of the envelope.
Read/write property MMin The minimum measure value in the area of the envelope.
Method Offset Moves the sides x units horizontally and y units vertically.
Method OffsetM Moves the sides m units.
Method OffsetZ Moves the sides z units.
Method Project Projects this geometry into a new spatial reference.
Method PutCoords Constructs an envelope from the coordinate values of lower, left and upper, right corners.
Method QueryCoords Returns the coordinates of lower, left and upper, right corners.
Method QueryEnvelope Copies this geometry's envelope properties into the specified envelope.
Method SetEmpty Removes all points from this geometry.
Method SnapToSpatialReference Moves points of this geometry so that they can be represented in the precision of the geometry's associated spatial reference system.
Read/write property SpatialReference The spatial reference associated with this geometry.
Method Union Adjusts to overlap inEnvelope.
Read/write property UpperLeft The upper left corner.
Read/write property UpperRight The upper right corner.
Read/write property Width The width of the envelope.
Read/write property XMax The position of the right side.
Read/write property XMin The position of the left side.
Read/write property YMax The position of the top.
Read/write property YMin The position of the bottom.
Read/write property ZMax The maximum Z value in the area of the envelope.
Read/write property ZMin The minimum Z value in the area of the envelope.

Inherited Interfaces

Interfaces Description
IGeometry Provides access to members that describe properties and behavior of all geometric objects.

CoClasses that implement IEnvelope

CoClasses and Classes Description
Envelope A rectangle with sides parallel to a coordinate system defining the extent of another geometry; optionally has min and max measure, height and ID attributes.

        //The following C# code shows how to create an envelope from coordinates:
        IEnvelope env = new EnvelopeClass() as IEnvelope;

        env.PutCoords(-10, -5, 10, 5);

See Also

IPoint Interface | IGeometry Interface

.NET Snippets

Create JPEG from ActiveView | Get All Features from Point Search in GeoFeatureLayer | Add Event Wiring for All IActiveViewEvents | Get First Feature from Point Search in GeoFeatureLayer | Create Low Precision Spatial Reference | Convert Spatial Reference From High To Low Precision | Zoom to Selected Globe Features | Add Scale Bar | Zoom by Ratio and Recenter | Add Legend | Convert Display Pixels to Map Units | Create JPEG (hi-resolution) from ActiveView | Set Max Extent On Spatial Domain | Create Grid From Feature Class | Zoom to Globe Layer | Zoom by Ratio | Add North Arrow

.NET Samples

Closest facility solver (Code Files: frmClosestFacilitySolver) | Curve conversion add-in (Code Files: CurveConversionDockWin) | 3D multipatch examples (Code Files: ExtrusionExamples) | Custom map navigation commands (Code Files: FixedZoomIn FixedZoomOut Pan PanDown PanLeft PanRight PanUp ZoomIn ZoomOut) | Dynamic display animated zoom (Code Files: AnimatedZoomInTool AnimatedZoomOutTool) | Dynamic biking (Code Files: DynamicBikingCmd) | Use a PageLayoutControl as an overview window (Code Files: Overview) | View CAD data in a MapControl (Code Files: CADView) | Service area solver (Code Files: frmServiceAreaSolver) | Dynamic display layer (Code Files: MyDynamicLayerClass) | Display feedback (Code Files: DisplayFeedbackSampleVB) | Custom map selection commands (Code Files: ClearFeatureSelection SelectFeatures) | Print preview using the PageLayoutControl (Code Files: PrintPreview) | Location-allocation solver (Code Files: frmLocationAllocationSolver) | Vehicle routing problem solver (Code Files: frmVRPSolver) | Origin-destination cost matrix solver (Code Files: frmODCostMatrixSolver) | Create a custom raster type from the ground up for DMCII data (Code Files: DMCIIRasterType) | Executing geoprocessing tools in the background (Code Files: RunGPForm) | Dynamic display—tracking dynamic object (Code Files: TrackObject) | Simple dynamic display application (Code Files: MyDynamicLayer) | Move a graphic along a path in ArcMap (Code Files: MapGraphicKeyframe) | Print multiple pages (Code Files: PrintMultiPagesVB_NET_Addin) | Custom scene navigation commands (Code Files: Fly ZoomIn ZoomOut) | Building a MapViewer application using the ArcGIS Engine controls (Code Files: MapViewer) | Enable layer drag and drop in the TOCControl (Code Files: LayerDragDrop) | RSS weather layer (Code Files: AddRSSWeatherLayer RSSWeatherLayerClass) | Triangle graphic element (Code Files: TriangleElementClass) | Custom selection extension (Code Files: ZoomToLayerMultiItem) | Creating a zoom factor extension that works with a ToolbarControl (Code Files: ZoomIn ZoomOut) | Create a custom selection extension by extending ArcObjects (Code Files: ZoomToLayerMultiItem) | Add map surrounds using the SymbologyControl (Code Files: NorthArrows ScaleBars ScaleText) | Update a legend format with SymbologyControl area and line patches (Code Files: AreaLinePatches) | Draw text on a MapControl (Code Files: DrawText) | Time Series Graph tool add-in (Code Files: TimeSeriesGraph)

.NET Related Topics

3DAnalystUI | Building a map viewing application using the ArcGIS Engine controls | Cartographic representations | CatalogUI | Checking for topology error features in a geodatabase topology | Creating a plug-in data source | Creating a TIN | Creating a topology in the geodatabase | DataSourcesRaster | Developing SOAP server object extensions | GeoAnalyst | Geodatabase | Geometry service | Getting started with dynamic display | How to create a sketch operation | How to create an image server layer | How to create dynamic menu commands using a MultiItem | How to erase a portion of a geodatabase raster dataset | How to find the combined extent of two geometries | How to implement error handling | How to perform a geodata transformation on a raster | How to perform an affine transformation | How to perform surface analysis on a terrain dataset | How to set raster properties when saving as a raster | How to split a raster dataset into multiple tiles | How to zoom to a layer in globe | How to zoom to selected features in globe | Listening to the OnValidate event for a geodatabase topology | Location | Performing basic map functions | Performing map selection | Querying geodatabase tables | Using ArcObjects (COM-based) in .NET | Working with map surrounds | Working with the analysis environment | Working with the edit sketch | Working with topologically related features