IClusterItemFactory.CustomizeCluster(MapItem) Method

Allows you to configure a cluster element before it is rendered on the map.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.1.dll

NuGet Package: DevExpress.Win.Map

Declaration

C#

void CustomizeCluster(
    MapItem cluster
)

VB.NET

Sub CustomizeCluster(
    cluster As MapItem
)

Parameters

Name	Type	Description
cluster	MapItem	A map item that denotes a cluster.

Remarks

The following example uses the CustomizeCluster method to format cluster element titles. Each cluster’s title displays the number of items that the cluster contains:

View Example: Map Control for WinForms - How to Use Clusterers to Aggregate Vector Items

C#

        clusterer.SetClusterItemFactory(new CustomClusterItemFactory());
        // ...
class CustomClusterItemFactory : IClusterItemFactory {
    public MapItem CreateClusterItem(IList<MapItem> objects) {
        return new MapDot();
    }

    public void CustomizeCluster(MapItem cluster) {
        ((MapDot)cluster).TitleOptions.Pattern = cluster.ClusteredItems.Count.ToString();
    }
}

VB.NET

        clusterer.SetClusterItemFactory(New CustomClusterItemFactory())
        ' ...
Friend Class CustomClusterItemFactory
    Implements IClusterItemFactory

    Private Function IClusterItemFactory_CreateClusterItem(objects As IList(Of MapItem)) As MapItem Implements IClusterItemFactory.CreateClusterItem
        Return New MapDot()
    End Function

    Private Sub IClusterItemFactory_CustomizeCluster(cluster As MapItem) Implements IClusterItemFactory.CustomizeCluster
        CType(cluster, MapDot).TitleOptions.Pattern = cluster.ClusteredItems.Count.ToString()
    End Sub
End Class