# 基于QLabel的ImageViewer

**Repository Path**: erith/label-image-viewer

## Basic Information

- **Project Name**: 基于QLabel的ImageViewer
- **Description**: 基于QLabel开发的图像显示控件。
支持Ctrl+O打开、按键C居中显示全图、鼠标滚轮缩放、鼠标拖拽平移、按K键切换以视口中心还是鼠标点作为缩放中心（默认以鼠标点）。可替代QLabel嵌入其他项目。
- **Primary Language**: C++
- **License**: LGPL-2.1
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2022-03-02
- **Last Updated**: 2025-06-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LabelImageViewer

#### 介绍
基于QLabel开发的图像显示控件，支持居中显示全图、以鼠标点位中心滚轮缩放、鼠标拖拽平移。

#### 软件架构
实现了QLabel的派生类LabelImageViewer

#### 安装教程

1.  用QtCreator打开Pro文件即可编译使用。
2.  或用vs新建空项目，加入src/label_image_viewer.h和label_image_viewer.cpp文件，配置好qt库的include和lib目录，编译生成exe，放到qt的bin路径下可执行（或已经将qt的bin目录加入环境变量则无需放入）。

#### 使用说明

1.  将h和cpp文件加入用户项目，注释掉cpp尾部的main函数。
2.  用LabelImageViewer替换掉用来显示图像的QLabel.
3.  在LabelImageViewer的父窗口（比如对话框）响应按钮或按键时调用LabelImageViewer的公共槽函数，如open、fitToWindow、switchMode、showImage。
4.  若要屏蔽鼠标滚轮和拖拽，可以调用语句labelImageViewer->setAttributes(Qt::WA_TransparentForMouseEvents);
5.  功能列表
Ctrl+O     弹出打开图片对话框
C          居中显示全图并保持比例
K          切换缩放中心为label中心还是鼠标点，默认是鼠标点
鼠标滚轮   缩放
鼠标拖拽   平移


#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)