Paragraph
Block-level container for inline content with paragraph-specific formatting including alignment, spacing, indentation, borders, and list association.
Definition
Namespace:Telerik.Windows.Documents.Flow.Model
Assembly:Telerik.Windows.Documents.Flow.dll
Syntax:
public sealed class Paragraph : BlockBase, IElementWithStyle, IElementWithPropertiesInheritance: objectDocumentElementBaseBlockBaseParagraph
Implements:
Inherited Members
Constructors
Initializes a new instance of the Paragraph class.
public Paragraph(RadFlowDocument document)The document in which the element will be added.
Fields
Defines whether punctuation characters can extend beyond paragraph margins for visual alignment.
public static readonly StylePropertyDefinition<bool?> AllowOverflowPunctuationPropertyDefinitionDefines whether East Asian typography line breaking rules are applied to control line wrapping for CJK text.
public static readonly StylePropertyDefinition<bool?> ApplyEastAsianLineBreakingRulesPropertyDefinitionDefines whether automatic spacing after paragraphs is applied based on document rendering context.
public static readonly StylePropertyDefinition<bool?> AutomaticSpacingAfterPropertyDefinitionDefines whether automatic spacing before paragraphs is applied based on document rendering context.
public static readonly StylePropertyDefinition<bool?> AutomaticSpacingBeforePropertyDefinitionBackgroundColorPropertyDefinition
StylePropertyDefinition<ThemableColor>
Defines the background fill color property for paragraph shading.
public static readonly StylePropertyDefinition<ThemableColor> BackgroundColorPropertyDefinitionDefines the border configuration property for paragraphs, controlling line style, color, and thickness on all sides.
public static readonly StylePropertyDefinition<ParagraphBorders> BordersPropertyDefinitionDefines whether spacing before and after is suppressed when adjacent paragraphs share the same style.
public static readonly StylePropertyDefinition<bool?> ContextualSpacingPropertyDefinitionDefines the positive indentation applied to the first line of paragraphs, measured in device-independent pixels.
public static readonly StylePropertyDefinition<double?> FirstLineIndentPropertyDefinitionDefines the text flow direction property, determining left-to-right or right-to-left content rendering.
public static readonly StylePropertyDefinition<FlowDirection?> FlowDirectionPropertyDefinitionDefines the negative first-line indentation (hanging indent) applied to paragraphs, measured in device-independent pixels.
public static readonly StylePropertyDefinition<double?> HangingIndentPropertyDefinitionDefines whether paragraphs should avoid being split across page breaks.
public static readonly StylePropertyDefinition<bool?> KeepOnOnePagePropertyDefinitionDefines whether paragraphs should remain on the same page as the following paragraph to prevent separation.
public static readonly StylePropertyDefinition<bool?> KeepWithNextParagraphPropertyDefinitionDefines the left margin indentation for paragraphs, measured in device-independent pixels.
public static readonly StylePropertyDefinition<double?> LeftIndentPropertyDefinitionDefines the line spacing value property, interpreted based on the line spacing type setting.
public static readonly StylePropertyDefinition<double?> LineSpacingPropertyDefinitionDefines how the line spacing value is interpreted (exact, at least, or multiple of line height).
public static readonly StylePropertyDefinition<HeightType?> LineSpacingTypePropertyDefinitionDefines the list identifier property that associates paragraphs with a specific list definition.
public static readonly StylePropertyDefinition<int?> ListIdPropertyDefinitionDefines the list level property (0-8) that determines indentation and numbering format within a list.
public static readonly StylePropertyDefinition<int?> ListLevelPropertyDefinitionDefines whether left and right indents are swapped on odd pages to support facing-page layouts.
public static readonly StylePropertyDefinition<bool?> MirrorIndentsPropertyDefinitionDefines the outline level property that determines paragraph hierarchy in table of contents and document structure.
public static readonly StylePropertyDefinition<OutlineLevel?> OutlineLevelPropertyDefinitionDefines whether a page break is inserted before paragraphs, forcing them to start on a new page.
public static readonly StylePropertyDefinition<bool?> PageBreakBeforePropertyDefinitionDefines the right margin indentation for paragraphs, measured in device-independent pixels.
public static readonly StylePropertyDefinition<double?> RightIndentPropertyDefinitionShadingPatternColorPropertyDefinition
StylePropertyDefinition<ThemableColor>
Defines the foreground pattern color property for paragraph shading when a pattern is applied.
public static readonly StylePropertyDefinition<ThemableColor> ShadingPatternColorPropertyDefinitionDefines the fill pattern style property for paragraph shading (e.g., solid, diagonal stripes, dots).
public static readonly StylePropertyDefinition<ShadingPattern?> ShadingPatternPropertyDefinitionDefines the spacing after paragraph property, measured in device-independent pixels.
public static readonly StylePropertyDefinition<double?> SpacingAfterPropertyDefinitionDefines the spacing before paragraph property, measured in device-independent pixels.
public static readonly StylePropertyDefinition<double?> SpacingBeforePropertyDefinitionDefines the collection of custom tab stop positions and alignments for paragraphs.
public static readonly StylePropertyDefinition<TabStopCollection> TabStopsPropertyDefinitionDefines the horizontal text alignment property for paragraphs.
public static readonly StylePropertyDefinition<Alignment?> TextAlignmentPropertyDefinitionMethods
Creates a deep copy of this paragraph with all inlines and formatting, associated to the current document.
Creates a deep copy of this paragraph with all inlines and formatting, associated to the specified document.
public Paragraph Clone(RadFlowDocument document)The document to which the cloned element should be associated.
Returns:The cloned element.
Properties
Gets or sets whether punctuation characters can extend beyond paragraph margins for visual alignment; defaults to true.
public bool AllowOverflowPunctuation { get; set; }The default is true.
Gets or sets whether East Asian typography line breaking rules are applied to control line wrapping behavior for CJK text; defaults to true.
public bool ApplyEastAsianLineBreakingRules { get; set; }The default value is true.
Gets or sets the border configuration for all sides of the paragraph, controlling line style, color, and thickness.
public ParagraphBorders Borders { get; set; }The borders.
Gets or sets whether spacing before and after is suppressed when adjacent paragraphs share the same paragraph style; defaults to false.
public bool ContextualSpacing { get; set; }The default value is false.
Gets or sets the text flow direction for the paragraph, determining whether content flows left-to-right or right-to-left; defaults to LeftToRight.
public FlowDirection FlowDirection { get; set; }The default value is LeftToRight
Gets the indentation settings for this paragraph, controlling left, right, first-line, and hanging indents.
public ParagraphIndentation Indentation { get; }The indentation.
Gets the collection of inline elements (runs, images, fields) contained within this paragraph.
public InlineCollection Inlines { get; }The inlines.
Gets or sets whether the paragraph should not be split across page breaks in page view mode; defaults to false.
public bool KeepOnOnePage { get; set; }The default value is false
Gets or sets whether this paragraph should remain on the same page as the following paragraph to prevent separation by page breaks; defaults to false.
public bool KeepWithNextParagraph { get; set; }The default value is false
Gets or sets the identifier of the list definition this paragraph belongs to, enabling list formatting.
public int ListId { get; set; }The list id.
Gets or sets the list level (0-8) that determines indentation and numbering format within the associated list; defaults to -1 (no list).
public int ListLevel { get; set; }The default value is -1 - list style is not referenced.
Gets or sets whether left and right indents are swapped on odd pages to support mirrored margins in facing-page layouts; defaults to false.
public bool MirrorIndents { get; set; }The default value is false.
Gets or sets the outline level that determines this paragraph's hierarchy in table of contents and document structure; defaults to Level9 (no outline level).
public OutlineLevel OutlineLevel { get; set; }The default value is Level9 - no level.
Gets or sets whether a page break is inserted before this paragraph in page view mode, forcing the paragraph to start on a new page; defaults to false.
public bool PageBreakBefore { get; set; }The default value is false
Gets the formatting properties container for this paragraph, providing access to alignment, spacing, indentation, borders, and other paragraph-level settings.
public ParagraphProperties Properties { get; }The properties.
Gets the background shading settings applied to the paragraph's area, including fill color and pattern.
public Shading Shading { get; }The shading.
Gets the spacing settings for this paragraph, controlling space before, after, and line spacing values.
public ParagraphSpacing Spacing { get; }The paragraph spacing.
Gets or sets the identifier of the paragraph style applied to this paragraph, affecting formatting through style inheritance.
public string StyleId { get; set; }The style id.
Implements:
Gets or sets the collection of custom tab stop positions and alignments for this paragraph.
public TabStopCollection TabStops { get; set; }The tab stops.
Gets or sets the horizontal alignment of text within the paragraph; defaults to Left.
public Alignment TextAlignment { get; set; }The default value is Left