msgs12.hlp (Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
MLM_IMPORT(1.2)
Message Group  Overview                           Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINMLE
 
MLM_IMPORT
mp1 = MPFROMP(plOffset);     /* import offset           */
mp2 = MPFROMLONG(cbCopy);    /* number of bytes to copy */
 
An application sends an MLM_IMPORT message to insert the contents of the
buffer specified by the MLM_SETIMPORTEXPORT message into the multiple-line
entry field (MLE).
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
plOffset   Low and high word of mp1. Points to the variable that specifies
           the offset (number of characters from the beginning of the text)
           to the edit-control buffer where the import buffer is to be
           inserted. A value of -1 specifies the current cursor position. On
           return, this variable contains the offset to the first character
           beyond the imported buffer.
 
cbCopy     Low and high word of mp2. Specifies the number of bytes to
           import. If the last byte transferred is half of a double-byte
           character or part of a line-break sequence
           (carriage-return/linefeed), the last character is not
           transferred.
 
Return Value
 
The return value is a 32-bit value (ULONG) that specifies the number of
bytes actually imported. This may be less than the value specified by the
cbCopy parameter──if the last byte to copy included only part of a
double-byte character or part of a line-break sequence. The return value is
zero if the import would overflow the text limit set by the
MLM_SETTEXTLIMIT message.
 
Comments
 
The contents of the buffer are interpreted as being in the form set by the
MLM_FORMAT message.
 
See Also
 
MLM_FORMAT, MLM_SETIMPORTEXPORT, MLM_SETTEXTLIMIT, MLN_OVERFLOW, WM_CONTROL