Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

StringTrimming enumeration

Applies to: desktop apps only

The StringTrimming enumeration specifies how to trim characters from a string so that the string fits into a layout rectangle. The layout rectangle is used to position and size the display string.

Syntax

typedef enum  {
  StringTrimmingNone                = 0,
  StringTrimmingCharacter           = 1,
  StringTrimmingWord                = 2,
  StringTrimmingEllipsisCharacter   = 3,
  StringTrimmingEllipsisWord        = 4,
  StringTrimmingEllipsisPath        = 5 
} StringTrimming;

Constants

StringTrimmingNone

Specifies that no trimming is done.

StringTrimmingCharacter

Specifies that the string is broken at the boundary of the last character that is inside the layout rectangle. This is the default.

StringTrimmingWord

Specifies that the string is broken at the boundary of the last word that is inside the layout rectangle.

StringTrimmingEllipsisCharacter

Specifies that the string is broken at the boundary of the last character that is inside the layout rectangle and an ellipsis (...) is inserted after the character.

StringTrimmingEllipsisWord

Specifies that the string is broken at the boundary of the last word that is inside the layout rectangle and an ellipsis (...) is inserted after the word.

StringTrimmingEllipsisPath

Specifies that the center is removed from the string and replaced by an ellipsis. The algorithm keeps as much of the last portion of the string as possible.

Remarks

Trimming affects only the last visible or partly visible (due to clipping) line of text.

Requirements

Minimum supported client

Windows XP, Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Product

GDI+ 1.0

Header

Gdiplusenums.h (include Gdiplus.h)

See also

StringFormat::SetTrimming
StringFormatFlags
StringAlignment
StringDigitSubstitute
DrawString Methods
MeasureString Methods
Formatting Text

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

Show: