WM FORMATFRAME

This message is sent to a frame window to calculate the sizes and positions of all of the frame controls and the client window.

Syntax

param1
    PSWP   pswp;    /* Structure array. */

param2
    PRECTL pprectl; /* Pointer to client window rectangle. */

Parameters

pswp (PSWP) - input

This points to an array that is to hold the SWP structures.

pprectl (PRECTL) - input

Pointer to client window rectangle. This is typically the window rectangle of pswp, but where the window has a wide border, as specified by FCF_DLGBORDER for example, the rectangle is inset by the size of the border.

Returns

ccount (USHORT) - returns

Count of the number of SWP arrays returned.

Remarks

in Frame Controls

Applications that subclass frame controls may find that the frame is already subclassed; the number of frame controls is variable.

The WM_FORMATFRAME and WM_QUERYFRAMECTLCOUNT messages must always be subclassed by calling the previous window procedure and modifying its result.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it, other than to set ccount to the default value of 0.

in Frame Controls

The SWP structure for the FID_CLIENT frame control, if present, is the last element of the pswp parameter, unless additional frame controls are added by subclassing; the SWP structures for these follow that for FID_CLIENT if present. The frame control window procedure first sends the message to the FID_CLIENT window. If FID_CLIENT returns ccount to indicate that the message has been processed, no additional processing is performed.

If not processed by the client, the frame control window procedure calculates the size and position of all the standard frame controls.

Related Messages

• WM_FORMATFRAME (in Frame Controls)