Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Graphics.MeasureString (String, Font, Int32)

 

Data di pubblicazione: ottobre 2016

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato.

Spazio dei nomi:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public SizeF MeasureString(
	string text,
	Font font,
	int width
)

Parametri

text
Type: System.String

Stringa da misurare.

font
Type: System.Drawing.Font

Oggetto Font che definisce il formato della stringa.

width
Type: System.Int32

Larghezza massima in pixel della stringa.

Valore restituito

Type: System.Drawing.SizeF

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nell'unità specificata nella proprietà PageUnit, della stringa specificata dal parametro text e disegnata con il parametro font.

Exception Condition
ArgumentException

font è null.

Il width parametro specifica il valore massimo del componente larghezza dell'oggetto restituito SizeF struttura (Width). Se il width parametro è minore della larghezza effettiva della stringa, restituita Width componente viene troncato a un valore che rappresenta il numero massimo di caratteri che possono essere contenuti all'interno della larghezza specificata. Per includere l'intera stringa, restituito Height componente viene adattato a un valore che consente la visualizzazione della stringa con incapsulamento di carattere.

Il MeasureString metodo è progettato per l'utilizzo con stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per le parti sporgenti delle icone. Inoltre, il DrawString metodo regola punti dell'icona per ottimizzare la qualità di visualizzazione e potrebbe essere visualizzato più ristretta rispetto a quanto indicato da una stringa MeasureString. Per ottenere dimensioni adeguate per le stringhe adiacenti nel layout (ad esempio, durante l'implementazione di testo formattato), utilizzare il MeasureCharacterRanges metodo o uno del MeasureString metodi che accetta un StringFormat, e passare GenericTypographic. Inoltre, assicurarsi di TextRenderingHint per il Graphics è AntiAlias.

Esempio di codice seguente è progettato per l'utilizzo con Windows Form e richiede PaintEventArgse, ovvero un parametro del Paint gestore dell'evento. Nel codice vengono eseguite le seguenti azioni:

  • Crea una stringa da misurare e un oggetto tipo di carattere impostato su Arial a 16 punti.

  • Imposta la larghezza massima della stringa.

  • Crea un oggetto dimensioni e utilizza, l'oggetto tipo di carattere 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.

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));
}

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: