MapItemAttribute Class

An attribute that can be applied to map items.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v18.1.dll

Declaration

C#

public class MapItemAttribute :
    IMapItemAttribute,
    ISupportObjectChanged

VB.NET

Public Class MapItemAttribute
    Implements IMapItemAttribute,
               ISupportObjectChanged

Remarks

For more information, see Provide Data Using Vector Item Attributes.

Example

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-color-manually-added-shapes-using-the-choropleth-colorizer-e4744

Form1.cs

private MapPolygon CreatePolygon(double areaValue, string polygonName, GeoPoint[] points) {
    MapPolygon item = new MapPolygon();

    item.Attributes.Add(new MapItemAttribute() {
        Name = areaValueAttrName,
        Type = typeof(double),
        Value = areaValue
    });
    item.Attributes.Add(new MapItemAttribute() {
        Name = polygonNameAttrName,
        Type = typeof(string),
        Value = polygonName
    });

    item.ToolTipPattern = "{" + polygonNameAttrName + "}=<b>{" + areaValueAttrName + "}</b>";

    foreach (GeoPoint point in points) {
        item.Points.Add(point);
    }

    return item;
}

Form1.vb

Private Function CreatePolygon(ByVal areaValue As Double, ByVal polygonName As String, ByVal points() As GeoPoint) As MapPolygon
    Dim item As New MapPolygon()

    item.Attributes.Add(New MapItemAttribute() With {.Name = areaValueAttrName, .Type = GetType(Double), .Value = areaValue})
    item.Attributes.Add(New MapItemAttribute() With {.Name = polygonNameAttrName, .Type = GetType(String), .Value = polygonName})

    item.ToolTipPattern = "{" & polygonNameAttrName & "}=<b>{" & areaValueAttrName & "}</b>"

    For Each point As GeoPoint In points
        item.Points.Add(point)
    Next point

    Return item
End Function

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the MapItemAttribute 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#

vote-app-t445500/CS/VoteApp/MapColorizer.cs#L17

if(attributes == null) return null;
var postalAttr = attributes["STUSPS"];
if(postalAttr != null) {

vote-applications-t446758/CS/VoteApp/MapColorizer.cs#L17

if(attributes == null) return null;
var postalAttr = attributes["STUSPS"];
if(postalAttr != null) {

how-to-color-manually-added-shapes-using-the-choropleth-colorizer-e4744/CS/Manual Colorization/Form1.cs#L71

item.Attributes.Add(new MapItemAttribute() {
    Name = areaValueAttrName,

how-to-customize-the-appearance-of-a-map-shape-title-e5184/CS/CustomizeShapeTitle/Form1.cs#L71

};
capital.Attributes.Add(new MapItemAttribute()
    { Name = "CityName", Type = typeof(string), Value = name });

how-to-implement-a-custom-colorizer-e4753/CS/CustomColorizer/Form1.cs#L63

item.Attributes.Add(new MapItemAttribute() { Name = powerAttrName, Type = typeof(Double), Value = power });

VB.NET

how-to-color-manually-added-shapes-using-the-choropleth-colorizer-e4744/VB/Manual Colorization/Form1.vb#L68

item.Attributes.Add(New MapItemAttribute() With {.Name = areaValueAttrName, .Type = GetType(Double), .Value = areaValue})
item.Attributes.Add(New MapItemAttribute() With {.Name = polygonNameAttrName, .Type = GetType(String), .Value = polygonName})

how-to-customize-the-appearance-of-a-map-shape-title-e5184/VB/CustomizeShapeTitle/Form1.vb#L49

Dim capital As New MapDot() With {.Location = New GeoPoint(latitude, longitude), .Size = 20}
capital.Attributes.Add(New MapItemAttribute() With {.Name = "CityName", .Type = GetType(String), .Value = name_Renamed})
capital.Attributes.Add(New MapItemAttribute() With {.Name = "Population", .Type = GetType(UInteger), .Value = population})

how-to-implement-a-custom-colorizer-e4753/VB/CustomColorizer/Form1.vb#L60

item.Attributes.Add(New MapItemAttribute() With {.Name = powerAttrName, .Type = GetType(Double), .Value = power})

how-to-customize-shape-title-options-t202086/VB/ShapeTitleOptions/Form1.vb#L25

dot.Attributes.Add(New MapItemAttribute() With {.Name = "Title", .Value = "Hello," & ControlChars.Lf & "I am Dot."})
storage.Items.Add(dot)

Inheritance

Object

MapItemAttribute