msgs12.hlp (Topic list)
MLM_QUERYFORMATRECT (1.2)
Message Group  Overview                           Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINMLE
 
MLM_QUERYFORMATRECT
mp1 = MPFROMP((PMLEFORMATRECT) pmlefrmrcl); /* point to MLEFORMATRECT */
mp2 = MPFROMP((PULONG) pflOptions);         /* point to variable      */
 
An application sends an MLM_QUERYFORMATRECT message to retrieve the
dimensions used to define the format rectangle for a multiple-line entry
field (MLE).
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
pmlefrmrcl  Low and high word of mp1. Points to the MLEFORMATRECT structure
            that receives the format-rectangle dimensions for the MLE.
 
pflOptions  Low and high word of mp2. Points to the variable that receives
            the flags that specify how the format rectangle is to be used. A
            value of zero causes the MLE to remove any format rectangle and
            to ignore the pmlefrmrcl parameter. Otherwise, this parameter
            can be a combination of the following values:
 
            Value                   Meaning
            ────────────────────────────────────────────────────────────────
            MLFFMTRECT_LIMITHORZ    Specifies that the text within the MLE
                                    cannot exceed the horizontal dimension
                                    specified by the pmlefrmrcl parameter.
                                    If word-wrap mode is turned on before
                                    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 before 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 pmlefrmrcl parameter.
                                    An MLN_PIXVERTOVERFLOW notification
                                    message is sent to the application
                                    whenever an MLE operation would cause
                                    text to exceed the vertical limit.
 
            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 MLFFMTRECT_LIMITHORZ,
                                    MLFFMTRECT_LIMITVERT, and
                                    MLFFMTRECT_MATCHWINDOW values.
 
Return Value
 
The return value is always FALSE.
 
See Also
 
MLM_SETFORMATRECT, MLEFORMATRECT