CreatePredefinedShapeGraphic(PredefinedShape,MapPoint,Double,Double,CIMPolygonSymbol) Method

In This Topic

Create a polygon graphic of the specified PredefinedShape using the provided extent and size dimension(s), and symbol. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public CIMPolygonGraphic CreatePredefinedShapeGraphic( 
   PredefinedShape shapeType,
   MapPoint location,
   double width,
   double height,
   CIMPolygonSymbol polySymbol
)

Public Overloads Function CreatePredefinedShapeGraphic( _
   ByVal shapeType As PredefinedShape, _
   ByVal location As MapPoint, _
   ByVal width As Double, _
   Optional ByVal height As Double, _
   Optional ByVal polySymbol As CIMPolygonSymbol _
) As CIMPolygonGraphic

Parameters

shapeType: The shape type of the graphic
location: The location of the graphic
width: The width of the graphic bounding box (required)
height: The height of the graphic bounding box (optional)
polySymbol: The symbol to be used with the graphic (optional)

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentException	empty or null geometry
System.ArgumentException	width does not exceed the minimum value

Remarks

As a minimum, a width must be provided. If a height is not provided it will be assumed to be the same as the width. Negative width or height values will be treated the same as if they were missing. When generating a circle (i.e. PredefinedShape.Circle) width is used as the circle diameter and height will be ignored. When generating a semicircle or "half-circle" (i.e. PredefinedShape.HalfCircle), if a height is not provided, then it is set to be half the width. When generating an ellipse (i.e. PredefinedShape.Ellipse) width and height are assumed to be the length of the two axis - major/minor depending on which dimension is the longest. For PredefinedShape.RoundedRectangle, a default corner rounding of 20% will be applied.

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

GraphicFactory Class
GraphicFactory Members
Overload List

Send feedback