Leggere in inglese

Condividi tramite


Graphics.MeasureString Metodo

Definizione

Misura la stringa specificata quando viene disegnata con il Fontspecificato.

Overload

MeasureString(ReadOnlySpan<Char>, Font, Int32, StringFormat)

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

MeasureString(String, Font, SizeF, StringFormat, Int32, Int32)

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat, Int32, Int32)

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

MeasureString(String, Font, Int32, StringFormat)

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

MeasureString(String, Font, SizeF, StringFormat)

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

MeasureString(String, Font, PointF, StringFormat)

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat)

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

MeasureString(ReadOnlySpan<Char>, Font)

Misura la stringa specificata quando viene disegnata con il Fontspecificato.

MeasureString(String, Font, Int32)

Misura la stringa specificata quando viene disegnata con il Fontspecificato.

MeasureString(String, Font, SizeF)

Misura la stringa specificata quando viene disegnata con il Font specificato all'interno dell'area di layout specificata.

MeasureString(ReadOnlySpan<Char>, Font, Int32)

Misura la stringa specificata quando viene disegnata con il Fontspecificato.

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

Misura la stringa specificata quando viene disegnata con il Font specificato all'interno dell'area di layout specificata.

MeasureString(String, Font)

Misura la stringa specificata quando viene disegnata con il Fontspecificato.

MeasureString(ReadOnlySpan<Char>, Font, PointF, StringFormat)

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

MeasureString(ReadOnlySpan<Char>, Font, Int32, StringFormat)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

C#
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, int width, System.Drawing.StringFormat? format);

Parametri

text
ReadOnlySpan<Char>

Stringa da misurare.

font
Font

Font che definisce il formato di testo della stringa.

width
Int32

Larghezza massima della stringa.

format
StringFormat

StringFormat che rappresenta le informazioni di formattazione, ad esempio l'interlinea, per la stringa.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata nel parametro text come disegnato con il parametro font e il parametro stringFormat.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 8, 9
Windows Desktop 8, 9

MeasureString(String, Font, SizeF, StringFormat, Int32, Int32)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

C#
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat, out int charactersFitted, out int linesFilled);
C#
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat stringFormat, out int charactersFitted, out int linesFilled);

Parametri

text
String

Stringa da misurare.

font
Font

Font che definisce il formato di testo della stringa.

layoutArea
SizeF

SizeF struttura che specifica l'area di layout massima per il testo.

stringFormat
StringFormat

StringFormat che rappresenta le informazioni di formattazione, ad esempio l'interlinea, per la stringa.

charactersFitted
Int32

Numero di caratteri nella stringa.

linesFilled
Int32

Numero di righe di testo nella stringa.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni della stringa, nelle unità specificate dalla proprietà PageUnit, del parametro text come disegnato con il parametro font e il parametro stringFormat.

Eccezioni

font è null.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

  • Crea una stringa per misurare e un oggetto carattere impostato su Arial (16 punti)

  • Imposta la dimensione massima del layout della stringa.

  • Crea un oggetto formato stringa e imposta i flag di formato su DirectionVertical.

  • Crea le variabili integer charactersFitted e linesFilled e un oggetto size per misurare la stringa.

  • Misura le dimensioni della stringa e determina il numero di caratteri inseriti e le righe riempite, utilizzando la stringa, l'oggetto carattere, le dimensioni massime del layout e il formato stringa.

  • Disegna un rettangolo rosso utilizzando le dimensioni misurate della stringa.

  • Disegna la stringa all'interno del rettangolo disegnato.

  • Disegna i valori del numero di caratteri inseriti e delle linee riempite.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.

C#
private void MeasureStringSizeFFormatInts(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum layout size.
    SizeF layoutSize = new SizeF(100.0F, 200.0F);

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    int charactersFitted;
    int linesFilled;
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, layoutSize, newStringFormat, out charactersFitted, out linesFilled);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0), newStringFormat);

    // Draw output parameters to screen.
    string outString = "chars " + charactersFitted + ", lines " + linesFilled;
    e.Graphics.DrawString(outString, stringFont, Brushes.Black, new PointF(100, 0));
}

Commenti

