object:setIsLocked()

类型 函数
库 widget.*
版本 版本 2024.3703
关键词 widget，滚动视图，ScrollViewWidget，setIsLocked
另请参阅 widget.newScrollView()
ScrollViewWidget

概述

将 ScrollViewWidget 设置为锁定状态（不滚动）或解锁状态（默认行为）。 或者，您可以锁定或解锁特定方向轴上的滚动视图。

语法

object:setIsLocked( isLocked [, axis] )
isLocked （必填）

布尔值. 设置为 true 锁定滚动视图；false 解锁滚动视图。

axis （可选）

字符串. 要锁定或解锁滚动视图的方向轴，可以是 "horizontal"（水平）或 "vertical"（垂直）。

示例

延迟锁定
local scrollView = widget.newScrollView {
    width = 400,
    height = 400,
    left = 0,
    top = 0,
    scrollWidth = 800,
    scrollHeight =  1200,
    hideBackground = false
}

local function lockScrollView()
    scrollView:setIsLocked( true )
end

-- Lock the scroll view after 2 seconds
timer.performWithDelay( 2000, lockScrollView )
锁定特定轴
local scrollView = widget.newScrollView {
    width = 400,
    height = 400,
    left = 0,
    top = 0,
    scrollWidth = 800,
    scrollHeight =  1200,
    hideBackground = false
}

-- Lock the scroll view only on the horizontal axis
scrollView:setIsLocked( true, "horizontal" )