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.
MLECTLDATA (1.2)
◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
#define INCL_WINMLE
typedef struct _MLECTLDATA { /* mlectl */
USHORT cbCtlData;
USHORT afIEFormat;
ULONG cchText;
IPT iptAnchor;
IPT iptCursor;
LONG cxFormat;
LONG cyFormat;
ULONG afFormatFlags;
} MLECTLDATA;
The MLECTLDATA structure contains multiple-line entry-field (MLE) format
information.
Field Description
────────────────────────────────────────────────────────────────────────────
cbCtlData Specifies the size of the structure (in bytes). Programs
written in the C language should use the sizeof operator to
set this field.
afIEFormat Specifies the import/export format. This parameter is be one
of the following values:
Value Meaning
─────────────────────────────────────────────────────────────
MLFIE_CFTEXT Specifies the clipboard text format. This
format uses carriage-return/linefeed
characters for line breaks on export, and
recognizes linefeed, carriage-return/linefeed,
or linefeed/carriage-return characters for
line breaks on import. This is the default
format.
MLFIE_NOTRANS Specifies a format that uses linefeed
characters for line breaks. Guarantees that
any text imported into the MLE in this form
can be recovered in exactly the same form on
export.
MLFIE_WINFMT Specifies the format of the MLE window. This
format recognizes carriage-return/linefeed
characters for line breaks on import. It
ignores the sequence
carriage-return/carriage-return/linefeed. On
export, it uses carriage-return/linefeed
characters to denote a hard line break and
carriage-return/carriage-return/linefeed
character to denote a soft line break caused
by word-wrapping.
cchText Specifies the maximum amount (in bytes) of text.
iptAnchor Specifies the offset (number of characters from the beginning
of the text) of the first character of the selection.
iptCursor Specifies the offset of the cursor position (one character to
the right of the selection).
cxFormat Specifies the width (in pels) of the format rectangle.
cyFormat Specifies the height (in pels) of the format rectangle.
afFormatFlags Specifies how the format rectangle is to be treated. This
parameter can be one or more of the following flags:
Value Meaning
─────────────────────────────────────────────────────────────
MLFFMTRECT_LIMITHORZ Specifies that the text within the
MLE cannot exceed the horizontal
dimension specified by the cxFormat
field. If word-wrap mode is turned on
when the format rectangle is set,
lines automatically wrap to stay
within the horizontal limit of the
format rectangle. If word-wrap mode
is turned off when the format
rectangle is set, an
MLN_PIXHORZOVERFLOW notification
message is sent to the application
whenever an operation would exceed
the horizontal limit specified in the
format rectangle.
MLFFMTRECT_LIMITVERT Specifies that the text within the
MLE cannot exceed the vertical
dimension specified by the cyFormat
field. Whenever an MLE operation
would cause text to exceed the
vertical limit, an
MLN_PIXVERTOVERFLOW notification
message is sent to the application.
MLFFMTRECT_MATCHWINDOW Specifies that the format rectangle
is to be kept the same size as the
MLE window (minus the border or
scroll bars).
MLFFMTRECT_FORMATRECT Specifies that the format rectangle
is to be kept the same size as the
MLE window (minus the border or
scroll bars) and that text cannot
exceed the size of the window. This
value is equivalent to combining the
values MLFFMTRECT_LIMITHORZ,
MLFFMTRECT_LIMITVERT, and
MLFFMTRECT_MATCHWINDOW.
See Also
MLM_FORMAT, MLM_SETFORMATRECT
♦