Futurebasic/语言/参考/滚动按钮
SCROLL BUTTON [#]idExpr ¬
[,[current][,[min][,[max][,[page][,[rect][,type]]]]]]
SCROLL BUTTON
语句在当前输出窗口中放置一个新的滚动条,或更改现有滚动条的特性。参数解释如下
"图像在此处"
- 选择一个
idExpr
值,使得ABS(idExpr)
与窗口中所有现有按钮和滚动条的 ID 不同。如果您使用负数idExpr
,并且窗口包含一个多样式非静态编辑字段,其 ID 号为ABS(idExpr)
,那么滚动条的动作将链接到该编辑字段(下面解释)。 - 为 current、min、max 和 page 选择初始值。所有这些参数都是可选的;任何被省略的参数都将具有以下默认初始值
current
= 0min
= 0max
= 255page
= 16
- 如果创建
_scrollOther
滚动条,请指定rect
参数。如果您创建的是_scrollVert
或_scrollHorz
滚动条,则此参数是可选的。 - 指定类型。此参数是可选的;它的默认值为
_scrollOther
。
- 将
idExpr
设置为窗口中现有滚动条的 ID 号。 - 如果您要更改任何 current、min、max 或 page 值,请指定相应的参数。任何被省略的参数都不会更改其值。
- 如果您要更改
_scrollOther
滚动条的矩形,请在 rect 参数中指定新的矩形。如果您省略此参数,矩形将不会更改。注意:当您更改_scrollVert
或_scrollHorz
滚动条时,rect 参数将被忽略。 - 您无法更改现有滚动条的类型。如果滚动条已经存在,则此参数将被忽略。
您可以使用 BUTTON
语句激活(突出显示)或停用(变暗)现有滚动条。
- 要激活它,请使用:
BUTTON scrollbarID, _activeBtn
- 要停用它,请使用:
BUTTON scrollbarID, _grayBtn
如果您在创建新滚动条时指定了负数 idExpr
值,FB 会在当前窗口中查找一个 ID 号等于 ABS(idExpr)
的多样式编辑字段(可以是静态的)。如果找到这样的字段,则滚动条和编辑字段的行为将链接在一起,如下所示
- 当用户(或您的程序)移动滚动条滑块时,编辑字段中的文本会垂直滚动;
- 当用户(或您的程序)更改字段中的文本,或垂直拖动它时,滚动条滑块会相应地移动。
将滚动条链接到编辑字段时,建议使用垂直滚动条。水平滚动条不会水平滚动文本,它的动作可能看起来很奇怪。
您无法更改链接到编辑字段的滚动条的 current
、min
或 max
参数。这些值会随着字段中文本内容和位置的改变而动态地自动更改。此外,您不能使用 BUTTON
语句来激活或停用这种滚动条;当编辑字段包含比视图矩形中可容纳的更多的行时,滚动条处于活动状态,否则处于非活动状态。
注意:要将滚动条链接到编辑字段,您必须先创建编辑字段,然后创建滚动条。
注意:您只能将滚动条链接到多样式编辑字段(使用负数 idExpr
值创建的字段)。
为了使滚动条可以使用,您的程序必须定期调用 HANDLEEVENTS
。除了其他事情之外,HANDLEEVENTS
会跟踪滚动条中鼠标的运动和点击,并响应这些用户操作移动滑块。您的程序还可以通过在 SCROLL BUTTON
语句中设置 current
参数来显式地移动滑块。
每当用户移动滑块时,都会生成一个类型为 _btnClick
的对话框事件。此事件的“id”值等于滚动条的 ID。您可以使用 BUTTON
函数确定滑块的当前位置
thumbPosition = BUTTON(scrollBarID)
要删除滚动条,请使用 BUTTON CLOSE
语句
BUTTON CLOSE scrollBarID
要了解有关滚动条的信息,请使用 BUTTON&
函数获取滚动条的控制记录。
BUTTON& BUTTON 函数;BUTTON 语句;EDIT FIELD;DIALOG 函数