XRCrossTabCell.AllowMarkupText Property
Gets or sets whether you can use HTML-style markup tags to format the cell text.
Namespace: DevExpress.XtraReports.UI.CrossTab
Assembly: DevExpress.XtraReports.v22.1.dll
NuGet Package: DevExpress.Reporting.Core
Declaration
[DefaultValue(false)]
[SRCategory(ReportStringId.CatBehavior)]
public virtual bool AllowMarkupText { get; set; }
Property Value
Type | Default | Description |
---|---|---|
Boolean | false | true if the control allows markup text; otherwise, false. |
Remarks
If a cell’s AllowMarkupText property is set to true, you can use markup tags to format the cell’s Text and Format String properties.
Supported Tags
The XRCrossTabCell supports the following tags:
Tag | End Tag | Description | |
---|---|---|---|
<p> | </p> | Inserts line breaks. | |
<br> | - | Inserts a single line break. | |
<nbsp> | - | Inserts a space. | |
<color=value> | </color> | Specifies the text color. | |
<backcolor=value> | </backcolor> | Specifies the background color. | |
<size=value> | </size> | Specifies the font size. | |
<b> | </b> | Defines bold text. | |
<i> | </i> | Defines italic text. | |
<r> | </r> | Defines regular text. This resets any bold, italic, underlined and strikethrough formats specified with tags or applied in the control’s appearance settings. | |
<s> | </s> | Defines strikethrough text. | |
<u> | </u> | Defines underlined text. | |
<sub> | </sub> | Defines that the text is smaller and displayed lower than the previous character. | |
<sup> | </sup> | Defines that the text is smaller and displayed higher than the previous character. | |
<font> | </font> | Specifies the font family. You can combine it with the color and size settings within a single tag. | |
<image=value> | - | Inserts an image from the report’s named image collection. Supports both raster images and SVG images. The image tag’s size attribute sets the image display pixel size. If the specified width/height exceeds the label’s width/height, it is reduced to display the entire image. Specify the size attribute after the tag’s value followed by the “;” character. | |
<href=value> | </href> | Displays a hyperlink. The value string specifies the hyperlink source, and the string between the opening and closing tags is the text to display. Note that hyperlinks are not clickable in the documents exported to the E-Mail / HTML format, because the label’s markup text is exported as an image. Use the XRRichText control to create an E-Mail / HTML document with clickable hyperlinks. |
Limitations
If the AllowMarkupText property is set to True, the following limitations apply:
- The TextAlignment property — the TextAlignment.TopJustify, TextAlignment.MiddleJustify, and TextAlignment.BottomJustify values have no effect.
- The Angle property has no effect.
- The content is exported as an image to the HTML, MHT, RTF, and DOCX formats.
Example
The following code demonstrates how to enable HTML-like markup in a cross-tab column named “rowTotal”:
using DevExpress.XtraReports.UI;
// ...
XRCrossTabCell cell = crossTab.Cells["rowTotal"] as XRCrossTabCell;
cell.AllowMarkupText = true;
cell.TextFormatString = "<b>Row Total:</b> {0}";