object:scrollToPosition()

类型 函数
库 widget.*
修订 发行版 2024.3703
关键字 控件、滚动视图、ScrollViewWidget、scrollToPosition
另请参阅 object:scrollTo()
widget.newScrollView()
ScrollViewWidget

概述

使 ScrollViewWidget 滚动到特定的 x 或 y 位置。

语法

object:scrollToPosition( options )

此函数采用单个参数 options，它是一个表格，接受以下参数

x (可选)

数字. 要滚动到的 x 位置。如果你只希望垂直滚动，则应当省略此参数。

y (可选)

数字. 要滚动到的 y 位置。如果你只希望水平滚动，则应当省略此参数。

time (可选)

数字. 以毫秒计的时间，滚动到指定的坐标。对于即时效果（无过渡效果），将其设为 0。默认值为 400。

onComplete (可选)

函数. 滚动完成后调用可选函数。

示例

local function onScrollComplete()
    print( "Scroll complete!" )
end

scrollView:scrollToPosition
{
    x = 100,
    y = -100,
    time = 800,
    onComplete = onScrollComplete
}