Interface IPolygon4
Provides access to members that extend the IPolygon3 interface.
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
[Guid("5AF81EB6-5616-49A0-B0A6-E265803E4BD2")]
public interface IPolygon4 : IPolygon3, IPolygon2, IPolygon, IPolycurve, ICurve, IGeometry
Properties
ConnectedComponentBag
Creates and returns a geometry bag containing polygons that represent connected components of the original. The rings of the output polygons are references to rings in the original.
IGeometryBag ConnectedComponentBag { get; }
Property Value
Dimension
esriGeometryDimension Dimension { get; }
Property Value
Envelope
IEnvelope Envelope { get; }
Property Value
ExteriorRingBag
Creates and returns a geometry bag that contains references to all exterior rings.
IGeometryBag ExteriorRingBag { get; }
Property Value
ExteriorRingCount
int ExteriorRingCount { get; }
Property Value
FromPoint
IPoint FromPoint { get; set; }
Property Value
GeometryType
esriGeometryType GeometryType { get; }
Property Value
InteriorRingBag[IRing]
Creates and returns a geometry bag that contains references to all rings that are interior to the specified exterior ring.
IGeometryBag InteriorRingBag[IRing exteriorRing] { get; }
Parameters
exteriorRingIRing
Property Value
InteriorRingCount[IRing]
int InteriorRingCount[IRing exteriorRing] { get; }
Parameters
exteriorRingIRing
Property Value
IsClosed
bool IsClosed { get; }
Property Value
IsEmpty
bool IsEmpty { get; }
Property Value
Length
double Length { get; }
Property Value
OutermostComponentBag
Creates and returns a geometry bag containing 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.
IGeometryBag OutermostComponentBag { get; }
Property Value
SpatialReference
ISpatialReference SpatialReference { get; set; }
Property Value
ToPoint
IPoint ToPoint { get; set; }
Property Value
Methods
Close()
void Close()
Densify(double, double)
void Densify(double maxSegmentLength, double maxDeviation)
Parameters
FindExteriorRing(IRing)
IRing FindExteriorRing(IRing interiorRing)
Parameters
interiorRingIRing
Returns
Generalize(double)
void Generalize(double maxAllowableOffset)
Parameters
maxAllowableOffsetdouble
GeoNormalize()
void GeoNormalize()
GeoNormalizeFromLongitude(double)
void GeoNormalizeFromLongitude(double Longitude)
Parameters
Longitudedouble
GetConnectedComponents(int, out IPolygon)
void GetConnectedComponents(int numComponentsRequested, out IPolygon components)
Parameters
GetConnectedComponents2(out IPolygon[])
void GetConnectedComponents2(out IPolygon[] components)
Parameters
componentsIPolygon[]
GetOutermostComponents(int, out int, out IPolygon, out bool)
void GetOutermostComponents(int numComponentsRequested, out int numComponentsReturned, out IPolygon components, out bool moreComponentsExist)
Parameters
GetOutermostComponents2(out IPolygon[], out bool)
void GetOutermostComponents2(out IPolygon[] components, out bool moreComponentsExist)
Parameters
GetSubcurve(double, double, bool, out ICurve)
void GetSubcurve(double fromDistance, double toDistance, bool asRatio, out ICurve outSubcurve)
Parameters
Project(ISpatialReference)
void Project(ISpatialReference newReferenceSystem)
Parameters
newReferenceSystemISpatialReference
QueryEnvelope(IEnvelope)
void QueryEnvelope(IEnvelope outEnvelope)
Parameters
outEnvelopeIEnvelope
QueryExteriorRings(ref IRing)
void QueryExteriorRings(ref IRing exteriorRings)
Parameters
exteriorRingsIRing
QueryExteriorRingsEx(int, out IRing)
void QueryExteriorRingsEx(int numExteriorRingsRequested, out IRing exteriorRings)
Parameters
QueryExteriorRingsEx2(out IRing[])
void QueryExteriorRingsEx2(out IRing[] exteriorRings)
Parameters
exteriorRingsIRing[]
QueryFromPoint(IPoint)
void QueryFromPoint(IPoint from)
Parameters
fromIPoint
QueryInteriorRings(IRing, ref IRing)
void QueryInteriorRings(IRing exteriorRing, ref IRing interiorRings)
Parameters
QueryInteriorRingsEx(IRing, int, out IRing)
void QueryInteriorRingsEx(IRing exteriorRing, int numInteriorRingsRequested, out IRing interiorRings)
Parameters
QueryInteriorRingsEx2(int, out IRing[])
void QueryInteriorRingsEx2(int exteriorRingIndex, out IRing[] interiorRings)
Parameters
QueryNormal(esriSegmentExtension, double, bool, double, ILine)
void QueryNormal(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, double Length, ILine normal)
Parameters
extensionesriSegmentExtensionDistanceAlongCurvedoubleasRatioboolLengthdoublenormalILine
QueryPoint(esriSegmentExtension, double, bool, IPoint)
void QueryPoint(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, IPoint outPoint)
Parameters
extensionesriSegmentExtensionDistanceAlongCurvedoubleasRatiobooloutPointIPoint
QueryPointAndDistance(esriSegmentExtension, IPoint, bool, IPoint, ref double, ref double, ref bool)
void QueryPointAndDistance(esriSegmentExtension extension, IPoint inPoint, bool asRatio, IPoint outPoint, ref double DistanceAlongCurve, ref double distanceFromCurve, ref bool bRightSide)
Parameters
extensionesriSegmentExtensioninPointIPointasRatiobooloutPointIPointDistanceAlongCurvedoubledistanceFromCurvedoublebRightSidebool
QueryTangent(esriSegmentExtension, double, bool, double, ILine)
void QueryTangent(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, double Length, ILine tangent)
Parameters
extensionesriSegmentExtensionDistanceAlongCurvedoubleasRatioboolLengthdoubletangentILine
QueryToPoint(IPoint)
void QueryToPoint(IPoint to)
Parameters
toIPoint
ReverseOrientation()
void ReverseOrientation()
SetEmpty()
void SetEmpty()
SimplifyEx(bool, bool, bool)
Same as ITopologicalOperator::Simplify, but with some additional options that affect performance and how the interior is classified.
void SimplifyEx(bool preserveFromToPoints, bool closeRings, bool useXORRule)
Parameters
Remarks
Parameters:
preserveFromToPoints: Boolean value that determines if the from/to points of a ring in the polygon need to remain located at ring indexes 0 and PointCount-1 af the completion of the operation. Specify 'false' to improve performance of this operation.
closeRings : Boolean value that determines if the rings of the polygon must be closed prior to reconstruct the topology of the polygon. Specify false if you know that rings are closed or you are passing in spaghetti input that should not be checked for closure.
useXORRule: Boolean value that determines how the 'inside' of the polygon is determined. Specify true to use an even-odd counting rule: a point is inside the polygon if a horizontal line through that has encountered an odd number of boundaries to the left (overlapping boundaries count 1 for each overlap). Use this when the input consists of well-defined rings that need to be oriented correctly, have overlaps removed, etc. Specify false to use the default behavior, which iterates over a two step process: dangle removal, then "peeling off" of the largest unambiguous rings. This approach can remove more segments than the XOR-true approach, but is probably more appropriate for spaghetti input where segment overlaps should not be considered significant.
Here is an example of the different between XOR=TRUE vs. XOR= FALSE:

SimplifyPreserveFromTo()
void SimplifyPreserveFromTo()
SimplifySpaghetti()
void SimplifySpaghetti()
Smooth(double)
void Smooth(double maxAllowableOffset)
Parameters
maxAllowableOffsetdouble
SnapToSpatialReference()
void SnapToSpatialReference()
SplitAtDistance(double, bool, bool, out bool, out int, out int)
void SplitAtDistance(double distance, bool asRatio, bool createPart, out bool SplitHappened, out int newPartIndex, out int newSegmentIndex)
Parameters
distancedoubleasRatioboolcreatePartboolSplitHappenedboolnewPartIndexintnewSegmentIndexint
SplitAtPoint(IPoint, bool, bool, out bool, out int, out int)
void SplitAtPoint(IPoint splitPoint, bool projectOnto, bool createPart, out bool SplitHappened, out int newPartIndex, out int newSegmentIndex)
Parameters
splitPointIPointprojectOntoboolcreatePartboolSplitHappenedboolnewPartIndexintnewSegmentIndexint
Weed(double)
void Weed(double maxAllowableOffsetFactor)
Parameters
maxAllowableOffsetFactordouble