TextRenderer.MeasureText Метод

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Измеряет указанный текст при прорисовке с помощью указанного шрифта.

Перегрузки

MeasureText(String, Font, Size, TextFormatFlags)	Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанного шрифта и инструкций форматирования, с использованием заданного размера для создания исходного ограничивающего прямоугольника для текста.
MeasureText(ReadOnlySpan<Char>, Font, Size, TextFormatFlags)	Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанного шрифта и инструкций форматирования, с использованием заданного размера для создания исходного ограничивающего прямоугольника для текста.
MeasureText(IDeviceContext, String, Font, Size)	Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанного шрифта в заданном контексте устройства, с использованием заданного размера для создания исходного ограничивающего прямоугольника для текста.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size)	Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанного шрифта в заданном контексте устройства, с использованием заданного размера для создания исходного ограничивающего прямоугольника для текста.
MeasureText(String, Font, Size)	Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанного шрифта, с использованием заданного размера для создания исходного ограничивающего прямоугольника.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font)	Предоставляет размер (в пикселях) указанного текста, отрисовываемого с помощью заданного шрифта в указанном контексте устройства.
MeasureText(IDeviceContext, String, Font)	Предоставляет размер (в пикселях) указанного текста, отрисовываемого с помощью заданного шрифта в указанном контексте устройства.
MeasureText(String, Font)	Предоставляет размер (в пикселях) указанного текста при отрисовке с помощью заданного шрифта.
MeasureText(ReadOnlySpan<Char>, Font)	Предоставляет размер (в пикселях) указанного текста при отрисовке с помощью заданного шрифта.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size, TextFormatFlags)	Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанных значений контекста устройства, шрифта и инструкций форматирования, с использованием заданного размера для создания исходного ограничивающего прямоугольника для текста.
MeasureText(ReadOnlySpan<Char>, Font, Size)	Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанного шрифта, с использованием заданного размера для создания исходного ограничивающего прямоугольника.
MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)	Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанных значений контекста устройства, шрифта и инструкций форматирования, с использованием заданного размера для создания исходного ограничивающего прямоугольника для текста.

MeasureText(String, Font, Size, TextFormatFlags)

Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанного шрифта и инструкций форматирования, с использованием заданного размера для создания исходного ограничивающего прямоугольника для текста.

public:
 static System::Drawing::Size MeasureText(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Size proposedSize, System::Windows::Forms::TextFormatFlags flags);

public static System.Drawing.Size MeasureText (string text, System.Drawing.Font font, System.Drawing.Size proposedSize, System.Windows.Forms.TextFormatFlags flags);

public static System.Drawing.Size MeasureText (string? text, System.Drawing.Font? font, System.Drawing.Size proposedSize, System.Windows.Forms.TextFormatFlags flags);

static member MeasureText : string * System.Drawing.Font * System.Drawing.Size * System.Windows.Forms.TextFormatFlags -> System.Drawing.Size

Public Shared Function MeasureText (text As String, font As Font, proposedSize As Size, flags As TextFormatFlags) As Size

Параметры

text: String

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

proposedSize: Size

Размер Size исходного ограничивающего прямоугольника.

flags: TextFormatFlags

Инструкции форматирования для применения к измеряемому тексту.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, отрисовываемого с помощью задаваемых значений параметра font и формата.

Примеры

В следующем примере кода показано, как использовать один из MeasureText методов . Чтобы запустить этот пример, вставьте код в форму Windows Forms и вызовите DrawALineOfText из обработчика Paint событий формы, передав e как PaintEventArgs.

