Back to all docs
API Reference / Telerik.Windows.Documents.Model / Paragraph
New to Telerik UI for WPF? Start a free 30-day trial

Paragraph

Class

Represents a paragraph element in a document model, containing text and formatting properties.

Definition

Namespace:Telerik.Windows.Documents.Model

Assembly:Telerik.Windows.Controls.RichTextBox.dll

Syntax:
C#
public class Paragraph : Block

Inheritance: objectDocumentElementBlockParagraph

Inherited Members DocumentElement.GetStyleProperty(IStylePropertyDefinition)DocumentElement.GetStyleProperty(string)DocumentElement.EnumerateChildrenOfType<T>()DocumentElement.GetParentOfType<T>()DocumentElement.CreateLayoutBox()DocumentElement.CopyPropertiesFrom(DocumentElement)DocumentElement.CopyPropertiesFromStyle(StyleDefinition)DocumentElement.ExtractStyleFromProperties()DocumentElement.ExtractStyleFromLocalProperties()DocumentElement.InvalidateAssociatedBoxesArrange()DocumentElement.InvalidateAssociatedBoxesMeasure()DocumentElement.InvalidateAssociatedBoxesLayout()DocumentElement.GetAssociatedLayoutBoxes()DocumentElement.GetRootDocument()DocumentElement.CreateShallowCopy()DocumentElement.GetPropertyValueSource(IStylePropertyDefinition)DocumentElement.ClearValue(IStylePropertyDefinition)DocumentElement.OnStylePropertyChanged(StylePropertyChangeEventArgs)DocumentElement.OnParentChanging()DocumentElement.OnParentChanged()DocumentElement.ChildIndexDocumentElement.HasStyleDocumentElement.StyleDocumentElement.StyleNameDocumentElement.TagDocumentElement.FirstLayoutBoxDocumentElement.IsFirstLayoutBoxInitializedDocumentElement.DocumentElementsDocumentElement.ParentDocumentElement.ChildrenDocumentElement.PreviousSiblingDocumentElement.NextSiblingDocumentElement.CursorDocumentElement.StyleChangingDocumentElement.StyleChangedDocumentElement.StylePropertyChangedDocumentElement.ParentChangingDocumentElement.ParentChangedDocumentElement.PropertyValueChanged...

Constructors

Paragraph()

Initializes a new instance of the Paragraph class.

C#
public Paragraph()

Paragraph(Paragraph)

Initializes a new instance of the Paragraph class by copying an already existing Paragraph.

C#
public Paragraph(Paragraph originalParagraph)
Parameters:originalParagraphParagraph

The original paragraph.

Fields

AutomaticSpacingAfterProperty

C#
public static readonly StylePropertyDefinition<bool?, ParagraphProperties> AutomaticSpacingAfterProperty

AutomaticSpacingBeforeProperty

C#
public static readonly StylePropertyDefinition<bool?, ParagraphProperties> AutomaticSpacingBeforeProperty

BackgroundProperty

C#
public static readonly StylePropertyDefinition<Color?, ParagraphProperties> BackgroundProperty

FirstLineIndentProperty

C#
public static readonly StylePropertyDefinition<double?, ParagraphProperties> FirstLineIndentProperty

FlowDirectionProperty

The flow direction property.

C#
public static readonly StylePropertyDefinition<FlowDirection?, ParagraphProperties> FlowDirectionProperty

IsLineBreakingRuleEnabledProperty

C#
public static readonly StylePropertyDefinition<bool?, ParagraphProperties> IsLineBreakingRuleEnabledProperty

KeepLinesProperty

C#
public static readonly StylePropertyDefinition<bool?, ParagraphProperties> KeepLinesProperty

LeftIndentProperty

C#
public static readonly StylePropertyDefinition<double?, ParagraphProperties> LeftIndentProperty

LineSpacingProperty

C#
public static readonly StylePropertyDefinition<double?, ParagraphProperties> LineSpacingProperty

LineSpacingTypeProperty

C#
public static readonly StylePropertyDefinition<LineSpacingType?, ParagraphProperties> LineSpacingTypeProperty

ListIdProperty

C#
public static readonly StylePropertyDefinition<int?, ParagraphProperties> ListIdProperty

ListLevelProperty

C#
public static readonly StylePropertyDefinition<int?, ParagraphProperties> ListLevelProperty

OutlineLevelProperty

C#
public static readonly StylePropertyDefinition<int?, ParagraphProperties> OutlineLevelProperty

RightIndentProperty

C#
public static readonly StylePropertyDefinition<double?, ParagraphProperties> RightIndentProperty

SpacingAfterProperty

C#
public static readonly StylePropertyDefinition<double?, ParagraphProperties> SpacingAfterProperty

SpacingBeforeProperty

C#
public static readonly StylePropertyDefinition<double?, ParagraphProperties> SpacingBeforeProperty

SuppressLineNumbersProperty

C#
public static readonly StylePropertyDefinition<bool?, ParagraphProperties> SuppressLineNumbersProperty

TextAlignmentProperty

C#
public static readonly StylePropertyDefinition<RadTextAlignment?, ParagraphProperties> TextAlignmentProperty

ThemeBackgroundProperty

C#
public static readonly StylePropertyDefinition<ThemeColorsEnum?, ParagraphProperties> ThemeBackgroundProperty

ThemeFillShadeProperty

C#
public static readonly StylePropertyDefinition<string, ParagraphProperties> ThemeFillShadeProperty

ThemeFillTintProperty

C#
public static readonly StylePropertyDefinition<string, ParagraphProperties> ThemeFillTintProperty

Properties

AutomaticSpacingAfter

Gets or sets the automatic spacing after the paragraph. This property determines the spacing that automatically applies after the paragraph, which can affect the overall layout and readability of the document.

C#
[XamlSerializable]
public bool AutomaticSpacingAfter { get; set; }
Property Value:

A double representing the spacing after the paragraph in the specified measurement units.

AutomaticSpacingBefore

Gets or sets a value indicating whether an automatic spacing before should be applied.

C#
[XamlSerializable]
public bool AutomaticSpacingBefore { get; set; }
Property Value:

true if [automatic spacing before]; otherwise, false.

Background

Color

Gets or sets the background.

C#
[XamlSerializable]
public Color Background { get; set; }
Property Value:

The background.

ElementRevisionInfo

Gets or sets the information for revisions on this element.

C#
[XamlCompositePropertySerializable]
public DocumentElementRevisionInfo ElementRevisionInfo { get; set; }
Property Value:

The element revision information.

FirstLineIndent

Gets or sets the first line indent.

C#
[XamlSerializable]
public double FirstLineIndent { get; set; }
Property Value:

The first line indent.

FlowDirection

FlowDirection

Gets or sets the flow direction.

C#
[XamlSerializable]
public FlowDirection FlowDirection { get; set; }
Property Value:

A value of type FlowDirection.

FontSize

Gets or sets the size of the font for the last paragraph marker.

C#
[XamlSerializable]
public double FontSize { get; set; }
Property Value:

The size of the font.

HangingIndent

Gets or sets the hanging indent.

C#
public double HangingIndent { get; set; }
Property Value:

The hanging indent.

HasRevisions

Gets a value indicating whether this instance has revisions.

C#
public bool HasRevisions { get; }
Property Value:

true if this instance has revisions; otherwise, false.

Inlines

Gets the collection of Inline elements added as children to this paragraph.

C#
public InlineCollection Inlines { get; }
Property Value:

The inlines.

IsDeleted

Gets a value indicating whether this instance has been deleted into document with enabled Track Changes.

C#
public bool IsDeleted { get; }
Property Value:

true if this instance is deleted; otherwise, false.

IsEmpty

Gets a value indicating whether this paragraph is empty.

C#
public bool IsEmpty { get; }
Property Value:

true if the paragraph doesn't contain inlines; otherwise, false.

IsHeading

Gets a value indicating whether a heading style is applied to this paragraph.

C#
public bool IsHeading { get; }
Property Value:

true if this instance has a heading style; otherwise, false.

IsInList

Gets a value indicating whether this paragraph is included in a list.

C#
public bool IsInList { get; }
Property Value:

true if this instance is in list; otherwise, false.

IsInserted

Gets a value indicating whether this instance has been inserted into document with enabled Track Changes.

C#
public bool IsInserted { get; }
Property Value:

true if this instance is inserted; otherwise, false.

IsLineBreakingRuleEnabled

Gets or sets a value indicating whether East Asian typography rules will be applied to determine which characters may begin and end each line.

C#
[XamlSerializable(true)]
public bool IsLineBreakingRuleEnabled { get; set; }

LeftIndent

Gets or sets the left indent.

C#
[XamlSerializable]
public double LeftIndent { get; set; }
Property Value:

The left indent.

LineSpacing

Gets or sets the spacing between the different lines of the paragraph.

C#
[XamlSerializable]
public double LineSpacing { get; set; }
Property Value:

The line spacing.

LineSpacingType

Specifies the line spacing type of a paragraph.

C#
[XamlSerializable]
public LineSpacingType LineSpacingType { get; set; }

ListId

Gets or sets identifier number of the list the paragraph is included in. The default value is -1 - the paragraph is not included in a list.

C#
[XamlSerializable(-1)]
public int ListId { get; set; }
Property Value:

The list identifier.

ListLevel

Gets or sets the list level.

C#
[XamlSerializable(0)]
public int ListLevel { get; set; }
Property Value:

The list level.

OutlineLevel

Gets or sets a value indicating the outline level. The outline level defines the level of this paragraph in TOC field. The default value is 0 - no level.

C#
[XamlSerializable(0)]
public int OutlineLevel { get; set; }
Property Value:

The outline level.

RightIndent

Gets or sets the right indent.

C#
[XamlSerializable]
public double RightIndent { get; set; }
Property Value:

The right indent.

SpacingAfter

Gets or sets the spacing after the paragraph.

C#
[XamlSerializable]
public double SpacingAfter { get; set; }
Property Value:

A double value representing the spacing, in pixels, that follows the paragraph.

SpacingBefore

Gets or sets the spacing before the paragraph.

