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


IEnvelope.ExpandZ Method (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geometry > ESRI.ArcGIS.Geometry > Interfaces > IE > IEnvelope Interface > IEnvelope.ExpandZ Method
ArcGIS Developer Help

IEnvelope.ExpandZ Method

Moves the Z attribute of the sides toward or away from each other.

[Visual Basic .NET]
Public Sub ExpandZ ( _
    ByVal dz As Double, _
    ByVal asRatio As Boolean _
)
[C#]
public void ExpandZ (
    double dz,
    bool asRatio
);
[C++]
HRESULT ExpandZ(
  double dz,
  VARIANT_BOOL asRatio
);
[C++]
Parameters
dz 

dz is a parameter of type double asRatio
asRatio is a parameter of type bool

Product Availability

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

Description

ExpandZ scales the Z attributes of the Envelope.  If asRatio = FALSE, the scaling is additive (ZMin = ZMin - dz, ZMax = ZMax + dz).  If asRatio = TRUE, the scaling is multiplicative (ZMin = ZMin - dz*Depth/2, ZMax = ZMax + dz*Depth/2)

[C#]

 

        public static void TestExpandZ()

        {

            const double ScaleFactor = 1.986;

 

            IEnvelope2 envelope = GetEnvelopeGeometry() as IEnvelope2;

 

            double beforeXMin, beforeXMax, beforeYMin, beforeYMax;

            envelope.QueryCoords(out beforeXMin, out beforeYMin, out beforeXMax, out beforeYMax);

 

            double beforeZMin, beforeZMax;

            envelope.QueryZCoords(out beforeZMin, out beforeZMax);

 

            envelope.ExpandZ(ScaleFactor, true);

 

            double afterXMin, afterXMax, afterYMin, afterYMax;

            envelope.QueryCoords(out afterXMin, out afterYMin, out afterXMax, out afterYMax);

 

            double afterZMin, afterZMax;

            envelope.QueryZCoords(out afterZMin, out afterZMax);

 

            //beforeXMin = -8.604

            //beforeXMax = 1.396

            //beforeYMin = -12.117

            //beforeYMax = -2.117

            //beforeZMin = -12.902

            //beforeZMax = -2.902

 

            //afterXMin = -8.604

            //afterXMax = 1.396

            //afterYMin = -12.117

            //afterYMax = -2.117

            //afterZMin = -17.829

            //afterZMax = 2.026

        }

 

See Also

IEnvelope Interface