Edit

EM_FINDWORDBREAK message

  • Article

Finds the next word break before or after the specified character position or retrieves information about the character at that position.

Parameters

wParam

Specifies the find operation. This parameter can be one of the following values.

Value Meaning
WB_CLASSIFY
 Returns the character class and word-break flags of the character at the specified position.
WB_ISDELIMITER
 Returns TRUE if the character at the specified position is a delimiter, or FALSE otherwise.
WB_LEFT
 Finds the nearest character before the specified position that begins a word.
WB_LEFTBREAK
 Finds the next word end before the specified position. This value is the same as WB_PREVBREAK.
WB_MOVEWORDLEFT
 Finds the next character that begins a word before the specified position. This value is used during CTRL+LEFT ARROW key processing. This value is the similar to WB_MOVEWORDPREV. See Remarks for more information.
WB_MOVEWORDRIGHT
 Finds the next character that begins a word after the specified position. This value is used during CTRL+right key processing. This value is similar to WB_MOVEWORDNEXT. See Remarks for more information.
WB_RIGHT
 Finds the next character that begins a word after the specified position.
WB_RIGHTBREAK
 Finds the next end-of-word delimiter after the specified position. This value is the same as WB_NEXTBREAK.

lParam

Zero-based character starting position.

Return value

The message returns a value based on the wParam parameter.

Return code Description
wParam
 Return Value
WB_CLASSIFY
 Returns the character class and word-break flags of the character at the specified position.
WB_ISDELIMITER
 Returns TRUE if the character at the specified position is a delimiter; otherwise it returns FALSE.
Others
 Returns the character index of the word break.

Remarks

If wParam is WB_LEFT and WB_RIGHT, the word-break procedure finds word breaks only after delimiters. This matches the functionality of an edit control. If wParam is WB_MOVEWORDLEFT or WB_MOVEWORDRIGHT, the word-break procedure also compares character classes and word-break flags.

For information about character classes and word-break flags, see Word and Line Breaks.

Requirements

Requirement Value
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]
Header
Richedit.h