TextFormatFlags TextFormatFlags TextFormatFlags TextFormatFlags Enum

Определение

Указывает сведения об отображении и размещении строк текста. Specifies the display and layout information for text strings.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
type TextFormatFlags = 
Public Enum TextFormatFlags
Наследование
TextFormatFlagsTextFormatFlagsTextFormatFlagsTextFormatFlags
Атрибуты

Поля

Bottom Bottom Bottom Bottom 8

Выравнивает текст по низу ограничивающего прямоугольника. Aligns the text on the bottom of the bounding rectangle. Применяется только в том случае, когда текст располагается на одной строке. Applied only when the text is a single line.

Default Default Default Default 0

Применяет форматирование по умолчанию, которым является выравнивание влево. Applies the default formatting, which is left-aligned.

EndEllipsis EndEllipsis EndEllipsis EndEllipsis 32768

Удаляет конец обрезанной строки и заменяет его многоточием. Removes the end of trimmed lines, and replaces them with an ellipsis.

ExpandTabs ExpandTabs ExpandTabs ExpandTabs 64

Расширяет табуляцию. Expands tab characters. По умолчанию количество символов на шаг табуляции равно восьми. The default number of characters per tab is eight. Значения WordEllipsis, PathEllipsis и EndEllipsis невозможно использовать с ExpandTabs. The WordEllipsis, PathEllipsis, and EndEllipsis values cannot be used with ExpandTabs.

ExternalLeading ExternalLeading ExternalLeading ExternalLeading 512

Включает внешнее межстрочное расстояние шрифта в высоту строки. Includes the font external leading in line height. Обычно внешнее межстрочное расстояние не включается в высоту строки текста. Typically, external leading is not included in the height of a line of text.

GlyphOverhangPadding GlyphOverhangPadding GlyphOverhangPadding GlyphOverhangPadding 0

Добавляет внутренние поля в ограничивающий прямоугольник, чтобы вместить выступающие глифы. Adds padding to the bounding rectangle to accommodate overhanging glyphs.

HidePrefix HidePrefix HidePrefix HidePrefix 1048576

Применяется только к Windows 2000 и Windows XP: Applies to Windows 2000 and Windows XP only:

HorizontalCenter HorizontalCenter HorizontalCenter HorizontalCenter 1

Центрирует текст по горизонтали в ограничивающем прямоугольнике. Centers the text horizontally within the bounding rectangle.

Internal Internal Internal Internal 4096

Использует системный шрифт для вычисления размеров текста. Uses the system font to calculate text metrics.

Left Left Left Left 0

Выравнивает текст по левой стороне области отсечения. Aligns the text on the left side of the clipping area.

LeftAndRightPadding LeftAndRightPadding LeftAndRightPadding LeftAndRightPadding 536870912

Добавляет внутренние поля для обеих сторон ограничивающего прямоугольника. Adds padding to both sides of the bounding rectangle.

ModifyString ModifyString ModifyString ModifyString 65536

Не влияет на прорисовываемый текст. Has no effect on the drawn text.

NoClipping NoClipping NoClipping NoClipping 256

Разрешает отображение выступающих частей глифов и развернутого текста, выходящих за пределы прямоугольной зоны форматирования. Allows the overhanging parts of glyphs and unwrapped text reaching outside the formatting rectangle to show.

NoFullWidthCharacterBreak NoFullWidthCharacterBreak NoFullWidthCharacterBreak NoFullWidthCharacterBreak 524288

Применяется только к Windows 98, Windows Me, Windows 200 и Windows XP: Applies to Windows 98, Windows Me, Windows 2000, or Windows XP only:

NoPadding NoPadding NoPadding NoPadding 268435456

Не добавляет внутренние поля в ограничивающий прямоугольник. Does not add padding to the bounding rectangle.

NoPrefix NoPrefix NoPrefix NoPrefix 2048

