TextRenderingHint Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica la qualità di rendering del testo.
public enum class TextRenderingHintpublic enum TextRenderingHinttype TextRenderingHint = Public Enum TextRenderingHint- Ereditarietà
Campi
| AntiAlias | 4 | Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo con anti-aliasing, senza funzionalità di hint. Migliore qualità dovuta alla funzionalità di antialias. Differenze nella larghezza delle aste possono essere evidenti a causa della disabilitazione della funzionalità di hint. |
| AntiAliasGridFit | 3 | Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo con anti-aliasing, con funzionalità di hint. Qualità notevolmente migliore, grazie alla funzionalità di antialias, ma riduzione delle prestazioni. |
| ClearTypeGridFit | 5 | Ogni carattere viene visualizzato utilizzando la relativa bitmap ClearType di glifo, con funzionalità di hint. Impostazione per la qualità più elevata. Utilizzata per sfruttare le funzionalità dei tipi di carattere ClearType. |
| SingleBitPerPixel | 2 | Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo. La funzionalità di hint non è utilizzata. |
| SingleBitPerPixelGridFit | 1 | Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo. La funzionalità di hint viene utilizzata per migliorare l'aspetto dei caratteri, per quanto concerne aste e curvatura. |
| SystemDefault | 0 | Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo, con l'hint di rendering predefinito del sistema. Il testo verrà visualizzato utilizzando le impostazioni di smussatura dei caratteri selezionate dall'utente per il sistema. |
Esempio
Nell'esempio di codice seguente viene illustrato l'uso delle TextRenderingHint proprietà e TextContrast e dell'enumerazione TextRenderingHint .
Questo esempio è progettato per essere usato con Windows Forms. Incollare il codice in una maschera e chiamare il metodo quando si gestisce l'evento ChangeTextRenderingHintAndTextContrast del Paint modulo, passando e come 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
Commenti
La qualità varia dal testo (prestazioni più veloci, ma di qualità più bassa) al testo antialiased (migliore qualità, ma prestazioni più lente) al testo ClearType (migliore qualità su uno schermo LCD).
