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


TextFormatFlags Перечисление

Определение

Указывает сведения об отображении и размещении строк текста.

Это перечисление поддерживает побитовую комбинацию значений его членов.

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

Поля

Bottom 8

Выравнивает текст по низу ограничивающего прямоугольника. Применяется только в том случае, когда текст располагается на одной строке.

Default 0

Применяет форматирование по умолчанию, которым является выравнивание влево.

EndEllipsis 32768

Удаляет конец обрезанной строки и заменяет его многоточием. Если используется для рисования текста с помощью TextRenderer, строка не изменяется, если ModifyString не указан флаг . Сравнение с PathEllipsis и WordEllipsis.

ExpandTabs 64

Расширяет табуляцию. По умолчанию количество символов на шаг табуляции равно восьми. Значения WordEllipsis, PathEllipsis и EndEllipsis невозможно использовать с ExpandTabs.

ExternalLeading 512

Включает внешнее межстрочное расстояние шрифта в высоту строки. Обычно внешнее межстрочное расстояние не включается в высоту строки текста.

GlyphOverhangPadding 0

Добавляет внутренние поля в ограничивающий прямоугольник, чтобы вместить выступающие глифы. Это значение по умолчанию.

HidePrefix 1048576

Игнорирует символ префикса амперсанда (&) в тексте, чтобы следующая буква не подчеркивалась, но другие мнемонические префиксы по-прежнему обрабатываются.

HorizontalCenter 1

Центрирует текст по горизонтали в ограничивающем прямоугольнике.

Internal 4096

Использует системный шрифт для вычисления размеров текста.

Left 0

Выравнивает текст по левой стороне области отсечения. Это значение по умолчанию.

LeftAndRightPadding 536870912

Добавляет внутренние поля для обеих сторон ограничивающего прямоугольника.

ModifyString 65536

Не влияет на нарисованный текст или измерения текста. Если используется для рисования текста с помощью TextRenderer, изменяет указанный строковый параметр в соответствии с отображаемым текстом, если отображается многоточие. Это значение не действует, если не указано EndEllipsis или PathEllipsis.

NoClipping 256

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

NoFullWidthCharacterBreak 524288

Устаревшее значение, которое не оказывает никакого влияния. Предотвращает разрыв строки в строке с двухбайтовых символов, чтобы данное правило разбиения строк было эквивалентно правилу для строк однобайтовых символов.

NoPadding 268435456

Не добавляет внутренние поля в ограничивающий прямоугольник.

NoPrefix 2048

Выключает обработку символов префикса. Как правило, символ префикса амперсанда (&) интерпретируется как директива для подчеркивания следующего символа, а символы префикса с двойным амперсандом (&&) — как директива для печати одного амперсанда. Путем задания объекта NoPrefix эта обработка отключается. Например, входная строка "A&bc&&d" с NoPrefix параметром applied приведет к выводу "A&bc&&d". Сравните с PrefixOnly.

PathEllipsis 16384

Удаляет центр обрезанной строки и заменяет его многоточием. Если используется для рисования текста с помощью TextRenderer, строка не изменяется, если ModifyString не указан флаг . Сравнение с EndEllipsis и WordEllipsis.

PrefixOnly 2097152

Рисует только подчеркивание в позиции символа после символа префикса амперсанда (&) и не рисует другие символы в строке.

PreserveGraphicsClipping 16777216

Сохраняет обрезку, заданную объектом Graphics. Применяется только к методам получающим контекст IDeviceContext, то есть объект Graphics.

PreserveGraphicsTranslateTransform 33554432

Сохраняет преобразование, заданное объектом Graphics. Применяется только к методам получающим контекст IDeviceContext, то есть объект Graphics.

Right 2

Выравнивает текст по правой стороне области отсечения.

RightToLeft 131072

Отображает текст справа налево.

SingleLine 32

Выводит текст на одной строке.

TextBoxControl 8192

Указывает, что текст должен форматироваться для отображения в элементе управления TextBox.

Top 0

Выравнивает текст по верху ограничивающего прямоугольника. Это значение по умолчанию.

VerticalCenter 4

Центрирует текст по вертикали в ограничивающем прямоугольнике.

WordBreak 16

Разрывает текст в конце слова.

WordEllipsis 262144

Обрезает строку по ближайшему слову, и в конец обрезанной строки вставляется многоточие. Сравнение с EndEllipsis и PathEllipsis.

Примеры

В следующем примере показано, как использовать перечисление TextFormatFlags . Чтобы запустить этот пример, вставьте следующий код в форму Windows Forms. Вызов RenderText6 из обработчика Paint событий формы, передавая e как 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

Комментарии

Перечисление TextFormatFlags используется при рисовании и измерении TextRenderer текста. TextRenderer не поддерживает добавление позиций табуляции для рисуемого текста, однако существующие позиции табуляции можно расширить с помощью флага ExpandTabs.

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

См. также раздел