TextFragment

Updated on Jun 3, 2026

The TextFragment class in RadPdfProcessing represents a single-line text object that you can add to a PDF page.

• Creating a TextFragment
• Modifying a TextFragment

Public API

Property	Description
CharacterSpacing	The spacing between the characters in the text.
WordSpacing	The spacing between the words in the text. (Only space character (Unicode 0x32) is considered a word break in the RadPdfProcessing document model.)
HorizontalScaling	The horizontal scaling that is applied to the characters.
Font	The font that is used to draw the text.
FontSize	The font size. The measurement unit used for font size is Device Independent Pixels (DIPs). You can convert it to points or other units with the Unit class.
RenderingMode	Enumeration representing the way the text is rendered. It can have one of the following values: Fill Fill text (the default value). Stroke Stroke text. FillAndStroke Fill, then stroke text. None Neither fill nor stroke text (invisible). FillAndAddToClippingPath Fill text and add to path for clipping. StrokeAndAddToClippingPath Stroke text and add to path for clipping. FillStrokeAndAddToClippingPath Fill, then stroke text and add to path for clipping. AddToClippingPath Add text to path for clipping.
TextRise	Specifies the distance, in unscaled text space units, to move the baseline up or down from its default location.
Fill	The color that is used to fill the text. The default value is Black.
Stroke	The color that is used to stroke text. The default value is Black.
StrokeThickness	The width of the stroke line.
StrokeLineCap	Specifies the shape used at the ends of open paths when they are stroked. It can have one of the following values: Flat Flat line cap. Round Round line cap. Square Square line cap.
StrokeLineJoin	Specifies the shape to be used at the corners of paths that are stroked. Join styles are significant only at the points where consecutive segments of a path connect at an angle. Available options: Bevel Produces a diagonal corner. Miter Produces a sharp corner. If the segments meet at too sharp an angle, a bevel join is used instead. Round Produces a smooth, circular arc between the lines.
StrokeDashArray	The pattern of dashes and gaps used to stroke paths.
StrokeDashOffset	The distance from the start of a line to the beginning of a dash pattern.
AlphaConstant	Specifies the constant shape or constant opacity value to be used for nonstroking operations.
StrokeAlphaConstant	Specifies the constant shape or constant opacity value to be used for stroking operations.
MiterLimit	The limit of the thickness of the join on a mitered corner.
Text	Represents the text that is drawn.
Position	The Position where the text element is drawn.

Method	Description
Clone (Introduced in Q2 2025)	Creates a deep copy of this document element.

To use a font that is not part of the standard fonts, register it with the RegisterFont() method of the FontRepository static class.

In .NET Standard/.NET (Target OS: None) environments, fonts beyond the 14 standard ones require a FontsProvider implementation to be resolved correctly.

Creating a TextFragment

TextFragment is a content element that you can add to the Content collection of an IContainerElement such as RadFixedPage. There are several approaches you can use:

• Create a TextFragment and add it to a page container.
• Use one of the factory methods of the ContentElementCollection to create a new text fragment and insert it into the respective container.

Both methods return the actual TextFragment instance so you can modify it.

Example 1: Create TextFragments and Add Them to a Page

C#

RadFixedDocument document = new RadFixedDocument();
RadFixedPage page = new RadFixedPage();
document.Pages.Add(page);
FixedContentEditor editor = new FixedContentEditor(page);

SimplePosition simplePosition = new SimplePosition();
simplePosition.Translate(20, 20);
TextFragment textFragment = page.Content.AddTextFragment("Document Processing Libraries");
textFragment.CharacterSpacing = 5;
textFragment.WordSpacing = 15;
textFragment.Position = simplePosition;

SimplePosition simplePosition2 = new SimplePosition();
simplePosition2.Translate(20, 120);
TextFragment textFragment2 = new TextFragment("Document Processing Libraries");
textFragment2.CharacterSpacing = 10;
textFragment2.WordSpacing = 20;
textFragment2.Position = simplePosition2;
page.Content.Add(textFragment2);

Figure 1: Inserted TextFragments

TextFragment represents a single line of text. To make your text flow in a document, verify that all fragments you add can fit in a line, or use FixedContentEditor.

The \r and \n characters do not have the usual meaning of "go to next line" when inserted into a PDF document. You cannot insert text that contains these characters and produce multiline text. Instead, split the text and insert it line by line. An alternative approach is to use the RadFixedDocumentEditor which allows you to create a document in a flow-like manner.

Modifying a TextFragment

Modify a TextFragment element with the properties listed in the Public API section.

Example 2: Modify TextFragment Properties

C#

RadFixedDocument document = new RadFixedDocument();
RadFixedPage page = new RadFixedPage();
document.Pages.Add(page);
FixedContentEditor editor = new FixedContentEditor(page);

SimplePosition simplePosition = new SimplePosition();
simplePosition.Translate(20, 20);
TextFragment textFragment = page.Content.AddTextFragment("Document");
textFragment.RenderingMode = RenderingMode.Stroke;
textFragment.Stroke = new RgbColor(255, 0, 255);
textFragment.CharacterSpacing = 5;
textFragment.WordSpacing = 15;

// Read the font file 
byte[] fontData = File.ReadAllBytes(@"C:\Windows\Fonts\arial.ttf");
FontFamily fontFamily = new FontFamily("Arial");

// Register the font 
FontsRepository.RegisterFont(fontFamily, FontStyles.Normal, FontWeights.Normal, fontData);
FontBase font;
bool success = FontsRepository.TryCreateFont(fontFamily, FontStyles.Normal, FontWeights.Normal, out font);
textFragment.Font = font;
textFragment.FontSize = Unit.PointToDip(12);
textFragment.Position = simplePosition;

textFragment = page.Content.AddTextFragment("Processing");
simplePosition = new SimplePosition();
simplePosition.Translate(20, 50);
textFragment.Position = simplePosition;
textFragment.CharacterSpacing = 5;
textFragment.WordSpacing = 15;
textFragment.Font = FontsRepository.Courier;
textFragment.FontSize = Unit.PointToDip(12);
textFragment.RenderingMode = RenderingMode.Stroke;
textFragment.Stroke = new RgbColor(0, 0, 255);
textFragment.StrokeThickness = 1;

simplePosition = new SimplePosition();
textFragment = page.Content.AddTextFragment("Libraries");
simplePosition.Translate(20, 80);
textFragment.Position = simplePosition;
textFragment.Font = FontsRepository.TimesItalic;
textFragment.FontSize = Unit.PointToDip(16);
textFragment.RenderingMode = RenderingMode.Stroke;
textFragment.StrokeLineCap = Telerik.Windows.Documents.Fixed.Model.Graphics.LineCap.Flat;
textFragment.StrokeLineJoin = Telerik.Windows.Documents.Fixed.Model.Graphics.LineJoin.Round;
textFragment.StrokeDashArray = new double[] { 1 };
textFragment.StrokeDashOffset = 2;
textFragment.AlphaConstant = 0.5;
textFragment.MiterLimit = 2;

Figure 2: Modified TextFragments

See Also

• RadFixedPage
• FixedContentEditor
• Position
• Block
• Extracting Text Within a Specific Rectangle in PDF Documents
• Getting Position and Size of TextFragment in PDF Documents
• Replacing Specific Text in PDF Spanning Multiple TextFragments in Telerik PdfProcessing