Il metodo MeasureString è progettato per l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il metodo DrawString regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa testo formattato), usare il metodo MeasureCharacterRanges o uno dei metodi MeasureString che accetta un StringFormat e passa GenericTypographic. Assicurarsi anche che il TextRenderingHint per il Graphics sia AntiAlias.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat, Int32, Int32)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

C#
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat, out int charactersFitted, out int linesFilled);

Parametri

text
ReadOnlySpan<Char>

Stringa da misurare.

font
Font

Font che definisce il formato di testo della stringa.

layoutArea
SizeF

SizeF struttura che specifica l'area di layout massima per il testo.

stringFormat
StringFormat

StringFormat che rappresenta le informazioni di formattazione, ad esempio l'interlinea, per la stringa.

charactersFitted
Int32

Numero di caratteri nella stringa.

linesFilled
Int32

Numero di righe di testo nella stringa.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni della stringa, nelle unità specificate dalla proprietà PageUnit, del parametro text come disegnato con il parametro font e il parametro stringFormat.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 8, 9
Windows Desktop 8, 9

MeasureString(String, Font, Int32, StringFormat)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

C#
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, int width, System.Drawing.StringFormat? format);
C#
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, int width, System.Drawing.StringFormat format);

Parametri

text
String

Stringa da misurare.

font
Font

Font che definisce il formato di testo della stringa.

width
Int32

Larghezza massima della stringa.

format
StringFormat

StringFormat che rappresenta le informazioni di formattazione, ad esempio l'interlinea, per la stringa.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata nel parametro text come disegnato con il parametro font e il parametro stringFormat.

Eccezioni

font è null.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

  • Crea una stringa per misurare e un oggetto tipo di carattere impostarlo su Arial (16 punti).

  • Imposta la larghezza massima della stringa.

  • Crea un oggetto formato stringa e imposta i flag di formato su DirectionVertical.

  • Crea un oggetto size per misurare la stringa.

  • Misura le dimensioni della stringa, utilizzando la stringa, l'oggetto carattere, la larghezza massima e il formato stringa.

  • Disegna un rettangolo rosso utilizzando le dimensioni misurate della stringa.

  • Disegna la stringa all'interno del rettangolo disegnato.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.

C#
private void MeasureStringWidthFormat(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum width of string.
    int stringWidth = 100;

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, stringWidth, newStringFormat);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0), newStringFormat);
}

Commenti

Il metodo MeasureString è progettato per l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il metodo DrawString regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa testo formattato), usare il metodo MeasureCharacterRanges o uno dei metodi MeasureString che accetta un StringFormate passare GenericTypographic. Assicurarsi inoltre che il TextRenderingHint per il Graphics sia AntiAlias.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

MeasureString(String, Font, SizeF, StringFormat)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

C#
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat);
C#
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat stringFormat);

Parametri

text
String

Stringa da misurare.

font
Font

Font definisce il formato di testo della stringa.

layoutArea
SizeF

SizeF struttura che specifica l'area di layout massima per il testo.

stringFormat
StringFormat

StringFormat che rappresenta le informazioni di formattazione, ad esempio l'interlinea, per la stringa.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata nel parametro text come disegnato con il parametro font e il parametro stringFormat.

Eccezioni

font è null.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

  • Crea una stringa per misurare e un oggetto carattere impostato su Arial (16 punti).

  • Imposta le dimensioni massime del layout della stringa, creando un oggetto size per misurare la stringa.

  • Crea un oggetto formato stringa e imposta i flag di formato su DirectionVertical.

  • Misura le dimensioni della stringa, utilizzando la stringa, l'oggetto carattere, le dimensioni massime del layout e il formato stringa.

  • Disegna un rettangolo rosso utilizzando le dimensioni misurate della stringa.

  • Disegna la stringa all'interno del rettangolo disegnato.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.

C#
private void MeasureStringSizeFFormat(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum layout size.
    SizeF layoutSize = new SizeF(100.0F, 200.0F);

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, layoutSize, newStringFormat);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0), newStringFormat);
}

Commenti

Il metodo MeasureString è progettato per l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il metodo DrawString regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa testo formattato), usare il metodo MeasureCharacterRanges o uno dei metodi MeasureString che accetta un StringFormate passare GenericTypographic. Assicurarsi inoltre che il TextRenderingHint per il Graphics sia AntiAlias.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

