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

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

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

public enum class TextFormatFlags

[System.Flags]
public enum TextFormatFlags

[<System.Flags>]
type TextFormatFlags = 

Public Enum TextFormatFlags

Наследование

Object

ValueType

Enum

TextFormatFlags

Атрибуты

FlagsAttribute

Поля

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.

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

• Шрифты и текст