API Reference
PdfParagraphBuilder
Fluent builder for rich paragraphs made of styled text runs.
Inheritance
- Object
- PdfParagraphBuilder
Usage
Explore 34 API references to this type
This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.
Returned or exposed by 32
- Method PdfParagraphBuilder.BackgroundColor
- Method PdfParagraphBuilder.Baseline
- Method PdfParagraphBuilder.Bold
- Method PdfParagraphBuilder.CharacterSpacing
- Method PdfParagraphBuilder.Color
- Method PdfParagraphBuilder.FallbackText
- Method PdfParagraphBuilder.FeatureSettings
- Method PdfParagraphBuilder.Font
- Method PdfParagraphBuilder.FontFamily
- Method PdfParagraphBuilder.FontSize
- Method PdfParagraphBuilder.HorizontalTextScaling
- Method PdfParagraphBuilder.Inline
- Method PdfParagraphBuilder.InlineBox
- Method PdfParagraphBuilder.InlineImage
- Method PdfParagraphBuilder.Italic
- Method PdfParagraphBuilder.LineBreak
- Method PdfParagraphBuilder.Link
- Method PdfParagraphBuilder.LinkToBookmark
- Method PdfParagraphBuilder.ResetBackgroundColor
- Method PdfParagraphBuilder.ResetColor
- Method PdfParagraphBuilder.ResetFeatureSettings
- Method PdfParagraphBuilder.ResetFont
- Method PdfParagraphBuilder.ResetFontSize
- Method PdfParagraphBuilder.Runs
- Method PdfParagraphBuilder.Strike
- Method PdfParagraphBuilder.Strikethrough
- Method PdfParagraphBuilder.Subscript
- Method PdfParagraphBuilder.Superscript
- Method PdfParagraphBuilder.Tab
- Method PdfParagraphBuilder.Text
- Method PdfParagraphBuilder.Underline
- Method PdfParagraphBuilder.Underlined
Accepted by parameters 2
- Method PdfContentBuilder.PanelParagraph
- Method PdfContentBuilder.Paragraph
Constructors
public PdfParagraphBuilder(PdfAlign align, PdfColor? defaultColor) #Create a new paragraph builder.
Parameters
- align OfficeIMO.Pdf.PdfAlign
- Paragraph alignment.
- defaultColor OfficeIMO.Pdf.PdfColor?
- Optional default text color.
Methods
public PdfParagraphBuilder BackgroundColor(PdfColor color) #PdfParagraphBuilderSets the current run background color.
Parameters
- color OfficeIMO.Pdf.PdfColor
public PdfParagraphBuilder Baseline(PdfTextBaseline baseline) #PdfParagraphBuilderSets the current baseline placement for subsequent runs.
Parameters
- baseline OfficeIMO.Pdf.PdfTextBaseline
public PdfParagraphBuilder Bold(Boolean enable = true) #PdfParagraphBuilderEnables or disables bold for subsequent runs.
Parameters
- enable System.Boolean = true
public PdfParagraphBuilder Bold(String text, PdfColor? color = null) #PdfParagraphBuilderAdds a bold text run.
Parameters
- text System.String
- color OfficeIMO.Pdf.PdfColor? = null
public PdfParagraphBuilder CharacterSpacing(Double points) #PdfParagraphBuilderSets additional advance after each rendered glyph, in page points, for subsequent text.
Parameters
- points System.Double
public PdfParagraphBuilder Color(PdfColor color) #PdfParagraphBuilderSets the current run color.
Parameters
- color OfficeIMO.Pdf.PdfColor
public PdfParagraphBuilder FallbackText(PdfEmbeddedFontFallbackSet fallbackSet, String text, String source = "") #PdfParagraphBuilderAdds text planned through an embedded-font fallback set while preserving the current run styling.
Parameters
- fallbackSet OfficeIMO.Pdf.PdfEmbeddedFontFallbackSet
- text System.String
- source System.String = ""
public PdfParagraphBuilder FeatureSettings(OfficeTextFeatureSettings settings) #PdfParagraphBuilderSets OpenType feature overrides for subsequent text runs, including kerning.
Parameters
- settings OfficeIMO.Drawing.OfficeTextFeatureSettings
public PdfParagraphBuilder Font(PdfStandardFont font) #PdfParagraphBuilderSets the current standard PDF font for subsequent runs.
Parameters
- font OfficeIMO.Pdf.PdfStandardFont
public PdfParagraphBuilder FontFamily(String familyName) #PdfParagraphBuilderSets a registered embedded named family for subsequent runs.
Parameters
- familyName System.String
public PdfParagraphBuilder FontSize(Double fontSize) #PdfParagraphBuilderSets the current run font size in points.
Parameters
- fontSize System.Double
public PdfParagraphBuilder HorizontalTextScaling(Double percentage) #PdfParagraphBuilderSets the horizontal glyph width percentage for subsequent text. Use 100 for normal width.
Parameters
- percentage System.Double
public PdfParagraphBuilder Inline(PdfInlineElement element) #PdfParagraphBuilderAdds a fixed-size visual that participates in paragraph wrapping.
Parameters
- element OfficeIMO.Pdf.PdfInlineElement
public PdfParagraphBuilder InlineBox(Double width, Double height, PdfColor? background = null, PdfColor? borderColor = null, Double borderWidth = 0.5, String? alternativeText = null, Double baselineOffset = 0) #PdfParagraphBuilderAdds a filled and/or bordered box that participates in paragraph wrapping.
Parameters
- width System.Double
- height System.Double
- background OfficeIMO.Pdf.PdfColor? = null
- borderColor OfficeIMO.Pdf.PdfColor? = null
- borderWidth System.Double = 0.5
- alternativeText System.String? = null
- baselineOffset System.Double = 0
public PdfParagraphBuilder InlineImage(Byte[] imageBytes, Double width, Double height, String? alternativeText = null, OfficeImageFit fit = Contain, Double baselineOffset = 0) #PdfParagraphBuilderAdds an image that participates in paragraph wrapping.
Parameters
- imageBytes System.Byte[]
- width System.Double
- height System.Double
- alternativeText System.String? = null
- fit OfficeIMO.Drawing.OfficeImageFit = Contain
- baselineOffset System.Double = 0
public PdfParagraphBuilder Italic(Boolean enable = true) #PdfParagraphBuilderEnables or disables italic for subsequent runs.
Parameters
- enable System.Boolean = true
public PdfParagraphBuilder Italic(String text, PdfColor? color = null) #PdfParagraphBuilderAdds an italic text run.
Parameters
- text System.String
- color OfficeIMO.Pdf.PdfColor? = null
public PdfParagraphBuilder LineBreak() #PdfParagraphBuilderAdds an explicit line break using the current run style.
public PdfParagraphBuilder Link(String text, String uri, PdfColor? color = null, Boolean underline = true, String? contents = null) #PdfParagraphBuilderAdds a hyperlink text run.
Parameters
- text System.String
- Link text.
- uri System.String
- Absolute URI or catalog-base-relative URI to open.
- color OfficeIMO.Pdf.PdfColor? = null
- Optional link color.
- underline System.Boolean = true
- Whether to underline the link text (default true).
- contents System.String? = null
- Optional link annotation contents; defaults to the link text when omitted.
public PdfParagraphBuilder LinkToBookmark(String text, String bookmarkName, PdfColor? color = null, Boolean underline = true, String? contents = null) #PdfParagraphBuilderAdds a hyperlink text run that points to a document bookmark.
Parameters
- text System.String
- Link text.
- bookmarkName System.String
- Named destination created with PdfDocument.Bookmark.
- color OfficeIMO.Pdf.PdfColor? = null
- Optional link color.
- underline System.Boolean = true
- Whether to underline the link text (default true).
- contents System.String? = null
- Optional link annotation contents; defaults to the link text when omitted.
public PdfParagraphBuilder ResetBackgroundColor() #PdfParagraphBuilderResets the current run background color.
public PdfParagraphBuilder ResetColor() #PdfParagraphBuilderResets the current run color to the paragraph default color.
public PdfParagraphBuilder ResetFeatureSettings() #PdfParagraphBuilderResets subsequent text runs to the default OpenType feature policy.
public PdfParagraphBuilder ResetFont() #PdfParagraphBuilderResets the current run font to the paragraph/document font.
public PdfParagraphBuilder ResetFontSize() #PdfParagraphBuilderResets the current run font size to the paragraph default font size.
public PdfParagraphBuilder Runs(IEnumerable<PdfTextRun> runs) #PdfParagraphBuilderAdds already prepared rich text runs, preserving their per-run styling and font selections.
Parameters
- runs System.Collections.Generic.IEnumerable<OfficeIMO.Pdf.PdfTextRun>
public PdfParagraphBuilder Strike(Boolean enable = true) #PdfParagraphBuilderEnables or disables strikethrough for subsequent runs.
Parameters
- enable System.Boolean = true
public PdfParagraphBuilder Strike(OfficeTextDecorationStyle style) #PdfParagraphBuilderSets the strikethrough pattern for subsequent runs.
Parameters
- style OfficeIMO.Drawing.OfficeTextDecorationStyle
public PdfParagraphBuilder Strikethrough(String text, PdfColor? color = null) #PdfParagraphBuilderAdds a strikethrough text run.
Parameters
- text System.String
- color OfficeIMO.Pdf.PdfColor? = null
public PdfParagraphBuilder Strikethrough(String text, OfficeTextDecorationStyle style, PdfColor? color = null) #PdfParagraphBuilderAdds a text run with the requested strikethrough pattern.
Parameters
- text System.String
- style OfficeIMO.Drawing.OfficeTextDecorationStyle
- color OfficeIMO.Pdf.PdfColor? = null
public PdfParagraphBuilder Subscript(Boolean enable = true) #PdfParagraphBuilderEnables or disables subscript baseline placement for subsequent runs.
Parameters
- enable System.Boolean = true
public PdfParagraphBuilder Subscript(String text, PdfColor? color = null) #PdfParagraphBuilderAdds a subscript text run.
Parameters
- text System.String
- color OfficeIMO.Pdf.PdfColor? = null
public PdfParagraphBuilder Superscript(Boolean enable = true) #PdfParagraphBuilderEnables or disables superscript baseline placement for subsequent runs.
Parameters
- enable System.Boolean = true
public PdfParagraphBuilder Superscript(String text, PdfColor? color = null) #PdfParagraphBuilderAdds a superscript text run.
Parameters
- text System.String
- color OfficeIMO.Pdf.PdfColor? = null
public PdfParagraphBuilder Tab(PdfTabLeaderStyle leader) #PdfParagraphBuilderAdds an explicit paragraph tab using the current style flags.
Parameters
- leader OfficeIMO.Pdf.PdfTabLeaderStyle
public PdfParagraphBuilder Tab(PdfTabLeaderStyle leader = None, PdfTabAlignment alignment = Left) #PdfParagraphBuilderAdds an aligned paragraph tab using the current style flags.
Parameters
- leader OfficeIMO.Pdf.PdfTabLeaderStyle = None
- alignment OfficeIMO.Pdf.PdfTabAlignment = Left
public PdfParagraphBuilder Text(String text) #PdfParagraphBuilderAdds a text run using the current style flags.
Parameters
- text System.String
public PdfParagraphBuilder Underline(Boolean enable = true) #PdfParagraphBuilderEnables or disables underline for subsequent runs.
Parameters
- enable System.Boolean = true
public PdfParagraphBuilder Underline(OfficeTextDecorationStyle style) #PdfParagraphBuilderSets the underline pattern for subsequent runs.
Parameters
- style OfficeIMO.Drawing.OfficeTextDecorationStyle
public PdfParagraphBuilder Underlined(String text, PdfColor? color = null) #PdfParagraphBuilderAdds an underlined text run.
Parameters
- text System.String
- color OfficeIMO.Pdf.PdfColor? = null
public PdfParagraphBuilder Underlined(String text, OfficeTextDecorationStyle style, PdfColor? color = null) #PdfParagraphBuilderAdds a text run with the requested underline pattern.
Parameters
- text System.String
- style OfficeIMO.Drawing.OfficeTextDecorationStyle
- color OfficeIMO.Pdf.PdfColor? = null
Inherited Methods
public virtual Boolean Equals(Object? obj) #BooleanParameters
- obj Object?
Properties
public PdfColor? DefaultColor { get; } #Default text color applied when no run color is specified.