缩略图视图：

 幻灯片视图：

单张图片视图：

功能菜单：

全屏播放模式：

关于本程序：

Windows的图片浏览器大家都用过，可以查看当前文件夹下的图片，往上翻、往下翻并且自动播放。在这一节里，Jungle将用Qt来设计这么一个图片浏览器，实现以下功能：

①浏览电脑里的文件夹，将当前文件夹下的图片列表罗列出来；

②鼠标点击列表上的某一张图片，图片将显示出来；

③可以控制浏览当前图片的上一张和下一张；

④实现自动播放的开始和停止控制。

其实总的思路可以分为两步走：

（1）浏览图片文件并显示为列表；

（2）显示图片。
1.实现环境
vs2008+Qt4.8.6+C++
2.UI设计

3.类的设计和说明
具体需要实现以下小步骤：

lineEdit_currentPath里输入当前文件夹路径（如“C:/”），在listWidget里按序显示当前文件夹下的图片文件列表；
鼠标点击列表上某张图，label里显示该图；
按钮“上一张”“下一张”实现图片转换；
自动播放通过QTimer实现，合理定时；

因此我们设计类如下：

#include <QtGui/QWidget>
#include <QDebug>
#include "ui_PictureBrowser.h"
///字符编码
#include <QTextCodec> 
///图标
#include <QIcon>
///目录
#include <QDir>
///定时器
#include <QTimer>
///图片
#include <QPixmap>
class PictureBrowser : public QWidget
{
	Q_OBJECT
public:
	PictureBrowser(QWidget *parent = 0, Qt::WFlags flags = 0);
	~PictureBrowser();
	///在QListWidget里显示当前目录下的明细
	void showFileInfoList(QFileInfoList pInfoList);
	///根据文件性质获取图标
	///iType=1:文件夹
	///iType=2:文件
	QIcon *getItemPropertyIcon(int iType);
	///显示当前图片
	void showPicture(int num);
public slots:
	///显示当前目录下的文件夹和文件
	void showCurrentDirFiles();
	///显示鼠标双击的列表里的文件夹下的文件
	void showNextDirFiles(QListWidgetItem *item);
	///上一张图片
	void showLastPicture();
	///下一张图片
	void showNextPicture();
	///自动播放
	void autoPlayPicture();
	///鼠标点击列表时显示
	void playCurrentItem(QListWidgetItem* item);
private:
	Ui::PictureBrowserClass ui;
	///自动播放定时器
	QTimer *timer;
	///当前文件夹的路径
	QString currentDirPath;
	///当前文件夹里的图片文件数量
	int numofPic;
};
#endif // PICTUREBROWSER_H

需要说明两个变量：

①QString currentDirPath：这个保存当前文件夹的绝对路径，用于初始化图片QPixmap；

②int numofPic：该变量统计当前文件夹下的图片总数量，用于操作“上一张”“下一张”时判断是否是第一张图或者最后一张图。
4.浏览图片文件并显示为列表
这部分的实现与Jungle在之前的一篇文章《Qt文件浏览器》（https://blog.csdn.net/sinat_21107433/article/details/80143750）设计和实现思路路一样，本文不再赘述。

具体作改变的在函数showFileInfoList（QFileInfoList pInfoList）里：
void PictureBrowser::showFileInfoList(QFileInfoList pInfoList)
{
	numofPic = 0;
	ui.listWidget->clear();
	for(int i=0;i<pInfoList.size();i++)
	{
		QFileInfo tmpInfo = pInfoList.at(i);
		QString pFileName = tmpInfo.fileName();
		QListWidgetItem *tmpItem = new QListWidgetItem(pFileName);
		if(tmpInfo.isDir())
			tmpItem->setIcon(*getItemPropertyIcon(1));
		else
		{
			tmpItem->setIcon(*getItemPropertyIcon(2));
			///获取文件后缀名
			QString suffix = tmpInfo.suffix();
			///只选取*.jpg,*.png格式文件
			if(suffix.indexOf("jpg")<0 && suffix.indexOf("png")<0)
				continue;
			else
				numofPic++;
		}
		ui.listWidget->addItem(tmpItem);
	}
}

改动部分的目的是为了统计当前文件夹里图片文件的总数，并保存至变量numofPic。

