PieSegment Class

A segment of a pie chart item.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v18.1.dll

Declaration

C#

public class PieSegment :
    MapSegmentBase,
    ILocatableRenderItem,
    IMapChartDataItem,
    IMapDataItem,
    IKeyColorizerElement,
    IColorizerElement,
    IInteractiveElementProvider,
    ISupportToolTip,
    IHitTestableElement,
    IMapItemAttributeOwner

VB.NET

Public Class PieSegment
    Inherits MapSegmentBase
    Implements ILocatableRenderItem,
               IMapChartDataItem,
               IMapDataItem,
               IKeyColorizerElement,
               IColorizerElement,
               IInteractiveElementProvider,
               ISupportToolTip,
               IHitTestableElement,
               IMapItemAttributeOwner

Related API Members

The following members accept/return PieSegment objects:

• MapHitInfo.PieSegment

Remarks

Instances of the PieSegment class are stored in the PieSegmentCollection returned by the MapPie.Segments property.

Example

The following example illustrates how to manually add a MapPie object to the Map control.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-manually-add-mappie-items-to-the-map-t116241

Form1.cs

using System;
using System.Drawing;
using System.Windows.Forms;
using DevExpress.XtraMap;

namespace MapPieItem {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e) {
            // Create a layer to show vector items.
            VectorItemsLayer itemsLayer = new VectorItemsLayer() {
                Data = CreateData(),
                Colorizer = CreateColorizer()
            };
            mapControl1.Layers.Add(itemsLayer);

            // Show a color legend.
            mapControl1.Legends.Add(new ColorListLegend() { Layer = itemsLayer });
        }


        // Create a storage to provide data for the vector layer.
        private IMapDataAdapter CreateData() {
            MapItemStorage storage = new MapItemStorage();

            // Create a pie with several segments.
            MapPie pie = new MapPie();
            pie.Size = 200;
            pie.Segments.Add(new PieSegment() { Argument = "A", Value = 100 });
            pie.Segments.Add(new PieSegment() { Argument = "B", Value = 50 });
            pie.Segments.Add(new PieSegment() { Argument = "C", Value = 120 });
            storage.Items.Add(pie);

            return storage;
        }

        // Create a colorizer to provide colors for bubble items.    
        private MapColorizer CreateColorizer() {
            KeyColorColorizer colorizer = new KeyColorColorizer();

            // Add colors to the colorizer.
            colorizer.Colors.Add(Color.Coral);
            colorizer.Colors.Add(Color.Orange);
            colorizer.Colors.Add(Color.LightBlue);

            colorizer.Keys.Add(new ColorizerKeyItem() { Key = "A", Name = "Category A" });
            colorizer.Keys.Add(new ColorizerKeyItem() { Key = "B", Name = "Category B" });
            colorizer.Keys.Add(new ColorizerKeyItem() { Key = "C", Name = "Category C" });

            // Load color indexes from bubbles via the 'Color' attribute
            colorizer.ItemKeyProvider = new ArgumentItemKeyProvider();

            return colorizer;
        }
    }

}

Form1.vb

Imports System
Imports System.Drawing
Imports System.Windows.Forms
Imports DevExpress.XtraMap

Namespace MapPieItem
    Partial Public Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
            ' Create a layer to show vector items.
            Dim itemsLayer As New VectorItemsLayer() With {.Data = CreateData(), .Colorizer = CreateColorizer()}
            mapControl1.Layers.Add(itemsLayer)

            ' Show a color legend.
            mapControl1.Legends.Add(New ColorListLegend() With {.Layer = itemsLayer})
        End Sub


        ' Create a storage to provide data for the vector layer.
        Private Function CreateData() As IMapDataAdapter
            Dim storage As New MapItemStorage()

            ' Create a pie with several segments.
            Dim pie As New MapPie()
            pie.Size = 200
            pie.Segments.Add(New PieSegment() With {.Argument = "A", .Value = 100})
            pie.Segments.Add(New PieSegment() With {.Argument = "B", .Value = 50})
            pie.Segments.Add(New PieSegment() With {.Argument = "C", .Value = 120})
            storage.Items.Add(pie)

            Return storage
        End Function

        ' Create a colorizer to provide colors for bubble items.    
        Private Function CreateColorizer() As MapColorizer
            Dim colorizer As New KeyColorColorizer()

            ' Add colors to the colorizer.
            colorizer.Colors.Add(Color.Coral)
            colorizer.Colors.Add(Color.Orange)
            colorizer.Colors.Add(Color.LightBlue)

            colorizer.Keys.Add(New ColorizerKeyItem() With {.Key = "A", .Name = "Category A"})
            colorizer.Keys.Add(New ColorizerKeyItem() With {.Key = "B", .Name = "Category B"})
            colorizer.Keys.Add(New ColorizerKeyItem() With {.Key = "C", .Name = "Category C"})

            ' Load color indexes from bubbles via the 'Color' attribute
            colorizer.ItemKeyProvider = New ArgumentItemKeyProvider()

            Return colorizer
        End Function
    End Class

End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the PieSegment class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-different-map-shapes-t139819/CS/MapItemsExample/Form1.cs#L90

var pie = new MapPie() { Location = new GeoPoint(-20, -30), Size = 100 };
pie.Segments.AddRange(new PieSegment[] {
    new PieSegment(){ Argument = "A", Value = 2},

how-to-customize-map-pie-parameters-t202713/CS/MapPieExample/Form1.cs#L19

};
pie.Segments.Add(new PieSegment() { Argument = NextLetter(), Value = defaultValue });
pie.Segments.Add(new PieSegment() { Argument = NextLetter(), Value = defaultValue });

how-to-manually-add-mappie-items-to-the-map-t116241/CS/MapPieItem/Form1.cs#L32

pie.Size = 200;
pie.Segments.Add(new PieSegment() { Argument = "A", Value = 100 });
pie.Segments.Add(new PieSegment() { Argument = "B", Value = 50 });

VB.NET

how-to-create-different-map-shapes-t139819/VB/MapItemsExample/Form1.vb#L102

Dim pie = New MapPie() With {.Location = New GeoPoint(-20, -30), .Size = 100}
pie.Segments.AddRange(New PieSegment() { _
    New PieSegment() With {.Argument = "A", .Value = 2}, _

how-to-customize-map-pie-parameters-t202713/VB/MapPieExample/Form1.vb#L17

pie = New MapPie() With {.Location = New GeoPoint(51.507222, -0.1275), .Size = 100, .Argument = "pie"}
pie.Segments.Add(New PieSegment() With {.Argument = NextLetter(), .Value = defaultValue})
pie.Segments.Add(New PieSegment() With {.Argument = NextLetter(), .Value = defaultValue})

how-to-manually-add-mappie-items-to-the-map-t116241/VB/MapPieItem/Form1.vb#L31

pie.Size = 200
pie.Segments.Add(New PieSegment() With {.Argument = "A", .Value = 100})
pie.Segments.Add(New PieSegment() With {.Argument = "B", .Value = 50})

Implements

IColorizerElement

Inheritance

Object

MapSegmentBase

PieSegment