Questa documentazione è stata archiviata e non viene gestita.

Metodo Graphics.MeasureString (String, Font, SizeF, StringFormat)

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

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

public SizeF MeasureString (
	string text,
	Font font,
	SizeF layoutArea,
	StringFormat stringFormat
)
public SizeF MeasureString (
	String text, 
	Font font, 
	SizeF layoutArea, 
	StringFormat stringFormat
)
public function MeasureString (
	text : String, 
	font : Font, 
	layoutArea : SizeF, 
	stringFormat : StringFormat
) : SizeF
Non applicabile.

Parametri

text

Stringa da misurare.

font

Oggetto Font che definisce il formato di testo della stringa.

layoutArea

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

stringFormat

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

Valore restituito

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nell'unità specificata dalla proprietà PageUnit, della stringa specificata nel parametro text e disegnata con i parametri font e stringFormat.

Il metodo MeasureString è progettato per l'utilizzo con stringhe singole e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per le parti sporgenti delle icone. Il metodo DrawString, inoltre, modifica i punti dell'icona per ottimizzare la qualità di visualizzazione ed è in grado di mostrare una stringa più ristretta rispetto a quanto indicato da MeasureString . Per ottenere dimensioni adeguate per le stringhe adiacenti nel layout (ad esempio, durante l'implementazione di testo formattato), utilizzare il metodo MeasureCharacterRanges o uno dei metodi MeasureString che accetta un oggetto StringFormat e passa la proprietà GenericTypographic. Inoltre, consente di accertarsi che la proprietà pubblica TextRenderingHint dell'oggetto Graphics sia AntiAlias.

L'esempio che segue deve essere utilizzato con Windows Form e richiede PaintEventArgse, un parametro del gestore eventi Paint. Nel codice vengono eseguite le seguenti azioni:

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

  • Impostazione delle dimensioni massime di layout della stringa, creando un oggetto dimensioni per misurare la stringa.

  • Creazione di un oggetto formato stringa e impostazione dei relativi flag di formato su DirectionVertical.

  • Misurazione delle dimensioni della stringa utilizzando la stringa, l'oggetto tipo di carattere, le dimensioni massime di layout e il formato stringa.

  • Disegno di un rettangolo rosso utilizzando le dimensioni misurate della stringa.

  • Disegno della stringa all'interno del rettangolo disegnato.

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

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

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:
Mostra: