# WindowTopTools

**Repository Path**: successfulDoIt/window-top-tools

## Basic Information

- **Project Name**: WindowTopTools
- **Description**: 基于C#开发的Window纯净版窗口置顶小工具，精致小巧9KB无臃肿依赖，用于对窗口进行置顶显示或取消置顶显示。选中窗口，按下Ctrl+Alt+Shift+D置顶或取消置顶窗口。程序启动3秒后自动隐藏到任务栏托盘位置，最小化后也是隐藏到任务栏托盘位置。
Windows，窗口置顶，窗体置顶，置顶，窗口钉，钉窗口，CSharp，C#，WinApi，DLL，User32
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-04-13
- **Last Updated**: 2025-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 窗口置顶工具

一个基于C#和Windows API的轻量级窗口置顶工具，精致小巧9KB无臃肿依赖，支持快捷键和系统托盘操作。

Windows，窗口置顶，窗体置顶，置顶，窗口钉，钉窗口，CSharp，C#，WinApi，DLL，User32

选中窗体，按下`Ctrl+Alt+Shift+D`置顶或取消置顶窗体。程序启动3秒后自动隐藏到任务栏托盘位置，最小化后也是隐藏到任务栏托盘位置。
![程序主界面](https://foruda.gitee.com/images/1744538179444086391/5ebbbb09_1969841.png "程序主界面")

![tuopan](imgs\tuopan.png)

## 功能特点

- **快捷键置顶**：选中窗口后按 `Ctrl+Alt+Shift+D` 快速置顶/取消置顶
- **窗口记录**：自动记录所有被置顶的窗口信息
- **右键菜单**：通过系统托盘图标管理置顶窗口
- **批量取消**：一键取消所有窗口置顶状态
- **自动清理**：程序退出时自动清理所有置顶状态

## 使用方法

### 基本操作

1. **置顶窗口**：
   - 选中需要置顶的窗口（使其获得焦点）
   - 按下快捷键 `Ctrl+Alt+Shift+D`
   - 窗口将保持在最前端显示

2. **取消置顶**：
   - 选中已置顶的窗口
   - 再次按下快捷键 `Ctrl+Alt+Shift+D`

### 系统托盘菜单

右键点击系统托盘图标，菜单分为两个区域：

#### 系统操作组
- **显示主界面**：显示程序主窗口
- **取消所有置顶**：取消所有已记录的窗口置顶状态

#### 窗口列表组
- 显示所有已置顶的窗口列表
- **左击**窗口项：激活并聚焦到该窗口
- **右击**窗口项：取消该窗口的置顶状态
- 无置顶窗口时显示"无置顶窗口"

### 退出程序

- 右键托盘图标 → 选择"退出"
- 或直接关闭主窗口

程序退出时会自动清理所有置顶状态，确保系统整洁。

## 编译说明

### 系统要求
- Windows 7 或更高版本
- .NET Framework 4.0 或更高版本

### 编译命令

使用C#编译器（csc.exe）编译：

```bash
# 找到csc.exe路径（通常在.NET Framework目录下）
# 例如：C:\Windows\Microsoft.NET\Framework\v4.0.30319\csc.exe

csc /target:winexe /out:WindowTopTools.exe window_top.cs

- /target:exe - 控制台应用程序（默认，会显示CMD窗口）
- /target:winexe - Windows应用程序（不显示CMD窗口）
```

## 技术实现

- **窗口置顶**：使用Win32 API `SetWindowPos` 实现
- **窗口信息获取**：结合 `GetWindowText` 和 `GetWindowModuleFileName` 获取窗口标题和程序名称
- **热键注册**：使用 `RegisterHotKey` 注册全局快捷键
- **系统托盘**：使用 `NotifyIcon` 实现系统托盘图标

## 注意事项

- 程序以管理员权限运行时效果最佳
- 某些系统窗口可能无法被置顶（如任务管理器等）
- 窗口关闭或程序退出后，置顶状态会自动清除
- 如果杀毒软件报毒请放行，源码可见，干净无毒。