This topic has not yet been rated Rate this topic

StringTrimming enumeration

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: 9/7/2011

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