QDesktopServices简介(QT打开网页或者资源管理器)

偏执的太偏执、 2022-09-03 13:15 1005阅读 0赞

**目录**

1.理论介绍

2.打开资源管理器

3.打开网页

4.自定义QDesktopServices::openUrl的行为

--------------------

# 1.理论介绍 #

QDesktopServices类提供了访问常见桌面服务的方法。

许多桌面环境提供的服务可被应用程序用于执行常见任务，如打开网页，其方式既一致又考虑到用户的应用程序偏好。

该类包含为这些服务提供简单接口的函数，这些接口指示服务是否成功。

函数的作用是:打开外部应用程序中位于任意url的文件。对于与本地文件系统上的资源对应的URL (URL方案为“file”)，将使用一个合适的应用程序来打开文件;否则，将使用web浏览器来获取和显示文件。

用户的桌面设置控制是否打开某些可执行文件类型进行浏览，或者是否执行它们。一些桌面环境被配置为禁止用户执行从非本地url获取的文件，或者在执行文件之前要求用户的许可。

**URL处理程序**

openUrl()函数的行为可以针对单个URL方案进行定制，以允许应用程序覆盖特定类型URL的默认处理行为。

分派机制只允许对每个URL方案使用一个自定义处理程序;这是使用setUrlHandler()函数设置的。每个处理程序都实现为一个槽，它只接受一个QUrl参数。

可以使用unsetUrlHandler()函数删除每个方案的现有处理程序。这将给定模式的处理行为返回为默认行为。

这理论描述可能比较抽象，本文第4节有实例，请结合起来看。

# 2.打开资源管理器 #

#include "QDesktopServices"
    #include "QUrl"
    
    //在资源管理器中打开某个文件夹
    QDesktopServices::openUrl(QUrl("file:///C:/Program Files", QUrl::TolerantMode));

**运行结果**：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70][]

**\[static\] bool QDesktopServices::openUrl(const QUrl & url)**

在用户桌面环境的合适Web浏览器中打开给定的url，如果成功返回true;否则返回false。

如果URL是对本地文件的引用(即，URL链接是"file"开头)，那么它将用合适的应用程序而不是Web浏览器打开。

上图中代码调用了1个QUrl的构造函数，其第2个参数可选值如下：

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:bottom;width:74pt;">Constant</td> 
 <td style="text-align:left;vertical-align:bottom;width:56pt;">Value</td> 
 <td style="vertical-align:bottom;width:497pt;">Description</td> 
 </tr> 
 <tr> 
 <td style="vertical-align:bottom;">QUrl::TolerantMode</td> 
 <td style="text-align:left;vertical-align:bottom;">0</td> 
 <td style="vertical-align:bottom;width:497pt;">QUrl将试图纠正一些常见的错误的url。这种模式对于解析来自不完全符合标准的源的url非常有用。</td> 
 </tr> 
 <tr> 
 <td style="vertical-align:bottom;">QUrl::StrictMode</td> 
 <td style="text-align:left;vertical-align:bottom;">1</td> 
 <td style="vertical-align:bottom;width:497pt;">只接受有效的url。这种模式对于一般的URL验证很有用。</td> 
 </tr> 
 <tr> 
 <td style="vertical-align:bottom;">QUrl::DecodedMode</td> 
 <td style="text-align:left;vertical-align:bottom;">2</td> 
 <td style="vertical-align:bottom;width:497pt;">QUrl将以完全解码的形式解释URL组件，其中百分比字符代表它们自己，而不是百分比编码序列的开始。此模式仅对URL的setter设置组件有效;在QUrl构造函数、infromEncoded()或setUrl()中是不允许的。有关此模式的更多信息，请参阅文档中的QUrl::FullyDecoded。</td> 
 </tr> 
 </tbody> 
</table>

# 3.打开网页 #

#include "QDesktopServices"
    #include "QUrl"
    
    //调用默认浏览器打开一个网页链接
    QDesktopServices::openUrl(QUrl("https://www.baidu.com/", QUrl::TolerantMode));

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70 1][]

# 4.自定义QDesktopServices::openUrl的行为 #

#include "QMessageBox"
    #include "QUrl"
    
    class MyHelpHandler : public QObject
    {
    	Q_OBJECT
    public:
    
    	public slots:
    		void showHelp(const QUrl &url)
    		{
    			QMessageBox mgsBox;
    			mgsBox.setText(url.toString());
    			mgsBox.exec();
    		}
    };

#include "desktopservicestest.h"
 #include <QtWidgets/QApplication>
 #include "QDesktopServices"
 #include "MyHelpHandler.h"
 
 MyHelpHandler handler;
 
 int main(int argc, char *argv[])
 {
 	QApplication a(argc, argv);
 
 	QDesktopServices::setUrlHandler("help", &handler, "showHelp");
 	QDesktopServices::openUrl(QUrl("help://showthisword/", QUrl::TolerantMode));
 
 	return a.exec();
 }

**运行结果**：

![20210808154601919.png][]

上面代码中我们定义了一个MyHelpHandler类和showHelp函数，这里的类名和函数名可以随便取，但是有如下两点要注意：

*  新创建的类要是QObject的子类
 *  新创建的函数的参数必须是const QUrl &url

代码的运行原理如下：

使用QDesktopServices::setUrlHandler指定调用QDesktopServices::openUrl时，程序将跳转到哪个函数去执行。上面的实例代码中，指定了当程序调用QDesktopServices::openUrl时，会在openUrl内部调用MyHelpHandler::showHelp。

解释了这么多，你可能还不明白，那么接着往下看吧。  
**\[static\] void QDesktopServices::setUrlHandler(const QString & scheme, QObject \* receiver, const char \* method)**

将给定方案的处理程序设置为接收方对象提供的处理程序方法。

这个函数提供了一种自定义openUrl()行为的方法。如果使用指定方案的URL调用openUrl()，则调用接收方对象上的给定方法，而不是QDesktopServices启动外部应用程序。

提供的方法必须实现为只接受单个QUrl参数的槽。

如果setUrlHandler()用于为已经有处理程序的方案设置新的处理程序，则现有的处理程序将简单地用新的处理程序替换。由于QDesktopServices不获得处理程序的所有权，因此在替换处理程序时不会删除对象。

注意，处理程序总是在调用QDesktopServices::openUrl()的线程中被调用。

请参见openUrl()和unsetUrlHandler()。

**\[static\] void QDesktopServices::unsetUrlHandler(const QString & scheme)**

移除先前为指定方案设置的URL处理程序。

参见setUrlHandler()。

这里补充说一下QDesktopServices::setUrlHandler的3个参数：

*  const QString & scheme：方案名称，我们这里假设方案名称为**plan**
 *  QObject \* receiver：一个类的实例对象的指针，我们这里假设类名为**A**
 *  const char \* method：取代QDesktopServices::openUrl()默认行为的一个**A**类的成员函数

还要补充说一下如何让QDesktopServices::setUrlHandler生效：

*  先调用setUrlHandler再调用openUrl
 *  然后要保证url是以**plan**开头的，因为我们调用setUrlHandler指定的方案名是“**plan**”
 *  url中不要加空格

例如

class A
    {
    
    };
    
    A objA;
    
    QDesktopServices::setUrlHandler("plan", &objA, "showHelp");
    QDesktopServices::openUrl(QUrl("plan://showthisword/", QUrl::TolerantMode));

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70]: /images/20220829/0563cfc658244d288aab1d91610f06c0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70 1]: /images/20220829/4634f6b28f9d4b7ab54396e46b0fdc94.png
[20210808154601919.png]: /images/20220829/2de7d1ba74df45e1b6d16b6a9a5a95d0.png