C S liderCtrl

一 个 “ 滑 动 块 控 件 ” （ 也 称 为 一 个 跟 踪 器 ） 是 一 个 包 含 一 个 滑 动 块 和 可 选 的 刻度 线 的 窗 口 。 当 用 户 用 鼠 标 或 方 向 键 移 动 滑 动 块 时 ， 该 控 件 发 送 通 知 消 息 来 表

明 这 些 改 变 。

当 你 想 要 用 户 选 择 不 连 续 的 值 或 是 某 一 范 围 内 的 连 续 值 的 集 合 时 ， 滑 动 块 控 件是 很 有 用 的 。 例 如 ， 你 可 以 让 用 户 通 过 移 动 滑 动 块 到 一 个 给 定 的 刻 度 线 来 设 置键 盘 的 重 复 速 度 。

CSliderCtrl 类 提 供 了 W indows 通 用 滑 动 块 控 件 的 功 能 。 这 个 控 件 （ 也 就 是CSliderCtrl 类 ） 只 对 在 W indows95 和 W indows NT 3.51 或 更 高 版 本 下 运 行 的 程序 是 可 用 的 。

滑 动 块 按 你 在 创 建 它 时 指 定 的 增 量 来 移 动 。 例 如 ， 如 果 你 指 定 此 滑 动 块 的 范 围为 五 ， 则 滑 动 块 只 能 有 六 个 位 置 ： 在 滑 动 块 控 件 最 左 边 的 一 个 位 置 和 另 外 五 个在 此 范 围 内 每 隔 一 个 增 量 的 位 置 。 通 常 ， 这 些 位 置 的 每 一 个 由 一 个 刻 度 线 来 标识 。

通 过 使 用 CSliderCtrl 的 构 造 函 数 和 Create 成 员 函 数 来 创 建 一 个 滑 动 块 。 一 旦 你已 经 创 建 了 一 个 滑 动 块 控 件 ， 你 就 可 以 使 用 CSliderCtrl 中 的 成 员 函 数 来 改 变 它的 许 多 属 性 。 这 些 你 可 以 做 的 改 变 包 括 设 置 滑 动 块 的 最 小 和 最 大 位 置 ， 绘 制 刻度 线 ， 设 置 一 个 选 择 范 围 ， 以 及 响 应 该 滑 动 块 。

#include <afxcmn.h>

请 参 阅 CProgressCtrl

CSliderCtrl 类 成 员

Construction

CsliderCtrl 构 造 一 个 CSliderCtrl 对 象

Create 创 建 一 个 滑 动 块 控 件 并 将 它 与 一 个 CSliderCtrl 对象 连 接

Attribute s GetLineSize 获 取 一 个 滑 动 块 控 件 的 行 大 小

SetLineSize 设 置 一 个 滑 动 块 控 件 的 行 大 小

GetPageSize 获 取 一 个 滑 动 块 控 件 的 页 大 小

SetPageSize 设 置 一 个 滑 动 块 控 件 的 页 大 小GetRangeMax 获 取 一 个 滑 动 块 的 位 置 的 最 大 值GetRangeMin 获 取 一 个 滑 动 块 的 位 置 的 最 小 值

GetRange 获 取 一 个 滑 动 块 的 位 置 的 最 大 值 和 最 小 值

SetRangeMin 设 置 一 个 滑 动 块 的 位 置 的 最 小 值

SetRangeMax 设 置 一 个 滑 动 块 的 位 置 的 最 大 值

SetRange 设 置 一 个 滑 动 块 的 位 置 的 最 小 值 和 最 大 值

GetSelection 获 取 当 前 选 择 的 范 围

SetSelection 设 置 当 前 选 择 的 范 围GetChannelRect 获 取 滑 动 块 控 件 的 通 道 的 尺 寸GetThumbRect 获 取 滑 动 块 控 件 的 拇 指 的 尺 寸GetPos 获 取 滑 动 块 的 当 前 位 置

SetPos 设 置 滑 动 块 的 当 前 位 置

GetNumTics 获 取 一 个 滑 动 块 控 件 中 的 刻 度 线 的 数 目GetTicArray 获 取 一 个 滑 动 块 控 件 的 刻 度 线 位 置 的 数 组GetTic 获 取 指 定 刻 度 线 的 位 置

续 表

GetTicPos 获 取 指 定 刻 度 线 的 以 客 户 坐 标 表 示 的 位 置

SetTic 设 置 指 定 刻 度 线 的 位 置

SetTicFreq 设 置 对 每 一 个 滑 动 块 控 件 的 增 量 ， 刻 度 线 的 频 率

GetBuddy 在 一 个 指 定 位 置 获 取 一 个 滑 动 块 控 件 的 伙 伴 窗 口

句 柄

SetBuddy 为 一 个 滑 动 块 控 件 分 配 一 个 伙 伴 窗 口

GetToolTips 获 取 分 配 给 一 个 滑 动 块 控 件 的 工 具 提 示 （ 如 果 有 ）

句 柄

SetToolTips 将 一 个 工 具 提 示 赋 给 一 个 滑 动 块 控 件

SetTipSide 定 位 跟 踪 器 控 件 使 用 的 工 具 提 示

Operations

ClearSel 清 除 在 一 个 滑 动 块 控 件 中 的 当 前 位 置

VerifyPos 检 验 滑 动 块 控 件 的 位 置 是 否 在 最 小 值 和 最 大 值 之间

ClearTics 将 当 前 刻 度 线 从 滑 动 块 控 件 中 移 走

成 员 函 数

CSliderCtrl::ClearSel

void ClearSel( BOOL bRedraw = FALSE );

参 数

bRedraw

重 画 标 志 。 如 果 这 个 参 数 是 TRUE ， 则 在 选 择 被 清 除 后 重 画 滑 动 块 ； 否则 不 重 画 滑 动 块 。

说 明

此 成 员 函 数 用 来 清 除 滑 动 块 中 的 当 前 位 置 。

请 参 阅 CSliderCtrl::GetSelection, CSliderCtrl::SetSelection

CSliderCtrl::ClearTics

void ClearTics( BOOL bRedraw = FALSE );

参 数

bRedraw

重 画 标 志 。 如 果 这 个 参 数 是 TRUE ， 则 在 选 择 被 清 除 后 重 画 滑 动 块 ； 否则 不 重 画 滑 动 块 。

说 明

此 成 员 函 数 用 来 从 一 个 滑 动 块 控 件 中 删 除 当 前 的 刻 度 线 。

请 参 阅 CSliderCtrl::GetTicArray, CSliderCtrl::GetTic, CSliderCtrl::GetNumTics

CSliderCtrl::Create

BOOL Create( DWORD dwStyle , const RECT& rect , CWnd* pParentWnd , UINT

nID );

返 回 值

如 果 初 始 化 成 功 则 返 回 非 零 值 ； 否 则 返 回 0 。

参 数

dwStyle

指 定 滑 动 块 控 件 的 风 格 。 滑 动 块 控 件 风 格 的 任 意 组 合 都 适 用 于 这 个 控 件 。

rect

指 定 滑 动 块 控 件 的 大 小 和 位 置 。 它 可 以 是 一 个 CRect 对 象 或 一 个 RECT 结

构 。

pParentWnd

指 定 此 滑 动 块 控 件 的 父 窗 口 ， 通 常 是 一 个 CDialog。 它 必 须 不 是 NULL 。

nID

指 定 此 滑 动 块 控 件 的 ID 。

说 明

构 造 一 个 CSliderCtrl 控 件 可 以 分 两 步 。 首 先 是 调 用 构 造 函 数 ， 然 后 调 用 Create ， 该 函 数 创 建 滑 动 块 控 件 并 将 它 与 此 CSliderCtrl 对 象 连 接 。

滑 动 块 控 件 可 以 是 垂 直 或 水 平 方 向 的 。 它 们 可 以 在 任 何 一 边 或 两 边 具 有 刻 度线 ， 或 者 是 两 边 都 没 有 。 它 们 也 可 以 用 来 指 定 某 个 范 围 的 连 续 值 。 这 些 属 性 通过 使 用 滑 动 块 风 格 来 控 件 ， 这 些 风 格 是 在 你 创 建 此 滑 动 块 控 件 的 时 候 指 定 的 ：

• TBS_HORZ 滑 动 块 为 水 平 方 向 。 这 个 方 向 是 缺 省 方 向 。

• TBS_VERT 滑 动 块 为 垂 直 方 向 。 如 果 你 没 有 指 定 方 向 ，

  滑 动 块 被 认 为 是水 平 方 向 。

• TBS_AUTOTICKS 创 建 的 滑 动 块 在 其 取 值 范 围 内 对 每 一 个 增

  量 都 有 一 个

刻 度 线 。 当 应 用 程 序 调 用 SetRange 成 员 函 数 时 这 些 刻 度 线 被 自 动 添 加 。 如果 你 使 用 了 这 个 风 格 ， 你 就 不 能 再 使 用 SetTic 和 SetTicFreq 成 员 函 数 来 指定 刻 度 线 的 位 置 。 可 以 使 用 ClearTics 成 员 函 数 来 代 替 。

• TBS_NOTICKS 创 建 一 个 不 显 示 刻 度 线 的 滑 动 块 控 件 。

• TBS_BOTTOM 在 一 个 水 平 滑 动 块 的 底 部 显 示 刻 度 线 。 可 以

  与 TBS_TOP

  • 起 使 用 ， 表 示 在 滑 动 块 的 两 边 都 显 示 刻 度 线 。

• TBS_TOP 在 一 个 水 平 滑 动 块 的 顶 部 显 示 刻 度 线 。 可 以 与

  TBS_BOTTOM

  • 起 使 用 ， 表 示 在 滑 动 块 的 两 边 都 显 示 刻 度 线 。

• TBS_RIGHT 在 一 个 垂 直 滑 动 块 的 右 边 显 示 刻 度 线 。 可 以

  与 TBS_LEFT 一起 使 用 ， 表 示 在 滑 动 块 的 两 边 都 显 示 刻 度 线 。

• TBS_LEFT 在 一 个 垂 直 滑 动 块 的 左 边 显 示 刻 度 线 。 可 以

  与 TBS_RIGHT 一起 使 用 ， 表 示 在 滑 动 块 的 两 边 都 显 示 刻 度 线 。

• TBS_BOTH 在 任 意 方 向 的 滑 动 块 的 两 边 都 显 示 刻 度 线 。

• TBS_ENABLESELRANGE 显 示 一 个 选 择 范 围 。 当 一 个 滑 动 块 控

  件 使 用 了这 个 风 格 时 ， 在 选 择 范 围 的 开 始 和 结 束 位 置 的 刻 度 线 被 显 示 为 三 角 形 （ 而不 是 垂 直 的 破 折 号 ） ， 而 且 选 择 范 围 被 用 高 亮 色 显 示 。 例 如 ， 在 一 个 简 单的 日 程 安 排 应 用 程 序 中 ， 选 择 范 围 也 许 是 很 有 用 的 。 用 户 可 以 对 应 于 一 天的 小 时 选 择 一 个 刻 度 线 范 围 来 标 识 一 个 预 定 的 会 议 时 间 。

请 参 阅 CSliderCtrl::CSliderCtrl

CSliderCtrl::CSliderCtrl

CSliderCtrl( );

说 明

此 成 员 函 数 用 来 构 造 一 个 CSliderCtrl 对 象 。

请 参 阅 CSliderCtrl::Create

