Qt下使用QWebEngineView实现百度地图的显示

2024-06-19 前端 0

文章目录

前言
一、前期准备
二、HTML文件创建
三、实现步骤
四、示例完整代码
总结

前言

本文讲述了在Qt下使用QWebEngineView来加载HTML页面，实现该需求是需要连接网络的，这里进行了百度地图的嵌入显示，主要内容将结合相应的示例进行讲解，以便大家学习，如有错误之处，欢迎大家批评指正。

项目效果
请添加图片描述

提示：以下是本篇文章正文内容，下面案例可供参考

一、前期准备

下面是我的示例相关信息：

Qt构建环境：Qt5.14_MSVC2017_64bit地图文件：baiduMap.html交互工具：qwebchannel.js

这里的构建环境使用的是MSVC编译器，这样才能使用qwebengineview，在项目的pro文件中需要添加下列代码：

QT += webenginewidgets   #只有用msvc编译器才能使用qwebengineview

Qt与JS交互工具qwebchannel.js在Qt安装文件夹内直接找到，后面需要将地图文件和交互工具放到项目生成的exe同级目录下
请添加图片描述

二、HTML文件创建

这里与Qt进行交互的是百度地图API，并且要生成一个html类型的地图文件，
首先打开百度地图开放平台->进行注册登录->选择控制台->应用管理->我的应用->创建应用（如下图）->提交后获取应用AK(后面生成的HTML文件需要使用)
请添加图片描述
接下来可以在百度地图开放平台示例中心来生成地图文件，下面是我的示例的baiduMap.html文件内容，其中也有与Qt交互的代码介绍，注意其中的“您的AK密钥”要修改为上一步获取的应用AK哦

<!DOCTYPE html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><meta name="viewport" content="initial-scale=1.0, user-scalable=no" /><title>CanvasLayer</title><script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的AK密钥"></script><style type="text/css">body, html,#container {width: 100%;height: 100%;overflow: hidden;margin:0;font-family:"微软雅黑";}</style></head><body>    <div id="container"></div>     <!-- 创建一个地图容器元素container --></body></html><script src="qwebchannel.js"></script><script type="text/javascript">	//百度地图开放平台示例中心	//https://lbsyun.baidu.com/jsdemo.htm#uWalkNavPanel		//创建地图实例    var map = new BMap.Map("container");		//初始化地图,设置中心点坐标和地图级别	map.centerAndZoom(new BMap.Point(116.404,39.915),11);   //根据经纬度来设置中心点	//map.centerAndZoom('北京市',11);   //根据城市名来设置中心点		//开启鼠标滚轮缩放    map.enableScrollWheelZoom(true)		//添加平移缩放控件    map.addControl(new BMap.NavigationControl());		//添加缩略地图	map.addControl(new BMap.OverviewMapControl());	//添加比例尺控件	map.addControl(new BMap.ScaleControl());	//添加地图类型控件	map.addControl(new BMap.MapTypeControl());		//还可以添加自定义控件,参考下面这篇文章	//JS调用百度地图——添加基础控件	//https://blog.csdn.net/weixin_43445778/article/details/105481424		/**********************JS****************************/	//设置经纬度	function setPoint(lng,lat)	{		map.setCenter(new BMap.Point(lng,lat));	}		/**********************QT****************************/	//qt交互注册,myBridge相当于示例中的m_bridge    new QWebChannel(qt.webChannelTransport,function(channel) 	{        myBridge = channel.objects.bridge;    });		//监听地图的单击事件    map.addEventListener("click",function(e)	{        myBridge.getPoint(e.point.lng,e.point.lat);    });</script>

这里需要学习一下百度地图JavaScript API的使用，可以参考这篇文章：百度地图API基本使用（一）

三、实现步骤

下面引用内容来自这篇文章，创建工程的详细步骤也可以进行参考：Qt嵌入百度地图API的详细流程与常见问题

基本思路：
1.在界面中要创建网页容器QWebEngineView类，这是Qt提供的继承于QWidget类的一个窗口，使用时在.pro文件中要添加QT += webenginewidgets；
2.创建Qt与Html的连接通道QWebChannel,通过该通道可以实现主程序与网页之间的通信。当然，通道的建立是双方面的，即主程序和网页中都要进行相关操作；
3.通道建立完成即可实现主程序与网页之间的函数相互调用，并由此实现参数传递

