This topic has not yet been rated - Rate this topic

TextFormatFlags Enumeration

.NET Framework 4

Other Versions

Specifies the display and layout information for text strings.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

C++

Copy

[FlagsAttribute]
public enum TextFormatFlags

Members

	Member name	Description
	Bottom	Aligns the text on the bottom of the bounding rectangle. Applied only when the text is a single line.
	EndEllipsis	Removes the end of trimmed lines, and replaces them with an ellipsis.
	ExpandTabs	Expands tab characters. The default number of characters per tab is eight. The WordEllipsis, PathEllipsis, and EndEllipsis values cannot be used with ExpandTabs.
	ExternalLeading	Includes the font external leading in line height. Typically, external leading is not included in the height of a line of text.
	Default	Applies the default formatting, which is left-aligned.
	HidePrefix	Applies to Windows 2000 and Windows XP only: Ignores the ampersand (&) prefix character in the text. The letter that follows will not be underlined, but other mnemonic-prefix characters are still processed. For example, an input string of "A&bc&&d" with HidePrefix applied would result in output of "Abc&d". Compare with NoPrefix and PrefixOnly.
	HorizontalCenter	Centers the text horizontally within the bounding rectangle.
	Internal	Uses the system font to calculate text metrics.
	Left	Aligns the text on the left side of the clipping area.
	ModifyString	Has no effect on the drawn text.
	NoClipping	Allows the overhanging parts of glyphs and unwrapped text reaching outside the formatting rectangle to show.
	NoPrefix	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. By specifying NoPrefix, this processing is turned off. For example, an input string of "A&bc&&d" with NoPrefix applied would result in output of "A&bc&&d". Compare with HidePrefix and PrefixOnly.
	NoFullWidthCharacterBreak	Applies to Windows 98, Windows Me, Windows 2000, or Windows XP only: Prevents a line break at a double-wide character string, so that the line-breaking rule is equivalent to single-wide character strings. For example, NoFullWidthCharacterBreak increases the readability of icon labels in Korean windows. This value has no effect unless WordBreak is also specified.
	PathEllipsis	Removes the center of trimmed lines and replaces it with an ellipsis.
	PrefixOnly	Applies to Windows 2000 or Windows XP only: Draws only an underline at the position of the character following the ampersand (&) prefix character. Does not draw any other characters in the string. For example, an input string of "A&bc&&d" would result in output of " _ ". Compare with HidePrefix and NoPrefix.
	Right	Aligns the text on the right side of the clipping area.
	RightToLeft	Displays the text from right to left.
	SingleLine	Displays the text in a single line.
	TextBoxControl	Specifies the text should be formatted for display on a TextBox control.
	Top	Aligns the text on the top of the bounding rectangle.
	VerticalCenter	Centers the text vertically, within the bounding rectangle.
	WordBreak	Breaks the text at the end of a word.
	WordEllipsis	Trims the line to the nearest word and an ellipsis is placed at the end of a trimmed line.
	PreserveGraphicsClipping	Preserves the clipping specified by a Graphics object. Applies only to methods receiving an IDeviceContext that is a Graphics.
	PreserveGraphicsTranslateTransform	Preserves the transformation specified by a Graphics. Applies only to methods receiving an IDeviceContext that is a Graphics.
	GlyphOverhangPadding	Adds padding to the bounding rectangle to accommodate overhanging glyphs.
	NoPadding	Does not add padding to the bounding rectangle.
	LeftAndRightPadding	Adds padding to both sides of the bounding rectangle.

Remarks

The TextFormatFlags enumeration is used by the TextRenderer when drawing and measuring text. The TextRenderer does not support adding tab stops to drawn text, although you can expand existing tab stops using the ExpandTabs flag.

Examples

The following code example demonstrates how to use the TextFormatFlags enumeration. To run this example, paste the following code into a Windows Form. Call RenderText6 from the form's Paint event handler, passing e as PaintEventArgs.

Copy


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);
}

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

System.Windows.Forms Namespace

Other Resources

Using Fonts and Text

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