CSliderCtrl::GetBuddy

CWnd* GetBuddy( BOOL fLocation = TRUE ) const;

返 回 值

返 回 一 个 指 向 CWnd 对 象 的 指 针 ， 该 对 象 是 在 由 fLocation 指 定 的 位 置 的 一 个伙 伴 窗 口 。 如 果 在 那 个 位 置 不 存 在 伙 伴 窗 口 ， 则 返 回 NULL 。

参 数

fLocation

这 个 值 是 用 来 指 示 在 相 关 位 置 上 将 获 取 哪 一 个 伙 伴 窗 口 的 句 柄 。 它 可 以是 下 列 值 之 一 ：

• TRUE 获 取 在 滑 动 块 左 边 的 伙 伴 窗 口 的 句 柄 。 如 果 该 滑

  动 块 控 件 使 用了 TBS_VERT 风 格 ， 则 将 获 取 滑 动 块 上 面 的 伙 伴 窗 口 。

• FALSE 获 取 在 滑 动 块 右 边 的 伙 伴 窗 口 的 句 柄 。 如 果 该 滑

  动 块 控 件 使用了 TBS_VERT 风 格 ， 则 将 获 取 滑 动 块 下 面 的 伙 伴 窗 口 。

说 明

此 成 员 函 数 用 来 实 现 Win32 消 息 TBM_GETBUDDY 的 行 为 ， 就 象 在 “ Platform SDK ” 中 所 描 述 的 一 样 。

有 关 滑 动 块 控 件 风 格 的 描 述 ， 参 见 “ Platform SD K” 中 的 “ 跟 踪 器 控 件 风 格 ” 。

请 参 阅 CSliderCtrl::SetBuddy

void GetChannelRect( LPRECT lprc ) const;

参 数

lprc

一 个 指 向 CRect 对 象 的 指 针 ， 该 对 象 包 含 了 当 函 数 返 回 时 通 道 的 边 界 矩 形 。

说 明

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 控 件 的 通 道 的 边 界 矩 形 的 大 小 和 位 置 。 通 道 是这 样 一 个 区 域 ， 滑 动 块 在 它 上 面 移 动 ， 并 且 当 选 择 了 一 个 范 围 后 ， 它 用 高 亮 色显 示 。

请 参 阅 CSliderCtrl::GetThumbRect

int GetLineSize( ) const;

返 回 值

返 回 此 滑 动 块 控 件 的 一 行 的 大 小 。

说 明

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 控 件 的 行 的 大 小 。 这 个 行 的 大 小 表 明 对 于TB_LINEUP 和 TB_LINEDOWN 通 知 ， 滑 动 块 移 动 多 少 。 行 的 大 小 的 缺 省 设 置是 1 。

请 参 阅 CSliderCtrl::SetLineSize, CSliderCtrl::GetPageSize

UINT GetNumTics( ) const;

返 回 值

返 回 在 滑 动 块 中 的 刻 度 线 的 数 目 。

说 明

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 中 的 刻 度 线 。

请 参 阅 SliderCtrl::GetTicArray, CSliderCtrl::GetTic, CSliderCtrl::GetTicPos, CSliderCtrl::SetTicFreq, CSliderCtrl::ClearTics

CSliderCtrl::GetPageSize

int GetPageSize( ) const;

返 回 此 滑 动 块 控 件 的 一 页 的 大 小 。

说 明

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 控 件 中 的 一 页 的 大 小 。 页 的 大 小 表 明 在 响 应

TB_PAGEUP 和 TB_PAGEDOWN 通 知 时 滑 动 块 会 移 动 多 少 。

请 参 阅 CSliderCtrl::GetLineSize, CSliderCtrl::SetPageSize

CSliderCtrl::GetPos

int GetPos( ) const;

返 回 值

返 回 当 前 的 位 置 。

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 控 件 中 的 滑 动 块 的 当 前 位 置 。

请 参 阅 CSliderCtrl::SetPos, CSliderCtrl::GetTicPos

CSliderCtrl::GetRange

void GetRange( int& nMin , int& nMax ) const;

参 数

nMin

• 个 用 来 接 收 最 小 位 置 的 整 数 的 引 用 。

nMax

• 个 用 来 接 收 最 大 位 置 的 整 数 的 引 用 。

此 成 员 函 数 用 来 获 取 在 一 个 滑 动 块 控 件 中 的 滑 动 块 的 最 大 和 最 小 位 置 。 这 个 函数 将 值 拷 贝 到 由 nMin 和 nMax 引 用 的 整 数 中 。

请 参 阅 SliderCtrl::GetRangeMin, CSliderCtrl::GetRangeMax, CSliderCtrl::SetRange

CSliderCtrl::GetRangeMax

int GetRangeMax( ) const;

返 回 值

返 回 控 件 的 最 大 值 。

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 控 件 中 的 滑 动 块 的 最 大 位 置 。

请 参 阅 CSliderCtrl::GetRangeMin, CSliderCtrl::GetRange, CSliderCtrl::SetRange

CSliderCtrl::GetRangeMin int GetRangeMin( ) const; 返 回 值

返 回 控 件 的 最 小 位 置 。

说 明

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 控 件 中 的 滑 动 块 的 最 小 位 置 。

请 参 阅 CSliderCtrl::GetRange, CSliderCtrl::GetRangeMax, CSliderCtrl::SetRange

CSliderCtrl::GetSelection

void GetSelection( int& nMin , int& nMax ) const;

参 数

nMin

• 个 用 来 接 收 当 前 选 择 的 开 始 位 置 的 整 数 的 引 用 。

nMax

• 个 用 来 接 收 当 前 选 择 的 结 束 位 置 的 整 数 的 引 用 。

说 明

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 控 件 中 的 当 前 选 择 的 开 始 和 结 束 位 置 。

请 参 阅 CSliderCtrl::SetSelection, CSliderCtrl::ClearSel

void GetThumbRect( LPRECT lprc ) const;

参 数

lprc

一 个 指 向 CRect 对 象 的 指 针 ， 该 对 象 包 含 了 当 函 数 返 回 时 此 滑 动 块 的 边 界

矩 形 。

说 明

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 控 件 中 的 滑 动 块 （ 拇 指 ） 的 边 界 矩 形 的 大 小 和位 置 。

请 参 阅 CSliderCtrl::GetChannelRect

int GetTic( int nTic ) const;

返 回 值

返 回 指 定 刻 度 线 的 位 置 。 如 果 nTic 没 有 指 定 一 个 有 效 索 引 ， 则 返 回 -1 。

参 数

nTic

一 个 刻 度 线 的 从 零 开 始 的 索 引 。

说 明

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 控 件 中 的 刻 度 线 的 位 置 。

请 参 阅 CSliderCtrl::SetTic, CSliderCtrl::GetTicArray, CSliderCtrl::GetTicPos,

CSliderCtrl::SetTicFreq, CSliderCtrl::ClearTics

CSliderCtrl::GetTicArray DWORD* GetTicArray( ) const; 返 回 值

返 回 包 含 此 滑 动 块 控 件 的 刻 度 线 位 置 的 数 组 的 地 址 。

说 明

此 成 员 函 数 用 来 获 取 包 含 一 个 滑 动 块 控 件 的 刻 度 线 的 数 组 的 地 址 。

请 参 阅 CSliderCtrl::SetTic, CSliderCtrl::GetTic, CSliderCtrl::GetTicPos, CSliderCtrl::SetTicFreq, CSliderCtrl::ClearTics

CSliderCtrl::GetTicPos

int GetTicPos( int nTic ) const;

返 回 值

返 回 指 定 刻 度 线 的 用 客 户 坐 标 表 示 的 物 理 位 置 。 如 果 nTic 没 有 指 定 一 个 有 效 的索 引 则 返 回 -1 。