这里是我的示例的初始化代码，其中的MyBridge类作为主程序和网页之间的"桥梁"，并通过信号与槽实现从网页接收数据：

void MainWindow::initWidget(){    //创建MyBridge对象用于与JS交互    m_bridge = new MyBridge();    //将单个对象注册到QWebChannel,注册名为bridge    QWebChannel *channel = new QWebChannel(this);    channel->registerObject(QString("bridge"),(QObject*)m_bridge);    ui->wg_map->page()->setWebChannel(channel);    //加载HTML文件    QString htmlPath = QCoreApplication::applicationDirPath() + "/baiduMap.html";    ui->wg_map->page()->load(QUrl(htmlPath));    //关联信号和槽函数    connect(m_bridge,&MyBridge::signal_showDate,this,&MainWindow::slot_showDate);}

发送按钮槽函数中通过runJavaScript函数实现地图上指定经纬度的跳转：

void MainWindow::on_pb_send_clicked(){    //调用HTML的setPoint函数    QString cmd = QString("setPoint(%1,%2)").arg(ui->le_longitude->text()).arg(ui->le_latitude->text());    ui->wg_map->page()->runJavaScript(cmd);}

四、示例完整代码

1.MyMap.pro

QT += core guiQT += webenginewidgets   #只有用msvc编译器才能使用qwebengineviewgreaterThan(QT_MAJOR_VERSION, 4): QT += widgetsCONFIG += c++11DEFINES += QT_DEPRECATED_WARNINGSSOURCES += /    main.cpp /    mainwindow.cpp /    mybridge.cppHEADERS += /    mainwindow.h /    mybridge.hFORMS += /    mainwindow.ui# Default rules for deployment.qnx: target.path = /tmp/$${TARGET}/binelse: unix:!android: target.path = /opt/$${TARGET}/bin!isEmpty(target.path): INSTALLS += target

2.mybridge.h

#ifndef MYBRIDGE_H#define MYBRIDGE_H#include<QObject>#include<QDebug>class MyBridge : public QObject{   Q_OBJECTpublic:    MyBridge();signals:    void signal_showDate(QString lng,QString lat);public slots:    void getPoint(QString lng,QString lat);};#endif // MYBRIDGE_H

3.mybridge.cpp

#include "mybridge.h"MyBridge::MyBridge(){}void MyBridge::getPoint(QString lng,QString lat){    emit signal_showDate(lng,lat);}

4.mainwindow.h

#ifndef MAINWINDOW_H#define MAINWINDOW_H#include <QMainWindow>#include <QWebEngineView>#include <QWebChannel>#include "mybridge.h"QT_BEGIN_NAMESPACEnamespace Ui { class MainWindow; }QT_END_NAMESPACEclass MainWindow : public QMainWindow{    Q_OBJECTpublic:    MainWindow(QWidget *parent = nullptr);    ~MainWindow();    void initWidget();private slots:    void slot_showDate(QString longitude,QString latitude);    void on_pb_send_clicked();private:    Ui::MainWindow *ui;    MyBridge *m_bridge;};#endif // MAINWINDOW_H

5.mainwindow.cpp

#include "mainwindow.h"#include "ui_mainwindow.h"MainWindow::MainWindow(QWidget *parent)    : QMainWindow(parent)    , ui(new Ui::MainWindow){    ui->setupUi(this);    this->initWidget();}MainWindow::~MainWindow(){    delete ui;}void MainWindow::initWidget(){    //创建MyBridge对象用于与JS交互    m_bridge = new MyBridge();    //将单个对象注册到QWebChannel,注册名为bridge    QWebChannel *channel = new QWebChannel(this);    channel->registerObject(QString("bridge"),(QObject*)m_bridge);    ui->wg_map->page()->setWebChannel(channel);    //加载HTML文件    QString htmlPath = QCoreApplication::applicationDirPath() + "/baiduMap.html";    ui->wg_map->page()->load(QUrl(htmlPath));    //关联信号和槽函数    connect(m_bridge,&MyBridge::signal_showDate,this,&MainWindow::slot_showDate);}void MainWindow::slot_showDate(QString longitude,QString latitude){    ui->le_longitude->setText(longitude);    ui->le_latitude->setText(latitude);}void MainWindow::on_pb_send_clicked(){    //调用HTML的setPoint函数    QString cmd = QString("setPoint(%1,%2)").arg(ui->le_longitude->text()).arg(ui->le_latitude->text());    ui->wg_map->page()->runJavaScript(cmd);}