Skip to content

text-rendering.md

Latest commit

 

History

History
33 lines (24 loc) · 2.67 KB

text-rendering.md

File metadata and controls

33 lines (24 loc) · 2.67 KB
title Text Rendering
page_title Text Rendering | Telerik Presentation Framework
description Telerik Presentation Framework allows you to control whether GDI or GDI+ will be used for text rendering.
slug winforms/telerik-presentation-framework/text-rendering
tags text,rendering
published true
position 9

Text Rendering

By default, Telerik Presentation Framework uses GDI+ to measure and render the text. You can easily switch to GDI instead by setting the UseCompatibleTextRendering property to false for the respective control. In R2 2017 we introduced the static property RadControl.UseCompatibleTextRenderingDefaultValue which allows the user to globally control the default value for UseCompatibleTextRendering property. It is recommended to set it before calling InitializeComponent.

caption Figure 1: UseCompatibleTextRendering.

telerik-presentation-framework-text-rendering 001

All controls that contain a TextPrimitive in its internal structure can specify what graphics text-rendering mode to be used for painting text of the element by the TextPrimitive.TextRenderingHint. The DisabledTextRenderingHint property controls the graphics text-rendering mode to be used for painting text of the element when in disabled mode. The available options are:

  • SystemDefault: Each character is drawn using its glyph bitmap, with the system default rendering hint. The text will be drawn using whatever font-smoothing settings the user has selected for the system.
  • SingleBitPerPixelGridFit: Each character is drawn using its glyph bitmap. Hinting is used to improve character appearance on stems and curvature.
  • SingleBitPerPixel: Each character is drawn using its glyph bitmap. Hinting is not used.
  • AntiAliasGridFit: Each character is drawn using its anti-aliased glyph bitmap with hinting. Much better quality due to anti-aliasing, but at a higher performance cost.
  • AntiAlias: Each character is drawn using its anti-aliased glyph bitmap without hinting. Better quality due to anti-aliasing. Stem width differences may be noticeable because hinting is turned off.
  • ClearTypeGridFit: Each character is drawn using its glyph ClearType bitmap with hinting. The highest quality setting. Used to take advantage of ClearType font features.

note [HTML-like text formatting]({%slug winforms/telerik-presentation-framework/html-like-text-formatting%}) functionality is supported only when using GDI+.

See Also