TextFormatFlags Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает сведения об отображении и размещении строк текста.
Это перечисление поддерживает побитовую комбинацию значений его членов.
public enum class TextFormatFlags[System.Flags]
public enum TextFormatFlags[<System.Flags>]
type TextFormatFlags = Public Enum TextFormatFlags- Наследование
- Атрибуты
Поля
| Bottom | 8 | Выравнивает текст по низу ограничивающего прямоугольника. Применяется только в том случае, когда текст располагается на одной строке. |
| Default | 0 | Применяет форматирование по умолчанию, которым является выравнивание влево. |
| EndEllipsis | 32768 | Удаляет конец обрезанной строки и заменяет его многоточием. Если используется для рисования текста с помощью |
| ExpandTabs | 64 | Расширяет табуляцию. По умолчанию количество символов на шаг табуляции равно восьми. Значения WordEllipsis, PathEllipsis и EndEllipsis невозможно использовать с ExpandTabs. |
| ExternalLeading | 512 | Включает внешнее межстрочное расстояние шрифта в высоту строки. Обычно внешнее межстрочное расстояние не включается в высоту строки текста. |
| GlyphOverhangPadding | 0 | Добавляет внутренние поля в ограничивающий прямоугольник, чтобы вместить выступающие глифы. Это значение по умолчанию. |
| HidePrefix | 1048576 | Игнорирует символ префикса амперсанда (&) в тексте, чтобы следующая буква не подчеркивалась, но другие мнемонические префиксы по-прежнему обрабатываются. |
| HorizontalCenter | 1 | Центрирует текст по горизонтали в ограничивающем прямоугольнике. |
| Internal | 4096 | Использует системный шрифт для вычисления размеров текста. |
| Left | 0 | Выравнивает текст по левой стороне области отсечения. Это значение по умолчанию. |
| LeftAndRightPadding | 536870912 | Добавляет внутренние поля для обеих сторон ограничивающего прямоугольника. |
| ModifyString | 65536 | Не влияет на нарисованный текст или измерения текста. Если используется для рисования текста с помощью |
| NoClipping | 256 | Разрешает отображение выступающих частей глифов и развернутого текста, выходящих за пределы прямоугольной зоны форматирования. |
| NoFullWidthCharacterBreak | 524288 | Устаревшее значение, которое не оказывает никакого влияния. Предотвращает разрыв строки в строке с двухбайтовых символов, чтобы данное правило разбиения строк было эквивалентно правилу для строк однобайтовых символов. |
| NoPadding | 268435456 | Не добавляет внутренние поля в ограничивающий прямоугольник. |
| NoPrefix | 2048 | Выключает обработку символов префикса. Как правило, символ префикса амперсанда (&) интерпретируется как директива для подчеркивания следующего символа, а символы префикса с двойным амперсандом (&&) — как директива для печати одного амперсанда. Путем задания объекта NoPrefix эта обработка отключается. Например, входная строка "A&bc&&d" с NoPrefix параметром applied приведет к выводу "A&bc&&d". Сравните с |
| PathEllipsis | 16384 | Удаляет центр обрезанной строки и заменяет его многоточием. Если используется для рисования текста с помощью |
| 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.
