ParagraphProperties
Configures formatting and behavior for Paragraph elements, including alignment, spacing, indentation, borders, shading, and list association with inheritance from styles and document defaults.
Definition
Namespace:Telerik.Windows.Documents.Flow.Model.Styles
Assembly:Telerik.Windows.Documents.Flow.dll
Syntax:
public sealed class ParagraphProperties : DocumentElementPropertiesBase, IElementWithStyle, IPropertiesWithShadingInheritance: objectDocumentElementPropertiesBaseParagraphProperties
Implements:
Inherited Members
Methods
Copy properties from specified source.
public override void CopyPropertiesFrom(DocumentElementPropertiesBase fromProperties)The source from which to copy the properties.
Overrides:
Enumerates the style properties.
protected override IEnumerable<IStyleProperty> EnumerateStyleProperties()The style properties.
Overrides:
Gets specific style property or null.
protected override IStyleProperty GetStylePropertyOverride(IStylePropertyDefinition propertyDefinition)The property definition.
Returns:Overrides:
Properties
Permits trailing punctuation to extend beyond the paragraph margin during line breaking, improving text flow for punctuation-heavy content; defaults to true. This property is local-only and not inherited.
public IStyleProperty<bool?> AllowOverflowPunctuation { get; }The default is true.
Enables East-Asian typography line-breaking rules for the paragraph, affecting where lines wrap in CJK text; defaults to true.
public IStyleProperty<bool?> ApplyEastAsianLineBreakingRules { get; }The default value is true.
Enables automatic calculation of spacing after the paragraph based on its content, allowing consumers to optimize inter-paragraph spacing dynamically.
public IStyleProperty<bool?> AutomaticSpacingAfter { get; }The automatic spacing after.
Enables automatic calculation of spacing before the paragraph based on its content, allowing consumers to optimize inter-paragraph spacing dynamically.
public IStyleProperty<bool?> AutomaticSpacingBefore { get; }The automatic spacing after.
BackgroundColor
IStyleProperty<ThemableColor>
Controls the background fill color behind the paragraph's content, supporting theme-aware colors.
public IStyleProperty<ThemableColor> BackgroundColor { get; }The color of the background.
Implements:
Configures decorative borders around the paragraph's edges, including style, width, and color for each side.
public IStyleProperty<ParagraphBorders> Borders { get; }The paragraph borders.
Suppresses spacing before and after the paragraph when adjacent paragraphs share the same style, reducing visual gaps in homogeneous content; defaults to false.
public IStyleProperty<bool?> ContextualSpacing { get; }The default value is false.
Controls additional indentation applied exclusively to the paragraph's first line, in device-independent pixels (1/96 inch).
public IStyleProperty<double?> FirstLineIndent { get; }The first line indent.
Controls text flow direction for the paragraph, affecting how inline content is laid out and rendered; defaults to LeftToRight.
public IStyleProperty<FlowDirection?> FlowDirection { get; }The default value is LeftToRight
Outdents the paragraph's first line relative to subsequent lines, creating a hanging indent effect in device-independent pixels (1/96 inch).
public IStyleProperty<double?> HangingIndent { get; }The hanging indent.
Prevents the paragraph from breaking across pages during pagination, keeping all lines together on a single page; defaults to false.
public IStyleProperty<bool?> KeepOnOnePage { get; }The default value is false
Prevents page breaks between this paragraph and the next during pagination, ensuring they appear together when possible; defaults to false.
public IStyleProperty<bool?> KeepWithNextParagraph { get; }The default value is false
Controls indentation from the left margin for all lines in the paragraph, in device-independent pixels (1/96 inch).
public IStyleProperty<double?> LeftIndent { get; }The left indent.
Controls vertical spacing between lines within the paragraph.
If LineSpacingType is Auto then the line height value times the value of the property, otherwise the value is in device independent pixels (1/96 inch).
public IStyleProperty<double?> LineSpacing { get; }The line spacing value.
Determines how line spacing is calculated, specifying whether values are absolute or proportional to font size.
public IStyleProperty<HeightType?> LineSpacingType { get; }The type line spacing rule.
Associates the paragraph with a numbered or bulleted list by referencing the list's identifier; defaults to -1 (no list association).
public IStyleProperty<int?> ListId { get; }The default value is -1 - list style is not referenced.
Specifies the hierarchical level within the associated list (0-8), determining indentation and numbering format; defaults to -1 (no level).
public IStyleProperty<int?> ListLevel { get; }The default value is -1 - list level is not referenced.
Swaps left and right indents on odd-numbered pages for mirrored layout in facing-page scenarios; defaults to false.
public IStyleProperty<bool?> MirrorIndents { get; }The default value is false.
Assigns the paragraph to a hierarchical outline level for document structure and table-of-contents generation; defaults to Level9 (no level).
public IStyleProperty<OutlineLevel?> OutlineLevel { get; }The default value is Level9 - no level.
Forces the paragraph to start on a new page during pagination, inserting an automatic page break before it; defaults to false.
public IStyleProperty<bool?> PageBreakBefore { get; }The default value is false
Configures character formatting for the paragraph marker glyph, which visually represents the paragraph in editing contexts.
public CharacterProperties ParagraphMarkerProperties { get; }The paragraph marker properties.
Controls indentation from the right margin for all lines in the paragraph, in device-independent pixels (1/96 inch).
public IStyleProperty<double?> RightIndent { get; }The left indent.
Specifies the fill pattern style overlaid on the paragraph's background, determining how the pattern color blends with the background; defaults to Clear.
public IStyleProperty<ShadingPattern?> ShadingPattern { get; }The default value is Clear
Implements:
ShadingPatternColor
IStyleProperty<ThemableColor>
Controls the foreground color of the shading pattern overlaid on the background, supporting theme-aware colors.
public IStyleProperty<ThemableColor> ShadingPatternColor { get; }The color of the pattern.
Implements:
Controls spacing added after the paragraph's last line, in device-independent pixels (1/96 inch).
public IStyleProperty<double?> SpacingAfter { get; }The spacing after value.
Controls spacing added above the paragraph's first line, in device-independent pixels (1/96 inch).
public IStyleProperty<double?> SpacingBefore { get; }The spacing before value.
Manages custom tab stop positions within the paragraph for precise alignment of tabbed content.
public IStyleProperty<TabStopCollection> TabStops { get; }The tab stops.
Controls horizontal alignment of the paragraph content within its container; defaults to Left.
public IStyleProperty<Alignment?> TextAlignment { get; }The default value is Left