另外，在showCurrentDirFiles()函数里同样增加了更新变量currentDirPath的操作：
void PictureBrowser::showCurrentDirFiles()
{
	//获取当前输入的目录
	QDir currentDir(ui.lineEdit_currentPath->text());
	QStringList fileList;
	fileList<<"*";
	QFileInfoList infoList = currentDir.entryInfoList(fileList,QDir::AllEntries,QDir::DirsFirst);
	//在QListWidget里显示文件列表
	this->showFileInfoList(infoList);

	//记录当前路径
	if(!infoList.isEmpty())
	{
		this->currentDirPath = infoList[0].absoluteFilePath();
		qDebug()<<currentDirPath;
	}
}

5.需要说明的Qt类

QTimer：定时器，通过setInterval()函数设置溢出频率，单位为毫秒;每达到设定的间隔，QTimer对象会发送timeout(）信号，通过用户定义的槽函数则会执行，以此来实现定时控制；
QPixmap：本文通过此类来实现加载和显示图片，将其显示在QLabel上；
QListWidget和QListWidgetItem：这两个类在上一篇文章（《Qt文件浏览器》）里介绍有，大家也可以查阅Qt帮助文档。

6.实现
#include "PictureBrowser.h"

PictureBrowser::PictureBrowser(QWidget *parent, Qt::WFlags flags)
	: QWidget(parent, flags)
{
	ui.setupUi(this);

	QTextCodec *codec = QTextCodec::codecForName("System");

	QTextCodec::setCodecForTr(codec);

	QTextCodec::setCodecForLocale(codec);
	QTextCodec::setCodecForCStrings(codec);

	currentDirPath = "";
	numofPic = 0;

	///初始化定时器
	timer = new QTimer(this);
	///设定播放时间间隔
	timer->setInterval(1500);///1.5s

	///文件浏览器槽函数
	connect(ui.lineEdit_currentPath,SIGNAL(returnPressed()),this,SLOT(showCurrentDirFiles()));
	connect(ui.listWidget,SIGNAL(itemDoubleClicked(QListWidgetItem*)),this,SLOT(showNextDirFiles(QListWidgetItem*)));

	///显示图片槽函数
	connect(ui.pushButton_lastPicture,SIGNAL(clicked()),this,SLOT(showLastPicture()));
	connect(ui.pushButton_nextPicture,SIGNAL(clicked()),this,SLOT(showNextPicture()));
	connect(ui.pushButton_autoPlay,SIGNAL(clicked()),this,SLOT(autoPlayPicture()));
	connect(ui.listWidget,SIGNAL(itemClicked(QListWidgetItem*)),this,SLOT(playCurrentItem(QListWidgetItem*)));

	///自动播放
	connect(this->timer,SIGNAL(timeout()),this,SLOT(showNextPicture()));
}
PictureBrowser::~PictureBrowser()
{
}

这里说明一点QTextCodec，加载字符编码，这个Jungle在之后的文章里再详细介绍。
void PictureBrowser::playCurrentItem(QListWidgetItem* item)
{
	QString strName = item->text();
	if(strName.indexOf("jpg")>=0 || strName.indexOf("png")>=0)
	{
		///获取当前图片的绝对路径
		QPixmap pic(currentDirPath+"/"+strName);
		ui.label->setScaledContents(true);
		ui.label->setPixmap(pic);
	}
}

显示上一张图片
void PictureBrowser::showLastPicture()
{
	///获取当前图片在当前文件夹中的索引
	int currentIndex = ui.listWidget->currentRow();
	
	if(currentIndex!=2)
	{
		///当前图片不是第一张,则显示上一张
		showPicture(currentIndex-1);
		///鼠标移动至上一张
		ui.listWidget->setCurrentRow(currentIndex-1);
	}
	else
	{
		///当前图片是第一张，则显示最后一张
		showPicture(numofPic+1);
		///鼠标移动至上一张
		ui.listWidget->setCurrentRow(numofPic+1);
	}
}

显示下一张图片
void PictureBrowser::showNextPicture()
{
	///获取当前图片在当前文件夹中的索引
	int currentIndex = ui.listWidget->currentRow();

	if(currentIndex!=numofPic+1)
	{
		///当前图片不是最后一张，则显示下一张
		showPicture(currentIndex+1);
		///鼠标移动至下一张
		ui.listWidget->setCurrentRow(currentIndex+1);
	}
	else
	{
		///当前图片是最后一张，则显示第一张
		showPicture(2);
		///鼠标移动至下一张
		ui.listWidget->setCurrentRow(2);
	}
}

显示图片
void PictureBrowser::showPicture(int num)
{
	QListWidgetItem* item = ui.listWidget->item(num);
	QString strName = item->text();

	///获取当前图片的绝对路径
	QPixmap pic(currentDirPath+"/"+strName);
	ui.label->setScaledContents(true);
	ui.label->setPixmap(pic);
}

自动播放
void PictureBrowser::autoPlayPicture()
{
	QString str = ui.pushButton_autoPlay->text();
	if(str == "自动播放")
	{
		this->timer->start();
		showPicture(ui.listWidget->currentRow());
		ui.pushButton_autoPlay->setText("停止");
	}
	else
	{
		this->timer->stop();
		ui.pushButton_autoPlay->setText("自动播放");
	}
}

7.实现效果


点击“下一张”后：



这里Jungle愚钝，不知道如何在博客是上传视频。不过没关系，Jungle已将源码上传至CSDN下载资料里了，大家可以去看看，同时在Jungle的知乎专栏也有视频https://zhuanlan.zhihu.com/p/36476290！

欢迎关注知乎专栏：Jungle是一个用Qt的工业Robot

欢迎关注Jungle的微信公众号：Jungle笔记

简介： 

一个简单实用的图片浏览器,效果类似微信图片浏览器,支持弹出动画和回缩动画,支持多图浏览,支持本地和网络图片浏览,支持多种属性自定义(支持横竖屏)

一、XLPhotoBrowser描述

一个简单实用的图片浏览器,效果类似微信图片浏览器,支持弹出动画和回缩动画,支持多图浏览,支持本地和网络图片浏览,支持多种属性自定义(支持横竖屏浏览)

支持多种图片浏览样式

类似微信图片浏览样式XLPhotoBrowserStylePageControl , 底部有个pagecontrol显示图片索引 

类似微博图片浏览样式XLPhotoBrowserStyleIndexLabel , 上面有个UILabel显示图片索引 

简单样式XLPhotoBrowserStyleSimple , 上面有UILabel显示图片索引,左下部分有个保存按钮,可以保存当前图片




支持长按手势弹出多功能选择框,类似微博微信中的效果



二、 安装方法

第一种方法: 使用cocoapods自动安装



pod 'XLPhotoBrowser+CoderXL'

第二种方法：参考底部链接查看原文

三、 使用说明 
1，基本使用 

(提供2种传递数据的方法:图片以数组形式批量传递 和 数据源方法分开传递每一个位置的图片数据)

方法一:一行代码进入图片浏览器 在某些场景,例如只是想浏览一组本地/网络图片,你可以这样使用:



    // 传入图片数据源,直接进行图片浏览
    // 传入图片数据源数组self.images 可以是UIImage对象数组 ,可以是ALAsset对象, 也可以是图片的NSURL链接 , 或者是可以变成NSURL链接的NSString对象数组

    [XLPhotoBrowser showPhotoBrowserWithImages:self.images currentImageIndex:0];

方法二：如果上面直接提供图片数组的方式不适合,你可以考虑实现数据源方法,提供数据

数据源方法提供了三个,不同的需求效果需要搭配不同的方法使用.根据每个方法的注释说明和项目的需求来决定具体要实现哪几个方法



/**
 进入图片浏览器
 */
- (void)clickImage:(UITapGestureRecognizer *)tap
{
    [XLPhotoBrowser showPhotoBrowserWithCurrentImageIndex:tap.view.tag imageCount:self.images.count datasource:self];
}

#pragma mark    -   XLPhotoBrowserDatasource
/**
 *  返回这个位置的占位图片 , 也可以是原图
 *  如果不实现此方法,会默认使用placeholderImage
 *
 *  @param browser 浏览器
 *  @param index   位置索引
 *
 *  @return 占位图片
 */
- (UIImage *)photoBrowser:(XLPhotoBrowser *)browser placeholderImageForIndex:(NSInteger)index
{
    return self.images[index];
}

/**
 *  返回指定位置图片的UIImageView,用于做图片浏览器弹出放大和消失回缩动画等
 *  如果没有实现这个方法,没有回缩动画,如果传过来的view不正确,可能会影响回缩动画效果
 *
 *  @param browser 浏览器
 *  @param index   位置索引
 *
 *  @return 展示图片的容器视图,如UIImageView等
 */
- (UIView *)photoBrowser:(XLPhotoBrowser *)browser sourceImageViewForIndex:(NSInteger)index
{
    return self.scrollView.subviews[index];
}

/**
 *  返回指定位置的高清图片URL
 *  如果你要显示更高质量的图片,可以通过这个方法传递网络/本地图片路径实现效果
 *
 *  @param browser 浏览器
 *  @param index   位置索引
 *
 *  @return 返回高清大图索引
 */
- (NSURL *)photoBrowser:(XLPhotoBrowser *)browser highQualityImageURLForIndex:(NSInteger)index
{
    return [NSURL URLWithString:self.urlStrings[index]];
}

ps:下面的示例代码中如非必要,统一用第一种方式传递图片数组来展示

2，进阶使用说明(自定义多种属性等)

如何进行网络图片浏览 一行代码进入浏览,传递网络图片的地址数组进去即可



    // 1. NSURL数组
//    NSMutableArray *URLArray = [NSMutableArray array];
//    for (NSString *urlString in self.urlStrings) {
//        NSURL *URL = [NSURL URLWithString:urlString];
//        [URLArray addObject:URL];
//    }
//    [XLPhotoBrowser showPhotoBrowserWithImages:URLArray currentImageIndex:0];

    // 2.可以变成NSURL链接的NSString对象数组
    [XLPhotoBrowser showPhotoBrowserWithImages:self.urlStrings currentImageIndex:0];

或者用数据源方式,实现photoBrowser: highQualityImageURLForIndex:方法

- (void)clickImage:(UITapGestureRecognizer *)tap
{
    [XLPhotoBrowser showPhotoBrowserWithCurrentImageIndex:tap.view.tag imageCount:self.images.count datasource:self];
}

#pragma mark    -   XLPhotoBrowserDatasource
// 可以不实现此方法
- (UIImage *)photoBrowser:(XLPhotoBrowser *)browser placeholderImageForIndex:(NSInteger)index
{
    return self.images[index];
}
- (NSURL *)photoBrowser:(XLPhotoBrowser *)browser highQualityImageURLForIndex:(NSInteger)index
{
    return [NSURL URLWithString:self.urlStrings[index]];
}

如何添加长按手势并自定义选择菜单 

获取XLPhotoBrowser实例对象,调用 

setActionSheetWithTitle:delegate:cancelButtonTitle:deleteButtonTitle:otherButtonTitles:方法 

同时在 XLPhotoBrowserDelegate代理方法中监听到用户的选择



/**
 *  浏览图片
 *
 */
- (void)clickImage:(UITapGestureRecognizer *)tap
{
    XLPhotoBrowser *browser = [XLPhotoBrowser showPhotoBrowserWithImages:self.images currentImageIndex:tap.view.tag];
    browser.browserStyle = XLPhotoBrowserStyleIndexLabel; // 微博样式

        // 设置长按手势弹出的地步ActionSheet数据,不实现此方法则没有长按手势
    [browser setActionSheetWithTitle:@"这是一个类似微信/微博的图片浏览器组件" delegate:self cancelButtonTitle:nil deleteButtonTitle:@"删除" otherButtonTitles:@"发送给朋友",@"保存图片",@"收藏",@"投诉",nil];
}

#pragma mark    -   XLPhotoBrowserDelegate

- (void)photoBrowser:(XLPhotoBrowser *)browser clickActionSheetIndex:(NSInteger)actionSheetindex currentImageIndex:(NSInteger)currentImageIndex
{
    // do something yourself
    switch (actionSheetindex) {
        case 4: // 删除
        {
            NSLog(@"点击了actionSheet索引是:%zd , 当前展示的图片索引是:%zd",actionSheetindex,currentImageIndex);
            [self.images removeObjectAtIndex:currentImageIndex];
            [self resetScrollView];
        }
            break;
        case 1: // 保存
        {
            NSLog(@"点击了actionSheet索引是:%zd , 当前展示的图片索引是:%zd",actionSheetindex,currentImageIndex);
            [browser saveCurrentShowImage];
        }
            break;
        default:
        {
            NSLog(@"点击了actionSheet索引是:%zd , 当前展示的图片索引是:%zd",actionSheetindex,currentImageIndex);
        }
            break;
    }
}

如何选择浏览器样式 

获取到实例对象以后,设置browserStyle属性即可



    XLPhotoBrowser *browser = [XLPhotoBrowser showPhotoBrowserWithImages:self.images currentImageIndex:tap.view.tag];
    browser.browserStyle = XLPhotoBrowserStyleIndexLabel; // 微博样式

如何修改pagecontrol为缩放动画样式
仅在XLPhotoBrowserStylePageControl样式中有效, 在XLPhotoBrowserStyleIndexLabel样式无效
    // 自定义pageControl的一些属性
    browser.pageDotColor = [UIColor purpleColor]; ///< 此属性针对动画样式的pagecontrol无效
    browser.currentPageDotColor = [UIColor greenColor];
    browser.pageControlStyle = XLPhotoBrowserPageControlStyleClassic;///< 修改底部pagecontrol的样式为系统样式,默认是弹性动画的样式

如何实现类似微信那样点击图片进入浏览器时的图片放大和退出浏览时图片缩放的过渡动画 

实现数据源方法中的photoBrowser:sourceImageViewForIndex:方法,传递图片的容器视图,才可以做过渡动画



#pragma mark    -   XLPhotoBrowserDatasource

- (UIImage *)photoBrowser:(XLPhotoBrowser *)browser placeholderImageForIndex:(NSInteger)index
{
    return self.images[index];
}

- (UIView *)photoBrowser:(XLPhotoBrowser *)browser sourceImageViewForIndex:(NSInteger)index
{
    return self.scrollView.subviews[index];
}


注意：如何使用XLPhotoBrowserConfig,如何开启调试模式,输出格式化的提示信息,打开在XLPhotoBrowserConfig中的这个代码即可 //#define XLPhotoBrowserDebug 1 

还可以在这里修改很多样式属性,如:修改浏览器的背景色/图片间隔等 ,使用方式很简单,具体的使用就不在这里赘述

原文链接： 
https://github.com/CoderXLLau/XLPhotoBrowser#1xlphotobrowser描述

如果你是做网站或者以网上业务为主的全职工作者，一款好的图片浏览器能让你在工作的时候事半功倍。window系统的普通图片浏览功能并不具备图片优化和设计的功能，经常要借助一些辅助来实现，而图片浏览器工具就是其中一个不错的选择。今天给大家来介绍几款好用的图片浏览器。
IrfanView图片浏览器
IrfanView是一款经典的图片浏览器，现在依然被许多用户使用。它的开发人员甚至对新版本的操作系统也非常有用。你可以拥有许多新的实用功能。这是一个免费的图片浏览器。浏览速度非常快，可以快速打开图像。另外还可以优化你的图片，调整大小和旋转图像。
IrfanView具有基本的编辑工具，如裁剪，调整大小，消除红眼或旋转图像。通过IrfanView创建幻灯片显示和打印照片，更重要的是支持批处理。IrfanView不仅支持图像格式，还可播放音频和视频格式，它有多种语言版本。你可以扫描图像并直接从图片查看器打印，还支持幻灯片放映，并帮助你进行基本的图像编辑。
XnView图片浏览器
XnView是一个快速图像查看器，你也可以在便携版本中使用它。与IrfanView相比，图像渲染质量更好且速度更快，但它的大多数功能与IrfanView查看器相同。它支持大量图像格式，500多种图像格式。幻灯片功能也可用，它甚至可以让你捕捉你的屏幕。你可以在多种语言中使用XnView，有多语言版本。XnView可用于Linux和Windows操作系统，你可以使用它管理和自定义照片库。
Nomacs图片浏览器
Nomacs是一款免费的开源照片查看器，具有众多特性和功能。你几乎可以在每个操作系统上使用它。它支持几乎所有图像格式，包括RAW和PSD图像。Nomacs能够查看图像的元数据，缩略图和直方图。
另外你还可以使用Nomacs浏览zip或MS Offiice文件。它可以帮助你提高图像的亮度，将照片与调整工具进行对比。
FastStone Image Viewer图片浏览器
FastStone图片浏览器是一个快速，稳定和可靠的图片查看器，图像浏览器，图像编辑器和图像转换器。它是一个免费软件和开源工具。FastStone支持大量图像格式。它具有基本的编辑工具，可以帮助你裁剪，旋转，调整图像大小。它还可以消除图像中的红眼。拖放和复制或移动功能可供用户使用。FastStone图像查看器提供多功能屏幕捕获功能。此查看器中提供了不同的效果和过渡，你可以对图像应用多级撤消或重做。
Imagine图片浏览器
Imagine是一款非常快速和轻量级的图片浏览器。它是免费的第三方图像查看器。它支持大量图像格式。并且可以查看图像文件的详细信息。它支持ZIP，RAR，7Z，ALZ，HV3，CBZ，CBR和CB7文件，Imagine拥有多语言支持。
32位64位版本都可用。它可以帮助你捕获屏幕，创建动画。还支持批量转换。Imagine支持以幻灯片形式查看图片。
以上所有图片浏览器工具都是非常给力，可以免费作为window照片查看器的替代品。建议大家选择其中任何一款使用，因为所有这些都易于使用，并且可以快速查看图像。
如果你在网上找不到可以使用的版本，右上角关注我，点击我头像进去，点击私信 - 回复“图片浏览器”，打包给你这五款图片浏览器工具！