TextFormatFlags TextFormatFlags TextFormatFlags TextFormatFlags Enum

Определение

Указывает сведения об отображении и размещении строк текста.Specifies the display and layout information for text strings.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
type TextFormatFlags = 
Public Enum TextFormatFlags
Наследование
TextFormatFlagsTextFormatFlagsTextFormatFlagsTextFormatFlags
Атрибуты

Поля

Bottom Bottom Bottom Bottom 8

Выравнивает текст по низу ограничивающего прямоугольника.Aligns the text on the bottom of the bounding rectangle. Применяется только в том случае, когда текст располагается на одной строке.Applied only when the text is a single line.

Default Default Default Default 0

Применяет форматирование по умолчанию, которым является выравнивание влево.Applies the default formatting, which is left-aligned.

EndEllipsis EndEllipsis EndEllipsis EndEllipsis 32768

Удаляет конец обрезанной строки и заменяет его многоточием.Removes the end of trimmed lines, and replaces them with an ellipsis.

ExpandTabs ExpandTabs ExpandTabs ExpandTabs 64

Расширяет табуляцию.Expands tab characters. По умолчанию количество символов на шаг табуляции равно восьми.The default number of characters per tab is eight. Значения WordEllipsis, PathEllipsis и EndEllipsis невозможно использовать с ExpandTabs.The WordEllipsis, PathEllipsis, and EndEllipsis values cannot be used with ExpandTabs.

ExternalLeading ExternalLeading ExternalLeading ExternalLeading 512

Включает внешнее межстрочное расстояние шрифта в высоту строки.Includes the font external leading in line height. Обычно внешнее межстрочное расстояние не включается в высоту строки текста.Typically, external leading is not included in the height of a line of text.

GlyphOverhangPadding GlyphOverhangPadding GlyphOverhangPadding GlyphOverhangPadding 0

Добавляет внутренние поля в ограничивающий прямоугольник, чтобы вместить выступающие глифы.Adds padding to the bounding rectangle to accommodate overhanging glyphs.

HidePrefix HidePrefix HidePrefix HidePrefix 1048576

Устаревшее значение, которое не оказывает никакого влияния.A legacy value that has no effect. Игнорировал префикс в виде амперсанда (&) в тексте, чтобы следующая буква не была подчеркнута, однако другие назначенные символы префикса по-прежнему обрабатывались.It ignored the ampersand (&) prefix character in the text, so that the letter that followed was not underlined, but other mnemonic-prefix characters were still processed.

HorizontalCenter HorizontalCenter HorizontalCenter HorizontalCenter 1

Центрирует текст по горизонтали в ограничивающем прямоугольнике.Centers the text horizontally within the bounding rectangle.

Internal Internal Internal Internal 4096

Использует системный шрифт для вычисления размеров текста.Uses the system font to calculate text metrics.

Left Left Left Left 0

Выравнивает текст по левой стороне области отсечения.Aligns the text on the left side of the clipping area.

LeftAndRightPadding LeftAndRightPadding LeftAndRightPadding LeftAndRightPadding 536870912

Добавляет внутренние поля для обеих сторон ограничивающего прямоугольника.Adds padding to both sides of the bounding rectangle.

ModifyString ModifyString ModifyString ModifyString 65536

Не влияет на прорисовываемый текст.Has no effect on the drawn text.

NoClipping NoClipping NoClipping NoClipping 256

Разрешает отображение выступающих частей глифов и развернутого текста, выходящих за пределы прямоугольной зоны форматирования.Allows the overhanging parts of glyphs and unwrapped text reaching outside the formatting rectangle to show.

NoFullWidthCharacterBreak NoFullWidthCharacterBreak NoFullWidthCharacterBreak NoFullWidthCharacterBreak 524288

Устаревшее значение, которое не оказывает никакого влияния.A legacy value that has no effect. Предотвращает разрыв строки в строке с двухбайтовых символов, чтобы данное правило разбиения строк было эквивалентно правилу для строк однобайтовых символов.It prevents a line break at a double-wide character string, so that the line-breaking rule is equivalent to that for single-wide character strings.

NoPadding NoPadding NoPadding NoPadding 268435456

Не добавляет внутренние поля в ограничивающий прямоугольник.Does not add padding to the bounding rectangle.

NoPrefix NoPrefix NoPrefix NoPrefix 2048

Выключает обработку символов префикса.Turns off processing of prefix characters. Обычно мнемоника символа префикса, использующая амперсанд (&), интерпретируется как указание подчеркнуть последующий символ, а мнемоника символа префикса с двойным амперсандом (&&) воспринимается как указание напечатать один амперсанд.Typically, the ampersand (&) mnemonic-prefix character is interpreted as a directive to underscore the character that follows, and the double-ampersand (&&) mnemonic-prefix characters as a directive to print a single ampersand. Путем задания объекта NoPrefix эта обработка отключается.By specifying NoPrefix, this processing is turned off. Например, результатом применения NoPrefix к входной строке "A&bc&&d" будут выходные данные "A&bc&&d".For example, an input string of "A&bc&&d" with NoPrefix applied would result in output of "A&bc&&d". Сравнение с PrefixOnly.Compare with PrefixOnly.

PathEllipsis PathEllipsis PathEllipsis PathEllipsis 16384

Удаляет центр обрезанной строки и заменяет его многоточием.Removes the center of trimmed lines and replaces it with an ellipsis.

PrefixOnly PrefixOnly PrefixOnly PrefixOnly 2097152

Устаревшее значение, которое не оказывает никакого влияния.A legacy value that has no effect. Рисовал только подчеркивание в позиции символа, следующего за префиксом в виде амперсанда (&), и не рисовал никакие другие символы в строке.It drew only an underline at the position of the character following the ampersand (&) prefix character, and did not draw any other characters in the string.

PreserveGraphicsClipping PreserveGraphicsClipping PreserveGraphicsClipping PreserveGraphicsClipping 16777216

Сохраняет обрезку, заданную объектом Graphics.Preserves the clipping specified by a Graphics object. Применяется только к методам получающим контекст IDeviceContext, то есть объект Graphics.Applies only to methods receiving an IDeviceContext that is a Graphics.

PreserveGraphicsTranslateTransform PreserveGraphicsTranslateTransform PreserveGraphicsTranslateTransform PreserveGraphicsTranslateTransform 33554432

Сохраняет преобразование, заданное объектом Graphics.Preserves the transformation specified by a Graphics. Применяется только к методам получающим контекст IDeviceContext, то есть объект Graphics.Applies only to methods receiving an IDeviceContext that is a Graphics.

Right Right Right Right 2

Выравнивает текст по правой стороне области отсечения.Aligns the text on the right side of the clipping area.

RightToLeft RightToLeft RightToLeft RightToLeft 131072

Отображает текст справа налево.Displays the text from right to left.

SingleLine SingleLine SingleLine SingleLine 32

Выводит текст на одной строке.Displays the text in a single line.

TextBoxControl TextBoxControl TextBoxControl TextBoxControl 8192

Указывает, что текст должен форматироваться для отображения в элементе управления TextBox.Specifies the text should be formatted for display on a TextBox control.

Top Top Top Top 0

Выравнивает текст по верху ограничивающего прямоугольника.Aligns the text on the top of the bounding rectangle.

VerticalCenter VerticalCenter VerticalCenter VerticalCenter 4

Центрирует текст по вертикали в ограничивающем прямоугольнике.Centers the text vertically, within the bounding rectangle.

WordBreak WordBreak WordBreak WordBreak 16

Разрывает текст в конце слова.Breaks the text at the end of a word.

WordEllipsis WordEllipsis WordEllipsis WordEllipsis 262144

Обрезает строку по ближайшему слову, и в конец обрезанной строки вставляется многоточие.Trims the line to the nearest word and an ellipsis is placed at the end of a trimmed line.

Примеры

В следующем примере показано, TextFormatFlags как использовать перечисление.The following example demonstrates how to use the TextFormatFlags enumeration. Чтобы выполнить этот пример, вставьте следующий код в форму Windows Forms.To run this example, paste the following code into a Windows Form. Вызовите RenderText6 из обработчика Paint событий формы, передав e его PaintEventArgsкак.Call RenderText6 from the form's Paint event handler, passing e as PaintEventArgs.

private void RenderText6(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.EndEllipsis;
    TextRenderer.DrawText(e.Graphics, "This is some text that will be clipped at the end.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags);
}
Private Sub RenderText6(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = TextFormatFlags.Bottom Or _
        TextFormatFlags.EndEllipsis
    TextRenderer.DrawText(e.Graphics, _
    "This is some text that will be clipped at the end.", _
    Me.Font, New Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags)

End Sub

Комментарии

Перечисление используется TextRenderer при рисовании и измерении текста. TextFormatFlagsThe TextFormatFlags enumeration is used by the TextRenderer when drawing and measuring text. Не поддерживает добавление табуляции к рисуемому тексту, хотя существующие позиции табуляции можно развернуть ExpandTabs с помощью флага. TextRendererThe TextRenderer does not support adding tab stops to drawn text, although you can expand existing tab stops using the ExpandTabs flag.

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

Дополнительно