MapPolylineBase.StartLineCap Property

Returns start cap settings.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.1.dll

NuGet Package: DevExpress.Win.Map

Declaration

C#

public MapLineCap StartLineCap { get; }

VB.NET

Public ReadOnly Property StartLineCap As MapLineCap

Property Value

Type	Description
MapLineCap	Contains start cap settings.

Remarks

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

C#

MapSpline spline = new MapSpline() { StrokeWidth = 2, Stroke = System.Drawing.Color.Blue };
spline.Points.AddRange(new GeoPoint[] {
                          new GeoPoint(-6, -4),
                          new GeoPoint(-3, -10),
                          new GeoPoint(-6, -20) });
mapItemStorage1.Items.Add(spline);

MapPolyline polyLine = new MapPolyline() { StrokeWidth = 2, Stroke = System.Drawing.Color.Blue };
polyLine.Points.AddRange(new GeoPoint[] {
                         new GeoPoint(-11, -4),
                         new GeoPoint(-8, -10),
                         new GeoPoint(-11, -20) });
mapItemStorage1.Items.Add(polyLine);

spline.StartLineCap.Visible = true;
polyLine.StartLineCap.Visible = true;

VB.NET

Dim spline As MapSpline = New MapSpline() With {
        .StrokeWidth = 2,
        .Stroke = Drawing.Color.Blue
}
spline.Points.AddRange(New GeoPoint() {New GeoPoint(-6, -4), 
                                       New GeoPoint(-3, -10), 
                                       New GeoPoint(-6, -20)})
mapItemStorage1.Items.Add(spline)

Dim polyLine As MapPolyline = New MapPolyline() With {
        .StrokeWidth = 2,
        .Stroke = Drawing.Color.Blue
}
polyLine.Points.AddRange(New GeoPoint() {New GeoPoint(-11, -4), 
                                         New GeoPoint(-8, -10), 
                                         New GeoPoint(-11, -20)})
mapItemStorage1.Items.Add(polyLine)

spline.StartLineCap.Visible = True
polyLine.StartLineCap.Visible = True

Result:

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 code defines the start cap template and its dimensions:

C#

MapUnit[] template = new MapUnit[] {new MapUnit(0, 0),
                                    new MapUnit(-0.5, -0.5),
                                    new MapUnit(0.45, 0),
                                    new MapUnit(-0.5, 0.5),
                                    new MapUnit(0, 0)};
spline.StartLineCap.Template = template;
polyLine.StartLineCap.Template = template;

spline.StartLineCap.Length = 20;
spline.StartLineCap.Width = 20;

polyLine.StartLineCap.Length = 35;
polyLine.StartLineCap.Width = 22;

VB.NET

Dim template As MapUnit() = New MapUnit() {New MapUnit(0, 0), 
                                           New MapUnit(-0.5, -0.5),
                                           New MapUnit(0.45, 0),
                                           New MapUnit(-0.5, 0.5),
                                           New MapUnit(0, 0)}

spline.StartLineCap.Template = template
polyLine.StartLineCap.Template = template

spline.StartLineCap.Length = 20
spline.StartLineCap.Width = 20

polyLine.StartLineCap.Length = 35
polyLine.StartLineCap.Width = 22

Result:

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

C#

spline.StartLineCap.IsFilled = false;
polyLine.StartLineCap.IsFilled = false;

VB.NET

spline.EndLineCap.IsFilled = False
polyLine.EndLineCap.IsFilled = False