Alan-CRL / DesktopDrawpadBlocker

DesktopDrawpadBlocker，Windows 软件插件，致力于剔除桌面上 希沃白板等 杂乱无章的画板悬浮窗，还您一个干净的桌面。

DesktopDrawpadBlocker 桌面画板悬浮窗拦截器

DesktopDrawpadBlocker，Windows 软件插件，致力于剔除桌面上 希沃白板桌面悬浮窗等 杂乱无章的桌面画板悬浮窗，还您一个干净的桌面。

软件简介

DesktopDrawpadBlocker 其原理类似弹窗拦截，会自动关闭 希沃白板桌面悬浮窗 和 希沃PPT小工具 等窗口并具有高度自定义化。 DesktopDrawpadBlocker 是作为 Windows 软件的插件程序，其并没有 UI界面，位于后台运行。

DDB 属于后台运行应用，默认 5000 毫秒扫描一次窗口，并关闭名单中的窗口，并且软件只需要普通用户权限。软件的配置文件和线程交互都通过根目录下的 json 文件，通过此 json 的变化指定程序的行为。高度的自定义化可以通过修改 json 文件完成，例如指定是否要关闭某程序，设定扫描间隔时间，设置程序行为等……

应用场景

DDB 使用 GPLv3 开源协议，可以作为您的软件的插件，您的软件可以使用 DDB 来达到拦截桌面画板悬浮窗的功能。 并大体具有两种典型模式：

• 同步模式（随宿主程序开启和关闭/随宿主程序关闭） 您的软件启动后开启 DDB，并指定您软件的路径，当 DDB 检测到您的软件关闭后，也会同步关闭
• 独立模式 您的软件可以设置 DDB 开启自动启动，来达到全时段拦截的效果（宿主软件与 DDB 互不干扰）

拓展：（可选）独立模式下，当宿主程序被关闭后，拦截到其他软件的窗口后，重启宿主程序

详细的 json 配置方法都会在下面讲到。

软件行为

程序开启后，会自动读取配置文件并开始工作。同时程序也会实时地察觉配置文件的更改，并做出调整。程序启动后会创建托盘图标，在此可以让其手动刷新配置或关闭程序等。

可选的拦截列表：

名称	标识名
希沃白板3 桌面悬浮窗	SeewoWhiteboard3Floating
希沃白板5 桌面悬浮窗	SeewoWhiteboard5Floating
希沃白板5C 桌面悬浮窗	SeewoWhiteboard5CFloating
希沃品课桌面悬浮窗（包括PPT控件）	SeewoPincoFloating
希沃PPT小工具	SeewoPPTFloating
AiClass 桌面悬浮窗	AiClassFloating
鸿合屏幕书写	HiteAnnotationFloating

如果有新的拦截需求，请添加 Issues

兼容性

程序使用 C++17 编写，最低兼容 Windows 7 sp0，并且单文件运行无需额外的运行库。

软件配置

软件的交互和配置都由其目录下的 interaction_configuration.json 完成。（您可以先启动一次 DDB，会生成使用模板）

[utf8 string] Edition：表示 DDB 版本，由 DDB 反馈
[bool] ~ConfigurationChange：当配置更改时应为 true，DDB 将更新配置

启动程序时此项因为 true（开启自启时除外），当 DDB 成功读取配置后，该项将变为 false

[bool] ~KeepOpen：决定程序是否需要开启

启动程序时此项因为 true（开启自启时除外），当程序关闭后此项将变为 false

[int64] SleepTime：每次扫描窗口的间隔（单位 ms）

[int64] Mode Mode：程序模式（0 独立模式 1 随宿主程序和开启和关闭 2 随宿主程序关闭）
[bool] Mode RestartHost：（模式为 0 时 必须）启用上述拓展功能
[utf8 string] Mode HostPath：（utf8，模式不为 0 或 开启拓展功能时 必须）宿主程序路径

[bool] Intercept [xxx]：上述拦截列表项，为 true 则拦截

在独立模式下，您的程序需要将程序设置成为软件启动项（或使用您的软件启动），DDB 会读取配置并开始工作。 添加开机启动项时务必注意需要添加启动参数： -startup 或在根目录下创建一个空白文件 start_up.signal

工作流程

进入程序主循环后，会按照下列顺序执行操作

1. 等待文件占用状态解除
2. 查询配置文件是否修改（如果是则更新配置）
3. 查询程序是否需要关闭
4. 拦截窗口
5. 扩展功能：重启宿主程序
6. 等待 SleepTime 毫秒

操控程序

按照以下步骤启动 DDB：

1. 将配置写入 json 文件，指定 ~ConfigurationChange 和 ~KeepOpen 为 true
2. 启动 DDB 的 exe 文件
   （程序成功启动后，~ConfigurationChange 变为 false 和 ~KeepOpen 保持为 true）
3. DDB 读取配置后开始工作

按照以下步骤修改 DDB 配置：

1. 将修改后的配置写入 json 文件 （读取配置成功后，~ConfigurationChange 变为 false 和 ~KeepOpen 保持为 true）

按照以下步骤关闭 DDB：

1. 将配置写入 json 文，指定 ~KeepOpen 为 false

FAQ

Q DDB 运行时修改配置会不会导致文件冲突？
A DDB 会在 json 拥有读写权限时再读取和修改 json，同时您的程序在修改 json 应至少占用写权限

Q 开启启动时需要设置 ~ConfigurationChange 和 ~KeepOpen 值吗？
A 不需要，但是添加开机启动项时务必注意需要添加启动参数： -startup 或在根目录下创建一个空白文件 start_up.signal，开机启动时不会检查这个两个值的合理性。

项目引用

智绘教Inkeys
JsonCpp
Spdlog