# PowerPointProgressBar

**Repository Path**: wh_hnu/PowerPointProgressBar

## Basic Information

- **Project Name**: PowerPointProgressBar
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PowerPoint Progress Bar Plugin

一个用于在 PowerPoint 幻灯片中插入进度条的 VSTO 插件。

## 功能特性

- **插入进度条**：在每张幻灯片中插入三个形状元素（已播放、未播放、游标）
- **多种位置支持**：顶部、底部、左侧、右侧
- **自定义样式**：颜色、透明度、圆角、阴影、边框
- **自定义总页数**：支持手动指定总页数（用于只展示部分内容）
- **一键删除**：通过持久化标识识别进度条，支持PPT关闭后重新打开
- **多语言支持**：中文 / English

## 系统要求

- Windows 7 或更高版本
- Microsoft Office 2013 或更高版本
- .NET Framework 4.7.2

## 项目结构

```
PowerPointProgressBar/
├── PowerPointProgressBar.sln        # 解决方案文件
├── PowerPointProgressBar.csproj     # 项目文件
├── ThisAddIn.cs                     # VSTO 入口点
│
├── Constants/
│   └── TagConstants.cs              # 标识常量
│
├── Models/
│   ├── PositionType.cs              # 位置枚举
│   ├── ProgressBarConfig.cs         # 配置模型
│   ├── ProgressBarElements.cs       # 元素集合
│   └── ShapeTemplate.cs             # 形状模板
│
├── Services/
│   ├── ConfigManager.cs             # 配置管理
│   ├── ProgressBarService.cs        # 核心服务
│   ├── ShapeFactory.cs              # 形状工厂
│   └── ShapeIdentifier.cs           # 形状标识
│
├── UI/
│   ├── Ribbon/
│   │   └── ProgressBarRibbon.cs     # Ribbon 界面
│   └── Dialogs/
│       └── SettingsDialog.cs        # 设置对话框
│
├── Helpers/
│   ├── GeometryHelper.cs            # 几何计算
│   ├── ShapeHelper.cs               # 形状辅助
│   └── SlideHelper.cs               # 幻灯片辅助
│
└── Resources/
    ├── Strings.resx                 # 英文资源
    └── Strings.zh-CN.resx           # 中文资源
```

## 编译说明

### 环境准备

1. 安装 Visual Studio 2019 或更高版本
2. 安装 ".NET 桌面开发" 工作负载
3. 安装 "Office/SharePoint 开发" 工作负载

### 编译步骤

1. 打开 `PowerPointProgressBar.sln`
2. 选择 Build > Build Solution（或按 Ctrl+Shift+B）
3. 编译输出位于 `bin\Debug\` 或 `bin\Release\`

## 安装说明

### 开发环境安装

1. 以管理员身份运行 Visual Studio
2. 打开项目属性，选择 "调试" 选项卡
3. 设置启动外部程序为 PowerPoint 路径
4. 按 F5 启动调试

### 生产环境安装

1. 创建 Windows Installer 项目（.msi）
2. 包含以下组件：
   - 主插件 DLL
   - .NET Framework 4.7.2（如未安装）
   - VSTO Runtime（如未安装）
3. 运行安装程序

## 使用方法

### 插入进度条

1. 打开 PowerPoint 演示文稿
2. 在功能区找到 "进度条" 选项卡
3. 点击 "插入进度条" 按钮
4. 进度条将自动添加到所有幻灯片

### 配置进度条

1. 点击 "设置" 按钮打开设置对话框
2. 在 "尺寸与位置" 选项卡设置位置和大小
3. 在 "颜色样式" 选项卡设置外观
4. 点击 "确定" 保存设置

### 快速设置

- **位置下拉框**：快速切换进度条位置
- **总页数输入框**：手动指定总页数（留空则自动获取）

### 删除进度条

1. 点击 "删除进度条" 按钮
2. 确认删除操作

## 技术细节

### 进度条标识机制

插件使用 `Shape.Tags` 属性来持久化标识进度条元素：

```csharp
shape.Tags.Add("PPTProgressBar", "IsProgressBar");
shape.Tags.Add("ElementType", "Played");  // 或 Unplayed, Cursor
shape.Tags.Add("GroupId", "唯一GUID");
```

这确保了即使 PPT 关闭后重新打开，插件仍能识别并管理进度条。

### 配置存储

- **全局配置**：存储在 `%AppData%\PPTProgressBar\config.json`
- **文档配置**：存储在 PPT 文件的 CustomXMLParts 中

## 许可证

MIT License

## 版本历史

### v1.0.0 (2024)
- 初始版本
- 支持基本的进度条插入和删除功能
- 支持多种位置和样式配置
- 支持中英文双语