开源API备份还原剪贴板

功能说明:

本程序是基于易语言开发的一款系统级剪贴板管理工具，其核心功能是实现对剪贴板内所有格式数据的完整备份与精确还原。程序通过调用 Windows 底层 API，突破了普通剪贴板读写仅支持文本或简单对象的限制，能够捕获并保存包括图像、文件列表等在内的多种复杂数据格式。

程序的主要逻辑架构分为后台处理模块和用户界面模块两部分，具体功能分析如下：

一、核心备份与还原逻辑

程序使用了名为"BackupRestore"的专用程序集来封装底层操作，其中包含两个关键的子程序，这也是判断程序用途的最直接依据：

1. .子程序 backupClipboard（备份剪贴板）

   该子程序实现了剪贴板快照功能。当执行此程序时，首先尝试打开系统剪贴板。若成功，它会初始化一个数组变量 CBDS（CLIPBOARD 数据结构）。随后，程序进入一个循环，利用 API_EnumClipboardFormats 枚举当前剪贴板中所有支持的格式类型。对于每一种检测到的格式，子程序会执行以下操作：

   - 获取格式名称：通过 API_GetClipboardFormatName 识别数据格式（如 CF_TEXT, CF_BITMAP 等）。

   - 获取数据内容：通过 API_GetClipboardData 获取数据句柄，并使用 API_GlobalSize 获取数据长度。

   - 内存拷贝：利用 API_GlobalLock 锁定内存块，再通过 API_CopyMemory 将原始二进制数据复制到程序的本地变量中，存储进 CBDS 数组。

   最终关闭剪贴板并返回布尔值表示操作是否成功。这一过程确保了剪贴板中的原始比特流被完整保留。

2. .子程序 restoreClipboard（还原剪贴板）

   该子程序实现了从内存恢复剪贴板的功能。执行时，首先打开剪贴板并调用 API_EmptyClipboard 清空当前内容。接着，程序遍历之前在备份步骤中填充的 CBDS 数组。对于数组中的每一个数据项：

   - 注册格式：如果存在自定义格式名称，使用 API_RegisterClipboardFormat 进行注册。

   - 分配内存：使用 API_GlobalAlloc 分配可移动且共享的全局内存空间，大小与备份时一致。

   - 还原数据：同样通过 GlobalLock 锁定新分配的内存，将 CBDS 中存储的字节集数据拷回，再调用 API_SetClipboardData 将句柄设置给剪贴板。

   完成所有数据写入后关闭剪贴板。这一步骤使得用户可以通过点击按钮瞬间找回之前被覆盖的剪贴板内容。

二、用户界面交互逻辑

在“窗口程序集 1"中，程序提供了可视化的操作入口，通过两个按钮分别触发上述的核心子程序：

1. .子程序 _按钮 1_被单击

   这是备份操作触发器。用户点击后，程序首先读取编辑框内容并置入剪贴板。紧接着调用 backupClipboard() 保存当前的剪贴板状态。随后修改编辑框内容为当前时间，并再次更新剪贴板。这种设计通常用于演示或测试，意在模拟“用户复制了一段文本（编辑框内容），但在覆盖之前先进行了存档”的场景。

2. .子程序 _按钮 2_被单击

   这是还原操作触发器。用户点击后，立即调用 restoreClipboard()，将之前备份的剪贴板数据恢复至系统剪贴板。之后，程序读取剪贴板中的文本内容并显示在编辑框中，让用户确认还原结果。

三、技术实现细节

为了实现对硬件级的剪贴板控制，程序引入了多个外部 DLL 命令，主要包括 user32.dll 中的剪贴板管理函数（如 OpenClipboard、SetClipboardData）和 kernel32.dll 中的内存管理函数（如 GlobalAlloc、RtlMoveMemory）。这些底层调用保证了程序在处理非标准格式数据时的稳定性和兼容性。变量 CBDS 被定义为一个公共的程序集变量，充当临时存储区，连接了备份与还原两个独立的过程。

综上所述，该程序是一个功能明确的剪贴板历史保护工具。它解决了常规操作中剪贴板内容容易被意外覆盖的问题，特别适用于需要在不同格式间频繁切换或希望保留特定批次复制内容的场景。通过简单的两按钮设计，实现了复杂的剪贴板状态保存与回滚功能。

======BackupRestore

           |  |

           |  |------ backupClipboard

           |  |

           |  |------ restoreClipboard

           |  |

           |  |

======窗口程序集1

           |  |

           |  |------ _按钮1_被单击

           |  |

           |  |------ _按钮2_被单击

           |  |

           |  |

======调用的Dll

           |  |

           |  |---[dll]------   API_CloseClipboard

           |  |

           |  |---[dll]------   API_EmptyClipboard

           |  |

           |  |---[dll]------   API_EnumClipboardFormats

           |  |

           |  |---[dll]------   API_GetClipboardData

           |  |

           |  |---[dll]------   API_OpenClipboard

           |  |

           |  |---[dll]------   API_SetClipboardData

           |  |

           |  |---[dll]------   API_GlobalSize

           |  |

           |  |---[dll]------   API_CopyMemory

           |  |

           |  |---[dll]------   API_GlobalLock

           |  |

           |  |---[dll]------   API_RegisterClipboardFormat

           |  |

           |  |---[dll]------   API_GetClipboardFormatName

           |  |

           |  |---[dll]------   API_GlobalAlloc

           |  |

           |  |---[dll]------   API_GlobalUnlock