C#
[XamlSerializable]
public double SpacingBefore { get; set; }
Property Value:

The spacing before.

SuppressLineNumbers

Gets or sets the value indicating whether the line numbering for the current Paragraph is suppressed.

C#
[XamlSerializable]
public bool SuppressLineNumbers { get; set; }
Property Value:

The line numbering.

TabStops

Gets or sets the tab stops.

C#
[XamlCompositePropertySerializable]
public TabStopCollection TabStops { get; set; }
Property Value:

The tab stops.

TextAlignment

Gets or sets the text alignment.

C#
[XamlSerializable]
public RadTextAlignment TextAlignment { get; set; }
Property Value:

A value of type RadTextAlignment.

ThemeBackground

Gets or sets the theme background.

C#
[XamlSerializable]
public ThemeColorsEnum ThemeBackground { get; set; }
Property Value:

The theme background.

ThemeFillShade

Gets or sets the theme fill shade.

C#
[XamlSerializable]
public string ThemeFillShade { get; set; }
Property Value:

The theme fill shade.

ThemeFillTint

Gets or sets the theme fill tint.

C#
[XamlSerializable]
public string ThemeFillTint { get; set; }
Property Value:

The theme fill tint.

Methods

CopyPropertiesFromOverride(DocumentElement)

Copies the properties from another Paragraph to the current instance.

C#
protected override void CopyPropertiesFromOverride(DocumentElement fromElement)
Parameters:fromElementDocumentElement

The Paragraph to copy the properties from.

Overrides: DocumentElement.CopyPropertiesFromOverride(DocumentElement)

CreateDeepCopy()

Creates a deep copy of the element.

C#
public override DocumentElement CreateDeepCopy()
Returns:

DocumentElement

The copied element.

Overrides: DocumentElement.CreateDeepCopy()

CreateLayoutBox(DocumentStructureCollection)

Creates a ParagraphLayoutBox for the element.

C#
public override LayoutBox CreateLayoutBox(DocumentStructureCollection documentCollection)
Parameters:documentCollectionDocumentStructureCollection

The document collection.

Returns:

LayoutBox

Overrides: DocumentElement.CreateLayoutBox(DocumentStructureCollection)

CreateNewElementInstance()

Creates a new Paragraph instance.

C#
protected override DocumentElement CreateNewElementInstance()
Returns:

DocumentElement

The new instance.

Overrides: DocumentElement.CreateNewElementInstance()

HasSameStyle(Paragraph)

Determines whether the current instance has the same style properties as another one.

C#
public virtual bool HasSameStyle(Paragraph other)
Parameters:otherParagraph

The other.

Returns:

bool

true if the current instance has the same style properties as the other one; otherwise, false.

OnRemoved()

Called when a DocumentElement is removed.

C#
protected override void OnRemoved()

Overrides: DocumentElement.OnRemoved()

OnStyleChanged()

Called after the style of a document element has been changed.

C#
protected override void OnStyleChanged()

Overrides: DocumentElement.OnStyleChanged()

OnStyleChanging()

Called before the style of a document element changes.

C#
protected override void OnStyleChanging()

Overrides: DocumentElement.OnStyleChanging()

OnTabStopsChanged()

Called when TabStops collection changes.

C#
protected virtual void OnTabStopsChanged()

RemoveFromList()

Removes the paragraph from a list.

C#
public void RemoveFromList()

Events

TabStopsChanged

Occurs when the TabStops collection changes.

C#
public event EventHandler TabStopsChanged
In this article
DefinitionConstructorsParagraph()Paragraph(Paragraph)FieldsAutomaticSpacingAfterPropertyAutomaticSpacingBeforePropertyBackgroundPropertyFirstLineIndentPropertyFlowDirectionPropertyIsLineBreakingRuleEnabledPropertyKeepLinesPropertyLeftIndentPropertyLineSpacingPropertyLineSpacingTypePropertyListIdPropertyListLevelPropertyOutlineLevelPropertyRightIndentPropertySpacingAfterPropertySpacingBeforePropertySuppressLineNumbersPropertyTextAlignmentPropertyThemeBackgroundPropertyThemeFillShadePropertyThemeFillTintPropertyPropertiesAutomaticSpacingAfterAutomaticSpacingBeforeBackgroundElementRevisionInfoFirstLineIndentFlowDirectionFontSizeHangingIndentHasRevisionsInlinesIsDeletedIsEmptyIsHeadingIsInListIsInsertedIsLineBreakingRuleEnabledLeftIndentLineSpacingLineSpacingTypeListIdListLevelOutlineLevelRightIndentSpacingAfterSpacingBeforeSuppressLineNumbersTabStopsTextAlignmentThemeBackgroundThemeFillShadeThemeFillTintMethodsCopyPropertiesFromOverride(DocumentElement)CreateDeepCopy()CreateLayoutBox(DocumentStructureCollection)CreateNewElementInstance()HasSameStyle(Paragraph)OnRemoved()OnStyleChanged()OnStyleChanging()OnTabStopsChanged()RemoveFromList()EventsTabStopsChanged
Not finding the help you need?
Contact Support