求助API实现气球提示框

功能说明:本程序是一个使用易语言（E Language）编写的 Windows 桌面应用程序示例，其主要功能是演示如何封装和使用 Windows 系统底层的 API 接口来创建自定义的消息提示框和气泡通知。程序的核心在于不依赖系统默认的 MessageBox 或简单的标签显示，而是通过调用 Win32 API 实现具有高度定制化的视觉提示效果，包括背景颜色、边框文字颜色、图标样式以及提示框的位置布局等。

程序主要由以下几个部分构成：

一、核心功能子程序：创建提示

程序中最关键的子程序是 `.子程序 创建提示`。这是一个通用封装函数，旨在为任何指定的窗口控件（如按钮）添加提示信息。该子程序接收多个参数以实现灵活配置：

1. 窗口单元句柄：指定将提示绑定到哪个窗口控件上。

2. 是否汽泡：控制提示框的样式，选择标准提示还是气球式气泡提示（#TTS_BALLOON）。

3. 是否使用图标与图标样式：允许在提示中显示信息、警告、错误等不同样式的系统图标。

4. 方向：决定提示框相对于目标控件的显示位置（居右或居中）。

5. 背景颜色与边框文本颜色：支持自定义提示框的视觉风格，使其融入应用程序的整体 UI 设计。

6. 提示文本：支持多行文本，通过换行符实现段落排版。

在该子程序内部，逻辑首先判断是否需要气泡模式，并设置相应的样式标志位。随后，利用 `创建窗体` (对应 Windows API CreateWindowExA) 创建一个属于 #TOOLTIPS_CLASSA 类的隐藏窗口作为提示容器，并将其设置为顶层窗口（#WS_EX_TOPMOST）以确保显示在最前端。接着，程序获取目标控件的矩形区域坐标，构建提示消息结构体，并通过 `发送窗体信息` (SendMessageA) 将文本、区域信息注册到提示窗口中。如果启用了图标，则发送图标信息指令；最后，通过发送特定消息设置提示的最大宽度和具体的颜色属性。

二、启动初始化流程

程序入口位于 `.子程序 __启动窗口_创建完毕`。当主窗口加载完成后，该子程序自动执行。它调用了两次 `创建提示` 函数，分别展示了两种不同的应用实例：

第一次调用关联“按钮 1"，开启气泡模式，标题为“夜雨绘秋图”，内容是一首描写秋季景色的七言诗。

第二次调用关联“按钮 2"，关闭气泡模式（或使用默认标准模式），标题为“双双燕——七夕”，内容是一首关于七夕节牛郎织女传说的词。

这一部分主要起到了演示作用，验证了 `创建提示` 函数的有效性，同时展示了如何处理中文文本和特殊字符（如换行符）。

三、底层 API 导入

为了实现上述功能，程序底部声明了一系列 Windows API DLL 命令，这些命令直接映射到 User32.dll 或 ComCtl32.dll 等系统库中的函数：

- CreateWindowExA：用于创建高级风格的窗口，此处用于实例化 Tooltip 控件。

- SetWindowPos：用于设置窗口的位置和状态，确保提示框置顶且不激活干扰当前操作。

- GetClientRect：获取控件的客户端矩形区域，以确定提示框弹出的锚点位置。

- SendMessageA：向窗口发送消息，用于添加工具栏项目、设置标题、颜色和宽度等配置。

- DestroyWindow：虽未在当前逻辑显式调用，但预留了销毁窗口的接口，用于资源清理。

四、程序特点与应用场景

1. 非阻塞性：与 MessageBox 不同，这种提示通常不会阻塞用户操作，更适合在后台展示轻量级通知。

2. 高度可定制：用户可以完全控制提示的颜色、大小和外观，适合需要统一 UI 风格的专业软件。

3. 复用性强：`创建提示` 子程序可以被多次调用，只需改变参数即可应用于界面中的不同控件。

4. 技术深度：展示了易语言如何通过调用外部 DLL 实现超出原生组件能力的系统级交互，体现了对 Windows 消息机制的深入理解。

综上所述，该程序是一个典型的易语言 API 编程教学案例，重点在于学习如何通过底层句柄操作和消息传递机制来实现图形界面中的增强型用户体验组件。

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

           |  |

           |  |------ __启动窗口_创建完毕

           |  |

           |  |------ 创建提示

           |  |

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

           |  |

           |  |

======调用的Dll

           |  |

           |  |---[dll]------   创建窗体

           |  |

           |  |---[dll]------   设置窗口风格

           |  |

           |  |---[dll]------   发送图标信息

           |  |

           |  |---[dll]------   发送颜色信息

           |  |

           |  |---[dll]------   发送窗体信息

           |  |

           |  |---[dll]------   获取矩形

           |  |

           |  |---[dll]------   破坏窗口