# CalcV

**Repository Path**: masonwu21/calc-v

## Basic Information

- **Project Name**: CalcV
- **Description**: No description available
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# calc-v

基于 Core UI 框架开发的现代化计算器应用程序，支持基础数学运算和货币汇率转换功能。

## 功能特性

### 📱 计算器
- 基础算术运算：加、减、乘、除
- 百分比计算
- 正负号切换
- 退格删除
- 清零重置
- 实时结果显示

### 💱 货币转换
- 多种主流货币支持（USD, EUR, GBP, JPY, CNY 等）
- 实时汇率换算
- 双向兑换
- 快速切换币种

### 🎨 界面交互
- 标签页导航（计算器 / 货币转换）
- 按钮点击反馈
- 键盘快捷键支持
- 响应式数字显示

## 技术栈

- **UI 框架**: Core UI (.uix 单文件组件)
- **编程语言**: C++
- **构建工具**: CMake
- **目标平台**: Windows

## 项目结构

```
├── src/
│   ├── calc.cpp        # 计算器核心逻辑
│   ├── calc.h         # Calculator 类定义
│   ├── calc.ui       # UI 布局文件
│   └── main.cpp      # 程序入口
├── core-ui-main/     # Core UI 框架库
├── CMakeLists.txt
└── LICENSE
```

## 构建要求

- Windows 操作系统
- MSVC 或 Clang-CL 编译器
- CMake 3.16+
- Windows SDK

## 快速开始

### 克隆项目

```bash
git clone https://gitee.com/masonwu21/calc-v.git
cd calc-v
```

### 构建项目

```bash
cmake -B build
cmake --build build
```

### 运行

构建完成后，在 `build/release/` 目录下找到生成的可执行文件运行即可。

## 使用说明

### 计算器模式
1. 点击数字按钮输入数值
2. 选择运算符（+, -, ×, ÷）
3. 按等号 (=) 获取结果
4. 支持键盘输入：数字键 0-9、小数点、Enter 确认、Esc 清空

### 货币转换模式
1. 在「来自」区域选择源货币并输入金额
2. 在「至」区域选择目标货币
3. 实时显示转换结果
4. 点击交换按钮可互换源目标和目标币种

## 许可证

MIT License

## 相关文档

- [Core UI 框架文档](core-ui-main/README.md)
- [Core UI API 参考](core-ui-main/UI_CORE_API.md)
- [快速开始指南](core-ui-main/docs/getting-started.md)