WM QUERYWINDOWPARAMS

This message occurs when an application queries the window parameters.

in Button Controls

Occurs when an application queries the button control window procedure window parameters.

in Entry Fields

This message occurs when an application queries the entry field control window parameters.

in Frame Controls

This message occurs when an application queries the frame control window parameters.

in List Boxes

Occurs when an application queries the list box control window parameters.

in Menu Controls

Occurs when an application queries the menu control window procedure parameters.

in Multiline Entry Fields

This message occurs when an application queries the entry field control window parameters.

in Scroll Bars

This message occurs when an application queries the scroll bar control window parameters.

in Static Controls

This message occurs when an application queries the static control window procedure window parameters.

in Title Bars

This message occurs when an application queries the title bar control window procedure window parameters.

Syntax

param1
    PWNDPARAMS pwndparams; /* Window parameter structure. */

param2
    ULONG      ulReserved; /* Reserved value, should be 0. */

in Circular Slider Controls

param1
     PWNDPARAMS  pwndparams  /*  Pointer to a WNDPARAMS window parameter structure. */

param2
     ULONG       ulReserved  /*  Reserved value, should be 0. */

in Slider Controls

param1
     PWNDPARAMS  pwndparams  /*  Pointer to a WNDPARAMS window parameter structure. */

param2
     ULONG       ulReserved  /*  Reserved value, should be 0. */

in Value Set Controls

param1
     PWNDPARAMS  wndparams   /*  Pointer to a WNDPARAMS window parameter structure. */

param2
     ULONG       ulReserved  /*  Reserved value, should be 0. */

Parameters

pwndparams (PWNDPARAMS) - input/output

This points to a WNDPARAMS structure. The valid values of fsStatus are WPM_CCHTEXT, WPM_TEXT, WPM_CBCTLDATA, and WPM_CTLDATA. The flags in fsStatus are cleared as each item is processed. If the call is successful, fsStatus is 0. If any item has not been processed, the flag for that item is still set.

ulReserved (ULONG) - input

Reserved value, should be 0.

in Slider Controls

pwndparams (PWNDPARAMS) - input/output

Pointer to a WNDPARAMS window parameter structure. This structure contains:

status (USHORT) - Window parameter selection. Identifies the window parameters that are to be set or queried. Valid values for the slider control are

WPM_CBCTLDATA: Window control data length.

WPM_CTLDATA: Window control data.

The flags in the status field are cleared as each item is processed. If the call is successful, the status field is 0. If any item has not been processed, the flag for that item is still set.

length (USHORT) - Length of the window text.

text (PSZ) - Window text.

presparamslength (USHORT) - Length of presentation parameters.

presparams (PVOID) - Presentation parameters.

ctldatalength (USHORT) - Length of window class-specific data.

ctldata (PVOID) - Window class-specific data.

ulReserved (ULONG) - Reserved value, should be 0.

in Circular Slider Controls

pwndparams (PWNDPARAMS) - input/output

Pointer to a WNDPARAMS window parameter structure. This structure contains:

status (ULONG) - Window parameter selection. Identifies the window parameters that are to be queried. Valid values for the slider control are

WPM_TEXT: Window text.

WPM_CCHTEXT: Window text length.

The flags in the status field are unchanged by this processing.

length (ULONG) - Length of the window text.

text (PSZ) - Window text.

presparamslength (ULONG) - Length of presentation parameters.

presparams (PVOID) - Presentation parameters.

ctldatalength (ULONG) - Length of window class-specific data.

ctldata (PVOID) - Window class-specific data.

ulReserved (ULONG) - Reserved value, should be 0.

in Value Set Controls

wndparams (PWNDPARAMS) - input/output

Pointer to a WNDPARAMS window parameter structure. For a value set, the valid values for the fsStatus field are WPM_CBCTLDATA and WPM_CTLDATA. The flags in the fsStatus field are cleared as each item is processed. If the call is successful, the fsStatus field is NULL. If any item has not been processed, the flag for that item is still set.

ulReserved (ULONG) - Reserved value, should be 0.

Returns

rc (BOOL) - returns

Success indicator.

TRUE: Successful completion

FALSE: Error occurred

Remarks

If this message is sent to a window of another process, the information in, or identified by, pwndparams must be in memory shared by both processes.

in Button Controls

The button control window procedure responds to this message by passing it to the default window procedure.

in Circular Slider Controls

The slider control window procedure responds to this message by returning the information in the buffer provided. If this message is sent to a slider window of another process, the information in, or identified by, the value of the pwndparams field must be in memory shared by both processes.

in Entry Fields

The entry field control window procedure responds to this message by returning the window parameters indicated by the fsStatus parameter of the WNDPARAMS data structure identified by the pwndparams parameter.

in List Boxes

The list box control window procedure responds to this message by passing it to the default window procedure.

in Menu Controls

The menu control window procedure responds to this message by passing it to the default window procedure.

in Multiline Entry Fields

The multi-line entry field control window procedure responds to this message by returning the window parameters indicated by the fsStatus parameter of the WNDPARAMS data structure, identified by the pwndparams parameter.

In response to the WPM_CCHTEXT flag, the text length is reported in the CF_TEXT format. If it exceeds 64KB-1, then this value is reported. In response to the WPM_TEXT flag, text up to the amount returned for the WPM_CCHTEXT value is placed at the indicated location in CF_TEXT format.

in Scroll Bars

The scroll bar control window procedure responds to this message by returning the window parameters indicated by the fsStatus parameter of the WNDPARAMS data structure identified by the pwndparams parameter.

in Slider Controls

The slider control window procedure responds to this message by returning the information in the buffer provided. If this message is sent to a slider window of another process, the information in, or identified by, the value of the pwndparams field must be in memory shared by both processes.

in Static Controls

The static control window procedure responds to this message by passing it to the default window procedure.

in Value Set Controls

The value set control window procedure responds to this message by returning the information in the buffer provided. If this message is sent to a value set window of another process, the information in, or identified by, the wndparams parameter must be in memory shared by both processes.

Default Processing

The default window procedure sets the cchText, cbPresParams, and cbCtlData parameters of the WNDPARAMS data structure identified by the pwndparams to 0, and sets rc to FALSE.

in Title Bars

The title bar control window procedure queries the appropriate window parameters in accordance with pwndparams and sets rc to TRUE if the operation is successful, otherwise to FALSE.

in Frame Controls

The frame control window procedure queries the appropriate window parameters in accordance with pwndparams and sets rc to TRUE if the operation is successful, otherwise to FALSE.

The window text of a frame control is obtained by sending this message to its FID_TITLEBAR.

Related Messages

• WM_QUERYWINDOWPARAMS (in Button Controls)
• WM_QUERYWINDOWPARAMS (in Entry Fields)
• WM_QUERYWINDOWPARAMS (in Frame Controls)
• WM_QUERYWINDOWPARAMS (in List Boxes)
• WM_QUERYWINDOWPARAMS (in Menu Controls)
• WM_QUERYWINDOWPARAMS (in Multiline Entry Fields)
• WM_QUERYWINDOWPARAMS (in Scroll Bars)
• WM_QUERYWINDOWPARAMS (in Static Controls)
• WM_QUERYWINDOWPARAMS (in Title Bars)