Expand(Double,Double,Double,Boolean) Method

Moves the X and Y coordinates of the EnvelopeBuilder sides toward or away from each other to scale the size of the Envelope. This method must be called on the MCT. Use QueuedTask.Run

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
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.InvalidOperationException	This geometry is not Z-Aware.

Remarks

If asRatio = FALSE, the expansion is additive.
XMin = XMin - dx
YMin = YMin - dy
XMax = XMax + dx
YMax = YMax + dy

If asRatio = TRUE, the expansion is multiplicative. If the user wants to increase the envelope width by 10%, then dx = 1.1. On the other hand, if the user intends to decrease the width by 10%, then dx = 0.9. No negative number allowed when asRatio is set to TRUE.
XMin = XMin - (dx-1)*Width/2
YMin = YMin - (dy-1)*Height/2
XMax = XMax + (dx-1)*Width/2
YMax = YMax + (dy-1)*Height/2
The Envelope remains centered at the same position.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 7

Reference

EnvelopeBuilder Class
EnvelopeBuilder Members
Overload List