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