private static void DrawALineOfText(PaintEventArgs e)
{
    // Declare strings to render on the form.
    string[] stringsToPaint = { "Tail", "Spin", " Toys" };

    // Declare fonts for rendering the strings.
    Font[] fonts = { new Font("Arial", 14, FontStyle.Regular), 
        new Font("Arial", 14, FontStyle.Italic), 
        new Font("Arial", 14, FontStyle.Regular) };

    Point startPoint = new Point(10, 10);

    // Set TextFormatFlags to no padding so strings are drawn together.
    TextFormatFlags flags = TextFormatFlags.NoPadding;

    // Declare a proposed size with dimensions set to the maximum integer value.
    Size proposedSize = new Size(int.MaxValue, int.MaxValue);

    // Measure each string with its font and NoPadding value and 
    // draw it to the form.
    for (int i = 0; i < stringsToPaint.Length; i++)
    {
        Size size = TextRenderer.MeasureText(e.Graphics, stringsToPaint[i], 
            fonts[i], proposedSize, flags);
        Rectangle rect = new Rectangle(startPoint, size);
        TextRenderer.DrawText(e.Graphics, stringsToPaint[i], fonts[i],
            startPoint, Color.Black, flags);
        startPoint.X += size.Width;
    }
}

Private Sub DrawALineOfText(ByVal e As PaintEventArgs)
    ' Declare strings to render on the form.
    Dim stringsToPaint() As String = {"Tail", "Spin", " Toys"}

    ' Declare fonts for rendering the strings.
    Dim fonts() As Font = {New Font("Arial", 14, FontStyle.Regular), _
        New Font("Arial", 14, FontStyle.Italic), _
        New Font("Arial", 14, FontStyle.Regular)}

    Dim startPoint As New Point(10, 10)

    ' Set TextFormatFlags to no padding so strings are drawn together.
    Dim flags As TextFormatFlags = TextFormatFlags.NoPadding

    ' Declare a proposed size with dimensions set to the maximum integer value.
    Dim proposedSize As Size = New Size(Integer.MaxValue, Integer.MaxValue)

    ' Measure each string with its font and NoPadding value and draw it to the form.
    For i As Integer = 0 To stringsToPaint.Length - 1
        Dim size As Size = TextRenderer.MeasureText(e.Graphics, _
            stringsToPaint(i), fonts(i), proposedSize, flags)
        Dim rect As Rectangle = New Rectangle(startPoint, size)
        TextRenderer.DrawText(e.Graphics, stringsToPaint(i), fonts(i), _
            startPoint, Color.Black, flags)
        startPoint.X += size.Width
    Next
End Sub

MeasureText proposedSize использует параметры и flags , чтобы указать отношение высоты к ширине при определении размера текста. При измерении текста в одной строке, если proposedSize параметр представляет объект с измерением высоты Size больше Int32.MaxValue, возвращаемый Size объект будет скорректирован в соответствии с фактической высотой текста.

Управлять прорисовкой текста можно с помощью одной из перегрузок метода DrawText, принимающей параметр TextFormatFlags. Например, поведение класса TextRenderer по умолчанию предполагает добавление внутренних полей в ограничивающий прямоугольник отображаемого текста с целью вместить в этот прямоугольник части глифов, выступающие за его границы. Если требуется прорисовать строку текста без этих дополнительных областей, следует использовать версии методов DrawText и MeasureText, которые принимают объект Size и параметр TextFormatFlags. Пример см. в разделе MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Примечание

Эта перегрузка MeasureText(String, Font, Size, TextFormatFlags) будет игнорировать TextFormatFlags значение NoPadding или LeftAndRightPadding. Если вы указываете значение заполнения, отличное от значения по умолчанию, следует использовать перегрузку MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags) , которая принимает IDeviceContext объект .

Применяется к

MeasureText(ReadOnlySpan<Char>, Font, Size, TextFormatFlags)

public:
 static System::Drawing::Size MeasureText(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Size proposedSize, System::Windows::Forms::TextFormatFlags flags);

public static System.Drawing.Size MeasureText (ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Size proposedSize, System.Windows.Forms.TextFormatFlags flags);

static member MeasureText : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Size * System.Windows.Forms.TextFormatFlags -> System.Drawing.Size

Public Shared Function MeasureText (text As ReadOnlySpan(Of Char), font As Font, proposedSize As Size, flags As TextFormatFlags) As Size

Параметры

text: ReadOnlySpan<Char>

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

proposedSize: Size

Размер Size исходного ограничивающего прямоугольника.

flags: TextFormatFlags

Инструкции форматирования для применения к измеряемому тексту.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, отрисовываемого с помощью задаваемых значений параметра font и формата.

Исключения

ArgumentOutOfRangeException

Свойство ModifyString задано.

Применяется к

MeasureText(IDeviceContext, String, Font, Size)

Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанного шрифта в заданном контексте устройства, с использованием заданного размера для создания исходного ограничивающего прямоугольника для текста.

public:
 static System::Drawing::Size MeasureText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Size proposedSize);

public static System.Drawing.Size MeasureText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Size proposedSize);

public static System.Drawing.Size MeasureText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Size proposedSize);

static member MeasureText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Size -> System.Drawing.Size

Public Shared Function MeasureText (dc As IDeviceContext, text As String, font As Font, proposedSize As Size) As Size

Параметры

dc: IDeviceContext

Контекст устройства, в котором должен измеряться текст.

text: String

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

proposedSize: Size

Размер Size исходного ограничивающего прямоугольника.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, отрисовываемого с помощью указанного параметра font.

Исключения

ArgumentNullException

dc имеет значение null.

Примеры

private static void DrawALineOfText(PaintEventArgs e)
{
    // Declare strings to render on the form.
    string[] stringsToPaint = { "Tail", "Spin", " Toys" };

    // Declare fonts for rendering the strings.
    Font[] fonts = { new Font("Arial", 14, FontStyle.Regular), 
        new Font("Arial", 14, FontStyle.Italic), 
        new Font("Arial", 14, FontStyle.Regular) };

    Point startPoint = new Point(10, 10);

    // Set TextFormatFlags to no padding so strings are drawn together.
    TextFormatFlags flags = TextFormatFlags.NoPadding;

    // Declare a proposed size with dimensions set to the maximum integer value.
    Size proposedSize = new Size(int.MaxValue, int.MaxValue);

    // Measure each string with its font and NoPadding value and 
    // draw it to the form.
    for (int i = 0; i < stringsToPaint.Length; i++)
    {
        Size size = TextRenderer.MeasureText(e.Graphics, stringsToPaint[i], 
            fonts[i], proposedSize, flags);
        Rectangle rect = new Rectangle(startPoint, size);
        TextRenderer.DrawText(e.Graphics, stringsToPaint[i], fonts[i],
            startPoint, Color.Black, flags);
        startPoint.X += size.Width;
    }
}

Private Sub DrawALineOfText(ByVal e As PaintEventArgs)
    ' Declare strings to render on the form.
    Dim stringsToPaint() As String = {"Tail", "Spin", " Toys"}

    ' Declare fonts for rendering the strings.
    Dim fonts() As Font = {New Font("Arial", 14, FontStyle.Regular), _
        New Font("Arial", 14, FontStyle.Italic), _
        New Font("Arial", 14, FontStyle.Regular)}

    Dim startPoint As New Point(10, 10)

    ' Set TextFormatFlags to no padding so strings are drawn together.
    Dim flags As TextFormatFlags = TextFormatFlags.NoPadding

    ' Declare a proposed size with dimensions set to the maximum integer value.
    Dim proposedSize As Size = New Size(Integer.MaxValue, Integer.MaxValue)

    ' Measure each string with its font and NoPadding value and draw it to the form.
    For i As Integer = 0 To stringsToPaint.Length - 1
        Dim size As Size = TextRenderer.MeasureText(e.Graphics, _
            stringsToPaint(i), fonts(i), proposedSize, flags)
        Dim rect As Rectangle = New Rectangle(startPoint, size)
        TextRenderer.DrawText(e.Graphics, stringsToPaint(i), fonts(i), _
            startPoint, Color.Black, flags)
        startPoint.X += size.Width
    Next
End Sub

Метод MeasureText использует параметр , proposedSize чтобы указать отношение высоты к ширине при определении размера текста. При измерении текста в одной строке, если proposedSize параметр представляет объект с измерением высоты Size больше Int32.MaxValue, возвращаемый Size объект будет скорректирован в соответствии с фактической высотой текста.

Применяется к

MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size)

public:
 static System::Drawing::Size MeasureText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Size proposedSize);

public static System.Drawing.Size MeasureText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Size proposedSize);

static member MeasureText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Size -> System.Drawing.Size

Public Shared Function MeasureText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, proposedSize As Size) As Size

Параметры

dc: IDeviceContext

Контекст устройства, в котором должен измеряться текст.

text: ReadOnlySpan<Char>

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

proposedSize: Size

Размер Size исходного ограничивающего прямоугольника.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, отрисовываемого с помощью указанного параметра font.

Исключения

ArgumentNullException

dc имеет значение null.

Применяется к

MeasureText(String, Font, Size)

Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанного шрифта, с использованием заданного размера для создания исходного ограничивающего прямоугольника.

public:
 static System::Drawing::Size MeasureText(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Size proposedSize);

public static System.Drawing.Size MeasureText (string text, System.Drawing.Font font, System.Drawing.Size proposedSize);

public static System.Drawing.Size MeasureText (string? text, System.Drawing.Font? font, System.Drawing.Size proposedSize);

static member MeasureText : string * System.Drawing.Font * System.Drawing.Size -> System.Drawing.Size

Public Shared Function MeasureText (text As String, font As Font, proposedSize As Size) As Size

Параметры

text: String

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

proposedSize: Size

Размер Size исходного ограничивающего прямоугольника.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, отрисовываемого с помощью указанного параметра font.

Примеры

private static void DrawALineOfText(PaintEventArgs e)
{
    // Declare strings to render on the form.
    string[] stringsToPaint = { "Tail", "Spin", " Toys" };

    // Declare fonts for rendering the strings.
    Font[] fonts = { new Font("Arial", 14, FontStyle.Regular), 
        new Font("Arial", 14, FontStyle.Italic), 
        new Font("Arial", 14, FontStyle.Regular) };

    Point startPoint = new Point(10, 10);

    // Set TextFormatFlags to no padding so strings are drawn together.
    TextFormatFlags flags = TextFormatFlags.NoPadding;

    // Declare a proposed size with dimensions set to the maximum integer value.
    Size proposedSize = new Size(int.MaxValue, int.MaxValue);

    // Measure each string with its font and NoPadding value and 
    // draw it to the form.
    for (int i = 0; i < stringsToPaint.Length; i++)
    {
        Size size = TextRenderer.MeasureText(e.Graphics, stringsToPaint[i], 
            fonts[i], proposedSize, flags);
        Rectangle rect = new Rectangle(startPoint, size);
        TextRenderer.DrawText(e.Graphics, stringsToPaint[i], fonts[i],
            startPoint, Color.Black, flags);
        startPoint.X += size.Width;
    }
}

Private Sub DrawALineOfText(ByVal e As PaintEventArgs)
    ' Declare strings to render on the form.
    Dim stringsToPaint() As String = {"Tail", "Spin", " Toys"}

    ' Declare fonts for rendering the strings.
    Dim fonts() As Font = {New Font("Arial", 14, FontStyle.Regular), _
        New Font("Arial", 14, FontStyle.Italic), _
        New Font("Arial", 14, FontStyle.Regular)}

    Dim startPoint As New Point(10, 10)

    ' Set TextFormatFlags to no padding so strings are drawn together.
    Dim flags As TextFormatFlags = TextFormatFlags.NoPadding

    ' Declare a proposed size with dimensions set to the maximum integer value.
    Dim proposedSize As Size = New Size(Integer.MaxValue, Integer.MaxValue)

    ' Measure each string with its font and NoPadding value and draw it to the form.
    For i As Integer = 0 To stringsToPaint.Length - 1
        Dim size As Size = TextRenderer.MeasureText(e.Graphics, _
            stringsToPaint(i), fonts(i), proposedSize, flags)
        Dim rect As Rectangle = New Rectangle(startPoint, size)
        TextRenderer.DrawText(e.Graphics, stringsToPaint(i), fonts(i), _
            startPoint, Color.Black, flags)
        startPoint.X += size.Width
    Next
