ArcObjects Library Reference (Geometry)  

IPolygon2.GetOutermostComponents Method

Populates an array with polygons that represent outermost components of the original and all components within (islands within lakes). The rings of the output polygons are references to rings in the original.

[Visual Basic .NET]
Public Sub GetOutermostComponents ( _
    ByVal numComponentsRequested As Integer, _
    ByRef numComponentsReturned As Integer, _
    ByRef components As IPolygon, _
    ByRef moreComponentsExist As Boolean _
)
[C#]
public void GetOutermostComponents (
    int numComponentsRequested,
    ref int numComponentsReturned,
    ref IPolygon components,
    ref bool moreComponentsExist
);
[C++]
HRESULT GetOutermostComponents(
  long numComponentsRequested,
  long* numComponentsReturned,
  IPolygon** components,
  VARIANT_BOOL* moreComponentsExist
);
[C++]

Parameters

numComponentsRequested   numComponentsRequested is a parameter of type long numComponentsReturned [out]   numComponentsReturned is a parameter of type long components [out]

  components is a parameter of type IPolygon

moreComponentsExist [out]   moreComponentsExist is a parameter of type VARIANT_BOOL

Product Availability

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

Remarks

The method returns an error in the following cases:

1. Number of components requested is smaller than 0

2. If the array is not dimensionned

3. If the polygon is not simple

[C#]

Does not work in .NET. Use IPolygon4.get_OutermostComponentBag instead.

See Also

IPolygon2 Interface