In Telerik’s RadRichTextBox you can easily insert images, tables, etc. Now it is possible to label these by inserting captions. This will help you define an image or a table and then refer to it later.
You can open the Caption window by clicking on the Caption button.
If the caret is inside a table, the caret would look like this:
On the top there is a preview of the caption text that would be inserted. In this case we haven’t inserted any other captions with label “Table” so the number that follows is 1. That number represents the number of captions inserted before that one with the same label.
You can select different options. The first one is Label. From here you can select the label text. By default you have two options – Figure and Table.
You can also specify the Position of the caption - Above selected item or Below selected item
We will have this option only if the caret is in a table or on an image. Otherwise it will be disabled.
Creating and deleting labels
You can add new labels by using the New Label… dialog and of course delete old ones with the Delete Label button.
You cannot delete the two default labels - Figure and Table
When Exclude label from caption checkbox is checked the label text will be removed and only the number will be left.
You can control how the numbering is displayed by using the Format ComboBox. You can see the available formats in the picture below. By default the (“1, 2, 3, …”) format is selected.
Include chapter number
When the Include chapter number checkbox is checked, every time you insert a Caption in a new section, the numbering is restarted. That’s why the preview now looks like this:
The first number shows the bullet of the section you are currently in, and the second number shows the number of Captions being inserted in this section.
A section is defined by the Heading styles, but only when they are in a list. You can choose which Heading style the chapter starts from and what separator to use. There are several available separators – hyphen, period, colon.
Clicking on the OK button will insert the Caption.It would look like this:
Here the Below selected item position is chosen, : for separator and A, B, C… for formatting.
Using Telerik’s rich text editor’s API is pretty straight forward. There is a method called InsertCaption() on RadRichTextBox which you can use to insert a new Caption into the document with a custom label. The method has the following signature:
public void InsertCaption(CaptionDefinition definition, string caption, bool includeLabel, bool insertBelow)
The CaptionDefinition class contains viable information for the creation of the caption like Label, NumberingFormat and SeparatorType. The “caption” parameter is of type string and represents the text in the caption that will be inserted after the number (also known as caption text). The “includeLabel” parameter is of type Boolean and if true will include the label text to the caption. The “insertBelow” parameter is of type Boolean as well and if true will insert the caption below the table or figure. So, in order to insert a caption using this method you would do something like:
CaptionDefinition captionDefinition = new CaptionDefinition(); captionDefinition.Label = "testLabel"; captionDefinition.NumberingFormat = Documents.Model.Fields.NumberingFormat.Arabic; captionDefinition.SeparatorType = Documents.Model.Fields.CaptionSeparatorType.Colon; this.radRichTextBox1.InsertCaption(captionDefinition, "captionText", true, true);
The RadDocument contains the two default CaptionDefinitions by default. They reside in a collection called “CaptionDefinitions” which is of type Dictionary
this.radRichTextBox1.InsertCaption(this.editor.Document.CaptionDefinitions["Table"], "captionText", true, true);
This code will insert a default caption with label Table.