# win.ui.ctrl.scrollbar 库模块帮助文档 ## win.ui.ctrl 成员列表 # ### win.ui.ctrl.scrollbar() # 滚动条控件 [返回对象:scrollbarObject](#scrollbarObject) ## scrollbarObject 成员列表 # ### scrollbarObject._parentForm # 返回创建控件的容器窗口（win.form对象），所有窗口控件都拥有此只读属性。对于使用窗体设计器创建的窗口，也就是返回设计时窗体容器。即使子窗口移除子窗口样式、更改父子关系，或以 orphanWindow显示，控件的 _parentForm 始终都不会改变 [返回对象:winform](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/_.html#winform) ### scrollbarObject.adjust # ```aardio scrollbarObject.adjust = function( cx,cy,wParam ) { _/*窗口改变大小时触发此函数*/ }; ``` ### scrollbarObject.adjustWindow() # 仅绑定窗口的滚动条此函数有效,\窗口调整大小时必须使用此函数重新滚动窗口到滚动条当前位置 ### scrollbarObject.bottom # 底部坐标 ### scrollbarObject.capture # 是否捕获全局鼠标消息 ### scrollbarObject.className # 运行时类名 ### scrollbarObject.close() # 关闭控件窗口 ### scrollbarObject.cls # 设计时类名 ### scrollbarObject.disabled # 是否禁用 ### scrollbarObject.enable( _ESB_ ) # 激活一个或两个滚动条箭头或是使其失效 ### scrollbarObject.getClientRect() # 控件客户区块位置(::RECT结构体) [返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject) ### scrollbarObject.getFont() # 控件字体(::LOGFONT结构体) [返回对象:logfontObject](#logfontObject) ### scrollbarObject.getInfo() # 返回滚动条信息 ### scrollbarObject.getParent() # 返回父窗口 [返回对象:scrollbarObject](#scrollbarObject) ### scrollbarObject.getPos() # 返回相对坐标,宽,高 x,y,cx,cy=win.getPos(hwnd) ### scrollbarObject.getRange() # 返回 4 个数值分别为 min,max,page,current, min 为滚动条范围最小值, max 为滚动条范围最大值, page为分页大小, current 为滚动条当前位置 ### scrollbarObject.getRect() # 控件区块位置(::RECT结构体) ### scrollbarObject.getRect(true) # 控件屏幕区块位置(::RECT结构体) ### scrollbarObject.height # 高度 ### scrollbarObject.hwnd # 控件句柄 ### scrollbarObject.id # 控件ID ### scrollbarObject.invalidate(/*可选使用::RECT()对象指定客户区*/) # 使窗口绘图区无效 ### scrollbarObject.invalidate(/*可选使用::RECT()对象指定客户区*/,0) # 使窗口绘图区无效不刷新背景 ### scrollbarObject.left # 左侧坐标 ### scrollbarObject.line # 行高 ### scrollbarObject.modifyStyle(remove,add,swpFlags) # 修改窗口样式,所有参数都是可选参数, @remove 用数值指定要移除的样式,可使用 _WS_ 前缀的常量 @add 用数值指定要添加的样式,可使用 _WS_ 前缀的常量 @swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos 细节请参考 win.modifyStyle 函数源码 ### scrollbarObject.modifyStyleEx(remove,add,swpFlags) # 修改窗口扩展样式,所有参数都是可选参数, @remove 用数值指定要移除的样式,可使用 _WS_EX_ 前缀的常量 @add 用数值指定要添加的样式,可使用 _WS_EX_ 前缀的常量 @swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos 细节请参考 win.modifyStyle 函数源码 ### scrollbarObject.pos # 获取或设置滚动按钮的当前位置如果赋值为负数、可禁止窗口重绘 ### scrollbarObject.postMessage(msg,wParam,lParam) # 投递窗口消息到消息队列中此函数用法请参考 ::User32.PostMessage ### scrollbarObject.redraw() # 刷新 ### scrollbarObject.right # 右侧坐标 ### scrollbarObject.scrollMessage # 滚动条消息ID 水平滚动条为 _WM_HSCROLL, 垂直滚动条为 _WM_HSCROLL ### scrollbarObject.scrollWindowTo(pos,rect,clipRect) # 仅绑定窗口的滚动条此函数有效, @pos 参数指定滚动条绝对位置, 可选用 @rect 传入 ::RECT 结构体指定滚动区块,, 可选用 @clipRect 传入 ::RECT 结构体指定剪切区块 ### scrollbarObject.sendMessage(msg,wParam,lParam) # 发送窗口消息此函数用法请参考 ::User32.SendMessage ### scrollbarObject.setFocus() # 设置焦点 ### scrollbarObject.setFont(指定字体) # 指定LOGFONT字体对象,或逻辑字体句柄 ### scrollbarObject.setFont(混入字体属性) # ```aardio scrollbarObject.setFont(point=10;name="宋体"); ``` ### scrollbarObject.setInfo() # ```aardio scrollbarObject.setInfo( fMask = fMask; min = min; max = max; page = page; pos = pos; trackPos = trackPos; ) ``` ### scrollbarObject.setParent(控件对象) # 改变父窗口 ### scrollbarObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) # 调整窗口位置或排序,所有参数可选同时指定x,y坐标则移动位置同时指定宽高则改变大小指定插入位置(句柄或_HWND前缀常量)则调整Z序 ### scrollbarObject.setRange # 设置滚动条范围 ### scrollbarObject.setRange(min,max,page,redraw) # 设置滚动条范围，参数： @min 为滚动条范围最小值, @max 为滚动条范围最大值, @page为分页大小, @redraw 是否刷新。 ### scrollbarObject.setRect(rc) # 设置控件区块位置(::RECT结构体) ### scrollbarObject.setRect(rc,true) # 设置控件屏幕区块位置(::RECT结构体) ### scrollbarObject.show(true) # 显示控件 ### scrollbarObject.theme # 外观主题,例如 winform.button.theme = "Explorer" winform.button.theme = false ### scrollbarObject.top # 顶部坐标 ### scrollbarObject.update() # 重绘invalidate函数指定的区块 ### scrollbarObject.updateWheelLines() # 返回系统设置的鼠标滚轮滚动行数, 并更新 wheelLines 的值 ### scrollbarObject.visible # 当前控件窗口是否显示。仅检查当前窗口的可见性样式（窗口是否具有 _WS_VISIBLE 样式）。不考虑父窗口是否可见，不考虑是否被其他窗口遮挡。如果需要同时判断父窗口的可见性，应改用 win.isVisible 函数。 ### scrollbarObject.wheelLines # 鼠标滚轮滚动行数,默认值为 3 调用 updateWheelLines 函数可获取系统设置并更新该值 ### scrollbarObject.width # 宽度 ### 自动完成常量 _SIF_ALL=0x17 _SIF_DISABLENOSCROLL=0x8 _SIF_PAGE=0x2 _SIF_POS=0x4 _SIF_RANGE=0x1 _SIF_TRACKPOS=0x10