MeasureString(String, Font, PointF, StringFormat)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

C#
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.PointF origin, System.Drawing.StringFormat? stringFormat);
C#
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.PointF origin, System.Drawing.StringFormat stringFormat);

Parametri

text
String

Stringa da misurare.

font
Font

Font definisce il formato di testo della stringa.

origin
PointF

PointF struttura che rappresenta l'angolo superiore sinistro della stringa.

stringFormat
StringFormat

StringFormat che rappresenta le informazioni di formattazione, ad esempio l'interlinea, per la stringa.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata dal parametro text come disegnato con il parametro font e il parametro stringFormat.

Eccezioni

font è null.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

  • Crea una stringa per misurare e un oggetto carattere impostato su Arial (16 punti)

  • Crea un punto per individuare l'angolo superiore sinistro della stringa.

  • Crea un oggetto formato stringa e imposta i flag di formato su DirectionVertical.

  • Crea un oggetto size per misurare la stringa.

  • Misura le dimensioni della stringa, utilizzando la stringa, l'oggetto carattere, il punto di individuazione e il formato stringa.

  • Disegna un rettangolo rosso utilizzando il punto di individuazione e le dimensioni misurate della stringa.

  • Disegna la stringa all'interno del rettangolo disegnato.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.

C#
private void MeasureStringPointFFormat(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set point for upper-left corner of string.
    float x = 50.0F;
    float y = 50.0F;
    PointF ulCorner = new PointF(x, y);

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, ulCorner, newStringFormat);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), x, y, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, ulCorner, newStringFormat);
}

Commenti

Il metodo MeasureString è progettato per l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il metodo DrawString regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa testo formattato), usare il metodo MeasureCharacterRanges o uno dei metodi MeasureString che accetta un StringFormate passare GenericTypographic. Assicurarsi inoltre che il TextRenderingHint per il Graphics sia AntiAlias.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

C#
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat);

Parametri

text
ReadOnlySpan<Char>

Stringa da misurare.

font
Font

Font definisce il formato di testo della stringa.

layoutArea
SizeF

SizeF struttura che specifica l'area di layout massima per il testo.

stringFormat
StringFormat

StringFormat che rappresenta le informazioni di formattazione, ad esempio l'interlinea, per la stringa.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata nel parametro text come disegnato con il parametro font e il parametro stringFormat.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 8, 9
Windows Desktop 8, 9

MeasureString(ReadOnlySpan<Char>, Font)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con il Fontspecificato.

C#
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font);

Parametri

text
ReadOnlySpan<Char>

Stringa da misurare.

font
Font

Font che definisce il formato di testo della stringa.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata dal parametro text come disegnato con il parametro font.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 8, 9
Windows Desktop 8, 9

MeasureString(String, Font, Int32)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con il Fontspecificato.

C#
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, int width);
C#
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, int width);

Parametri

text
String

Stringa da misurare.

font
Font

Font che definisce il formato della stringa.

width
Int32

Larghezza massima della stringa in pixel.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata nel parametro text come disegnato con il parametro font.

Eccezioni

font è null.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

  • Crea una stringa per misurare e un oggetto carattere impostato su Arial (16 punti).

  • Imposta la larghezza massima della stringa.

  • Crea un oggetto size e lo usa, l'oggetto font e la larghezza massima della stringa per misurare le dimensioni della stringa.

  • Disegna un rettangolo rosso utilizzando le dimensioni misurate della stringa.

  • Disegna la stringa all'interno del rettangolo disegnato.

C#
private void MeasureStringWidth(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum width of string.
    int stringWidth = 200;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, stringWidth);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0));
}

Commenti

Il parametro width specifica il valore massimo del componente width della struttura SizeF restituita (Width). Se il parametro width è minore della larghezza effettiva della stringa, il componente restituito Width viene troncato a un valore che rappresenta il numero massimo di caratteri che verranno inseriti all'interno della larghezza specificata. Per adattare l'intera stringa, il componente Height restituito viene regolato in base a un valore che consente di visualizzare la stringa con ritorno a capo automatico.

Il metodo MeasureString è progettato per l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il metodo DrawString regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa testo formattato), usare il metodo MeasureCharacterRanges o uno dei metodi MeasureString che accetta un StringFormate passare GenericTypographic. Assicurarsi inoltre che il TextRenderingHint per il Graphics sia AntiAlias.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

MeasureString(String, Font, SizeF)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con il Font specificato all'interno dell'area di layout specificata.

C#
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.SizeF layoutArea);
C#
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.SizeF layoutArea);

Parametri

text
String

Stringa da misurare.

font
Font

Font definisce il formato di testo della stringa.

layoutArea
SizeF

SizeF struttura che specifica l'area di layout massima per il testo.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata dal parametro text come disegnato con il parametro font.

Eccezioni

font è null.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

  • Crea una stringa per misurare e un oggetto carattere impostato su Arial (16 punti).

  • Imposta la dimensione massima del layout della stringa.

  • Crea un oggetto size e lo usa, l'oggetto font e la dimensione massima del layout per misurare le dimensioni della stringa.

  • Disegna un rettangolo rosso utilizzando le dimensioni misurate della stringa.

  • Disegna la stringa all'interno del rettangolo disegnato.

C#
private void MeasureStringSizeF(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum layout size.
    SizeF layoutSize = new SizeF(200.0F, 50.0F);

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, layoutSize);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0));
}

Commenti

Il metodo MeasureString è progettato per l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il metodo DrawString regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa testo formattato), usare il metodo MeasureCharacterRanges o uno dei metodi MeasureString che accetta un StringFormate passare GenericTypographic. Assicurarsi inoltre che il TextRenderingHint per il Graphics sia AntiAlias.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

MeasureString(ReadOnlySpan<Char>, Font, Int32)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con il Fontspecificato.

C#
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, int width);

Parametri

text
ReadOnlySpan<Char>

Stringa da misurare.

font
Font

Font che definisce il formato della stringa.

width
Int32

Larghezza massima della stringa in pixel.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata nel parametro text come disegnato con il parametro font.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 8, 9
Windows Desktop 8, 9

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con il Font specificato all'interno dell'area di layout specificata.

C#
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.SizeF layoutArea);

Parametri

text
ReadOnlySpan<Char>

Stringa da misurare.

font
Font

Font definisce il formato di testo della stringa.

layoutArea
SizeF

SizeF struttura che specifica l'area di layout massima per il testo.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata dal parametro text come disegnato con il parametro font.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 8, 9
Windows Desktop 8, 9

MeasureString(String, Font)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con il Fontspecificato.

C#
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font);
C#
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font);

Parametri

text
String

Stringa da misurare.

font
Font

Font che definisce il formato di testo della stringa.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata dal parametro text come disegnato con il parametro font.

Eccezioni

font è null.

font è null.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

  • Crea una stringa da misurare.

  • Crea un oggetto carattere e lo imposta su Arial (16 punti).

  • Crea un oggetto size e lo usa e l'oggetto font per misurare le dimensioni della stringa.

  • Disegna un rettangolo rosso utilizzando le dimensioni misurate della stringa.

  • Disegna la stringa all'interno del rettangolo disegnato.

C#
private void MeasureStringMin(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0));
}

Commenti

Il metodo MeasureString è progettato per l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il metodo DrawString regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa testo formattato), usare il metodo MeasureCharacterRanges o uno dei metodi MeasureString che accetta un StringFormate passare GenericTypographic. Assicurarsi inoltre che il TextRenderingHint per il Graphics sia AntiAlias.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

MeasureString(ReadOnlySpan<Char>, Font, PointF, StringFormat)

Origine:
Graphics.cs
Origine:
Graphics.cs
Origine:
Graphics.cs

Misura la stringa specificata quando viene disegnata con l'Font specificato e formattata con il StringFormatspecificato.

C#
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.PointF origin, System.Drawing.StringFormat? stringFormat);

Parametri

text
ReadOnlySpan<Char>

Stringa da misurare.

font
Font

Font definisce il formato di testo della stringa.

origin
PointF

PointF struttura che rappresenta l'angolo superiore sinistro della stringa.

stringFormat
StringFormat

StringFormat che rappresenta le informazioni di formattazione, ad esempio l'interlinea, per la stringa.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nelle unità specificate dalla proprietà PageUnit, della stringa specificata dal parametro text come disegnato con il parametro font e il parametro stringFormat.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 8, 9
Windows Desktop 8, 9