EditWordBreakProc
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