End Sub

Применяется к

MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font)

Предоставляет размер (в пикселях) указанного текста, отрисовываемого с помощью заданного шрифта в указанном контексте устройства.

public:
 static System::Drawing::Size MeasureText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font);

public static System.Drawing.Size MeasureText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font);

static member MeasureText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font -> System.Drawing.Size

Public Shared Function MeasureText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font) As Size

Параметры

dc: IDeviceContext

Контекст устройства, в котором должен измеряться текст.

text: ReadOnlySpan<Char>

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, прорисовываемого с помощью указанного параметра font в заданном контексте устройства.

Исключения

ArgumentNullException

dc имеет значение null.

Применяется к

MeasureText(IDeviceContext, String, Font)

public:
 static System::Drawing::Size MeasureText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font);

public static System.Drawing.Size MeasureText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font);

public static System.Drawing.Size MeasureText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font);

static member MeasureText : System.Drawing.IDeviceContext * string * System.Drawing.Font -> System.Drawing.Size

Public Shared Function MeasureText (dc As IDeviceContext, text As String, font As Font) As Size

Параметры

dc: IDeviceContext

Контекст устройства, в котором должен измеряться текст.

text: String

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, отрисовываемого на одной строке с помощью указанного параметра font в заданном контексте устройства.

Примеры

private static void DrawALineOfText(PaintEventArgs e)
{
    // Declare strings to render on the form.
    string[] stringsToPaint = { "Tail", "Spin", " Toys" };

    // Declare fonts for rendering the strings.
    Font[] fonts = { new Font("Arial", 14, FontStyle.Regular), 
        new Font("Arial", 14, FontStyle.Italic), 
        new Font("Arial", 14, FontStyle.Regular) };

    Point startPoint = new Point(10, 10);

    // Set TextFormatFlags to no padding so strings are drawn together.
    TextFormatFlags flags = TextFormatFlags.NoPadding;

    // Declare a proposed size with dimensions set to the maximum integer value.
    Size proposedSize = new Size(int.MaxValue, int.MaxValue);

    // Measure each string with its font and NoPadding value and 
    // draw it to the form.
    for (int i = 0; i < stringsToPaint.Length; i++)
    {
        Size size = TextRenderer.MeasureText(e.Graphics, stringsToPaint[i], 
            fonts[i], proposedSize, flags);
        Rectangle rect = new Rectangle(startPoint, size);
        TextRenderer.DrawText(e.Graphics, stringsToPaint[i], fonts[i],
            startPoint, Color.Black, flags);
        startPoint.X += size.Width;
    }
}

Private Sub DrawALineOfText(ByVal e As PaintEventArgs)
    ' Declare strings to render on the form.
    Dim stringsToPaint() As String = {"Tail", "Spin", " Toys"}

    ' Declare fonts for rendering the strings.
    Dim fonts() As Font = {New Font("Arial", 14, FontStyle.Regular), _
        New Font("Arial", 14, FontStyle.Italic), _
        New Font("Arial", 14, FontStyle.Regular)}

    Dim startPoint As New Point(10, 10)

    ' Set TextFormatFlags to no padding so strings are drawn together.
    Dim flags As TextFormatFlags = TextFormatFlags.NoPadding

    ' Declare a proposed size with dimensions set to the maximum integer value.
    Dim proposedSize As Size = New Size(Integer.MaxValue, Integer.MaxValue)

    ' Measure each string with its font and NoPadding value and draw it to the form.
    For i As Integer = 0 To stringsToPaint.Length - 1
        Dim size As Size = TextRenderer.MeasureText(e.Graphics, _
            stringsToPaint(i), fonts(i), proposedSize, flags)
        Dim rect As Rectangle = New Rectangle(startPoint, size)
        TextRenderer.DrawText(e.Graphics, stringsToPaint(i), fonts(i), _
            startPoint, Color.Black, flags)
        startPoint.X += size.Width
    Next
End Sub

Применяется к

MeasureText(String, Font)

Предоставляет размер (в пикселях) указанного текста при отрисовке с помощью заданного шрифта.

public:
 static System::Drawing::Size MeasureText(System::String ^ text, System::Drawing::Font ^ font);

public static System.Drawing.Size MeasureText (string text, System.Drawing.Font font);

public static System.Drawing.Size MeasureText (string? text, System.Drawing.Font? font);

static member MeasureText : string * System.Drawing.Font -> System.Drawing.Size

Public Shared Function MeasureText (text As String, font As Font) As Size

Параметры

text: String

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, отрисовываемого на одной строке с помощью задаваемого объекта font. Управлять прорисовкой текста можно с помощью одной из перегрузок метода DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags), принимающей параметр TextFormatFlags. Например, поведение класса TextRenderer по умолчанию предполагает добавление внутренних полей в ограничивающий прямоугольник отображаемого текста с целью вместить в этот прямоугольник части глифов, выступающие за его границы. Если требуется прорисовать строку текста без этих дополнительных областей, следует использовать версии методов DrawText(IDeviceContext, String, Font, Point, Color) и MeasureText(IDeviceContext, String, Font), которые принимают объект Size и параметр TextFormatFlags. Пример см. в разделе MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Примеры

В следующем примере кода показано, как использовать метод MeasureText. Чтобы запустить этот пример, вставьте код в форму Windows Forms и вызовите MeasureText1 из обработчика Paint событий формы, передав e как PaintEventArgs.

private void MeasureText1(PaintEventArgs e)
{
    String text1 = "Measure this text";
    Font arialBold = new Font("Arial", 12.0F);
    Size textSize = TextRenderer.MeasureText(text1, arialBold);
    TextRenderer.DrawText(e.Graphics, text1, arialBold, 
        new Rectangle(new Point(10, 10), textSize), Color.Red);  
}

Private Sub MeasureText1(ByVal e As PaintEventArgs)
    Dim text1 As String = "Measure this text"
    Dim arialBold As New Font("Arial", 12.0F)
    Dim textSize As Size = TextRenderer.MeasureText(text1, arialBold)
    TextRenderer.DrawText(e.Graphics, text1, arialBold, _
        New Rectangle(New Point(10, 10), textSize), Color.Red)

End Sub

Применяется к

MeasureText(ReadOnlySpan<Char>, Font)

Предоставляет размер (в пикселях) указанного текста при отрисовке с помощью заданного шрифта.

public:
 static System::Drawing::Size MeasureText(ReadOnlySpan<char> text, System::Drawing::Font ^ font);

public static System.Drawing.Size MeasureText (ReadOnlySpan<char> text, System.Drawing.Font? font);

static member MeasureText : ReadOnlySpan<char> * System.Drawing.Font -> System.Drawing.Size

Public Shared Function MeasureText (text As ReadOnlySpan(Of Char), font As Font) As Size

Параметры

text: ReadOnlySpan<Char>

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

Возвращаемое значение

Size

Размер Size текста (в пикселях), прорисовываемого в одной строке с использованием указанного шрифта. Управлять прорисовкой текста можно с помощью одной из перегрузок метода DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags), принимающей параметр TextFormatFlags. Например, поведение класса TextRenderer по умолчанию предполагает добавление внутренних полей в ограничивающий прямоугольник отображаемого текста с целью вместить в этот прямоугольник части глифов, выступающие за его границы. Если требуется прорисовать строку текста без этих дополнительных областей, следует использовать версии методов DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color) и MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font), которые принимают значение размера и параметр TextFormatFlags. Пример см. в разделе MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Применяется к

MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size, TextFormatFlags)

Предоставляет размер (в пикселях) указанного текста при его отрисовке с помощью указанных значений контекста устройства, шрифта и инструкций форматирования, с использованием заданного размера для создания исходного ограничивающего прямоугольника для текста.

public:
 static System::Drawing::Size MeasureText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Size proposedSize, System::Windows::Forms::TextFormatFlags flags);

public static System.Drawing.Size MeasureText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Size proposedSize, System.Windows.Forms.TextFormatFlags flags);

static member MeasureText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Size * System.Windows.Forms.TextFormatFlags -> System.Drawing.Size

Public Shared Function MeasureText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, proposedSize As Size, flags As TextFormatFlags) As Size

Параметры

dc: IDeviceContext

Контекст устройства, в котором должен измеряться текст.

text: ReadOnlySpan<Char>

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

proposedSize: Size

Размер Size исходного ограничивающего прямоугольника.

flags: TextFormatFlags

Инструкции форматирования для применения к измеряемому тексту.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, отрисовываемого с помощью задаваемых значений параметра font и формата.

Исключения

ArgumentNullException

dc имеет значение null.

ArgumentOutOfRangeException

Свойство ModifyString задано.

Применяется к

MeasureText(ReadOnlySpan<Char>, Font, Size)

public:
 static System::Drawing::Size MeasureText(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Size proposedSize);

public static System.Drawing.Size MeasureText (ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Size proposedSize);

static member MeasureText : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Size -> System.Drawing.Size

Public Shared Function MeasureText (text As ReadOnlySpan(Of Char), font As Font, proposedSize As Size) As Size

Параметры

text: ReadOnlySpan<Char>

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

proposedSize: Size

Размер Size исходного ограничивающего прямоугольника.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, отрисовываемого с помощью указанного параметра font.

Применяется к

MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)

public:
 static System::Drawing::Size MeasureText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Size proposedSize, System::Windows::Forms::TextFormatFlags flags);

public static System.Drawing.Size MeasureText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Size proposedSize, System.Windows.Forms.TextFormatFlags flags);

public static System.Drawing.Size MeasureText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Size proposedSize, System.Windows.Forms.TextFormatFlags flags);

static member MeasureText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Size * System.Windows.Forms.TextFormatFlags -> System.Drawing.Size

Public Shared Function MeasureText (dc As IDeviceContext, text As String, font As Font, proposedSize As Size, flags As TextFormatFlags) As Size

Параметры

dc: IDeviceContext

Контекст устройства, в котором должен измеряться текст.

text: String

Текст для измерения.

font: Font

Объект Font для применения к измеряемому тексту.

proposedSize: Size

Размер Size исходного ограничивающего прямоугольника.

flags: TextFormatFlags

Инструкции форматирования для применения к измеряемому тексту.

Возвращаемое значение

Size

Размер Size (в пикселях) объекта text, отрисовываемого с помощью задаваемых значений параметра font и формата.

Исключения

ArgumentNullException

dc имеет значение null.

Примеры

В следующем примере показано, как использовать MeasureText методы и DrawText для рисования одной линии текста в разных стилях шрифтов. Чтобы выполнить этот пример, вставьте следующий код в Форму Windows Forms и вызовите DrawALineOfText из обработчика Paint событий формы, передавая e как PaintEventArgs.

private static void DrawALineOfText(PaintEventArgs e)
{
    // Declare strings to render on the form.
    string[] stringsToPaint = { "Tail", "Spin", " Toys" };

    // Declare fonts for rendering the strings.
    Font[] fonts = { new Font("Arial", 14, FontStyle.Regular), 
        new Font("Arial", 14, FontStyle.Italic), 
        new Font("Arial", 14, FontStyle.Regular) };

    Point startPoint = new Point(10, 10);

    // Set TextFormatFlags to no padding so strings are drawn together.
    TextFormatFlags flags = TextFormatFlags.NoPadding;

    // Declare a proposed size with dimensions set to the maximum integer value.
    Size proposedSize = new Size(int.MaxValue, int.MaxValue);

    // Measure each string with its font and NoPadding value and 
    // draw it to the form.
    for (int i = 0; i < stringsToPaint.Length; i++)
    {
        Size size = TextRenderer.MeasureText(e.Graphics, stringsToPaint[i], 
            fonts[i], proposedSize, flags);
        Rectangle rect = new Rectangle(startPoint, size);
        TextRenderer.DrawText(e.Graphics, stringsToPaint[i], fonts[i],
            startPoint, Color.Black, flags);
        startPoint.X += size.Width;
    }
}

Private Sub DrawALineOfText(ByVal e As PaintEventArgs)
    ' Declare strings to render on the form.
    Dim stringsToPaint() As String = {"Tail", "Spin", " Toys"}

    ' Declare fonts for rendering the strings.
    Dim fonts() As Font = {New Font("Arial", 14, FontStyle.Regular), _
        New Font("Arial", 14, FontStyle.Italic), _
        New Font("Arial", 14, FontStyle.Regular)}

    Dim startPoint As New Point(10, 10)

    ' Set TextFormatFlags to no padding so strings are drawn together.
    Dim flags As TextFormatFlags = TextFormatFlags.NoPadding

    ' Declare a proposed size with dimensions set to the maximum integer value.
    Dim proposedSize As Size = New Size(Integer.MaxValue, Integer.MaxValue)

    ' Measure each string with its font and NoPadding value and draw it to the form.
    For i As Integer = 0 To stringsToPaint.Length - 1
        Dim size As Size = TextRenderer.MeasureText(e.Graphics, _
            stringsToPaint(i), fonts(i), proposedSize, flags)
        Dim rect As Rectangle = New Rectangle(startPoint, size)
        TextRenderer.DrawText(e.Graphics, stringsToPaint(i), fonts(i), _
            startPoint, Color.Black, flags)
        startPoint.X += size.Width
    Next
End Sub

Метод MeasureText использует proposedSize параметры и flags , чтобы указать отношение высоты к ширине при определении размера текста. При измерении текста в одной строке, если proposedSize параметр представляет объект с размером высоты Size больше Int32.MaxValue, возвращаемый Size объект будет скорректирован в соответствии с фактической высотой текста.

Управлять прорисовкой текста можно с помощью одной из перегрузок метода DrawText, принимающей параметр TextFormatFlags. Например, поведение класса TextRenderer по умолчанию предполагает добавление внутренних полей в ограничивающий прямоугольник отображаемого текста с целью вместить в этот прямоугольник части глифов, выступающие за его границы. Если необходимо нарисовать текстовую линию без этих дополнительных пробелов, используйте версии DrawText и MeasureText , которые принимают Size параметр и TextFormatFlags , как показано в примере.

Применяется к

Поделиться через

TextRenderer.MeasureText Метод

Определение

Перегрузки

MeasureText(String, Font, Size, TextFormatFlags)

Параметры

Возвращаемое значение

Примеры

Комментарии

Применяется к

MeasureText(ReadOnlySpan<Char>, Font, Size, TextFormatFlags)

Параметры

Возвращаемое значение

Исключения

Применяется к

MeasureText(IDeviceContext, String, Font, Size)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size)

Параметры

Возвращаемое значение

Исключения

Применяется к

MeasureText(String, Font, Size)

Параметры

Возвращаемое значение

Примеры

Комментарии

Применяется к

MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font)

Параметры

Возвращаемое значение

Исключения

Применяется к

MeasureText(IDeviceContext, String, Font)

Параметры

Возвращаемое значение

Примеры

Комментарии

Применяется к

MeasureText(String, Font)

Параметры

Возвращаемое значение

Примеры

Комментарии

Применяется к

MeasureText(ReadOnlySpan<Char>, Font)

Параметры

Возвращаемое значение

Применяется к

MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size, TextFormatFlags)

Параметры

Возвращаемое значение

Исключения

Применяется к

MeasureText(ReadOnlySpan<Char>, Font, Size)

Параметры

Возвращаемое значение

Применяется к

MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

Дополнительные ресурсы