An EditWordBreakProc function is an application-defined callback function. A value of type EDITWORDBREAKPROC is a pointer to such a function.
Windows NT: A multiline edit control calls an EditWordBreakProc function whenever the control must break a line of text.
Windows 95: A multiline edit control or a rich edit control calls an EditWordBreakProc function whenever the control must break a line of text.
int CALLBACK EditWordBreakProc(
LPTSTR lpch, | // pointer to edit text |
int ichCurrent, | // index of starting point |
int cch, | // length in characters of edit text |
int code | // action to take |
); |
Parameters
lpch
Points to the text of the edit control.
ichCurrent
Specifies an index to a character position in the buffer of text that identifies the point at which the function should begin checking for a word break.
cch
Specifies the number of characters in the edit control text.
code
Specifies the action to be taken by the callback function. This parameter can be one of the following values:
Value | Action |
WB_ISDELIMITER | Checks whether the character at the current position is a delimiter. |
WB_LEFT | Looks for the beginning of a word to the left of the current position. |
WB_RIGHT | Looks for the beginning of a word to the right of the current position. (This is useful in right-aligned edit controls.) |
Windows 95: Additional values for the code parameter are defined for rich edit controls. For a list of these values, see the description of the EM_FINDWORDBREAK message.
Return Values
If the code parameter specifies WB_ISDELIMITER, the return value is nonzero (TRUE) if the character at the current position is a delimiter, or zero if it is not. Otherwise, the return value is an index to the beginning of a word in the buffer of text.
Remarks
A carriage return followed by a linefeed must be treated as a single word by the callback function. Two carriage returns followed by a linefeed also must be treated as a single word.
An application must install the callback function by specifying the address of the callback function in an EM_SETWORDBREAKPROC message.
EditWordBreakProc is a placeholder for an application-defined function name.
See Also