| title | ms.custom | ms.date | ms.reviewer | ms.suite | ms.technology | ms.tgt_pltfrm | ms.topic | f1_keywords | dev_langs | helpviewer_keywords | ms.assetid | caps.latest.revision | author | ms.author | manager | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
CSliderCtrl Class | Microsoft Docs |
11/04/2016 |
|
reference |
|
|
|
dd12b084-4eda-4550-a810-8f3cfb06b871 |
22 |
mikeblome |
mblome |
ghogen |
Provides the functionality of the Windows common slider control.
class CSliderCtrl : public CWnd
| Name | Description |
|---|---|
| CSliderCtrl::CSliderCtrl | Constructs a CSliderCtrl object. |
| Name | Description |
|---|---|
| CSliderCtrl::ClearSel | Clears the current selection in a slider control. |
| CSliderCtrl::ClearTics | Removes the current tick marks from a slider control. |
| CSliderCtrl::Create | Creates a slider control and attaches it to a CSliderCtrl object. |
| CSliderCtrl::CreateEx | Creates a slider control with the specified Windows extended styles and attaches it to a CSliderCtrl object. |
| CSliderCtrl::GetBuddy | Retrieves the handle to a slider control buddy window at a given location. |
| CSliderCtrl::GetChannelRect | Retrieves the size of the slider control's channel. |
| CSliderCtrl::GetLineSize | Retrieves the line size of a slider control. |
| CSliderCtrl::GetNumTics | Retrieves the number of tick marks in a slider control. |
| CSliderCtrl::GetPageSize | Retrieves the page size of a slider control. |
| CSliderCtrl::GetPos | Retrieves the current position of the slider. |
| CSliderCtrl::GetRange | Retrieves the minimum and maximum positions for a slider. |
| CSliderCtrl::GetRangeMax | Retrieves the maximum position for a slider. |
| CSliderCtrl::GetRangeMin | Retrieves the minimum position for a slider. |
| CSliderCtrl::GetSelection | Retrieves the range of the current selection. |
| CSliderCtrl::GetThumbLength | Retrieves the length of the slider in the current trackbar control. |
| CSliderCtrl::GetThumbRect | Retrieves the size of the slider control's thumb. |
| CSliderCtrl::GetTic | Retrieves the position of the specified tick mark. |
| CSliderCtrl::GetTicArray | Retrieves the array of tick mark positions for a slider control. |
| CSliderCtrl::GetTicPos | Retrieves the position of the specified tick mark, in client coordinates. |
| CSliderCtrl::GetToolTips | Retrieves the handle to the tooltip control assigned to the slider control, if any. |
| CSliderCtrl::SetBuddy | Assigns a window as the buddy window for a slider control. |
| CSliderCtrl::SetLineSize | Sets the line size of a slider control. |
| CSliderCtrl::SetPageSize | Sets the page size of a slider control. |
| CSliderCtrl::SetPos | Sets the current position of the slider. |
| CSliderCtrl::SetRange | Sets the minimum and maximum positions for a slider. |
| CSliderCtrl::SetRangeMax | Sets the maximum position for a slider. |
| CSliderCtrl::SetRangeMin | Sets the minimum position for a slider. |
| CSliderCtrl::SetSelection | Sets the range of the current selection. |
| CSliderCtrl::SetThumbLength | Sets the length of the slider in the current trackbar control. |
| CSliderCtrl::SetTic | Sets the position of the specified tick mark. |
| CSliderCtrl::SetTicFreq | Sets the frequency of tick marks per slider control increment. |
| CSliderCtrl::SetTipSide | Positions a tooltip control used by a trackbar control. |
| CSliderCtrl::SetToolTips | Assigns a tooltip control to a slider control. |
A "slider control" (also known as a trackbar) is a window containing a slider and optional tick marks. When the user moves the slider, using either the mouse or the direction keys, the control sends notification messages to indicate the change.
Slider controls are useful when you want the user to select a discrete value or a set of consecutive values in a range. For example, you might use a slider control to allow the user to set the repeat rate of the keyboard by moving the slider to a given tick mark.
This control (and therefore the CSliderCtrl class) is available only to programs running under Windows 95/98 and Windows NT version 3.51 and later.
The slider moves in increments that you specify when you create it. For example, if you specify that the slider should have a range of five, the slider can only occupy six positions: a position at the left side of the slider control and one position for each increment in the range. Typically, each of these positions is identified by a tick mark.
You create a slider by using the constructor and the Create member function of CSliderCtrl. Once you have created a slider control, you can use member functions in CSliderCtrl to change many of its properties. Changes that you can make include setting the minimum and maximum positions for the slider, drawing tick marks, setting a selection range, and repositioning the slider.
For more information on using CSliderCtrl, see Controls and Using CSliderCtrl.
CSliderCtrl
Header: afxcmn.h
Clears the current selection in a slider control.
void ClearSel(BOOL bRedraw = FALSE);
bRedraw
Redraw flag. If this parameter is TRUE, the slider is redrawn after the selection is cleared; otherwise the slider is not redrawn.
Removes the current tick marks from a slider control.
void ClearTics(BOOL bRedraw = FALSE);
bRedraw
Redraw flag. If this parameter is TRUE, the slider is redrawn after the tick marks are cleared; otherwise the slider is not redrawn.
Creates a slider control and attaches it to a CSliderCtrl object.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
dwStyle
Specifies the slider control's style. Apply any combination of slider control styles, described in the Windows SDK, to the control.
rect
Specifies the slider control's size and position. It can be either a CRect object or a RECT structure.
pParentWnd
Specifies the slider control's parent window, usually a CDialog. It must not be NULL.
nID
Specifies the slider control's ID.
Nonzero if initialization was successful; otherwise 0.
You construct a CSliderCtrl in two steps. First, call the constructor, and then call Create, which creates the slider control and attaches it to the CSliderCtrl object.
Depending on the values set for dwStyle, the slider control can have either a vertical or horizontal orientation. It can have tick marks on either side, both sides, or neither. It can also be used to specify a range of consecutive values.
To apply extended window styles to the slider control, call CreateEx instead of Create.
Creates a control (a child window) and associates it with the CSliderCtrl object.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
dwExStyle
Specifies the extended style of the control being created. For a list of extended Windows styles, see the dwExStyle parameter for CreateWindowEx in the Windows SDK.
dwStyle
Specifies the slider control's style. Apply any combination of slider control styles, described in the Windows SDK, to the control.
rect
A reference to a RECT structure describing the size and position of the window to be created, in client coordinates of pParentWnd.
pParentWnd
A pointer to the window that is the control's parent.
nID
The control's child-window ID.
Nonzero if successful; otherwise 0.
Use CreateEx instead of Create to apply extended Windows styles, specified by the Windows extended style preface WS_EX_.
Constructs a CSliderCtrl object.
CSliderCtrl();
Retrieves the handle to a slider control buddy window at a given location.
CWnd* GetBuddy(BOOL fLocation = TRUE) const;
fLocation
A Boolean value that indicates which of two buddy window handles to retrieve. Can be one of the following values:
-
TRUE Retrieves the handle to the buddy to the left of the slider. If the slider control uses the
TBS_VERTstyle, the message will retrieve the buddy above the slider. -
FALSE Retrieves the handle to the buddy to the right of the slider. If the slider control uses the
TBS_VERTstyle, the message will retrieve the buddy below the slider.
A pointer to a CWnd object that is the buddy window at the location specified by fLocation, or NULL if no buddy window exists at that location.
This member function implements the behavior of the Win32 message TBM_GETBUDDY, as described in the Windows SDK. For a description of the slider control styles, see Trackbar Control Styles in the Windows SDK.
Retrieves the size and position of the bounding rectangle for a slider control's channel.
void GetChannelRect(LPRECT lprc) const;
lprc
A pointer to a CRect object that contains the size and position of the channel's bounding rectangle when the function returns.
The channel is the area over which the slider moves and which contains the highlight when a range is selected.
Retrieves the size of the line for a slider control.
int GetLineSize() const;
The size of a line for the slider control.
The line size affects how much the slider moves for the TB_LINEUP and TB_LINEDOWN notifications. The default setting for the line size is 1.
Retrieves the number of tick marks in a slider control.
UINT GetNumTics() const;
The number of tick marks in the slider control.
Retrieves the size of the page for a slider control.
int GetPageSize() const;
The size of a page for the slider control.
The page size affects how much the slider moves for the TB_PAGEUP and TB_PAGEDOWN notifications.
Retrieves the current position of the slider in a slider control.
int GetPos() const;
The current position.
Retrieves the maximum and minimum positions for the slider in a slider control.
void GetRange(
int& nMin,
int& nMax) const;
nMin
Reference to an integer that receives the minimum position.
nMax
Reference to an integer that receives the maximum position.
This function copies the values into the integers referenced by nMin and nMax.
Retrieves the maximum position for the slider in a slider control.
int GetRangeMax() const;
The control's maximum position.
Retrieves the minimum position for the slider in a slider control.
int GetRangeMin() const;
The control's minimum position.
Retrieves the starting and ending positions of the current selection in a slider control.
void GetSelection(
int& nMin,
int& nMax) const;
nMin
Reference to an integer that receives the starting position of the current selection.
nMax
Reference to an integer that receives the ending position of the current selection.
Retrieves the length of the slider in the current trackbar control.
int GetThumbLength() const;
The length of the slider, in pixels.
This method sends the TBM_GETTHUMBLENGTH message, which is described in the Windows SDK.
Retrieves the size and position of the bounding rectangle for the slider (thumb) in a slider control.
void GetThumbRect(LPRECT lprc) const;
lprc
A pointer to a CRect object that contains the bounding rectangle for the slider when the function returns.
Retrieves the position of a tick mark in a slider control.
int GetTic(int nTic) const;
nTic
Zero-based index identifying a tick mark.
The position of the specified tick mark or - 1 if nTic does not specify a valid index.
Retrieves the address of the array containing the positions of tick marks for a slider control.
DWORD* GetTicArray() const;
The address of the array containing tick mark positions for the slider control.
Retrieves the current physical position of a tick mark in a slider control.
int GetTicPos(int nTic) const;
nTic
Zero-based index identifying a tick mark.
The physical position, in client coordinates, of the specified tick mark or - 1 if nTic does not specify a valid index.
Retrieves the handle to the tooltip control assigned to the slider control, if any.
CToolTipCtrl* GetToolTips() const;
A pointer to a CToolTipCtrl object, or NULL if tooltips are not in use. If the slider control does not use the TBS_TOOLTIPS style, the return value is NULL.
This member function implements the behavior of the Win32 message TBM_GETTOOLTIPS, as described in the Windows SDK. Note that this member function returns a CToolTipCtrl object instead of a handle to a control.
For a description of the slider control styles, see Trackbar Control Styles in the Windows SDK.
Assigns a window as the buddy window for a slider control.
CWnd* SetBuddy(
CWnd* pWndBuddy,
BOOL fLocation = TRUE);
pWndBuddy
A pointer to a CWnd object that will be set as the slider control's buddy.
fLocation
Value specifying the location at which to display the buddy window. This value can be one of the following:
-
TRUE The buddy will appear to the left of the trackbar if the trackbar control uses the
TBS_HORZstyle. If the trackbar uses theTBS_VERTstyle, 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_HORZstyle. If the trackbar uses theTBS_VERTstyle, the buddy appears below the trackbar control.
A pointer to a CWnd object that was previously assigned to the slider control at that location.
This member function implements the behavior of the Win32 message TBM_SETBUDDY, as described in the Windows SDK. Note that this member function uses pointers to CWnd objects, rather than window handles for both its return value and parameter.
For a description of the slider control styles, see Trackbar Control Styles in the Windows SDK.
Sets the size of the line for a slider control.
int SetLineSize(int nSize);
nSize
The new line size of the slider control.
The previous line size.
The line size affects how much the slider moves for the TB_LINEUP and TB_LINEDOWN notifications.
Sets the size of the page for a slider control.
int SetPageSize(int nSize);
nSize
The new page size of the slider control.
The previous page size.
The page size affects how much the slider moves for the TB_PAGEUP and TB_PAGEDOWN notifications.
Sets the current position of the slider in a slider control.
void SetPos(int nPos);
nPos
Specifies the new slider position.
Sets the range (minimum and maximum positions) for the slider in a slider control.
void SetRange(
int nMin,
int nMax,
BOOL bRedraw = FALSE);
nMin
Minimum position for the slider.
nMax
Maximum position for the slider.
bRedraw
The redraw flag. If this parameter is TRUE, the slider is redrawn after the range is set; otherwise the slider is not redrawn.
Sets the maximum range for the slider in a slider control.
void SetRangeMax(
int nMax,
BOOL bRedraw = FALSE);
nMax
Maximum position for the slider.
bRedraw
The redraw flag. If this parameter is TRUE, the slider is redrawn after the range is set; otherwise the slider is not redrawn.
Sets the minimum range for the slider in a slider control.
void SetRangeMin(
int nMin,
BOOL bRedraw = FALSE);
nMin
Minimum position for the slider.
bRedraw
The redraw flag. If this parameter is TRUE, the slider is redrawn after the range is set; otherwise the slider is not redrawn.
Sets the starting and ending positions for the current selection in a slider control.
void SetSelection(
int nMin,
int nMax);
nMin
Starting position for the slider.
nMax
Ending position for the slider.
Sets the length of the slider in the current trackbar control.
void SetThumbLength(int nLength);
| Parameter | Description |
|---|---|
[in] nLength |
Length of the slider, in pixels. |
This method requires that the trackbar control be set to TBS_FIXEDLENGTH style.
This method sends the TBM_SETTHUMBLENGTH message, which is described in the Windows SDK.
The following code example defines the variable, m_sliderCtrl, that is used to access the current trackbar control. The example also defines a variable, thumbLength, that is used to store the default length of the trackbar control's thumb component. These variables are used in the next example.
[!code-cppNVC_MFC_CSliderCtrl_s1#1]
The following code example sets the trackbar control's thumb component to twice its default length.
[!code-cppNVC_MFC_CSliderCtrl_s1#2]
Sets the position of a tick mark in a slider control.
BOOL SetTic(int nTic);
nTic
Position of the tick mark. This parameter must specify a positive value.
Nonzero if the tick mark is set; otherwise 0.
Sets the frequency with which tick marks are displayed in a slider.
void SetTicFreq(int nFreq);
nFreq
Frequency of the tick marks.
For example, if the frequency is set to 2, a tick mark is displayed for every other increment in the slider's range. The default setting for the frequency is 1 (that is, every increment in the range is associated with a tick mark).
You must create the control with the TBS_AUTOTICKS style to use this function. For more information, see CSliderCtrl::Create.
Positions a tooltip control used by a trackbar control.
int SetTipSide(int nLocation);
nLocation
Value representing the location at which to display the tooltip control. For a list of possible values, see the Win32 message TBM_SETTIPSIDE, as described in the Windows SDK.
A value that represents the tooltip control's previous location. The return value equals one of the possible values for nLocation.
This member function implements the behavior of the Win32 message TBM_SETTIPSIDE, as described in the Windows SDK. Slider controls that use the TBS_TOOLTIPS style display tooltips. For a description of the slider control styles, see Trackbar Control Styles in the Windows SDK.
Assigns a tooltip control to a slider control.
void SetToolTips(CToolTipCtrl* pWndTip);
pWndTip
A pointer to a CToolTipCtrl object containing the tooltips to use with the slider control.
This member function implements the behavior of the Win32 message TBM_SETTOOLTIPS, as described in the Windows SDK. When a slider control is created with the TBS_TOOLTIPS style, it creates a default tooltip control that appears next to the slider, displaying the slider's current position. For a description of the slider control styles, see Trackbar Control Styles in the Windows SDK.
MFC Sample CMNCTRL2
CWnd Class
Hierarchy Chart
CProgressCtrl Class