How To Provide a Custom Wordbreak Function in Edit Controls

This article has been archived. It is offered "as is" and will no longer be updated.
An application sends the EM_SETWORDBREAKPROC message to an edit control toreplace the default wordwrap function with an application-defined wordwrapfunction. The default wordwrap function breaks a line in a multiline editcontrol (MLE) at a space character. If an application needs to change thisfunctionality (that is, to break at some character other than a space),then the application must provide its own wordwrap (wordbreak) function.
More information
A wordwrap function scans a text buffer (which contains text to be sent tothe display), looking for the first word that does not fit on the currentdisplay line. The wordwrap function places this word at the beginning ofthe next line on the display.

A wordwrap function defines the point at which Windows should break a lineof text for multiline edit controls, usually at a space character thatseparates two words. This can be changed so that the line in an MLE can bebroken at any character. For more information on the EM_SETWORDBREAKPROCmessage, please refer to the Platform SDK.

Below is sample code that demonstrates how to break a line in a multilineedit control at the "~" (tilde) character (for example) instead of theregular space (" ") character.

The sample code assumes that the edit control is a multiline edit controland that it is a child control in a dialog box.

Sample Code

   //Prototype the application-defined wordbreakproc.   int CALLBACK WordBreakProc(LPSTR, int, int, int) ;   //Install wordbreakproc in the WM_INITDIALOG case.     case WM_INITDIALOG:/*    For 16 bit applications use the following line to setup your   CALLBACK function.       lpWrdBrkProc = MakeProcInstance(WordBreakProc, hInst);It is not neccessary to use MakeProcInstance in 32-bit applications.*/        //Send the EM_SETWORDBREAKPROC message to the edit control       //to install the new wordbreak procedure.        SendDlgItemMessage(hDlg, ID_EDIT, EM_SETWORDBREAKPROC, 0,                           (LPARAM)(EDITWORDBREAKPROC)lpWrdBrkProc) ;        return (TRUE);   int FAR PASCAL WordBreakProc(LPSTR lpszEditText, int ichCurrent,                                int cchEditText, int wActionCode)   {      char FAR *lpCurrentChar;      int  nIndex;      int  nLastAction;      switch (wActionCode) {        case WB_ISDELIMITER:        // Windows sends this code so that the wordbreak function can        // check to see if the current character is the delimiter.        // If so, return TRUE. This will cause a line break at the ~        // character.         if ( lpszEditText[ichCurrent] == '~' )            return TRUE;         else            return FALSE;         break;        // Because we have replaced the default wordbreak procedure, our        // wordbreak procedure must provide the other standard features in        // edit controls.       case WB_LEFT:        // Windows sends this code when the user enters CTRL+LEFT ARROW.        // The wordbreak function should scan the text buffer for the        // beginning of the word from the current position and move the        // caret to the beginning of the word.            {               BOOL bCharFound = FALSE;               lpCurrentChar = lpszEditText + ichCurrent;               nIndex = ichCurrent;               while (nIndex > 0  &&                     (*(lpCurrentChar-1) != '~' &&                      *(lpCurrentChar-1) != 0x0A) ||                     !bCharFound )              {                  lpCurrentChar = AnsiPrev(lpszEditText ,lpCurrentChar);                  nIndex--;                  if (*(lpCurrentChar) != '~' &&  *(lpCurrentChar) != 0x0A)                     // We have found the last char in the word. Continue                     // looking backwards till we find the first char of                     // the word.                    {                      bCharFound = TRUE;                      // We will consider a CR the start of a word.                      if (*(lpCurrentChar) == 0x0D)                          break;                    }               }               return nIndex;            }         break;        case WB_RIGHT:        //Windows sends this code when the user enters CTRL+RIGHT ARROW.        //The wordbreak function should scan the text buffer for the        //beginning of the word from the current position and move the        //caret to the end of the word.         for (lpCurrentChar = lpszEditText+ichCurrent, nIndex = ichCurrent;              nIndex < cchEditText;              nIndex++, lpCurrentChar=AnsiNext(lpCurrentChar))          if ( *lpCurrentChar == '~' ) {         lpCurrentChar=AnsiNext(lpCurrentChar);            nIndex++;            while ( *lpCurrentChar == '~' ) {              lpCurrentChar=AnsiNext(lpCurrentChar);              nIndex++;             }            return nIndex;          }          return cchEditText;          break;    }  }				
The wordwrap (wordbreak) function above needs to be exported in the .DEFfile of the application. The function can be modified and customizedaccording to the application's needs.

Article ID: 109551 - Last Review: 01/11/2015 00:50:07 - Revision: 3.0

  • kbnosurvey kbarchive kbctrl kbeditctrl kbhowto KB109551