# win.ui.ctrl.trackbar 库模块帮助文档

## win.ui.ctrl 成员列表 <a id="win.ui.ctrl" href="#win.ui.ctrl">&#x23;</a>

### win.ui.ctrl.trackbar() <a id="win.ui.ctrl.trackbar" href="#win.ui.ctrl.trackbar">&#x23;</a>
跟踪条控件  
XP 系统不支持透明背景，之后的系统都支持  

[返回对象:trackbarObject](#trackbarObject)

## trackbarObject 成员列表 <a id="trackbarObject" href="#trackbarObject">&#x23;</a>

### trackbarObject._parentForm <a id="trackbarObject._parentForm" href="#trackbarObject._parentForm">&#x23;</a>
返回创建控件的容器窗口（win.form对象），所有窗口控件都拥有此只读属性。  
对于使用窗体设计器创建的窗口，也就是返回设计时窗体容器。  

即使子窗口移除子窗口样式、更改父子关系，或以 orphanWindow显示，  
控件的 _parentForm 始终都不会改变  

[返回对象:winform](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/_.html#winform)

### trackbarObject.bottom <a id="trackbarObject.bottom" href="#trackbarObject.bottom">&#x23;</a>
底部坐标

### trackbarObject.capture <a id="trackbarObject.capture" href="#trackbarObject.capture">&#x23;</a>
是否捕获全局鼠标消息

### trackbarObject.className <a id="trackbarObject.className" href="#trackbarObject.className">&#x23;</a>
运行时类名

### trackbarObject.close() <a id="trackbarObject.close" href="#trackbarObject.close">&#x23;</a>
关闭控件窗

### trackbarObject.cls <a id="trackbarObject.cls" href="#trackbarObject.cls">&#x23;</a>
设计时类名

### trackbarObject.disabled <a id="trackbarObject.disabled" href="#trackbarObject.disabled">&#x23;</a>
是否禁用

### trackbarObject.getClientRect() <a id="trackbarObject.getClientRect" href="#trackbarObject.getClientRect">&#x23;</a>
控件客户区块位置(::RECT结构体)  

[返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject)

### trackbarObject.getFont() <a id="trackbarObject.getFont" href="#trackbarObject.getFont">&#x23;</a>
控件字体(::LOGFONT结构体)  

[返回对象:logfontObject](#logfontObject)

### trackbarObject.getNotifyCustomDraw() <a id="trackbarObject.getNotifyCustomDraw" href="#trackbarObject.getNotifyCustomDraw">&#x23;</a>
[返回对象:NMCUSTOMDRAWObject](#NMCUSTOMDRAWObject)

### trackbarObject.getNotifyCustomDraw(code,ptr) <a id="trackbarObject.getNotifyCustomDraw" href="#trackbarObject.getNotifyCustomDraw">&#x23;</a>
NM_CUSTOMDRAW通知消息返回NMLVCUSTOMDRAW结构体

### trackbarObject.getParent() <a id="trackbarObject.getParent" href="#trackbarObject.getParent">&#x23;</a>
返回父窗口  

[返回对象:staticObject](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/ctrl/static.html#staticObject)

### trackbarObject.getPos() <a id="trackbarObject.getPos" href="#trackbarObject.getPos">&#x23;</a>
返回相对坐标,宽,高  
x,y,cx,cy=win.getPos(hwnd)

### trackbarObject.getRect() <a id="trackbarObject.getRect" href="#trackbarObject.getRect">&#x23;</a>
控件区块位置(::RECT结构体)

### trackbarObject.getRect(true) <a id="trackbarObject.getRect" href="#trackbarObject.getRect">&#x23;</a>
控件屏幕区块位置(::RECT结构体)

### trackbarObject.height <a id="trackbarObject.height" href="#trackbarObject.height">&#x23;</a>
高度

### trackbarObject.hwnd <a id="trackbarObject.hwnd" href="#trackbarObject.hwnd">&#x23;</a>
控件句柄

### trackbarObject.id <a id="trackbarObject.id" href="#trackbarObject.id">&#x23;</a>
控件ID

### trackbarObject.invalidate(/*可选使用::RECT()对象指定客户区*/) <a id="trackbarObject.invalidate(/*可选使用::RECT" href="#trackbarObject.invalidate(/*可选使用::RECT">&#x23;</a>
使窗口绘图区无效

### trackbarObject.invalidate(/*可选使用::RECT()对象指定客户区*/,0) <a id="trackbarObject.invalidate(/*可选使用::RECT" href="#trackbarObject.invalidate(/*可选使用::RECT">&#x23;</a>
使窗口绘图区无效  
不刷新背景

### trackbarObject.left <a id="trackbarObject.left" href="#trackbarObject.left">&#x23;</a>
左侧坐标

### trackbarObject.max <a id="trackbarObject.max" href="#trackbarObject.max">&#x23;</a>
最大值,注意不能大于0xFFFF,不要使用负数

### trackbarObject.min <a id="trackbarObject.min" href="#trackbarObject.min">&#x23;</a>
最小值,注意不能大于0xFFFF,不要使用负数

### trackbarObject.modifyStyle(remove,add,swpFlags) <a id="trackbarObject.modifyStyle" href="#trackbarObject.modifyStyle">&#x23;</a>
修改窗口样式,所有参数都是可选参数,  
@remove 用数值指定要移除的样式,可使用 _WS_ 前缀的常量  
@add 用数值指定要添加的样式,可使用 _WS_ 前缀的常量  
@swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量  
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos  
细节请参考 win.modifyStyle 函数源码

### trackbarObject.modifyStyleEx(remove,add,swpFlags) <a id="trackbarObject.modifyStyleEx" href="#trackbarObject.modifyStyleEx">&#x23;</a>
修改窗口扩展样式,所有参数都是可选参数,  
@remove 用数值指定要移除的样式,可使用 _WS_EX_ 前缀的常量  
@add 用数值指定要添加的样式,可使用 _WS_EX_ 前缀的常量  
@swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量  
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos  
细节请参考 win.modifyStyle 函数源码

### trackbarObject.pos <a id="trackbarObject.pos" href="#trackbarObject.pos">&#x23;</a>
滑块当前刻度,注意不能大于 0xFFFF,不要使用负数

### trackbarObject.postMessage(msg,wParam,lParam) <a id="trackbarObject.postMessage" href="#trackbarObject.postMessage">&#x23;</a>
投递窗口消息到消息队列中  
此函数用法请参考 ::User32.PostMessage

### trackbarObject.redraw() <a id="trackbarObject.redraw" href="#trackbarObject.redraw">&#x23;</a>
刷新

### trackbarObject.right <a id="trackbarObject.right" href="#trackbarObject.right">&#x23;</a>
右侧坐标

### trackbarObject.sendMessage(msg,wParam,lParam) <a id="trackbarObject.sendMessage" href="#trackbarObject.sendMessage">&#x23;</a>
发送窗口消息  
此函数用法请参考 ::User32.SendMessage

### trackbarObject.setFocus() <a id="trackbarObject.setFocus" href="#trackbarObject.setFocus">&#x23;</a>
设置焦点

### trackbarObject.setFont(指定字体) <a id="trackbarObject.setFont" href="#trackbarObject.setFont">&#x23;</a>
指定LOGFONT字体对象,或逻辑字体句柄

### trackbarObject.setFont(混入字体属性) <a id="trackbarObject.setFont" href="#trackbarObject.setFont">&#x23;</a>

```aardio
trackbarObject.setFont(point=10;name="宋体");
```

### trackbarObject.setFrequency(2) <a id="trackbarObject.setFrequency" href="#trackbarObject.setFrequency">&#x23;</a>
刻度标记间隔  
必须在样式中指定自动刻度标记

### trackbarObject.setParent(控件对象) <a id="trackbarObject.setParent" href="#trackbarObject.setParent">&#x23;</a>
改变父窗口

### trackbarObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) <a id="trackbarObject.setPos" href="#trackbarObject.setPos">&#x23;</a>
调整窗口位置或排序,所有参数可选  
同时指定x,y坐标则移动位置  
同时指定宽高则改变大小  
指定插入位置(句柄或_HWND前缀常量)则调整Z序

### trackbarObject.setRange(最小刻度,最大刻度) <a id="trackbarObject.setRange" href="#trackbarObject.setRange">&#x23;</a>
设置最大最小刻度,注意不能大于0xFFFF,不要使用负数

### trackbarObject.setRect(rc) <a id="trackbarObject.setRect" href="#trackbarObject.setRect">&#x23;</a>
设置控件区块位置(::RECT结构体)

### trackbarObject.setRect(rc,true) <a id="trackbarObject.setRect" href="#trackbarObject.setRect">&#x23;</a>
设置控件屏幕区块位置(::RECT结构体)

### trackbarObject.setSel(起始刻度,结束刻度) <a id="trackbarObject.setSel" href="#trackbarObject.setSel">&#x23;</a>
设置选区

### trackbarObject.setTick(刻度) <a id="trackbarObject.setTick" href="#trackbarObject.setTick">&#x23;</a>
显示设置刻度标记位置

### trackbarObject.show(true) <a id="trackbarObject.show" href="#trackbarObject.show">&#x23;</a>
显示控件

### trackbarObject.theme <a id="trackbarObject.theme" href="#trackbarObject.theme">&#x23;</a>
外观主题,例如  
winform.button.theme = "Explorer"  
winform.button.theme = false

### trackbarObject.threadCallable() <a id="trackbarObject.threadCallable" href="#trackbarObject.threadCallable">&#x23;</a>
开启此控件的跨线程调用功能

### trackbarObject.tooltip <a id="trackbarObject.tooltip" href="#trackbarObject.tooltip">&#x23;</a>
提示文本,只写属性,  
值如果不是指针会自动调用 tostring 函数转为字符串,  
可用于在 oncommand 事件中修改提示文本

### trackbarObject.top <a id="trackbarObject.top" href="#trackbarObject.top">&#x23;</a>
顶部坐标

### trackbarObject.update() <a id="trackbarObject.update" href="#trackbarObject.update">&#x23;</a>
重绘invalidate函数指定的区块

### trackbarObject.value <a id="trackbarObject.value" href="#trackbarObject.value">&#x23;</a>
滑块当前刻度,注意不能大于 0xFFFF,不要使用负数

### trackbarObject.visible <a id="trackbarObject.visible" href="#trackbarObject.visible">&#x23;</a>
当前控件窗口是否显示。  
仅检查当前窗口的可见性样式（窗口 是否具有 _WS_VISIBLE 样式）。  
不考虑父窗口是否可见，不考虑是否被其他窗口遮挡。  
如果需要同时判断父窗口的可见性，应改用 win.isVisible 函数。

### trackbarObject.width <a id="trackbarObject.width" href="#trackbarObject.width">&#x23;</a>
宽度

## NMCUSTOMDRAWObject 成员列表 <a id="NMCUSTOMDRAWObject" href="#NMCUSTOMDRAWObject">&#x23;</a>

### NMCUSTOMDRAWObject.dwDrawStage <a id="NMCUSTOMDRAWObject.dwDrawStage" href="#NMCUSTOMDRAWObject.dwDrawStage">&#x23;</a>
绘图状态

### NMCUSTOMDRAWObject.dwItemSpec <a id="NMCUSTOMDRAWObject.dwItemSpec" href="#NMCUSTOMDRAWObject.dwItemSpec">&#x23;</a>
行序号

### NMCUSTOMDRAWObject.hdc <a id="NMCUSTOMDRAWObject.hdc" href="#NMCUSTOMDRAWObject.hdc">&#x23;</a>
设置句柄

### NMCUSTOMDRAWObject.hdr <a id="NMCUSTOMDRAWObject.hdr" href="#NMCUSTOMDRAWObject.hdr">&#x23;</a>
[返回对象:nmhdrObject](#nmhdrObject)

### NMCUSTOMDRAWObject.lItemlParam <a id="NMCUSTOMDRAWObject.lItemlParam" href="#NMCUSTOMDRAWObject.lItemlParam">&#x23;</a>
自定义数据，LPARAM 参数

### NMCUSTOMDRAWObject.rc <a id="NMCUSTOMDRAWObject.rc" href="#NMCUSTOMDRAWObject.rc">&#x23;</a>
[返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject)

### NMCUSTOMDRAWObject.uItemState <a id="NMCUSTOMDRAWObject.uItemState" href="#NMCUSTOMDRAWObject.uItemState">&#x23;</a>
状态值，例如 _CDIS_FOCUS

### NMCUSTOMDRAWObject.update() <a id="NMCUSTOMDRAWObject.update" href="#NMCUSTOMDRAWObject.update">&#x23;</a>
更新数据

### 自动完成常量
_CCM_GETUNICODEFORMAT=0x2006  
_CCM_SETUNICODEFORMAT=0x2005  
_TBM_CLEARSEL=0x413  
_TBM_CLEARTICS=0x409  
_TBM_GETBUDDY=0x421  
_TBM_GETCHANNELRECT=0x41A  
_TBM_GETLINESIZE=0x418  
_TBM_GETNUMTICS=0x410  
_TBM_GETPAGESIZE=0x416  
_TBM_GETPOS=0x400  
_TBM_GETPTICS=0x40E  
_TBM_GETRANGEMAX=0x402  
_TBM_GETRANGEMIN=0x401  
_TBM_GETSELEND=0x412  
_TBM_GETSELSTART=0x411  
_TBM_GETTHUMBLENGTH=0x41C  
_TBM_GETTHUMBRECT=0x419  
_TBM_GETTIC=0x403  
_TBM_GETTICPOS=0x40F  
_TBM_GETTOOLTIPS=0x41E  
_TBM_GETUNICODEFORMAT=0x2006  
_TBM_SETBUDDY=0x420  
_TBM_SETLINESIZE=0x417  
_TBM_SETPAGESIZE=0x415  
_TBM_SETPOS=0x405  
_TBM_SETPOSNOTIFY=0x422  
_TBM_SETRANGE=0x406  
_TBM_SETRANGEMAX=0x408  
_TBM_SETRANGEMIN=0x407  
_TBM_SETSEL=0x40A  
_TBM_SETSELEND=0x40C  
_TBM_SETSELSTART=0x40B  
_TBM_SETTHUMBLENGTH=0x41B  
_TBM_SETTIC=0x404  
_TBM_SETTICFREQ=0x414  
_TBM_SETTIPSIDE=0x41F  
_TBM_SETTOOLTIPS=0x41D  
_TBM_SETUNICODEFORMAT=0x2005  
_TBS_AUTOTICKS=0x1  
_TBS_BOTH=0x8  
_TBS_BOTTOM=0x0  
_TBS_DOWNISLEFT=0x400  
_TBS_ENABLESELRANGE=0x20  
_TBS_FIXEDLENGTH=0x40  
_TBS_HORZ=0x0  
_TBS_LEFT=0x4  
_TBS_NOTHUMB=0x80  
_TBS_NOTICKS=0x10  
_TBS_NOTIFYBEFOREMOVE=0x800  
_TBS_REVERSED=0x200  
_TBS_RIGHT=0x0  
_TBS_TOOLTIPS=0x100  
_TBS_TOP=0x4  
_TBS_TRANSPARENTBKGND=0x1000  
_TBS_VERT=0x2  
_TB_BOTTOM=0x7  
_TB_ENDTRACK=0x8  
_TB_LINEDOWN=0x1  
_TB_LINEUP=0x0  
_TB_PAGEDOWN=0x3  
_TB_PAGEUP=0x2  
_TB_THUMBPOSITION=0x4  
_TB_THUMBTRACK=0x5  
_TB_TOP=0x6  
