GDI+ Compatibility Mode

Cells support the string rendering using both GDI as well as GDI+. GDI is used by default. GDI+ is used when the CellStyle.UseCompatibleTextRendering property is set to True. This property works the same as the Label and Button controls in .NET Framework 2.0 and above. The value, True, in the CellStyle.UseCompatibleTextRendering property implies GDI+ compatible mode. The Styles of each of the Cell Types can be used to determine whether the cell types support the GDI+ compatibility mode of the styles.

There are a few limitations due to the differences between GDI and GDI+, if the GDI+ compatibility mode is enabled. Refer to the Limitations section of this document for details.

Enable GDI+ Compatibility Mode

You need to set the CellStyle.UseCompatibleTextRendering property to True to enable the GDI+ compatibility mode.

Using Code

This example sets the UseCompatibleTextRendering property.

[VB]

Imports GrapeCity.Win.MultiRow

GcMultiRow1.Rows(0).Cells(0).Style.UseCompatibleTextRendering = MultiRowTriState.True
GcMultiRow1.Rows(0).Cells(0).Value = "GDI+ Compatibility Mode"

[CS]

using GrapeCity.Win.MultiRow;

gcMultiRow1.Rows[0].Cells[0].Style.UseCompatibleTextRendering = MultiRowTriState.True;
gcMultiRow1.Rows[0].Cells[0].Value = "GDI+ Compatibility Mode";

Distributing Text

You can use the distributed alignment of text when the GDI+ compatibility mode is enabled. To specify the space on the left and right for the distributed text, you can use either or both the padding and equal distribution. Unlike Excel, indent is not applied to the distributed alignment.

Using Code

This example uses the distributed alignment.

[VB]

Imports GrapeCity.Win.MultiRow

GcMultiRow1.Rows(0).Cells(0).Style.UseCompatibleTextRendering = MultiRowTriState.True
GcMultiRow1.Rows(0).Cells(0).Style.TextAdjustment = TextAdjustment.Distribute
GcMultiRow1.Rows(0).Cells(0).Value = "Nebraska"

[CS]

using GrapeCity.Win.MultiRow;

gcMultiRow1.Rows[0].Cells[0].Style.UseCompatibleTextRendering = MultiRowTriState.True;
gcMultiRow1.Rows[0].Cells[0].Style.TextAdjustment = TextAdjustment.Distribute;
gcMultiRow1.Rows[0].Cells[0].Value = "Nebraska";

Rotating Text

You can use the text rotation when the GDI+ compatibility mode is enabled.

Using Code

This example rotates the text.

[VB]

Imports GrapeCity.Win.MultiRow

GcMultiRow1.Rows(0).Cells(0).Style.UseCompatibleTextRendering = MultiRowTriState.True
GcMultiRow1.Rows(0).Cells(0).Style.TextAngle = 45.0F
GcMultiRow1.Rows(0).Cells(0).Value = "Ohio"

[CS]

using GrapeCity.Win.MultiRow;

gcMultiRow1.Rows[0].Cells[0].Style.UseCompatibleTextRendering = MultiRowTriState.True;
gcMultiRow1.Rows[0].Cells[0].Style.TextAngle = 45f;
gcMultiRow1.Rows[0].Cells[0].Value = "Ohio";

Vertical Text

You can use the vertical text feature when the GDI+ compatibility mode is enabled.

Using Code

This example uses vertical text.

[VB]

Imports GrapeCity.Win.MultiRow

gcMultiRow1.Rows(0).Cells(0).Style.UseCompatibleTextRendering = MultiRowTriState.True
gcMultiRow1.Rows(0).Cells(0).Style.TextVertical = MultiRowTriState.True
gcMultiRow1.Rows(0).Cells(0).VerticalResize(50)
gcMultiRow1.Rows(0).Cells(0).Value = "Yellow Line"

[CS]

using GrapeCity.Win.MultiRow;

gcMultiRow1.Rows[0].Cells[0].Style.UseCompatibleTextRendering = MultiRowTriState.True;
gcMultiRow1.Rows[0].Cells[0].Style.TextVertical = MultiRowTriState.True;
gcMultiRow1.Rows[0].Cells[0].VerticalResize(50);
gcMultiRow1.Rows[0].Cells[0].Value = "Yellow Line";

Limitations

When the GDI+ compatibility mode is enabled, there might be cases where the space between characters and cell position for cells in edit mode are different from the cells not in edit mode ( Microsoft Support Document Online Number - 307208 Why text appears different when drawn with GDIPlus versus GDI http://support.microsoft.com/kb/307208/).
When the GDI+ compatibility mode is enabled, and you specify Microsoft Sans Serif for the cell font, the single byte Yen character will be displayed as back slash when not in edit mode.
When the GDI+ compatibility mode is enabled, and word wrap has been enabled, there might be cases where space characters are not displayed.
When the GDI+ compatibility mode is enabled, there might be cases when the double byte hyphen is not displayed. This problem was fixed in November 2008 ( Microsoft Support Document Online Number - 956807). If you use an application that uses GDI+ API functions on Windows Server 2008, Windows Vista, Windows Server 2003, or Windows XP, the Unicode hyphen character (U+2010) is not rendered (http://support.microsoft.com/kb/956807/).
When the GDI+ compatibility mode is enabled, the tab characters (tab stop) are not displayed. This is a limitation of MultiRow.
When the GDI+ compatibility mode is enabled, the Unicode composite and control characters are not displayed correctly (for example: "\u0041\u0301\u304b\u3099\u304b\u309a", "\u202e Lighting\u202c").
When the GDI+ compatibility mode is enabled, there are cases where the character width is incorrect when the same character is repeated a number of times (for example: "jjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjj").