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 эта обработка отключается. Например, результатом применения NoPrefix к входной строке "A&bc&&d" будут выходные данные "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. Вызов 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 .

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

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