ElementSelectionMode Enum

Lists selection modes available for the end-user.

Namespace: DevExpress.XtraTreeMap

Assembly: DevExpress.XtraTreeMap.v18.1.dll

Declaration

C#

public enum ElementSelectionMode

VB.NET

Public Enum ElementSelectionMode

Members

Name	Description
None	Selection is disabled.
Single	One tree map item can be selected at a time.
Multiple	Several tree map items can be selected at the same time.
Extended	Extended single selection mode, allowing you to select several items with the SHIFT key held down.

Related API Members

The following properties accept/return ElementSelectionMode values:

• TreeMapControl.SelectionMode

Remarks

Values of this enumeration are used to specify the TreeMapControl.SelectionMode property.

Example

To specify end-user permissions, use the TreeMapControl.EnableHighlighting and TreeMapControl.SelectionMode properties.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-configure-the-tree-map-item-highlighting-and-selection-t361896

Form1.cs

using DevExpress.XtraTreeMap;
using System;
using System.Windows.Forms;

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

        private void Form1_Load(object sender, EventArgs e) {
            chkEnableHighlighting.Checked = treeMap.EnableHighlighting;

            lbSelectionMode.DataSource = Enum.GetValues(typeof(ElementSelectionMode));
            lbSelectionMode.SelectedValue = treeMap.SelectionMode;
        }

        private void chkEnableHighlighting_CheckedChanged(object sender, EventArgs e) {
            treeMap.EnableHighlighting = chkEnableHighlighting.Checked;
        }

        private void lbSelectionMode_SelectedIndexChanged(object sender, EventArgs e) {
            treeMap.SelectionMode = (ElementSelectionMode)lbSelectionMode.SelectedValue;
        }
    }
}

Program.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace HighlightingAndSelection {
    static class Program {
        /// <summary>
        /// The main entry point for the application.
        /// </summary>
        [STAThread]
        static void Main() {
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
            Application.Run(new Form1());
        }
    }
}

Form1.vb

Imports DevExpress.XtraTreeMap
Imports System
Imports System.Windows.Forms

Namespace HighlightingAndSelection
    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
            chkEnableHighlighting.Checked = treeMap.EnableHighlighting

            lbSelectionMode.DataSource = System.Enum.GetValues(GetType(ElementSelectionMode))
            lbSelectionMode.SelectedValue = treeMap.SelectionMode
        End Sub

        Private Sub chkEnableHighlighting_CheckedChanged(ByVal sender As Object, ByVal e As EventArgs) Handles chkEnableHighlighting.CheckedChanged
            treeMap.EnableHighlighting = chkEnableHighlighting.Checked
        End Sub

        Private Sub lbSelectionMode_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs) Handles lbSelectionMode.SelectedIndexChanged
            treeMap.SelectionMode = CType(lbSelectionMode.SelectedValue, ElementSelectionMode)
        End Sub
    End Class
End Namespace

Program.vb

Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Threading.Tasks
Imports System.Windows.Forms

Namespace HighlightingAndSelection
    Friend NotInheritable Class Program

        Private Sub New()
        End Sub

        ''' <summary>
        ''' The main entry point for the application.
        ''' </summary>
        <STAThread> _
        Shared Sub Main()
            Application.EnableVisualStyles()
            Application.SetCompatibleTextRenderingDefault(False)
            Application.Run(New Form1())
        End Sub
    End Class
End Namespace

Related GitHub Examples

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

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-configure-the-tree-map-item-highlighting-and-selection-t361896/CS/HighlightingAndSelection/Form1.cs#L14

lbSelectionMode.DataSource = Enum.GetValues(typeof(ElementSelectionMode));
lbSelectionMode.SelectedValue = treeMap.SelectionMode;

VB.NET

how-to-configure-the-tree-map-item-highlighting-and-selection-t361896/VB/HighlightingAndSelection/Form1.vb#L16

lbSelectionMode.DataSource = System.Enum.GetValues(GetType(ElementSelectionMode))
lbSelectionMode.SelectedValue = treeMap.SelectionMode