InteractiveClusterModeBase.ExpandedClusterLayout Property

Gets or sets the layout of expanded cluster items.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Map

Declaration

C#

[DefaultValue(null)]
public IExpandedClusterLayout ExpandedClusterLayout { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property ExpandedClusterLayout As IExpandedClusterLayout

Property Value

Type	Default	Description
IExpandedClusterLayout	null	An object of a class that implements the IExpandedClusterLayout interface.

Remarks

Users can hover over a cluster to expand it and see all nested map items. To enable this functionality, follow the steps below:

• Create a MouseHoverInteractiveClusterMode object and assign it to the MapControl.InteractiveClusterMode property.

• Select a layout algorithm that defines how to position nested map items when a cluster is expanded. To do this, assign one of the following objects to the InteractiveClusterModeBase.ExpandedClusterLayout property:

  • ExpandedClusterAdaptiveLayout – Items are positioned in a circle or spiral depending on the item count in the cluster.
  • ExpandedClusterCircularLayout – Items are positioned in a circle.
  • ExpandedClusterSourceLocationLayout – Items are positioned based on their source locations.
  • ExpandedClusterSpiralLayout – Items are positioned in a spiral.

  After a user moves the mouse cursor out of the cluster, clustered items are repositioned based on their actual locations. Then, clustered items are collapsed into the cluster.

The following example selects an optimal view (circular or spiral) for nested cluster items depending on their count in the cluster:

View Example

C#

MouseHoverInteractiveClusterMode interactiveMode = new MouseHoverInteractiveClusterMode();
interactiveMode.ExpandedClusterLayout = new ExpandedClusterAdaptiveLayout();
map.InteractiveClusterMode = interactiveMode;

VB.NET

Dim interactiveMode As MouseHoverInteractiveClusterMode = New MouseHoverInteractiveClusterMode()
interactiveMode.ExpandedClusterLayout = New ExpandedClusterAdaptiveLayout()
map.InteractiveClusterMode = interactiveMode

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ExpandedClusterLayout property.

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#

winforms-map-aggregate-vector-items-using-a-clusterer/CS/ClustererSample/Form1.cs#L34

MouseHoverInteractiveClusterMode interactiveMode = new MouseHoverInteractiveClusterMode();
interactiveMode.ExpandedClusterLayout = new ExpandedClusterAdaptiveLayout();
map.InteractiveClusterMode = interactiveMode;

VB.NET

winforms-map-aggregate-vector-items-using-a-clusterer/VB/ClustererSample/Form1.vb#L37

Dim interactiveMode As MouseHoverInteractiveClusterMode = New MouseHoverInteractiveClusterMode()
interactiveMode.ExpandedClusterLayout = New ExpandedClusterAdaptiveLayout()
map.InteractiveClusterMode = interactiveMode