Spread Windows Forms 8.0 Product Documentation > Developer's Guide > Customizing Interaction with Cell Types > Working with Graphical Cell Types > Setting a Rich Text Cell |
You can create a rich text cell that has text with multiple colors and fonts in the cell.
The rich text cell has a run-time menu for formatting the text in a cell and for loading an RTF file (rich text formatted file). The menu also has basic edit operations such as cut, copy, paste, delete, and select all. To bring up the menu at run time the cell must be in Edit mode. Then you right-click in the cell to bring up the menu for handling the contents of that cell. Highlight the text first if you wish to set the color, font, or style of the text in the cell. An example of the use of the menu is shown in this figure.
The choices in the context menu are described in this table.
Menu Item |
Description |
---|---|
Cut Copy Paste |
Standard Clipboard operations that cut, copy, and paste to and from the Clipboard the contents (text and formatting) of the cell |
Delete |
Removes the selected contents (text and formatting) of the cell |
Select All |
Selects the entire contents (text and formatting) of the cell |
Clear All |
Clears the entire contents (text and formatting) of the cell |
Load |
Opens the File Open dialog to allow you to select an RTF file to load |
Color |
Opens a color palette to allow you to select a color that is either applied to selected text or is used as the color of subsequent text |
Font |
Opens a font picker to allow you to select a font face and size that is either applied to selected text or is used as the font of subsequent text |
Style |
Opens a menu to allow you to select a font style (bold, italics, or underline) that is either applied to selected text or is used as the font of subsequent text |
Align |
Opens a menu to allow you to set the text alignment |
When the rich-text cell is first edited or text is loaded, the RTF string of data and formatting information is set in the cell. Subsequent changes to the cell, column, or row appearance settings (such as font, text color, alignment) do not affect the existing text because the formatting information for that text is already set. For the newer settings to be applied to the original string, you must completely clear the cell of both data and formatting.
Setting a property such as alignment may not apply after the cell has been modified in edit mode. Many formatting properties (HorizontalAlignment, Font, ForeColor, etc...) can be set in the hidden RTF code associated with the Value of the cell. For example, setting the HorizontalAlignment property prior to any editing may correctly set the alignment, but setting this property after editing may not have the desired effect. RTF has hidden formatting embedded in the RTF string which may be parsed or viewed through the Value property of the cell.
You can use the Value property in code to load the contents of an RTF file as a string of RTF commands, or you can set any set of RTF commands directly.
The cell width may be off several pixels if you automatically size the rich text cell and you are using multiple fonts.
Deleting the text from a rich-text cell puts a non-null string in the cell. This may cause unexpected results with the ISBLANK and COUNTBLANK formula functions since they treat the non-null string as non-blank.
If the WordWrap property is true when using the GetPreferredRowHeight method, the height may be slightly larger if the last character on a wrapped line is on the border.
The rich-text cell uses the Microsoft .NET RichTextBox class for editing. Text using a font with extended character sets, like MSPMincho, cannot be set to a font that does not support extended character sets, like Tahoma. The result is that RichTextBox does not allow you to change the font of a Far East script-based font to a Western font.
This font issue is a limitation of the RichTextBox for the Microsoft Windows 2000 operating system. If you try to set a font that does not support extended character sets, like Tahoma, on text with extended characters, a message box is displayed.
For more information on the properties and methods of this cell type, refer to the RichTextCellType class.
C# |
Copy Code
|
---|---|
FarPoint.Win.Spread.CellType.RichTextCellType rtf = new FarPoint.Win.Spread.CellType.RichTextCellType(); rtf.WordWrap = true; rtf.Multiline = true; fpSpread1.ActiveSheet.Cells[0, 0].CellType = rtf; fpSpread1.ActiveSheet.Columns[0].Width = 300; fpSpread1.ActiveSheet.Rows[0].Height = 150; fpSpread1.ActiveSheet.Cells[0, 0].Value = @"{\rtf1\ansi\ansicpg1252\deff0\deflang1033 {\fonttbl{\f0\fscript\fprq2\fcharset0 Comic Sans MS;} {\f1\froman\fprq2\fcharset0 Times New Roman;} {\f2\fswiss\fcharset0 Arial;}}{\colortbl ;\red128 \green0\blue128;\red0\green255\blue255;\red255\green0\ blue0;\red0\green255\blue0;\red0\green0\blue255;} \viewkind4\uc1\pard\cf1\b\f0\fs24 Testing\cf2\b0\fs28 \cf3 \f1\fs40 1... \cf4\i 2... \cf5\ul\i0 3...\cf0\f2\fs20\par}"; |
VB |
Copy Code
|
---|---|
Dim rtf As New FarPoint.Win.Spread.CellType.RichTextCellType() rtf.WordWrap = True rtf.Multiline = True FpSpread1.ActiveSheet.Cells(0, 0).CellType = rtf FpSpread1.ActiveSheet.Columns(0).Width = 300 FpSpread1.ActiveSheet.Rows(0).Height = 150 FpSpread1.ActiveSheet.Cells(0, 0).Value = "{\rtf1\ansi\ansicpg1252\deff0\deflang1033" + _ "{\fonttbl{\f0\fscript\fprq2\fcharset0 Comic Sans MS;}" + _ "{\f1\froman\fprq2\fcharset0 Times New Roman;}" + _ "{\f2\fswiss\fcharset0 Arial;}}" + _ "{\colortbl ;\red128\green0\blue128;\red0\green255\blue255;" + _ "\red255\green0\blue0;" + _ "\red0\green255\blue0;\red0\green0\blue255;}" + _ "\viewkind4\uc1\pard\cf1\b\f0\fs24 Testing\cf2\b0\fs28" + _ " \cf3\f1\fs40 1... \cf4\i 2... \cf5\ul\i0 3...\cf0\f2\fs20\par" + _ "}" |
C# |
Copy Code
|
---|---|
System.IO.TextReader f = System.IO.File.OpenText("your_file.rtf"); string bits; bits = f.ReadToEnd(); f.Close(); fpSpread1.ActiveSheet.Cells[0, 0].CellType = new FarPoint.Win.Spread.CellType.RichTextCellType(); fpSpread1.ActiveSheet.Cells[0, 0].Value = bits; |
VB |
Copy Code
|
---|---|
Dim f as System.IO.TextReader = System.IO.File.OpenText("your_file.rtf") Dim bits As String bits = f.ReadToEnd() f.Close() FpSpread1.ActiveSheet.Cells(0, 0).CellType = New FarPoint.Win.Spread.CellType.RichTextCellType() FpSpread1.ActiveSheet.Cells(0, 0).Value = bits |
Or right-click on the cell or cells and select Cell Type. From the list, select RichText. In the CellType editor, set the properties you need. Click Apply.