# Qt_Toast

**Repository Path**: zbylalalala1/qt_toast

## Basic Information

- **Project Name**: Qt_Toast
- **Description**: 使用QWidget结合Qt的动画效果实现的仿安卓Toast控件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-04-08
- **Last Updated**: 2025-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 示例截图

**单点：**

![单点渐变](README.assets/singleClick.gif)

**多次点击堆叠效果**

![多次点击堆叠](README.assets/multipleClick.gif)

## 概述

这是一个仿安卓风格的 Toast 消息提示控件，基于 Qt 框架实现。支持多种消息类型和显示时长，具有渐入渐出动画效果。

## 功能特性
- 支持三种消息类型：
  
  - 普通消息 (NORMAL)
  - 警告消息 (WARNING)
  - 危险消息 (DANGER)
- 支持两种显示时长：
  
  - 短时长 (SHORT_DUR - 1000ms)
  - 长时长 (LONG_DUR - 2000ms)
- 自动堆叠显示多个消息
- 平滑的淡出动画效果
- 圆角矩形背景
- 半透明效果
## 使用方法
### 基本调用
```cpp
#include "Toast.h"

// 显示普通消息，短时长
Toast::showToast(parentWidget, "操作成功");

// 显示警告消息，长时长
Toast::showToast(parentWidget, "警告：磁盘空间不足", Toast::WARNING, Toast::LONG_DUR);

// 显示危险消息
Toast::showToast(parentWidget, "错误：文件保存失败", Toast::DANGER);
```
```

### 集成到项目
1. 将以下文件添加到您的项目中：
   - `Toast.h`
   - `Toast.cpp`
2. 在您的项目文件(.pro)中包含 Toast.pri：
include($$PWD/Toast/Toast.pri)
```

## API 文档
### 枚举类型
```cpp
enum Duration {
    LONG_DUR = 2000,  // 长时长(2000ms)
    SHORT_DUR = 1000  // 短时长(1000ms)
};

enum ToastType {
    NORMAL,   // 普通消息
    WARNING,  // 警告消息
    DANGER    // 危险消息
};
```

### 主要方法
- `showToast`
  ```cpp
  static void showToast(QWidget *parent, const QString &message, const ToastType &type = NORMAL, Duration duration = SHORT_DUR);
  ```
  ```
   显示 Toast 消息