TextRenderingHint Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica a qualidade de renderização do texto.
public enum class TextRenderingHintpublic enum TextRenderingHinttype TextRenderingHint = Public Enum TextRenderingHint- Herança
Campos
| AntiAlias | 4 | Cada caractere é desenhado usando seu bitmap de glifo com suavização sem dicas. Melhor qualidade devido à suavização. Diferenças de largura de hastes podem ser perceptíveis, pois as dicas estão desativadas. |
| AntiAliasGridFit | 3 | Cada caractere é desenhado usando seu bitmap de glifo com suavização e dicas. Qualidade muito melhor devido à suavização, porém com custo de desempenho mais alto. |
| ClearTypeGridFit | 5 | Cada caractere é desenhado usando seu bitmap ClearType de glifo com dicas. A configuração de qualidade mais alta. Usado para tirar proveito dos recursos de fonte ClearType. |
| SingleBitPerPixel | 2 | Cada caractere é desenhado usando seu bitmap de glifo. As dicas não são usadas. |
| SingleBitPerPixelGridFit | 1 | Cada caractere é desenhado usando seu bitmap de glifo. As dicas são usadas para melhorar a aparência de caractere nas hastes e curvaturas. |
| SystemDefault | 0 | Cada caractere é desenhado usando seu bitmap de glifo, com a dica de renderização padrão do sistema. O texto será desenhado usando as configurações de suavização de fonte selecionadas pelo usuário para o sistema. |
Exemplos
O exemplo de código a seguir demonstra o uso das TextRenderingHint propriedades e TextContrast e da TextRenderingHint enumeração .
Este exemplo foi projetado para ser usado com Windows Forms. Cole o código em um formulário e chame o ChangeTextRenderingHintAndTextContrast método ao manipular o evento do Paint formulário, passando e como PaintEventArgs.
private:
void ChangeTextRenderingHintAndTextContrast( PaintEventArgs^ e )
{
// Retrieve the graphics object.
Graphics^ formGraphics = e->Graphics;
// Declare a new font.
System::Drawing::Font^ myFont = gcnew System::Drawing::Font( FontFamily::GenericSansSerif,20,FontStyle::Regular );
// Set the TextRenderingHint property.
formGraphics->TextRenderingHint = System::Drawing::Text::TextRenderingHint::SingleBitPerPixel;
// Draw the string.
formGraphics->DrawString( "Hello World", myFont, Brushes::Firebrick, 20.0F, 20.0F );
// Change the TextRenderingHint property.
formGraphics->TextRenderingHint = System::Drawing::Text::TextRenderingHint::AntiAliasGridFit;
// Draw the string again.
formGraphics->DrawString( "Hello World", myFont, Brushes::Firebrick, 20.0F, 60.0F );
// Set the text contrast to a high-contrast setting.
formGraphics->TextContrast = 0;
// Draw the string.
formGraphics->DrawString( "Hello World", myFont, Brushes::DodgerBlue, 20.0F, 100.0F );
// Set the text contrast to a low-contrast setting.
formGraphics->TextContrast = 12;
// Draw the string again.
formGraphics->DrawString( "Hello World", myFont, Brushes::DodgerBlue, 20.0F, 140.0F );
// Dispose of the font object.
delete myFont;
}
private void ChangeTextRenderingHintAndTextContrast(PaintEventArgs e)
{
// Retrieve the graphics object.
Graphics formGraphics = e.Graphics;
// Declare a new font.
Font myFont = new Font(FontFamily.GenericSansSerif, 20,
FontStyle.Regular);
// Set the TextRenderingHint property.
formGraphics.TextRenderingHint =
System.Drawing.Text.TextRenderingHint.SingleBitPerPixel;
// Draw the string.
formGraphics.DrawString("Hello World", myFont,
Brushes.Firebrick, 20.0F, 20.0F);
// Change the TextRenderingHint property.
formGraphics.TextRenderingHint =
System.Drawing.Text.TextRenderingHint.AntiAliasGridFit;
// Draw the string again.
formGraphics.DrawString("Hello World", myFont,
Brushes.Firebrick, 20.0F, 60.0F);
// Set the text contrast to a high-contrast setting.
formGraphics.TextContrast = 0;
// Draw the string.
formGraphics.DrawString("Hello World", myFont,
Brushes.DodgerBlue, 20.0F, 100.0F);
// Set the text contrast to a low-contrast setting.
formGraphics.TextContrast = 12;
// Draw the string again.
formGraphics.DrawString("Hello World", myFont,
Brushes.DodgerBlue, 20.0F, 140.0F);
// Dispose of the font object.
myFont.Dispose();
}
Private Sub ChangeTextRenderingHintAndTextContrast(ByVal e As _
PaintEventArgs)
' Retrieve the graphics object.
Dim formGraphics As Graphics = e.Graphics
' Declare a new font.
Dim myFont As Font = New Font(FontFamily.GenericSansSerif, _
20, FontStyle.Regular)
' Set the TextRenderingHint property.
formGraphics.TextRenderingHint = _
System.Drawing.Text.TextRenderingHint.SingleBitPerPixel
' Draw the string.
formGraphics.DrawString("Hello World", myFont, _
Brushes.Firebrick, 20.0F, 20.0F)
' Change the TextRenderingHint property.
formGraphics.TextRenderingHint = _
System.Drawing.Text.TextRenderingHint.AntiAliasGridFit
' Draw the string again.
formGraphics.DrawString("Hello World", myFont, _
Brushes.Firebrick, 20.0F, 60.0F)
' Set the text contrast to a high-contrast setting.
formGraphics.TextContrast = 0
' Draw the string.
formGraphics.DrawString("Hello World", myFont, _
Brushes.DodgerBlue, 20.0F, 100.0F)
' Set the text contrast to a low-contrast setting.
formGraphics.TextContrast = 12
' Draw the string again.
formGraphics.DrawString("Hello World", myFont, _
Brushes.DodgerBlue, 20.0F, 140.0F)
' Dispose of the font object.
myFont.Dispose()
End Sub
Comentários
A qualidade varia de texto (desempenho mais rápido, mas de menor qualidade) a texto suavizado (melhor qualidade, mas desempenho mais lento) ao texto ClearType (melhor qualidade em um vídeo LCD).
