MapPolyline Class

The class used to draw a polyline on a map.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v18.2.dll

Declaration

C#

public class MapPolyline :
    MapShape,
    IPointContainerCore,
    ISupportCoordPoints,
    ISupportIntermediatePoints,
    IEditableItem

VB.NET

Public Class MapPolyline
    Inherits MapShape
    Implements IPointContainerCore,
               ISupportCoordPoints,
               ISupportIntermediatePoints,
               IEditableItem

Related API Members

The following members return MapPolyline objects:

• MapHitInfo.MapPolyline

Remarks

The following image shows an example of a map polyline object.

Note that, a map shape should fulfill the following condition to cross the 180th meridian: one or several points’ longitudes should exceed the 180 (-180) limit:

C#

MapPolygon polygon = new MapPolygon();
polygon.Points.Add(new GeoPoint(10, -170));
polygon.Points.Add(new GeoPoint(10, 170));
polygon.Points.Add(new GeoPoint(-10, 170));
polygon.Points.Add(new GeoPoint(-10, -170));
vectorItemStorage.Items.Add(polygon);

// Point longitudes enclose the 180 meridian.
MapPolygon polygonCross180 = New MapPolygon();
polygonCross180.Fill = Color.Orange;
polygonCross180.Points.Add(new GeoPoint(30, 190));
polygonCross180.Points.Add(new GeoPoint(30, 170));
polygonCross180.Points.Add(new GeoPoint(20, 170));
polygonCross180.Points.Add(new GeoPoint(20, 190));
vectorItemStorage.Items.Add(polygon180);

VB.NET

Dim polygon = New MapPolygon
polygon.Points.Add(New GeoPoint(10, -170))
polygon.Points.Add(New GeoPoint(10, 170))
polygon.Points.Add(New GeoPoint(-10, 170))
polygon.Points.Add(New GeoPoint(-10, -170))
vectorItemStorage.Items.Add(polygon)

' Point longitudes enclose the 180 meridian.
Dim polygonCross180 = New MapPolygon
polygonCross180.Fill = Color.Orange
polygonCross180.Points.Add(New GeoPoint(30, 190))
polygonCross180.Points.Add(New GeoPoint(30, 170))
polygonCross180.Points.Add(New GeoPoint(20, 170))
polygonCross180.Points.Add(New GeoPoint(20, 190))
vectorItemStorage.Items.Add(polygonCross180)

The code above produces the following image:

Example

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-different-map-shapes-t139819

Form1.cs

var polyline = new MapPolyline() { StrokeWidth = 4, Stroke = Color.Yellow };
polyline.Points.AddRange(new GeoPoint[] {
    new GeoPoint(-29,130),
    new GeoPoint(-40,140),
    new GeoPoint(-20,150)
});
ItemStorage.Items.Add(polyline);

Form1.vb

Dim polyline = New MapPolyline() With {.StrokeWidth = 4, .Stroke = Color.Yellow}
polyline.Points.AddRange(New GeoPoint() { _
    New GeoPoint(-29,130), _
    New GeoPoint(-40,140), _
    New GeoPoint(-20,150) _
})
ItemStorage.Items.Add(polyline)

Implements

IColorizerElement

IEditableItem

Inheritance

Object

MapItem

MapShape

MapPolyline