This documentation is archived and is not being maintained.

StringTrimming Enumeration

Specifies how to trim characters from a string that does not completely fit into a layout shape.

Namespace:  System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public enum StringTrimming

Member nameDescription
NoneSpecifies no trimming.
CharacterSpecifies that the text is trimmed to the nearest character.
WordSpecifies that text is trimmed to the nearest word.
EllipsisCharacterSpecifies that the text is trimmed to the nearest character, and an ellipsis is inserted at the end of a trimmed line.
EllipsisWordSpecifies that text is trimmed to the nearest word, and an ellipsis is inserted at the end of a trimmed line.
EllipsisPathThe center is removed from trimmed lines and replaced by an ellipsis. The algorithm keeps as much of the last slash-delimited segment of the line as possible.

The following example shows how to set the Trimming property and how to use the StringTrimming enumeration. This example is designed to be used with a Windows Form. Paste this code into a form and call the ShowStringTrimming method when handling the form's Paint event, passing e as PaintEventArgs.

private void ShowStringTrimming(PaintEventArgs e)

    StringFormat format1 = new StringFormat();
    string quote = "Not everything that can be counted counts," +
        " and not everything that counts can be counted.";
    format1.Trimming = StringTrimming.EllipsisWord;
    e.Graphics.DrawString(quote, this.Font, Brushes.Black, 
        new RectangleF(10.0F, 10.0F, 90.0F, 50.0F), format1);

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0