Export (0) Print
Expand All
Expand Minimize

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 class StringTrimming

Member nameDescription
CharacterSpecifies that the text is trimmed to the nearest character.
EllipsisCharacterSpecifies that the text is trimmed to the nearest character, 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.
EllipsisWordSpecifies that text is trimmed to the nearest word, and an ellipsis is inserted at the end of a trimmed line.
NoneSpecifies no trimming.
WordSpecifies 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.

   void ShowStringTrimming( PaintEventArgs^ e )
      StringFormat^ format1 = gcnew 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, RectangleF(10.0F,10.0F,90.0F,50.0F), format1 );

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

© 2014 Microsoft