TBM_SETBUDDY message

Assigns a window as the buddy window for a trackbar control. Trackbar buddy windows are automatically displayed in a location relative to the control's orientation (horizontal or vertical).

Parameters

wParam

Value specifying the location at which to display the buddy window. This value can be one of the following:

Value Meaning
TRUE
The buddy will appear to the left of the trackbar if the trackbar control uses the TBS_HORZ style. If the trackbar uses the TBS_VERT style, the buddy appears above the trackbar control.
FALSE
The buddy will appear to the right of the trackbar if the trackbar control uses the TBS_HORZ style. If the trackbar uses the TBS_VERT style, the buddy appears below the trackbar control.

lParam

Handle to the window that will be set as the trackbar control's buddy.

Return value

Returns the handle to the window that was previously assigned to the control at that location.

Remarks

Note

Trackbar controls support up to two buddy windows. This can be useful when you must display text or images at each end of the control.

Requirements

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