CCM_SETVERSION message

This message is used to inform the control that you are expecting a behavior associated with a particular version.

Parameters

wParam

The version number.

lParam

Must be zero.

Return value

Returns the version specified in the previous CCM_SETVERSION message. If wParam is set to a value greater than the current DLL version, it returns -1.

Remarks

In a few cases, a control may behave differently, depending on the version. This primarily applies to bugs that were fixed in later versions. The CCM_SETVERSION message enables you to inform the control which behavior is expected. You can determine which version you have specified by sending a CCM_GETVERSION message. For an example of how to use this message, see Custom Draw With List-View and Tree-View Controls.

If you have ComCtl32.dll version 6 installed, regardless of what value you set in wParam, the CCM_SETVERSION message returns version 6.

Note

This message only sets the version number for the control to which it is sent.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h