DWRITE_WORD_WRAPPING enumeration (dwrite.h)

  • Article

Specifies the word wrapping to be used in a particular multiline paragraph.

Note  DWRITE_WORD_WRAPPING_EMERGENCY_BREAK, DWRITE_WORD_WRAPPING_WHOLE _WORD, and DWRITE_WORD_WRAPPING_CHARACTER are available in Windows 8.1 and later, only.
 

Syntax

typedef enum DWRITE_WORD_WRAPPING {
  DWRITE_WORD_WRAPPING_WRAP = 0,
  DWRITE_WORD_WRAPPING_NO_WRAP = 1,
  DWRITE_WORD_WRAPPING_EMERGENCY_BREAK = 2,
  DWRITE_WORD_WRAPPING_WHOLE_WORD = 3,
  DWRITE_WORD_WRAPPING_CHARACTER = 4
} ;

Constants

 
DWRITE_WORD_WRAPPING_WRAP
Value: 0
Indicates that words are broken across lines to avoid text overflowing the layout box.
DWRITE_WORD_WRAPPING_NO_WRAP
Value: 1
Indicates that words are kept within the same line even when it overflows the layout box. This option is often used with scrolling to reveal overflow text.
DWRITE_WORD_WRAPPING_EMERGENCY_BREAK
Value: 2
Note  Windows 8.1 and later only.

 

Words are broken across lines to avoid text overflowing the layout box.
Emergency wrapping occurs if the word is larger than the maximum width.
DWRITE_WORD_WRAPPING_WHOLE_WORD
Value: 3
Note  Windows 8.1 and later only.

 

When emergency wrapping, only wrap whole words, never breaking words when the layout width is too small for even a single word.
DWRITE_WORD_WRAPPING_CHARACTER
Value: 4
Note  Windows 8.1 and later only.

 

Wrap between any valid character clusters.

Requirements

Requirement Value
Minimum supported client Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | UWP apps]
Header dwrite.h