Выключает обработку символов префикса. Turns off processing of prefix characters. Обычно мнемоника символа префикса, использующая амперсанд (&), интерпретируется как указание подчеркнуть последующий символ, а мнемоника символа префикса с двойным амперсандом (&&) воспринимается как указание напечатать один амперсанд. Typically, the ampersand (&) mnemonic-prefix character is interpreted as a directive to underscore the character that follows, and the double-ampersand (&&) mnemonic-prefix characters as a directive to print a single ampersand. Путем задания объекта NoPrefix эта обработка отключается. By specifying NoPrefix, this processing is turned off. Например, результатом применения NoPrefix к входной строке "A&bc&&d" будут выходные данные "A&bc&&d". For example, an input string of "A&bc&&d" with NoPrefix applied would result in output of "A&bc&&d".

PathEllipsis PathEllipsis PathEllipsis PathEllipsis 16384

Удаляет центр обрезанной строки и заменяет его многоточием. Removes the center of trimmed lines and replaces it with an ellipsis.

PrefixOnly PrefixOnly PrefixOnly PrefixOnly 2097152

Применяется только к Windows 2000 и Windows XP: Applies to Windows 2000 or Windows XP only:

PreserveGraphicsClipping PreserveGraphicsClipping PreserveGraphicsClipping PreserveGraphicsClipping 16777216

Сохраняет обрезку, заданную объектом Graphics. Preserves the clipping specified by a Graphics object. Применяется только к методам получающим контекст IDeviceContext, то есть объект Graphics. Applies only to methods receiving an IDeviceContext that is a Graphics.

PreserveGraphicsTranslateTransform PreserveGraphicsTranslateTransform PreserveGraphicsTranslateTransform PreserveGraphicsTranslateTransform 33554432

Сохраняет преобразование, заданное объектом Graphics. Preserves the transformation specified by a Graphics. Применяется только к методам получающим контекст IDeviceContext, то есть объект Graphics. Applies only to methods receiving an IDeviceContext that is a Graphics.

Right Right Right Right 2

Выравнивает текст по правой стороне области отсечения. Aligns the text on the right side of the clipping area.

RightToLeft RightToLeft RightToLeft RightToLeft 131072

Отображает текст справа налево. Displays the text from right to left.

SingleLine SingleLine SingleLine SingleLine 32

Выводит текст на одной строке. Displays the text in a single line.

TextBoxControl TextBoxControl TextBoxControl TextBoxControl 8192

Указывает, что текст должен форматироваться для отображения в элементе управления TextBox. Specifies the text should be formatted for display on a TextBox control.

Top Top Top Top 0

Выравнивает текст по верху ограничивающего прямоугольника. Aligns the text on the top of the bounding rectangle.

VerticalCenter VerticalCenter VerticalCenter VerticalCenter 4

Центрирует текст по вертикали в ограничивающем прямоугольнике. Centers the text vertically, within the bounding rectangle.

WordBreak WordBreak WordBreak WordBreak 16

Разрывает текст в конце слова. Breaks the text at the end of a word.

WordEllipsis WordEllipsis WordEllipsis WordEllipsis 262144

Обрезает строку по ближайшему слову, и в конец обрезанной строки вставляется многоточие. Trims the line to the nearest word and an ellipsis is placed at the end of a trimmed line.

Примеры

В следующем примере кода демонстрируется использование ExpandTabs перечисления.The following code example demonstrates how to use the ExpandTabs enumeration. Чтобы выполнить этот пример, вставьте следующий код в форму Windows.To run this example, paste the following code into a Windows Form. Вызовите RenderText6 из формы Paint обработчик событий, передав e как PaintEventArgs.Call RenderText6 from the form's Paint event handler, passing e as 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 при рисовании и измерение текста.The TextFormatFlags enumeration is used by the TextRenderer when drawing and measuring text. TextRenderer Делает использование флага ExpandTabs прекращается поддерживает добавление позиций табуляции для отображаемого текста, несмотря на то, что вы можете развернуть существующую вкладку.The TextRenderer does not support adding tab stops to drawn text, although you can expand existing tab stops using the ExpandTabs flag.

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

См. также