Back to Devexpress

Character Comb

eud-eud-for-devexpress-reports-reporting-for-web-report-designer-use-report-elements-use-basic-report-controls-character-comb.md

latest4.5 KB
Original Source

Character Comb

  • Feb 09, 2026
  • 5 minutes to read

Overview

The Character Comb control displays text so that each character is printed in an individual cell.

To add a Character Comb to the report, drag the Character Comb item from the Toolbox onto the report’s area.

The number of cells displayed by the control in Print Preview depends on the Can Shrink and Auto Width settings.

  • If both these properties are enabled, the number of cells corresponds to the number of characters in the control’s text.
  • Otherwise, the number of cells corresponds to the specified cell size and the control size.

See the Content Layout and Position section to learn more on using these properties.

You can also adjust the character comb’s size to match its characters using the Fit Bounds To Text command from the control’s context menu:

  • If the Word Wrap option is enabled, the command keeps control content displayed in multiple lines. It decreases the control’s height and adjusts the width to fit this content.

  • If the Word Wrap option is disabled, the command adjusts the control’s height and width to completely display the control’s content in a single line. As a result, the number of cells corresponds to the number of characters.

When exporting this control to third-party formats, consider the following

  • When a report is exported to an XLS or XLSX file, the cells of the Character Comb correspond to the cells of a resulting Excel sheet.
  • When a report is exported to a CSV (or TXT ) file, the content of individual cells is separated (or spaced) by a specified Separator character.

In most aspects, the Character Comb is similar to the Label control from which it inherits most of its properties and its basic behavior. For general information about binding these controls to data and display summary function results, see the Label topic. To learn about Character Comb specifics, see the following sections in this document.

Main Options

The following properties are specific to the Character Comb control:

  • Cell Vertical Spacing and Cell Horizontal Spacing

  • Border Width

  • Cell Size Mode

Content Layout and Position

This section describes the Character Comb properties that affect the control’s position on a page and content layout.

The following image illustrates the behavior of the Auto Width property that specifies whether or not the width of a control depends on its text. Expand the Character Comb Tasks or Behavior category to specify this property.

AutoWidth = trueAutoWidth = false

The following image illustrates the behavior of the Can Shrink property that specifies whether or not the height of a control depends on its text. Expand the Character Comb Tasks or Behavior category to specify this property.

CanShrink = trueCanShrink = false

The Text Alignment property specifies the alignment of text within a control. Expand the Appearance category to specify this property.

TextAlignment = Top LeftTextAlignment = Middle CenterTextAlignment = Bottom Right