Version

Record Numbering (xamDataPresenter)

Topic Overview

Purpose

This topic explains the Record Numbering feature of the xamDataPresenter .

Required background

The following topics are prerequisites to understanding this topic:

Topic Purpose

This topic introduces the xamDataPresenter control and various elements, on which control is composed.

This topic provides information on how the fields are presented by the xamDataPresenter .

Introduction

Record numbering summary

The Record Numbering feature allows you to display one of several different numbering types in the xamDataPresenter’s record selector column. The numbering is placed in a new control element – RecordSelectorNumber.

The following screenshot demonstrates the xamDataPresenter with record numbering enabled:

Record Numbering 1.png

Record Numbering Configuration Summary

Record numbering configuration summary chart

The following table explains briefly the configurable aspects of the record numbering and maps them to the properties that configure them. Further details are available after the table.

Configurable aspect Details Properties

Configure the numbering type to use

Configure the child records numbering format

Configure the numbering start

Configure the record numbering element

Configuring Numbering Type

Overview

Use the RecordSelectorNumberType property to enable or disable record numbering and specify the numbering type you want.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Disable record numbering

RecordSelectorNumberType

Display record numbering based on the underlying data item

RecordSelectorNumberType

Display record numbering affected by the records’ sort order

RecordSelectorNumberType

Display record numbering for the visible records only

Note
Note

In this mode the record numbering won’t have gaps when records are filtered.

RecordSelectorNumberType

Configuring Numbering Format

Overview

Use the RecordSelectorNumberFormat to specify the child nodes’ record numbering with hierarchical data structures.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Display child’s record numbering index within its parent collection

RecordSelectorNumberFormat

Concatenate the parent’s numbering to the child’s numbering.

For example: “2.1.5” for the second root record’s first child record’s fifth child record.

RecordSelectorNumberFormat

Configuring Numbering Start

Overview

Use the RecordSelectorNumberStart property to specify the start number used for the record numbering.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Set new start value for record numbering

RecordSelectorNumberStart

To a value of type int.

Configuring Numbering Styling

Overview

Use the RecordSelectorNumberStyle property to provide styling for the record selector numbering element.

Note
Note

RecordSelectorNumber is a new control element and a style for it can be provided either explicitly by setting the RecordSelectorNumberStyle property or implicitly by defining a Style in the Resources collection that is keyed by its type.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Style the record selector numbering element

RecordSelectorNumberStyle

To a value of type Style.

Related Topics

The following topics provide additional information related to this topic.

Topic Purpose

This topic provides overview information about the selection of the data presenter’s cells, rows and fields.