maui-404638-html-edit-modify-html-markup.md
The HTML Edit control includes APIs that allow you to customize the appearance of the selected/typed text. End-users can also use it select content and customize its appearance using the built-in toolbar control.
The table below lists properties that customize text decoration and font settings for the selected text:
| Property | Description |
|---|---|
| SelectedTextDecorations | Gets or sets the TextDecorations applied to the selected/typed text. This is a bindable property. |
| SelectedTextFontAttributes | Gets or sets the font attributes of the text that is selected/typed text. This is a bindable property. |
| SelectedTextFontFamily | Gets or sets the font family of the text that is selected/typed text. This is a bindable property. |
| SelectedTextFontSize | Gets or sets the font size of the text that is selected/typed text. This is a bindable property. |
The following code snippet selects a text area and specifies its SelectedTextDecorations and SelectedTextFontFamily properties:
await htmledit.SetSelectionRangeAsync(0,18);
htmledit.SelectedTextDecorations = TextDecorations.Underline;
htmledit.SelectedTextFontFamily = "Courier";
The built-in toolbar includes the following items that change text decoration and font settings for the selected/typed text:
You can also find related toolbar items in the toolbar keyboard area view:
Use the SelectedTextHeadingLevel property to customize heading type of the selected/typed text.
The following code snippet selects the text region and set its SelectedTextHeadingLevel property to Heading1:
await htmledit.SetSelectionRangeAsync(0,18);
htmledit.SelectedTextHeadingLevel = HtmlHeadingLevel.Heading1;
The built-in keyboard area view includes the following commands that change heading types of the selected/typed text:
Use SelectedTextHorizontalAlignment and SelectedTextLineHeight properties to customize height and alignment for the line that contains the caret or current text selection.
The following code changes caret position and specifies the corresponding line’s SelectedTextHorizontalAlignment and SelectedTextLineHeight properties:
await htmledit.SetSelectionRangeAsync(123, 0);
htmledit.SelectedTextLineHeight = new HtmlLineHeight(20,Unit.Points);
htmledit.SelectedTextHorizontalAlignment = HtmlTextHorizontalAlignment.Justify;
The built-in toolbar includes the following items that change height and alignment for the line that contains the caret or current selection:
You can also find related toolbar items in the toolbar keyboard area view:
Use SelectedTextIndent property to customize indent for the line that contains the caret or current selection. The and SelectedTextListType property allows you to create a list.
The following code snippet selects two text regions and specifies their SelectedTextIndent and SelectedTextListType properties:
await htmledit.SetSelectionRangeAsync(108, 12);
htmledit.SelectedTextListType = HtmlListType.Bullet;
await htmledit.SetSelectionRangeAsync(125, 30);
htmledit.SelectedTextIndent = HtmlTextIndent.Indent1;
htmledit.SelectedTextListType = HtmlListType.Bullet;
The built-in toolbar includes the following items that change line indents and create lists:
You can also find related toolbar items in the toolbar keyboard area view:
Use SelectedTextBackground and SelectedTextForeground properties to customize background and foreground colors for selected/typed text.
The following code snippet selects two text regions. It sets the first region’s SelectedTextBackground property to DarkOrange and the second region’s SelectedTextForeground property to LightGreen :
await htmledit.SetSelectionRangeAsync(0,18);
htmledit.SelectedTextForeground = Colors.DarkOrange;
await htmledit.SetSelectionRangeAsync(123,10);
htmledit.SelectedTextBackground = Colors.LightGreen;
The built-in toolbar includes the following items that change background and foreground colors for selected/typed text:
You can also find related toolbar items in the toolbar keyboard area view:
Use the SelectedTextHyperlink property and the InsertImageAsync method to insert hyperlinks and images into HTML content.
The code snippet below inserts a hyperlink and an image into content. The image is stored in the project’s Resources/Raw folder.
await htmledit.SetSelectionRangeAsync(123, 9);
htmledit.SelectedTextHyperlink = new HtmlHyperlink(htmledit.SelectedText, "https://dictionary.cambridge.org/dictionary/english/effective");
await Task.Delay(200);
await htmledit.SetSelectionRangeAsync(160, 0);
await htmledit.InsertImageAsync("devexpress.png");
The built-in toolbar includes the following items that insert a hyperlink or an image:
Call the InsertTable command to display the TableSizeSelector control where you can pick the table size to insert into HTML content.
Call the DeleteTable command to remove the table that is under caret.
You can also use the following commands to insert/remove table rows and columns:
| Command | Description |
|---|---|
| InsertTableColumnLeft | Gets the command that inserts the table column to the left of the caret position. |
| InsertTableColumnRight | Gets the command that inserts the table column to the right of the caret position. |
| InsertTableRowAbove | Gets the command that inserts the table column to the above the caret position. |
| InsertTableRowBelow | Gets the command that inserts the table column below the caret position. |
| DeleteTableColumn | Gets the command that removes the table column that is under the caret. |
| DeleteTableRow | Gets the command that removes the table row that is under the caret. |
The built-in toolbar includes the following item that inserts tables:
When a table is selected, the following toolbar panel is displayed:
Select ContentThis topic describes how to select the displayed content.Create a Custom ToolbarThis topic describes how to create a custom DXToolbar.