← 返回滚动控制组件参考 · 全部使用指导

滚动控制使用指导

• 滚动控制使用指导
  • 快速上手
  • 常见问题
  • 搭建与测试
  • 案例：返回顶部
  • 属性、方法与事件速查
  • 常见问题与验收
  • 完整 .aia 源码与操作指导
    • 滚动控制

不可见组件：读取和控制「垂直滚动条布局」「水平滚动条布局」的滚动位置——比如聊天记录加一条后自动滚到底部、 回到顶部按钮；注册布局后，滚动、到达开头或末尾时触发事件（可做「滚到底加载更多」）。

功能参照 ColinTree 的 ScrollArrangementHandlers 拓展：原版把水平、垂直拆成两个组件，每个组件只能绑定一个布局； 内置版合并为一个组件，方法直接以布局为参数，可同时管理多个布局。 位置与距离的单位和组件宽高一致；垂直布局是纵向位置，水平布局是横向位置，0 为开头。

快速上手

1. 拖一个垂直滚动条布局（高度设为 300 像素），在里面放一个标签 标签_记录（勾选「HTML格式」）；
2. 布局下方放一个文本输入框、两个按钮（按钮_发送、按钮_回顶部）和一个滚动控制；
3. 搭下面的代码块：每发一条消息追加到记录末尾并自动滚到底；滚到顶时给个提示。

各案例独立使用；组合到同一屏幕时，将同名事件的处理合并到一个事件积木中。

when Screen1.Initialize() {
  滚动控制1.Register(垂直滚动条布局1)
}

when 按钮_发送.Click() {
  标签_记录.Text = join(标签_记录.Text, "<br>我：", 文本输入框1.Text)
  文本输入框1.Text = ""
  滚动控制1.ScrollToEnd(垂直滚动条布局1)
}

when 按钮_回顶部.Click() {
  滚动控制1.ScrollToStart(垂直滚动条布局1)
}

when 滚动控制1.ReachedStart(布局) {
  按钮_回顶部.Text = "已在顶部"
}

发几条消息，记录超过布局高度后，每次发送都会自动滚到最新一条；点「回顶部」平滑滚回开头，按钮文字变成「已在顶部」。

常见问题

搭建与测试

在设计器拖入本组件和案例涉及的按钮、标签、布局等组件，按案例中的名称重命名。先运行最小案例，确认事件返回，再增加业务逻辑。示例中的素材先上传到项目，服务器地址、令牌、文件路径换成自己的值。

可见组件需要有非零宽高；不可见工具组件必须由属性或方法启动。设计器展示样式不等于运行时已加载数据或绑定目标。联机测试应使用包含本组件的 AI 伴侣；涉及系统入口或权限的行为还要编译安装后验证。

案例：返回顶部

放垂直滚动条布局，加入足够多的内容形成滚动；按钮位于滚动布局外。

when Screen1.Initialize() {
  滚动控制1.Register(垂直滚动条布局1)
}
when 按钮_顶部.Click() {
  滚动控制1.ScrollToStart(垂直滚动条布局1)
}
when 按钮_底部.Click() {
  滚动控制1.ScrollToEnd(垂直滚动条布局1)
}

注册真正的滚动布局，不是普通垂直布局。内容未超过容器时没有可滚动距离；新增内容后等布局完成再滚到底部。

属性、方法与事件速查

完整参数类型、默认值和平台说明见组件参考。下表按调用入口列出用途；有完成事件的方法在事件中读取结果。

常见问题与验收

完整 .aia 源码与操作指导

下载 .aia 源码

无需账号、网络。大学名单仅作真实名称的滚动内容，不表示排名。大学列表独立占半屏；操作按钮始终在列表外，控制的是大学列表。滚动位置单位安卓dp、鸿蒙vp。

导入 ScrollHandlerAllFeatures.aia，连接最新伴侣，或编译独立安装包。真机／伴侣运行尚未实测。

所有返回值均用于界面反馈，错误由底部错误区展示。设计器采用明确非默认配置，初始化与界面同步。API 覆盖检查按最终 AIA 检查方法、事件、属性读取与设置及设计器配置，不能替代真实设备验证。

滚动控制

导入方法：项目 → 导入项目（.aia）→ 选择下载的 .aia 源码文件。 无需账号、网络。大学名单仅作真实名称的滚动内容，不表示排名。大学列表独立占半屏；操作按钮始终在列表外，控制的是大学列表。滚动位置单位安卓dp、鸿蒙vp。 覆盖检查 8/8。首次载入及保存重开均0个错误，真实后台导入、安装包编译通过；真机／伴侣／硬件联调尚未实测。全部属性读写、方法与事件的操作入口和预期结果见组件指导。