Last Updated: 17 Nov 2020 07:11 by ADMIN
Created on: 12 Sep 2016 11:02
Category: RichTextBox
Type: Feature Request
RichTextBox: Add support for page background color

In MS Word, the users can change the background color of the page. 

A 'w:background' property is applied to the whole document in DOCX, and this property is used as a page color in Paged layout mode, and as a background color in Web layout mode. 

When implementing, think of whether RadRichTextBox.Background should be synchronized with this property when RadRichTextBox.DocumentInheritsDefaultStyleSettings is true.

Workaround: Currently, background could be set using RadRichTextBox.Background property in Web layout mode, and using a custom style, as described in When the LayoutMode is Paged the Background forum thread, in Paged layout mode.


Posted on: 17 Nov 2020 07:11

Hi Joshua,

I am sorry to hear your disappointment with this missing functionality. Although I completely understand the inconvenience it might be causing you, it is not scheduled for implementation at this point as the team is working on more demanded tasks. I have raised the priority of the task but due to the tight planning and the relatively low demand for this feature, I am unable to say when it might be implemented.

Please, make sure to continue following this item so we can notify you about status changes on it. 

Progress Telerik

Virtual Classroom, the free self-paced technical training that gets you up to speed with Telerik and Kendo UI products quickly just got a fresh new look + new and improved content including a brand new Blazor course! Check it out at https://learn.telerik.com/.

Posted on: 10 Nov 2020 21:55
I'd also like to add that setting page color has been a normal feature of Microsoft Word since at least Office 95. Market penetration of the feature is 100% and all DOCX files can be expected to set page color.
Posted on: 10 Nov 2020 21:24
The workaround is not a complete workaround because it assumes the application knows what the document file's page color is. Otherwise, the file has to be loaded twice: once to populate the document object, and once to expand the DOCX and parse the XML to manually find the page color. This is very inefficient for large files. I would have to do the same for HTML files and parse the HTML syntax a second time to know what the page color should be.

Also, the workaround only applies to reading files. I use Telerik’s library to write DOCX files too. The workaround would suggest I have to write the DOCX once, then read it back, then write it a second time with the page color.

Is this a complicated feature on your side? I considered implementing this myself and offering it as a pull request, but I wouldn't even know where to begin, and it seems overwhelming for me to learn that area of the library code within the time I can commit. In the meantime, I am unable to read dark-themed documents created by Microsoft Word users, or to create dark-themed documents that they can read.