Download demo project - 40 Kb
Download source - 6 Kb
<!-- Article Starts -->
<!-- The 'p' starts a paragraph of normal text -->
While MFC does provide a rich edit control, it does not provide a quick and
easy way to handle formatting and RTF codes.
CAutoRichEditCtrl is a derivative
CRichEditCtrl. This new class adds several functions that allow you to add
formatting quickly. It also provides two functions to let you retrieve the
formatted text (RTF) in a
CString, and to insert an RTF
CString into the
CAutoRichEditCtrl in a dialog box, follow these instructions.
- Insert a normal rich edit control in your dialog box.
- Using ClassWizard, attach a control variable of type
CRichEditCtrl to your control.
- Copy AutoRichEditCtrl.cpp and AutoRichEditCtrl.h (download below) to your source directory, and #include "AutoRichEditCtrl.h" in your dialog's header.
- In your dialog's header, change
- In your application's InitInstance (
CMyApp::InitInstance()), include a call to
AfxInitRichEdit() - this is needed for all rich edit controls.
- Add interface elements that use
CAutoRichEditCtrls's functions - see below.
Once you've inserted the control into your project, you can add toolbar buttons, menu commands, or other elements to call the following functions:
- GetRTF() - returns a
CString holding the text of the control (including the RTF formatting code).
- SetRTF(CString sRTF) - parameter sRTF is an RTF formatted CString. Calling this will insert and format the string. If a
CString is passed that does not have valid RTF code, the control will be cleared.
- SelectionIsBold() - returns
true if the current selection is bold, otherwise
- SelectionIsItalic()- returns
true if the current selection is italic, else
- SelectionIsUnderlined() - returns
true if the current selection is underlined, else
- SetSelectionBold() - sets the current selection to be bold (Note: this will actually act like pressing the Bold toolbar button in Wordpad - if the text is not bold, it will become bold; if the text is already bold, it will remove the bold formatting; if part of the selection is bold, the entire selection will become bold; if there is not anything selected, the format is changed to bold so when the user starts typing, it will be in bold).
- SetSelectionItalic() - sets the current selection to italic (see note in
- SetSelectionUnderlined() - sets the current selection to underlined (see note in
- SetParagraphCenter() - sets the current paragraph to be centered.
- SetParagraphLeft() - sets the current paragraph to be left justified.
- SetParagraphRight() - sets the current paragraph to be right justified.
- ParagraphIsCentered() - returns
true if the current paragraph is centered, else
- ParagraphIsLeft() - returns
true if the current paragraph is left justified, else
- ParagraphIsRight() - returns
true if the current paragraph is right justified, else
- SetParagraphBulleted() - sets the bullet style (see note in
- ParagraphIsBulleted() - returns
true if the current selection is bulleted, else
- SelectColor() - displays a color selection dialog box and sets the selection to the chosen color (if OK is pressed).
- SetFontName(CString sFontName) - sets the selected font to
- SetFontSize(int nPointSize) - sets the selection to
- GetSelectionFontName() - returns a
CString holding the selection's font name.
- GetSelectionFontSize() - returns a
long holding the selection's font size.
- GetSystemFonts(CStringArray &saFontList) -
saFontList will hold an array of all true-type fonts available on the system.
- GetCharFormat() - returns the
CHARFORMAT structure of the current selection.
To see examples of these functions, download the demo app. The source code that shows examples of how to use each function is located in
A quick example here: if you want a rich edit control in a dialog to use formatting, you may create a toolbar with the typical bold, italic, and underline buttons. Just use ClassWizard to add a function for when the user presses the button (like OnBold), then call the right function (like
m_richedit.SetSelectionBold();, assuming your rich edit control is named
m_richedit). That's all it takes to set up the formatting correctly.
When you want to save the text, just do a
CString sText = m_richedit.GetRTF();, then save the string however you like - when you call
m_richedit.SetRTF(sText); with the same string, the formatting will be just like it was when you saved it.
Two thank you's are in order for Zafir Anjum and Girish Bharadwaj. The code that streams the RTF string into the control was taken from Zafir's article, Inserting an RTF string using StreamIn. The code that retrieves all the fonts on the system was derived from Girish's article, Owner Drawn Font Selection ComboBox.
You are free to use/modify this source code for whatever you like. If you do make any modifications or additions, I would appreciate it you let me know (or better, let everybody know by posting a comment). Of course, this control is provided as is, and no warranty is expressed or implied as to its fitness for any particular purpose.
Hope this helps you out!