New to Telerik UI for WPFStart a free 30-day trial

Default cluster items generator. Group data items using distance between 2 locations in degrees.

Definition

Namespace:Telerik.Windows.Controls.Map

Assembly:Telerik.Windows.Controls.DataVisualization.dll

Syntax:

C#
public class ClusterItemGenerator : IClusterItemGenerator

Inheritance: objectClusterItemGenerator

Implements: IClusterItemGenerator

Constructors

Initializes a new instance of the ClusterItemGenerator class.

C#
public ClusterItemGenerator()

Properties

Gets or sets value which indicates whether cluster should be automatically expanded when it contains 1 data item only.

C#
public bool AutoExpandWhenSingle { get; set; }

Gets or sets array of the doubles which define close distance between 2 locations in degrees for every zoom level.

C#
public double[] CloseDistance { get; set; }
Remarks:

If distance between 2 locations for the given zoom level is less than value in the array, then we consider these 2 locations as close ones. Close locations should be combined into 1 cluster.

Gets the value mappings that constitute the data mappings for a layer.

C#
public DataMappingCollection DataMappings { get; }

Gets or sets value which indicates whether cluster should be deleted if it is empty.

C#
public bool DeleteWhenEmpty { get; set; }

Gets or sets radius (in pixels) which will be used to calculate coordinates of the items when cluster is expanded to the polygon vertices.

C#
public double ExpandRadius { get; set; }

Indicates whether expanded cluster should be hidden.

C#
public bool HideExpanded { get; set; }

Methods

Creates cluster at the specified location.

C#
public virtual ClusterItem CreateCluster(Location center, object item)
Parameters:centerLocation

Center of the cluster.

itemobject

Data item which initialized creation of the cluster.

Returns:

ClusterItem

New cluster item.

Implements: IClusterItemGenerator.CreateCluster(Location, object)

Gets binding for location property.

C#
public virtual Binding GetBindingForLocation(object dataItem)
Parameters:dataItemobject

Data item to which is binding source.

Returns:

Binding

Binding to location property.

Implements: IClusterItemGenerator.GetBindingForLocation(object)

Gets location from the data item.

C#
public virtual Location GetLocationFromItem(object dataItem)
Parameters:dataItemobject

Data item to get location from.

Returns:

Location

Location of the data item.

Implements: IClusterItemGenerator.GetLocationFromItem(object)

Detects whether given original data item belongs to the region of the specified cluster.

C#
public virtual bool IsItemInClusterRegion(ClusterItem cluster, object dataItem, int zoomLevel)
Parameters:clusterClusterItem

Cluster.

dataItemobject

Data item.

zoomLevelint

Zoom level.

Returns:

bool

true - if data item belongs to the region of the specified cluster.

Implements: IClusterItemGenerator.IsItemInClusterRegion(ClusterItem, object, int)