menu

MAUI

  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class SfRichTextEditor - MAUI API Reference | Syncfusion

    Show / Hide Table of Contents

    Class SfRichTextEditor

    Represents a rich text editor control that provides HTML editing capabilities with toolbar support.

    Inheritance
    System.Object
    SfView
    SfRichTextEditor
    Implements
    IDrawableLayout
    Microsoft.Maui.Graphics.IDrawable
    Microsoft.Maui.IAbsoluteLayout
    Microsoft.Maui.ILayout
    Microsoft.Maui.IView
    Microsoft.Maui.IElement
    Microsoft.Maui.ITransform
    Microsoft.Maui.IContainer
    System.Collections.Generic.IList<Microsoft.Maui.IView>
    System.Collections.Generic.ICollection<Microsoft.Maui.IView>
    System.Collections.Generic.IEnumerable<Microsoft.Maui.IView>
    System.Collections.IEnumerable
    Microsoft.Maui.ISafeAreaView
    Microsoft.Maui.IPadding
    Microsoft.Maui.ICrossPlatformLayout
    Microsoft.Maui.IVisualTreeElement
    System.IDisposable
    Inherited Members
    SfView.ArrangeContent(Rect)
    SfView.ArrangeOverride(Rect)
    SfView.Children
    SfView.ClipToBounds
    SfView.GetSemanticsNodesCore(Double, Double)
    SfView.IDrawableLayout.DrawingOrder
    SfView.IDrawableLayout.InvalidateDrawable()
    SfView.MeasureContent(Double, Double)
    SfView.MeasureOverride(Double, Double)
    SfView.OnDraw(ICanvas, RectF)
    SfView.OnHandlerChanged()
    SfView.Padding
    Namespace: Syncfusion.Maui.RichTextEditor
    Assembly: Syncfusion.Maui.RichTextEditor.dll
    Syntax
    public class SfRichTextEditor : SfView, IDrawableLayout, IDrawable, IAbsoluteLayout, ILayout, IView, IElement, ITransform, IContainer, IList<IView>, ICollection<IView>, IEnumerable<IView>, IEnumerable, ISafeAreaView, IPadding, ICrossPlatformLayout, IVisualTreeElement, ISemanticsProvider, IDisposable, IParentThemeElement, IThemeElement

    Constructors

    SfRichTextEditor()

    Initializes a new instance of the SfRichTextEditor class.

    Declaration
    public SfRichTextEditor()

    Fields

    BorderColorProperty

    Identifies the BorderColor bindable property.

    Declaration
    public static readonly BindableProperty BorderColorProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    BorderThicknessProperty

    Identifies the BorderThickness bindable property.

    Declaration
    public static readonly BindableProperty BorderThicknessProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    DefaultFontFamilyProperty

    Identifies the DefaultFontFamily bindable property.

    Declaration
    public static readonly BindableProperty DefaultFontFamilyProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    DefaultFontSizeProperty

    Identifies the DefaultFontSize bindable property.

    Declaration
    public static readonly BindableProperty DefaultFontSizeProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    DefaultTextColorProperty

    Identifies the DefaultTextColor bindable property.

    Declaration
    public static readonly BindableProperty DefaultTextColorProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    EditorBackgroundColorProperty

    Identifies the EditorBackgroundColor bindable property.

    Declaration
    public static readonly BindableProperty EditorBackgroundColorProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    EnableAutoSizeProperty

    Identifies the EnableAutoSize bindable property.

    Declaration
    public static readonly BindableProperty EnableAutoSizeProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    EnableWordWrapProperty

    Identifies the EnableWordWrap bindable property.

    Declaration
    public static readonly BindableProperty EnableWordWrapProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    FontFamiliesProperty

    Identifies the FontFamilies bindable property.

    Declaration
    public static readonly BindableProperty FontFamiliesProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    HtmlTextProperty

    Identifies the HtmlText bindable property.

    Declaration
    public static readonly BindableProperty HtmlTextProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    IsFocusedProperty

    Identifies the IsFocused bindable property.

    Declaration
    public static readonly BindableProperty IsFocusedProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    PlaceholderColorProperty

    Identifies the PlaceholderColor bindable property.

    Declaration
    public static readonly BindableProperty PlaceholderColorProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    PlaceholderFontFamilyProperty

    Identifies the PlaceholderFontFamily bindable property.

    Declaration
    public static readonly BindableProperty PlaceholderFontFamilyProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    PlaceholderFontSizeProperty

    Identifies the PlaceholderFontSize bindable property.

    Declaration
    public static readonly BindableProperty PlaceholderFontSizeProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    PlaceholderProperty

    Identifies the Placeholder bindable property.

    Declaration
    public static readonly BindableProperty PlaceholderProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    ReadOnlyProperty

    Identifies the ReadOnly bindable property.

    Declaration
    public static readonly BindableProperty ReadOnlyProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    ShowToolbarProperty

    Identifies the ShowToolbar bindable property.

    Declaration
    public static readonly BindableProperty ShowToolbarProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    TableCellColorProperty

    Identifies the TableCellColor bindable property.

    Declaration
    public static readonly BindableProperty TableCellColorProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    TableCellSelectionColorProperty

    Identifies the TableCellSelectionColor bindable property.

    Declaration
    public static readonly BindableProperty TableCellSelectionColorProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    TextProperty

    Identifies the Text bindable property.

    Declaration
    public static readonly BindableProperty TextProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    ToolbarItemsProperty

    Identifies the ToolbarItems bindable property. This property represents the collection of toolbar items used in the editor. The default is an empty collection.

    Declaration
    public static readonly BindableProperty ToolbarItemsProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    ToolbarPositionProperty

    Identifies the ToolbarPosition bindable property.

    Declaration
    public static readonly BindableProperty ToolbarPositionProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    ToolbarSettingsProperty

    Identifies the ToolbarSettings bindable property. This property defines the settings for the toolbar's appearance and behavior.

    Declaration
    public static readonly BindableProperty ToolbarSettingsProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    Properties

    BorderColor

    Gets or sets the BorderColor.

    Declaration
    public Color BorderColor { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Graphics.Color

    The BorderColor color for the editor's BorderColor.

    BorderThickness

    Gets or sets the Border thickness.

    Declaration
    public double BorderThickness { get; set; }
    Property Value
    Type Description
    System.Double

    The thickness of the editor's border.

    DefaultFontFamily

    Gets or sets the default font family for new text.

    Declaration
    public string DefaultFontFamily { get; set; }
    Property Value
    Type Description
    System.String

    The default font family name.

    DefaultFontSize

    Gets or sets the default font size for new text.

    Declaration
    public double DefaultFontSize { get; set; }
    Property Value
    Type Description
    System.Double

    The default font size in pixels.

    DefaultTextColor

    Gets or sets the default text color for the editor.

    Declaration
    public Color DefaultTextColor { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Graphics.Color

    The default color for text entered by the user.

    EditorBackgroundColor

    Gets or sets the Background Color for the editor.

    Declaration
    public Color EditorBackgroundColor { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Graphics.Color

    The Background Color of the control.

    EnableAutoSize

    Gets or sets a value indicating whether the editor is read-only.

    Declaration
    public bool EnableAutoSize { get; set; }
    Property Value
    Type Description
    System.Boolean

    True if the editor is read-only; otherwise, false.

    EnableWordWrap

    Gets or sets the word wrap mode in the editor.

    Declaration
    public bool EnableWordWrap { get; set; }
    Property Value
    Type Description
    System.Boolean

    The word wrap mode. Default is Normal.

    FontFamilies

    Gets or sets the collection of font family styles available for new text.

    Declaration
    public IList<RichTextEditorFontStyle> FontFamilies { get; set; }
    Property Value
    Type
    System.Collections.Generic.IList<RichTextEditorFontStyle>

    HtmlText

    Gets or sets the html content to the editor.

    Declaration
    public string HtmlText { get; set; }
    Property Value
    Type Description
    System.String

    The Html text as a string.

    IsFocused

    Gets a value indicating whether the editor currently has focus.

    Declaration
    public bool IsFocused { get; set; }
    Property Value
    Type Description
    System.Boolean

    True if the editor has focus; otherwise, false.

    Placeholder

    Gets or sets the placeholder text displayed when the editor is empty.

    Declaration
    public string Placeholder { get; set; }
    Property Value
    Type Description
    System.String

    The placeholder text.

    PlaceholderColor

    Gets or sets the text color of the placeholder.

    Declaration
    public Color PlaceholderColor { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Graphics.Color

    The color of the placeholder text.

    PlaceholderFontFamily

    Gets or sets the font family for the placeholder text.

    Declaration
    public string PlaceholderFontFamily { get; set; }
    Property Value
    Type Description
    System.String

    The font family name for the placeholder.

    PlaceholderFontSize

    Gets or sets the font size for the placeholder text.

    Declaration
    public double PlaceholderFontSize { get; set; }
    Property Value
    Type Description
    System.Double

    The font size in pixels for the placeholder.

    ReadOnly

    Gets or sets a value indicating whether the editor is read-only.

    Declaration
    public bool ReadOnly { get; set; }
    Property Value
    Type Description
    System.Boolean

    True if the editor is read-only; otherwise, false.

    ShowToolbar

    Gets or sets a value indicating whether the toolbar is visible.

    Declaration
    public bool ShowToolbar { get; set; }
    Property Value
    Type Description
    System.Boolean

    True if the toolbar is visible; otherwise, false.

    TableCellColor

    Gets or sets the Table cell color for the editor.

    Declaration
    public Color TableCellColor { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Graphics.Color

    The Table Cell Color of the control.

    TableCellSelectionColor

    Gets or sets the Table cell selection color for the editor.

    Declaration
    public Color TableCellSelectionColor { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Graphics.Color

    The Table Cell Selection Color of the control.

    Text

    Gets or sets the plain text content of the editor without HTML formatting.

    Declaration
    public string Text { get; set; }
    Property Value
    Type Description
    System.String

    The plain text content as a string.

    ToolbarItems

    Gets or sets the collection of toolbar items used in the editor.

    Declaration
    public RichTextEditorToolBarItemCollection ToolbarItems { get; set; }
    Property Value
    Type
    RichTextEditorToolBarItemCollection

    ToolbarPosition

    Gets or sets the position of the toolbar.

    Declaration
    public RichTextEditorToolbarPosition ToolbarPosition { get; set; }
    Property Value
    Type Description
    RichTextEditorToolbarPosition

    The toolbar position.

    ToolbarSettings

    Gets or sets the appearance settings for the toolbar.

    Declaration
    public RichTextEditorToolbarSettings ToolbarSettings { get; set; }
    Property Value
    Type
    RichTextEditorToolbarSettings

    Methods

    AlignCenter()

    Aligns the current paragraph or selection to the center.

    Declaration
    public void AlignCenter()

    AlignJustify()

    Justifies the current paragraph or selection.

    Declaration
    public void AlignJustify()

    AlignLeft()

    Aligns the current paragraph or selection to the left.

    Declaration
    public void AlignLeft()

    AlignRight()

    Aligns the current paragraph or selection to the right.

    Declaration
    public void AlignRight()

    ApplyFontFamily(String)

    Sets the font family for the selected text or cursor position.

    Declaration
    public void ApplyFontFamily(string fontFamily)
    Parameters
    Type Name Description
    System.String fontFamily

    The font family name to apply.

    ApplyFontSize(Double)

    Sets the font size for the selected text or cursor position.

    Declaration
    public void ApplyFontSize(double fontSize)
    Parameters
    Type Name Description
    System.Double fontSize

    The font size in pixels.

    ApplyHighlightColor(Color)

    Applies background color formatting to the selected text or at cursor position.

    Declaration
    public void ApplyHighlightColor(Color color)
    Parameters
    Type Name Description
    Microsoft.Maui.Graphics.Color color

    The background color to apply to the text.

    ApplyParagraphFormat(RichTextEditorParagraphFormat)

    Sets the paragraph format as paragraph, heading (1-4), quotation or code block.

    Declaration
    public void ApplyParagraphFormat(RichTextEditorParagraphFormat heading)
    Parameters
    Type Name Description
    RichTextEditorParagraphFormat heading

    The value may be paragraph, heading (1-4), quotation or code block.

    ApplyTextColor(Color)

    Applies text color formatting to the selected text or at cursor position.

    Declaration
    public void ApplyTextColor(Color color)
    Parameters
    Type Name Description
    Microsoft.Maui.Graphics.Color color

    The color to apply to the text.

    DecreaseIndent()

    Decreases the indentation level of the current paragraph or selection.

    Declaration
    public void DecreaseIndent()

    Dispose()

    Releases all resources used by the SfRichTextEditor.

    Declaration
    public void Dispose()

    Dispose(Boolean)

    Releases the unmanaged resources used by the SfRichTextEditor and optionally releases the managed resources.

    Declaration
    protected virtual void Dispose(bool disposing)
    Parameters
    Type Name Description
    System.Boolean disposing

    True to release both managed and unmanaged resources; false to release only unmanaged resources.

    EditHyperlink(String, String, String)

    Edits an existing hyperlink at the current selection or cursor position.

    Declaration
    public void EditHyperlink(string text, string oldUrl, string newUrl)
    Parameters
    Type Name Description
    System.String text

    The text to display for the hyperlink.

    System.String oldUrl

    The URL for the hyperlink.

    System.String newUrl

    The URL for the hyperlink.

    Focus()

    Focuses the editor programmatically.

    Declaration
    public void Focus()

    GetSelectedText()

    Gets the Selected Text.

    Declaration
    public Task<string> GetSelectedText()
    Returns
    Type
    System.Threading.Tasks.Task<System.String>

    IncreaseIndent()

    Increases the indentation level of the current paragraph or selection.

    Declaration
    public void IncreaseIndent()

    InsertHyperlink(String, String)

    Inserts a hyperlink at the current cursor position or replaces the current selection.

    Declaration
    public void InsertHyperlink(string displayText, string url)
    Parameters
    Type Name Description
    System.String displayText

    The text to display for the hyperlink.

    System.String url

    The URL for the hyperlink.

    InsertHyperlinkAsync(String, String, String)

    Inserts a hyperlink at the current cursor position or replaces selected text.

    Declaration
    public Task<bool> InsertHyperlinkAsync(string url, string text, string title = null)
    Parameters
    Type Name Description
    System.String url

    The URL of the hyperlink.

    System.String text

    The display text of the hyperlink.

    System.String title

    The optional title attribute of the hyperlink.

    Returns
    Type Description
    System.Threading.Tasks.Task<System.Boolean>

    A task that represents the asynchronous operation. The task result contains true if successful.

    InsertImage(RichTextEditorImageSource)

    Increases the image at the currnt cursor position.

    Declaration
    public void InsertImage(RichTextEditorImageSource imageSource)
    Parameters
    Type Name Description
    RichTextEditorImageSource imageSource

    InsertTable(Int32, Int32)

    Insert the table

    Declaration
    public void InsertTable(int rowCount, int columnCount)
    Parameters
    Type Name Description
    System.Int32 rowCount
    System.Int32 columnCount

    MoveCursorToEnd()

    Moves the cursor to the end of the content in the editor.

    Declaration
    public void MoveCursorToEnd()

    MoveCursorToStart()

    Moves the cursor to the start of the content in the editor.

    Declaration
    public void MoveCursorToStart()

    OnBindingContextChanged()

    Declaration
    protected override void OnBindingContextChanged()
    Overrides
    SfView.OnBindingContextChanged()

    OnHistoryStateChanged()

    Raises the HistoryStateChanged event.

    Declaration
    protected virtual void OnHistoryStateChanged()

    OnPropertyChanged(String)

    Override the OnPropertyChanged to handle MinimumHeightRequest changes

    Declaration
    protected override void OnPropertyChanged(string propertyName)
    Parameters
    Type Name Description
    System.String propertyName

    OnSizeAllocated(Double, Double)

    Called when the size of the control is allocated.

    Declaration
    protected override void OnSizeAllocated(double width, double height)
    Parameters
    Type Name Description
    System.Double width

    The allocated width.

    System.Double height

    The allocated height.

    Redo()

    Performs a redo operation.

    Declaration
    public void Redo()

    RemoveHyperlink(String, String)

    Removes the hyperlink at the current cursor position while preserving the text.

    Declaration
    public void RemoveHyperlink(string text, string Url)
    Parameters
    Type Name Description
    System.String text
    System.String Url

    ToggleBold()

    Applies bold formatting to the selected text or at cursor position.

    Declaration
    public void ToggleBold()

    ToggleBulletList()

    Toggles bullet list formatting for the current paragraph or selection.

    Declaration
    public void ToggleBulletList()

    ToggleItalic()

    Applies italic formatting to the selected text or at cursor position.

    Declaration
    public void ToggleItalic()

    ToggleNumberedList()

    Toggles numbered list formatting for the current paragraph or selection.

    Declaration
    public void ToggleNumberedList()

    ToggleStrikethrough()

    Applies strikethrough formatting to the selected text or at cursor position.

    Declaration
    public void ToggleStrikethrough()

    ToggleSubscript()

    Applies subscript formatting to the selected text or at cursor position.

    Declaration
    public void ToggleSubscript()

    ToggleSuperscript()

    Applies superscript formatting to the selected text or at cursor position.

    Declaration
    public void ToggleSuperscript()

    ToggleUnderline()

    Applies underline formatting to the selected text or at cursor position.

    Declaration
    public void ToggleUnderline()

    Undo()

    Performs an undo operation.

    Declaration
    public void Undo()

    Unfocus()

    Removes focus from the editor.

    Declaration
    public void Unfocus()

    Events

    Focused

    Occurs when the editor gains focus.

    Declaration
    public event EventHandler Focused
    Event Type
    Type
    System.EventHandler

    FormatChanged

    Occurs when the formatting status changes.

    Declaration
    public event EventHandler<RichTextEditorFormatChangedEventArgs> FormatChanged
    Event Type
    Type
    System.EventHandler<RichTextEditorFormatChangedEventArgs>

    HyperlinkClicked

    Occurs when a hyperlink is selected in the editor.

    Declaration
    public event EventHandler<RichTextEditorHyperlinkClickedEventArgs> HyperlinkClicked
    Event Type
    Type
    System.EventHandler<RichTextEditorHyperlinkClickedEventArgs>

    ImageRequested

    Image inserted event occurs when image button in toolbar is clicked.

    Declaration
    public event EventHandler<RichTextEditorImageRequestedEventArgs> ImageRequested
    Event Type
    Type
    System.EventHandler<RichTextEditorImageRequestedEventArgs>

    TextChanged

    Occurs when text content in the editor changes.

    Declaration
    public event EventHandler<RichTextEditorTextChangedEventArgs> TextChanged
    Event Type
    Type
    System.EventHandler<RichTextEditorTextChangedEventArgs>

    Unfocused

    Occurs when the editor loses focus.

    Declaration
    public event EventHandler Unfocused
    Event Type
    Type
    System.EventHandler

    Implements

    IDrawableLayout
    Microsoft.Maui.Graphics.IDrawable
    Microsoft.Maui.IAbsoluteLayout
    Microsoft.Maui.ILayout
    Microsoft.Maui.IView
    Microsoft.Maui.IElement
    Microsoft.Maui.ITransform
    Microsoft.Maui.IContainer
    System.Collections.Generic.IList<>
    System.Collections.Generic.ICollection<>
    System.Collections.Generic.IEnumerable<>
    System.Collections.IEnumerable
    Microsoft.Maui.ISafeAreaView
    Microsoft.Maui.IPadding
    Microsoft.Maui.ICrossPlatformLayout
    Microsoft.Maui.IVisualTreeElement
    System.IDisposable
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved