# 屏幕滚动播放器 v2.1.3

适用于捐款、赞助、奖学助学及会议活动的屏幕名单展示。支持 Windows 10/11 64 位系统，可离线使用。

## 开始使用

1. 将压缩包解压到可以写入的文件夹，运行 `DonationScroller_v2.1.3.exe`。不要直接在压缩包内运行。
2. 按销售方提供的信息完成激活，也可选择“继续试用”。
3. 首次打开默认为暂停，字幕隐藏。添加名单，确认目标屏幕、滚动方向、字体与位置。
4. 点击“开始播放”。点击“暂停并隐藏”后，字幕隐藏且不影响其他软件操作；继续时接着当前进度播放。
5. 完整使用说明在右上角“帮助”菜单中，也可按 F1 打开。

## 离线授权与试用

1. 在授权窗口复制本机机器码，发给销售方。
2. 填写销售方提供的授权名称、到期日期和激活码，三项信息须一致。
3. 点击“激活”。成功后，授权保存在程序文件夹中的 `license-v2.key`。

永久授权日期填写 `PERMANENT`，限期授权填写销售方提供的日期，例如 `20261231`。激活码较长，建议完整复制粘贴。运行中可通过“更多 → 离线授权”打开授权窗口。

未授权时可继续试用，滚动仅播放前 10 条名单并带试用标识；名单仍可编辑和保存。限期授权在到期日全天有效，到期或失效后转为试用，不删除名单。请保持系统日期准确，授权文件仅适用于对应电脑。

## 编辑名单

- 底部输入姓名或公司(机构)名称，按 Tab 进入金额，按 Enter 追加。
- 双击表格中的姓名或金额即可编辑，Enter 提交，Esc 取消；也可选中一行按 F2。
- 在 Excel 中复制姓名、金额两列，通过“批量导入”粘贴，先检查后加入。存在无效行时会询问是否只加入有效行，重复记录不会擅自删除。
- Ctrl / Shift 可多选，点击删除图标或按 Delete 删除所选记录。“更多 → 清空名单”可清空全部记录，操作前会询问确认。
- 名单操作支持最多 30 步撤销与重做，关闭程序后不保留撤销历史。
- 搜索姓名或金额只影响表格显示，不改变滚动播放顺序。清空搜索恢复全部名单。

金额可自动补齐单位，并去掉整数金额末尾的 `.00`。“文字样式”里的“千分位分隔符”总开关默认关闭，开启后显示如 `1,000元`；小数与单位不变。该开关仅改变显示，原始金额和导出内容不会被改写。

## 播放与样式

- 顶部可选择横向或纵向滚动、速度和目标屏幕。两种方向分别记忆位置、姓名金额间距和速度等设置。
- 速度输入后按 Enter，或点击其他控件、按 Tab 离开输入框，即可应用并保存。
- 右侧“文字样式”可调整字体、字号、加粗、颜色、描边、阴影、抬头、间隔符、单位及姓名金额间距。
- “位置布局”可通过数值、滑块或拖动位置概览中的字幕区域调整位置，并提供贴近顶部、贴近底部和置顶设置。
- 速度和位置滑块不会响应鼠标滚轮；滚轮经过位置滑块时只滚动设置面板。需要调节时可拖动、点击滑块，或聚焦后使用方向键。
- 字幕背景透明。右上角预览中的浅色、深色、红色背景仅用于比较文字效果，不改变实际字幕背景。
- 右上角为静态样式预览，显示首条名单，不代表当前播放进度或大屏幕的等比例画面。

播放中修改设置会直接影响字幕，请在现场播放前确认样式和位置。普通参数输入框离开后应用，滑块、颜色和开关直接生效。窗口随 DPI 缩放，空间不足时右侧设置区可滚动。

## 外接屏幕与 PPT

需要在电脑上编辑名单、同时让大屏幕持续放映时，先将 Windows 显示模式设为“扩展”，再分别为 PowerPoint 幻灯片放映和本程序选择对应的目标屏幕。

开始活动前确认两套程序使用同一块大屏幕，并检查字幕颜色、字号和位置是否合适。大屏幕与电脑的分辨率、缩放和刷新率可能不同，建议使用实际播放设备提前试播。

## 保存与备份

名单变更会自动保存，参数应用后也会保存。点击“应用并保存”可主动提交当前输入，结果显示在底部状态栏；保存失败时请检查程序文件夹是否可写入。

| 文件 | 内容 |
| --- | --- |
| `donations.txt` | 名单 |
| `settings.ini` | 播放参数与快捷键 |
| `license-v2.key` | 本机授权 |
| `donations.txt.bak` | 上一次名单变更前的备份 |

“更多 → 恢复上次名单备份”可恢复上一份名单，名单未变化时重复保存不会覆盖这份备份。它不能替代长期归档，请另外备份重要活动名单。“更多 → 导出名单”可生成 Excel 可打开的 TSV 文件。

“更多 → 恢复全部默认设置”只恢复播放参数、方向和快捷键等，不清空名单，也不取消授权。

## 常用操作

| 操作 | 方法 |
| --- | --- |
| 使用说明与教程 | 帮助菜单或 F1 |
| 搜索名单 | Ctrl+F |
| 连续编辑单元格 | Tab / Shift+Tab |
| 撤销 / 重做名单 | 工具栏箭头，或不在文本框内时按 Ctrl+Z / Ctrl+Y |
| 应用并保存 | Ctrl+S / Alt+K |
| 参数快速定位 | Alt 加标签括号内的字母或数字 |
| 调整全局快捷键 | 右侧“快捷键”设置 |
| 隐藏到托盘 | 点击窗口右上角关闭按钮 |
| 调出窗口 | 单击托盘图标，或使用配置的调出快捷键 |
| 彻底退出 | 更多菜单或托盘右键菜单中的“退出程序” |

客户发布包仅包含播放器、本说明和 `示例名单.txt`，不含个人名单、设置、授权文件及授权码生成器。示例名单可用记事本打开，复制内容后通过“批量导入”加入。