SnapList.Separator Property

Provides access to the separator settings of a Snap list.

Namespace: DevExpress.Snap.Core.API

Assembly: DevExpress.Snap.v19.1.Core.dll

Declaration

C#

SnapDocument Separator { get; }

VB.NET

ReadOnly Property Separator As SnapDocument

Property Value

Type	Description
SnapDocument	An object implementing the SnapDocument interface.

Example

This example illustrates how to separate rows of a Snap list by using the SnapList.Separator property.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-insert-a-separator-between-rows-of-a-snap-list-t191681

Form1.cs

using System;
using System.Data;
using System.Windows.Forms;
using DevExpress.Snap.Core.API;
using DevExpress.XtraRichEdit.API.Native;
// ...
        private void Form1_Load(object sender, EventArgs e) {
            // Create a dataset and bind the Snap control to data.
            DataSet ds = new DataSet();
            DataTable dt = new DataTable("Customers");
            dt.Columns.Add("Id", typeof(int));
            dt.Columns.Add("Name", typeof(string));
            dt.Rows.Add(1, "Steven Buchanan");
            dt.Rows.Add(2, "Anne Dodsworth");
            dt.Rows.Add(3, "Janet Levering");
            ds.Tables.Add(dt);
            this.snapControl1.DataSources.Add("DS", ds);

            // Create a Snap list and populate it with the data.
            SnapList snList = this.snapControl1.Document.CreateSnList(
                this.snapControl1.Document.Range.Start, "List1");
            snList.BeginUpdate();
            snList.DataSourceName = "DS";
            snList.DataMember = "Customers";
            SnapDocument listRow = snList.RowTemplate;
            Table listRowTable = listRow.Tables.Create(listRow.Range.Start, 1, 2);
            TableCellCollection listRowCells = listRowTable.FirstRow.Cells;
            listRow.CreateSnText(listRowCells[0].ContentRange.End, @"Id");
            listRow.CreateSnText(listRowCells[1].ContentRange.End, @"Name");

            // Define a list separator and specify its format.
            snList.Separator.AppendText(new string('\f', 1));

            // Finalize the Snap list creation.
            snList.EndUpdate();
            snList.Field.Update();
        }

Form1.vb

Imports System
Imports System.Data
Imports System.Windows.Forms
Imports DevExpress.Snap.Core.API
Imports DevExpress.XtraRichEdit.API.Native
' ...
        Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
            ' Create a dataset and bind the Snap control to data.
            Dim ds As New DataSet()
            Dim dt As New DataTable("Customers")
            dt.Columns.Add("Id", GetType(Integer))
            dt.Columns.Add("Name", GetType(String))
            dt.Rows.Add(1, "Steven Buchanan")
            dt.Rows.Add(2, "Anne Dodsworth")
            dt.Rows.Add(3, "Janet Levering")
            ds.Tables.Add(dt)
            Me.snapControl1.DataSources.Add("DS", ds)

            ' Create a Snap list and populate it with the data.
            Dim snList As SnapList = Me.snapControl1.Document.CreateSnList(Me.snapControl1.Document.Range.Start, "List1")
            snList.BeginUpdate()
            snList.DataSourceName = "DS"
            snList.DataMember = "Customers"
            Dim listRow As SnapDocument = snList.RowTemplate
            Dim listRowTable As Table = listRow.Tables.Create(listRow.Range.Start, 1, 2)
            Dim listRowCells As TableCellCollection = listRowTable.FirstRow.Cells
            listRow.CreateSnText(listRowCells(0).ContentRange.End, "Id")
            listRow.CreateSnText(listRowCells(1).ContentRange.End, "Name")

            ' Define a list separator and specify its format.
            snList.Separator.AppendText(New String(ControlChars.FormFeed, 1))

            ' Finalize the Snap list creation.
            snList.EndUpdate()
            snList.Field.Update()
        End Sub