StringTrimming Enumeration

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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
Character

Specifies that the text is trimmed to the nearest character.

EllipsisCharacter

Specifies that the text is trimmed to the nearest character, and an ellipsis is inserted at the end of a trimmed line.

EllipsisPath

The 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.

EllipsisWord

Specifies that text is trimmed to the nearest word, and an ellipsis is inserted at the end of a trimmed line.

None

Specifies no trimming.

Word

Specifies that text is trimmed to the nearest word.

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

.NET Framework
Available since 1.1
Return to top
Show: