TBM_SETBUDDY

This 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.

At a Glance

Header file: Commctrl.h
Windows CE versions: 2.0 and later

Syntax

  1. TBM_SETBUDDY wParam = (WPARAM)(BOOL) fLocation;
    lParam = (LPARAM)(HWND) hwndBuddy;

Parameters

fLocation

Boolean that specifies the location at which to display the buddy window. It is one of the following values:

Value Description
TRUE The buddy appears 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 appears 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.

hwndBuddy

Handle to the window to be set as the trackbar control’s buddy.

Return Values

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

Remarks

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.