Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

MapLine.StartLineCap Property

Returns MapLine start cap settings.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.2.dll

NuGet Package: DevExpress.Win.Map

#Declaration

public MapLineCap StartLineCap { get; }

#Property Value

Type Description
MapLineCap

Contains MapLine start cap settings.

#Remarks

Use the StartLineCap property to display a shape at the beginning of a map line. The default cap shape is an arrow. Set the Visible property to true to display the arrow:

MapLine line = new MapLine() { Point1 = new GeoPoint(-3, -10),
                               Point2 = new GeoPoint(0, 0), 
                               StrokeWidth = 2, 
                               Stroke = System.Drawing.Color.Blue };
mapItemStorage1.Items.Add(line);                              
line.StartLineCap.Visible = true;

Result:

Map Line Cap

To display a custom shape, set the MapLineCap.Template property to a MapUnit array that defines a cap template.

Use the MapLineCap.Width and MapLineCap.Length properties to specify dimensions of the default arrow or a custom shape.

The following example defines the start cap template and its dimensions:

MapLine line = new MapLine() { Point1 = new GeoPoint(-3, -10),
                               Point2 = new GeoPoint(0, 0), 
                               StrokeWidth = 2, 
                               Stroke = System.Drawing.Color.Blue };
mapItemStorage1.Items.Add(line);                               
line.StartLineCap.Visible = true;
line.StartLineCap.Length = 30;
line.StartLineCap.Width = 22;
line.StartLineCap.Template = new MapUnit[] { new MapUnit(0, 0),
                                           new MapUnit(-0.5, -0.5),
                                           new MapUnit(0.25, 0),
                                           new MapUnit(-0.5, 0.5),
                                           new MapUnit(0, 0),
};

Result:

Map Line Cap template

The MapLineCap.IsFilled property specifies whether the cap shape is filled:

line.StartLineCap.IsFilled = false;

Map Line Cap IsFilled property is false

When map lines are created based on data source values, use the following API members to map data source fields to start cap properties:

For more examples on MapLine cap property mappings, see the demo:

Run Demo: Map Arrows

See Also