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

Определение

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

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

public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
[<System.Flags>]
type TextFormatFlags = 
Public Enum TextFormatFlags
Наследование
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". Сравнение с PrefixOnly.

Internal 4096

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

TextBoxControl 8192

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

PathEllipsis 16384

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

EndEllipsis 32768

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

ModifyString 65536

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

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 .

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

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