快速上手

相关源文件

本页面内容基于以下源文件生成：

• README.md
• Textify.rc
• MainDlg.cpp
• MainDlg.h
• extra/setup_lang/Czech.nsh
• extra/setup_lang/Dutch.nsh
• extra/setup_lang/Greek.nsh
• extra/setup_lang/Arabic.nsh
• extra/setup_lang/French.nsh
• extra/setup_lang/German.nsh

Textify 是一款 Windows 平台的小工具，专门用于从无法直接复制文本的对话框和控件中提取文本内容。该工具通过鼠标快捷键激活，支持自定义组合键配置，适用于需要从系统界面元素中获取文本的场景。

工具简介

Textify 的核心功能是解决 Windows 系统中部分对话框和控件不支持文本复制的问题。根据项目描述，该工具允许从"dialogs and controls which don't allow it otherwise"（无法以其他方式复制的对话框和控件）中提取文本（README.md:1-7）。

工具的工作原理是通过注册全局鼠标快捷键，当用户按下配置的组合键并点击目标控件时，Textify 会捕获该操作并显示一个文本对话框，展示从目标控件提取的文本内容。核心触发逻辑在 OnHotKey 函数中实现：当快捷键 ID 为 1 时，获取当前光标位置并弹出文本对话框（MainDlg.cpp:110-120）。

环境要求

根据安装程序语言资源的描述，Textify 设计用于 Windows 7/8/10 系统（extra/setup_lang/Czech.nsh:1-21）。项目采用 C++ 开发，基于 ATL（Active Template Library）框架构建 Windows 应用程序。

系统要求：

• 操作系统：Windows 7/8/10（extra/setup_lang/Czech.nsh:10）
• 架构：需要确认（未在源文件中明确说明 x86/x64 支持）

运行时依赖：

• 需要确认：是否依赖特定版本的 Visual C++ Redistributable

安装步骤

Textify 提供两种安装模式：标准安装和便携模式。

安装方式对比：

安装程序支持以下选项（extra/setup_lang/Czech.nsh:1-21）：

• 开机自启动：&Spustit $(^NameDA) při startu Windows
• 开始菜单快捷方式
• 桌面快捷方式

推荐安装路径：

1. 从官方网站下载安装程序：https://ramensoftware.com/textify（[README.md:5](https://github.com/m417z/Textify/blob/main/README.md#L5)）
2. 运行安装程序，选择"Standard"（标准）或"Portable"（便携）模式
3. 根据需要勾选桌面快捷方式和开机自启动选项

命令行安装（静默模式）： 需要确认：安装程序是否支持 /S 或其他静默安装参数

最短可运行路径

安装完成后，Textify 可通过以下方式快速启动：

启动方式一：桌面快捷方式 双击桌面上的 Textify 图标启动程序。

启动方式二：开始菜单 从开始菜单中找到 Textify 并启动。

程序启动后会显示主对话框，同时在系统托盘区域创建图标（MainDlg.cpp:33-39）。如果配置了开机自启动且启用了隐藏窗口选项，程序启动时不会显示主界面（MainDlg.cpp:25-31）。

首次使用配置：

1. 启动 Textify 后，在主界面中配置快捷键组合
2. 选择修饰键：Ctrl、Alt、Shift（可多选）
3. 选择鼠标按键：左键、右键或中键
4. 点击"应用"按钮保存配置

快捷键配置

Textify 的核心交互机制基于鼠标快捷键。用户需要配置一个组合键，包含修饰键和鼠标按键。

支持的修饰键（MainDlg.cpp:154-156）：

• Ctrl
• Alt
• Shift

支持的鼠标按键（MainDlg.cpp:172-187）：

• 左键
• 右键
• 中键

界面字符串资源定义了各按键的显示文本（Textify.rc:183-220）。配置完成后，点击"应用"按钮会将设置保存到 INI 配置文件中（MainDlg.cpp:195）。

配置示例：

安全警告：如果用户未选择任何修饰键（仅使用鼠标按键），程序会弹出警告对话框，提示这可能导致意外触发（MainDlg.cpp:158-170）。

运行验证

验证程序正常运行：

1. 启动 Textify 后，检查系统托盘区域是否出现程序图标
2. 按下配置的快捷键组合（如 Ctrl + 左键点击）
3. 程序应显示一个文本对话框，展示从目标控件提取的文本

托盘图标验证： 程序启动时会初始化托盘图标数据结构（MainDlg.cpp:34），并根据配置决定是否显示托盘图标（MainDlg.cpp:36-39）。

预期行为：

• 程序启动后主窗口居中显示（MainDlg.cpp:14）
• 托盘图标右键菜单包含"显示主窗口"和"退出"选项（MainDlg.h:22-24）
• 按下快捷键后，文本对话框应出现在鼠标位置附近

更新检查： 如果启用了更新检查功能，程序会在启动 10 秒后检查更新，之后每小时检查一次（MainDlg.cpp:42-45）。

常见问题与排错

问题一：快捷键无响应

可能原因：

• 快捷键与其他软件冲突
• 程序未正确注册全局热键

解决方案：

1. 检查是否有其他软件占用了相同的快捷键组合
2. 尝试更换为更复杂的组合键（如 Ctrl + Alt + 右键）
3. 重启 Textify 程序

问题二：无法从某些控件提取文本

可能原因：

• 目标控件使用非标准 Windows 控件
• 目标程序以管理员权限运行，而 Textify 以普通权限运行

解决方案：

1. 尝试以管理员身份运行 Textify
2. 检查目标控件是否为标准 Windows 控件
3. 需要确认：查阅官方文档了解支持的控件类型

问题三：程序启动后立即消失

可能原因：

• 配置了"启动时隐藏窗口"选项
• 程序已在后台运行

解决方案：

1. 检查系统托盘是否有 Textify 图标
2. 通过任务管理器确认是否有 Textify 进程在运行
3. 双击托盘图标或右键选择显示主窗口

问题四：托盘图标不显示

可能原因：

• 配置了隐藏托盘图标选项
• Windows 资源管理器重启后图标未恢复

解决方案： 程序会监听 TaskbarCreated 消息以处理资源管理器重启的情况（MainDlg.h:91）。如果图标仍未显示，尝试重启 Textify。

界面初始化流程

程序启动时执行以下初始化步骤（MainDlg.cpp:11-48）：

正在加载图表渲染器...

主对话框类 CMainDlg 继承自 CDialogImpl，定义了消息映射表处理各种窗口消息和自定义消息（MainDlg.h:1-30）。关键消息包括：

• WM_INITDIALOG：对话框初始化
• WM_HOTKEY：全局热键响应
• WM_TIMER：定时器事件（用于更新检查）
• WM_DESTROY：窗口销毁时的资源清理

程序退出与资源清理

当程序退出时，会执行以下清理操作（MainDlg.cpp:50-68）：

1. 注销鼠标和键盘热键
2. 删除托盘图标
3. 停止更新检查定时器
4. 销毁图标资源

下一步建议

完成基本配置后，可以进一步探索以下功能：

1. 高级设置：通过主界面的"更多设置"按钮访问高级配置选项（Textify.rc:219）
2. 自定义界面语言：程序支持多种界面语言，可在设置中更改
3. 开机自启动：通过安装程序或手动配置实现开机自动运行

如需了解更详细的配置选项和高级用法，请参阅"使用指南"章节。