参 数

nTic

一 个 刻 度 线 的 从 零 开 始 的 索 引 。

说 明

此 成 员 函 数 用 来 获 取 一 个 滑 动 块 控 件 中 的 一 个 刻 度 线 的 当 前 物 理 位 置 。

请 参 阅 CSliderCtrl::SetTic, CSliderCtrl::GetTic, CSliderCtrl::SetTicFreq, CSliderCtrl::ClearTics

CSliderCtrl::GetToolTips CToolTipCtrl* GetToolTips( ) const; 返 回 值

返 回 一 个 指 向 CToolTipCtrl 对 象 的 指 针 。 如 果 没 有 使 用 工 具 提 示 则 返 回 NULL 。如 果 此 滑 动 块 控 件 没 有 使 用 TBS_TOOLTIPS 风 格 ， 则 返 回 值 是 NULL 。

说 明

此 成 员 函 数 用 来 实 现 Win32 消 息 TBM_GETTOOLTIPS 的 行 为 ，就 象 在“ Platform SDK ” 中 描 述 的 那 样 。

注 意 这 个 成 员 函 数 返 回 一 个 CToolTipCtrl 对 象 。 而 不 是 一 个 控 件 句 柄 。

有 关 滑 动 块 控 件 风 格 的 描 述 ， 参 见 “ Platform SD K” 中 的 “ 跟 踪 器 风 格 ” 。

请 参 阅 CSliderCtrl::SetToolTips

CSliderCtrl::SetBuddy

CWnd* SetBuddy ( CWnd* pWndBuddy , BOOL fLocation = TRUE );

返 回 值

返 回 一 个 指 向 CWnd 对 象 的 指 针 ， 该 对 象 是 先 前 在 那 个 位 置 上 分 配 给 此 滑 动 块控 件 的 。

参 数

pWndBuddy

• 个 指 向 CWnd 对 象 的 指 针 ， 该 对 象 将 被 设 置 为 滑 动 块 控

  件 的 伙 伴 。

fLocation

是 用 来 指 定 显 示 伙 伴 窗 口 的 位 置 的 值 。 这 个 值 可 以 是 下 列 值 之 一 ：

• TRUE 如 果 滑 动 块 控 件 使 用 TBS-HORZ 风 格 ， 则 伙 伴 将 显 示

  在 滑 动 块的 左 边 。 如 果 滑 动 块 控 件 使 用 TBS-VERT 风 格 ， 伙 伴 就 出 现 在 滑 动 块控 件 的 上 方 。

• FALSE 如 果 滑 动 块 控 件 使 用 TBS-HORZ 风 格 ， 则 伙 伴 就 出 现

  在 滑 动块 的 右 边 。 如 果 滑 动 块 控 件 使 用 TBS-VERT 风 格 ， 伙 伴 就 出 现 在 滑 动块 控 件 的 下 方 。

说 明

此 成 员 函 数 用 来 实 现 Win32 消 息 TBM_SETBUDDY 的 行 为 ， 就 象 在 “ Platform

SDK ” 中 描 述 的 那 样 。

注 意 ， 这 个 成 员 函 数 在 它 的 返 回 值 和 参 数 中 都 使 用 了 指 向 CWnd 对 象 的 指 针 ， 而 不 是 窗 口 句 柄 。

有 关 滑 动 块 控 件 风 格 的 描 述 ， 参 见 “ Platform SD K” 中 的 “ 跟 踪 器 风 格 ” 。

请 参 阅 CSliderCtrl::GetBuddy

C SliderCtrl::SetLineSize int SetLineSize( int nSize ); 返 回 值

返 回 先 前 的 行 大 小 。

nSize

滑 动 块 控 件 的 新 的 行 大 小 。

说 明

此 成 员 函 数 用 来 设 置 一 个 滑 动 块 控 件 的 行 的 大 小 。 这 个 行 大 小 表 示 在 响 应

TB_LINEUP 和 TV_LINEDOWN 通 知 时 ， 滑 动 块 移 动 多 少 。

请 参 阅 CSliderCtrl::GetLineSize, CSliderCtrl::SetPageSize

CSliderCtrl::SetPageSize

int SetPageSize( int nSize );

返 回 先 前 的 页 大 小 。

参 数

nSize

滑 动 块 控 件 的 新 的 页 大 小 。

说 明

此 成 员 函 数 用 来 设 置 一 个 滑 动 块 控 件 的 页 的 大 小 。 这 个 页 大 小 表 示 在 响 应

TB_PAGEUP 和 TB_PAGEDOWN 通 知 时 ， 滑 动 块 移 动 多 少 。

请 参 阅 CSliderCtrl::GetPageSize, CSliderCtrl::GetLineSize

CSliderCtrl::SetPos void SetPos( int nPos ); 参 数

nPos

指 定 新 的 滑 动 块 位 置 。

说 明

此 成 员 函 数 用 来 设 置 一 个 滑 动 块 控 件 中 的 滑 动 块 的 当 前 位 置 。

请 参 阅 CSliderCtrl::GetPos, CSliderCtrl::SetTic, CSliderCtrl::VerifyPos

CSliderCtrl::SetRange

void SetRange( int nMin , int nMax , BOOL bRedraw = FALSE );

参 数

bMin

滑 动 块 的 最 小 位 置 。

nMax

滑 动 块 的 最 大 位 置 。

bRedraw

重 画 标 志 。 如 果 这 个 参 数 是 TRUE ， 则 在 范 围 被 重 新 设 置 之 后 滑 动 块 被重 画 ； 否 则 不 重 画 滑 动 块 。

说 明

此 成 员 函 数 用 来 设 置 一 个 滑 动 块 控 件 的 滑 动 块 的 范 围 （ 位 置 的 最 小 值 和 最 大值 ） 。

请 参 阅 CSliderCtrl::GetRange, CSliderCtrl::SetRangeMax,

CSliderCtrl::SetRangeMin

CSliderCtrl::SetRangeMax

void SetRangeMax( int nMax , BOOL bRedraw = FALSE );

参 数

nMax

滑 动 块 的 最 大 位 置 。

bRedraw

重 画 标 志 。 如 果 这 个 参 数 是 TRUE ， 则 在 范 围 被 设 置 之 后 ， 重 画 滑 动 块 ； 否 则 不 重 画 滑 动 块 。

说 明

此 成 员 函 数 用 来 设 置 一 个 滑 动 块 控 件 中 的 滑 动 块 的 最 大 位 置 。

请 参 阅 CSliderCtrl::SetRange, CSliderCtrl::GetRangeMax, CSliderCtrl::SetRangeMin

CSliderCtrl::SetRangeMin

void SetRangeMin( int nMin , BOOL bRedraw = FALSE );

参 数

nMin

滑 动 块 的 最 小 位 置 。

bRedraw

重 画 标 志 。 如 果 这 个 参 数 是 TRUE ， 则 在 范 围 被 设 置 之 后 ， 重 画 滑 动 块 ； 否 则 不 重 画 滑 动 块 。

此 成 员 函 数 用 来 设 置 一 个 滑 动 块 控 件 中 的 滑 动 块 的 最 大 位 置 。

请 参 阅 CSliderCtrl::SetRange, CSliderCtrl::GetRangeMin, CSliderCtrl::SetRangeMax

CSliderCtrl::SetSelection

void SetSelection( int nMin , int nMax );

参 数

nMin

滑 动 块 的 开 始 位 置 。

nMax

滑 动 块 的 结 束 位 置 。

此 成 员 函 数 用 来 设 置 一 个 滑 动 块 控 件 中 当 前 选 择 的 开 始 和 结 束 位 置 。

请 参 阅 CSliderCtrl::GetSelection, CSliderCtrl::ClearSel

CSliderCtrl::SetTic BOOL SetTic( int nTic ); 返 回 值

如 果 设 置 了 刻 度 线 则 返 回 非 零 值 ； 否 则 返 回 0 。

参 数

nTic

刻 度 线 的 位 置 。 这 个 参 数 必 须 指 定 一 个 正 值 。

此 成 员 函 数 用 来 设 置 一 个 滑 动 块 控 件 中 的 一 个 刻 度 线 的 位 置 。

请 参 阅 CSliderCtrl::GetTic, CSliderCtrl::GetTicArray, CSliderCtrl::GetTicPos, CSliderCtrl::SetTicFreq, CSliderCtrl::ClearTics

CSliderCtrl::SetTicFreq void SetTicFreq( int nFreq ); 参 数

nFreq

刻 度 线 的 频 率 。

此 成 员 函 数 用 来 设 置 显 示 在 一 个 滑 动 块 中 的 刻 度 线 的 的 频 率 。 例 如 ， 如 果 频 率被 设 置 为 2 ， 则 在 滑 动 块 的 范 围 中 每 两 个 增 量 显 示 一 个 刻 度 线 。 缺 省 的 频 率 设置 是 1 （ 即 ， 范 围 中 每 一 个 增 量 都 有 一 个 与 之 对 应 的 刻 度 线 ） 。

要 使 用 这 个 函 数 ， 你 必 须 创 建 具 有 TBS_AUTOTICKS 风 格 的 控 件 。 更 多 的 信息 ， 参 见 CSliderCtrl::Create 。

请 参 阅 CSliderCtrl::Create, CSliderCtrl::SetTic, CSliderCtrl::GetTicArray

CSliderCtrl::SetTipSide

int SetTipSide ( int nLocation );

返 回 一 个 代 表 工 具 提 示 控 件 的 先 前 位 置 的 值 。 这 个 返 回 值 等 于 nLocation 的 可能 取 值 之 一 。

参 数

nLocation

是 代 表 要 显 示 工 具 提 示 控 件 的 位 置 的 值 。 其 可 能 取 值 的 列 表 ， 参 见“ Platform SDK ” 中 所 描 述 的 Win32 消 息 TBM_SETTIPSIDE 。

说 明

此 成 员 函 数 用 来 实 现“ Platform SDK ”中 所 描 述 的 W in32 消 息 TBM_SETTIPSIDE

的 行 为 。

的 描 述 ， 参 见 “ Platform SDK ” 中 的 “ 跟 踪 器 控 件 风 格 ” 。

CSliderCtrl::SetToolTips

void SetToolTips( CToolTipCtrl* pWndTip );

参 数

pWndTip

是 一 个 指 向 CToolTipCtrl 对 象 的 指 针 ， 该 对 象 包 含 了 这 个 滑 动 块 控 件 的 工具 提 示 。

说 明

此 成 员 函 数 用 来 实 现 “ Platform SDK ” 中 所 描 述 的 W in32 消 息

TBM_SETOOLTIPS 的 行 为 。

的 显 示 在 滑 动 块 的 旁 边 的 工 具 提 示 控 件 ， 它 显 示 滑 动 块 的 当 前 位 置 。 有 关 滑 动块 控 件 风 格 的 描 述 ， 参 见 “ Platform SDK ” 中 的 “ 跟 踪 器 控 件 风 格 ” 。

请 参 阅 CSliderCtrl::GetToolTips

CSliderCtrl::VerifyPos

void VerifyPos( );

说 明

此 成 员 函 数 用 来 检 验 一 个 滑 动 块 控 件 中 的 滑 动 块 的 当 前 位 置 是 否 在 最 小 和 最 大值 之 间 。

请 参 阅 CSliderCtrl::GetRange, CSliderCtrl::SetPos, CSliderCtrl::GetTicPos