# qscreenshot

**Repository Path**: zzm3280/qscreenshot

## Basic Information

- **Project Name**: qscreenshot
- **Description**: qscreenshot——一个使用QtQuick开发的截图工具，工具栏仿照微信截图，支持后台热键截图
- **Primary Language**: QML
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-02
- **Last Updated**: 2025-09-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

该项目是一个基于Qt的屏幕截图工具，支持全局快捷键设置与多种操作系统平台（Windows、macOS、X11）。它包含用于处理热键注册与事件过滤的类（`QHotkey`及其平台相关实现），以及用于执行屏幕截图和保存图像的类（`ScreenshotHelper`）。此外，项目还提供了配置管理（`Confighelper`）和QML图像提供支持（`PixmapProvider`）。QHotkey Github:[QHotkey](http://https://www.github.com/Skycoder42/QHotkey)

以下是一个适用于该项目的`README.md`文件内容：

---

# QScreenShot

QScreenShot 是一个基于 Qt 的屏幕截图工具，支持全局快捷键设置，并可在多个操作系统平台上运行（包括 Windows、macOS 和 X11）。该项目提供了一套完整的截图功能，包括全屏截图、区域截图、图像保存到剪贴板或文件等功能。

## 功能特性

- **全局快捷键支持**：通过 `QHotkey` 类实现跨平台的全局快捷键注册与事件处理。
- **截图功能**：支持全屏截图和区域截图，并可将截图保存到剪贴板或文件。
- **配置管理**：通过 `Confighelper` 类实现配置信息的读写。
- **QML 支持**：提供 QML 组件用于界面交互，并通过 `PixmapProvider` 提供图像资源支持。

## 支持平台

- Windows
- macOS
- Linux (X11)

## 构建要求

- Qt 5 或更高版本
- CMake
- 支持 C++11 的编译器

## 构建步骤

1. 克隆仓库：
   ```bash
   git clone https://gitee.com/zzm3280/qscreenshot.git
   cd qscreenshot
   ```

2. 创建构建目录并进入：
   ```bash
   mkdir build && cd build
   ```

3. 使用 CMake 配置项目：
   ```bash
   cmake ..
   ```

4. 构建项目：
   ```bash
   cmake --build .
   ```

5. 运行程序：
   ```bash
   ./qscreenshot
   ```

## 使用方法

- **全屏截图**：按下预设的全局快捷键（如 `PrintScreen`）进行全屏截图。
- **区域截图**：按下快捷键后，鼠标会变成十字光标，拖动选择截图区域。
- **保存截图**：截图完成后，可以选择将图像保存到文件或复制到剪贴板。

## 贡献指南

欢迎贡献代码和改进！如果您希望提交 Pull Request，请确保遵循以下步骤：

1. Fork 仓库。
2. 创建新分支。
3. 提交更改。
4. 编写清晰的提交信息。
5. 提交 Pull Request。

## 许可证

本项目采用 MIT 许可证。详情请参阅 [LICENSE](LICENSE) 文件。

## 联系方式

如有任何问题或建议，请提交 Issue 或联系项目维护者。

--- 

以上内容为该项目的简要说明和使用指南，适用于开发者和最终用户。