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.

Description

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.

Members

Description
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.
[C#]

        //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

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

.NET Samples

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

.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 | DefenseSolutions | 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 | SOAP Web services | 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 |