Expand(Double,Double,Double,Boolean) Method

Moves the X, Y and Z coordinates of the envelope sides toward or away from each other to scale the size of the envelope.

Syntax

C#
Visual Basic (Declaration)

public void Expand( 
   double dx,
   double dy,
   double dz,
   bool asRatio
)

Public Overloads Sub Expand( _
   ByVal dx As Double, _
   ByVal dy As Double, _
   ByVal dz As Double, _
   ByVal asRatio As Boolean _
)

Parameters

dx: Change in x
dy: Change in y
dz: Change in z
asRatio: If asRatio = true, the expansion is multiplicative. If false, the expansion is additive.

Exceptions

Exception	Description
System.InvalidOperationException	This geometry is not Z-Aware.
GeometryObjectException	ZMin or ZMax is NaN.

Remarks

If asRatio = false, the expansion is additive. If you want to increase the envelope width by 5 units, then dx = 5. On the other hand, if you want to decrease the envelope width by 5 units, then dx = -5. Similarly, set dy to increase or decrease the envelope height and dz to increase or decrease the envelope depth.

If asRatio = true, the expansion is multiplicative. If you want to increase the envelope width by 10%, then dx = 1.1. On the other hand, if you want to decrease the width by 10%, then dx = 0.9. Similarly, set dy to increase or decrease the envelope height and dz to increase or decrease the envelope depth. No negative numbers are allowed when asRatio is set to true.

The Envelope remains centered at the same position.

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

EnvelopeBuilderEx Class
EnvelopeBuilderEx Members
Overload List