滑块控件成员函数

应用程序可以调用滑块控件的成员函数,以检索有关滑块控件 (CSliderCtrl) 的信息并更改其特征。

若要检索滑块的位置(即用户选择的值),请使用 GetPos 成员函数。 若要设置滑块的位置,请使用 SetPos 成员函数。 随时可以使用 VerifyPos 成员函数确保滑块介于最小值与最大值之间。

滑块控件的范围是滑块控件可以表示的连续值的集。 大多数应用程序使用 SetRange 成员函数在首次创建滑块控件时设置其范围。 应用程序可以使用 SetRangeMaxSetRangeMin 成员函数在创建滑块控件后动态更改范围。 允许动态更改范围的应用程序通常会在用户完成滑块控件处理时检索最终范围设置。 若要检索这些设置,请使用 GetRangeGetRangeMaxGetRangeMin 成员函数。

应用程序可以使用 TBS_AUTOTICKS 样式自动显示滑块控件的刻度线。 但是,如果应用程序需要控制刻度线的位置或频率,则可以使用多个成员函数。

若要设置刻度线的位置,应用程序可以使用 SetTic 成员函数。 SetTicFreq 成员函数允许应用程序设置在滑块控件范围内定期显示的刻度线。 例如,应用程序可以使用此成员函数在 1 到 100 范围内仅显示 10 个刻度线。

若要检索范围中与刻度线对应的索引,请使用 GetTic 成员函数。 GetTicArray 成员函数检索这些索引的数组。 若要检索刻度线的位置(采用客户端坐标),请使用 GetTicPos 成员函数。 应用程序可以使用 GetNumTics 成员函数检索刻度线数量。

ClearTics 成员函数移除滑块控件的所有刻度线。

滑块控件的行大小确定当应用程序收到 TB_LINEDOWN 或 TB_LINEUP 通知消息时滑块移动的距离。 同样,页面大小确定对 TB_PAGEDOWN 和 TB_PAGEUP 通知消息的响应。 应用程序可以使用 GetLineSizeSetLineSizeGetPageSizeSetPageSize 成员函数检索和设置行和页面大小值。

应用程序可以使用成员函数检索滑块控件的尺寸。 GetThumbRect 成员函数检索滑块的边框。 GetChannelRect 成员函数检索滑块控件通道的边框。 (通道是滑块移动的区域,其中包含选择范围时突出显示的区域。)

如果滑块控件具有 TBS_ENABLESELRANGE 样式,则用户可以从中选择一系列连续值。 许多成员函数允许动态调整选择范围。 SetSelection 成员函数设置所选内容的起始和结束位置。 当用户完成选择范围设置后,应用程序可以使用 GetSelection 成员函数检索设置。 若要清除用户的选择,请使用 ClearSel 成员函数。

另请参阅

使用 CSliderCtrl
Controls