formExtractor: 在QtWebkit的javascript访问QObject的例子

http://hi.baidu.com/331703405/blog/item/82de913cb7d0773171cf6cd6.html

formExtractor: 在QtWebkit的javascript访问QObject的例子

2010-05-17 11:09

现在写这个题目晚了点， QtWebkit一度是个比较火的话题（当然目前仍然很火）， 这个formExtractor应该是在4.5的时候就存在于Qt的例子里了(QTDIR/examples/webkit /formextractor)， 只是仔细看过这个例子的人估计还比较少。 这里简单分析一下这个例子， 算是给做webkit开发的人提供个扫盲性质的指导。

闲话少说， 先来看一个formExtractor的截图。

相关文件包括：

formextractor.pro
formextractor.ui
formextractor.h
formextractor.cpp
main.cpp
mainwindow.h
form.html
formextractor.qrc

整个程序的基本界面是用Designer设计的formextractor.ui文件， 左边白色背景的部分放了个QWebView, webview里显示的内容是一个html页面， 里面放了一个form；右边是普通的QWidget， 里面放了若干QLabel、QLineEdit等控件。 formextractor.cpp/.h是ui文件对应的窗体类， 用的是单继承的方式。 （关于如何在Qt程序中使用ui文件， 参考以前的blog文章：Qt4中ui文件的使用方法）

mainwindow.cpp/.h是程序的主窗体， 作为formextractor的父窗体并提供菜单， 这两个文件与本文主题无关， 可以直接忽略不看。（另外截图上也没体现出来这个菜单， 不知道这个例子的文档是谁写的， 这么无厘头。）

form.html是个比较简单的html文件，里面放了一个form，并在按下提交按钮时调用formExtractor对象的submit方法。

简单介绍了一下工程的结构， 下面就是具体的代码了。 其实说到底， 在QtWebkit的javascript里访问QObject的最关键的关键就是下面这个方法：

void QWebFrame::addToJavaScriptWindowObject ( const QString & name, QObject * object )

我们要在js调用该QObject之前调用这个函数。 这个时机不好掌握， 不过我们可以按文档的建议， 把这个函数放在一个signal的槽里调用。 代码如下：

///   in constructor ///
connect(ui.webView->page()->mainFrame(), SIGNAL(javaScriptWindowObjectCleared()),
this, SLOT(populateJavaScriptWindowObject()));
///   slot     
void FormExtractor::populateJavaScriptWindowObject()
{
ui.webView->page()->mainFrame()->addToJavaScriptWindowObject(“formExtractor”, this);
}

addToJavaScriptWindowObject的第一个参数是对象在javascript里的名字， 可以自由命名， 第二个参数是对应的QObject实例指针。 这样在javascript里就可以直接访问formExtractor对象拉， 就像在Qt里访问这个formExtractor一样， 是不是看上去超级简单？ 当然事情不会总是怎么简单的。 如果我们翻开Qt文档关于addToJavaScriptWindowObject的说明就会发现， 还有一点非常重要的内容在文档中仅仅是一笔带过， 不注意看很可能就错过了重要的信息：

Make object available under name from within the frame’s JavaScript context. The object will be inserted as a child of the frame’s window object.

Qt properties will be exposed as JavaScript properties and slots as JavaScript methods.

有没有意识到蓝色字体显示的这句话意味着什么呢？ 大概聪明的同学们都已经意识到了吧。 要想在js里调用Qt的方法， 还有一个重要的条件需要满足， 那就是把这个方法声明为槽函数， 普通的函数是不行的! 要想在js里直接访问到QObject的成员， 该成员必须定义为属性才行! 而这个QObject不一定非得是QWidget， 可以是任何QObject及其派生类的实例。 满足了上面的条件我们就可以在js里调用formExtractor的函数啦:

 

这里和调用任何js的变量和函数都是一致的， 具体看看js的语法就行了。

在Qt代码里同样可以访问webview页面中的内容， 如formExtractor的submit方法里就利用form元素的名字来找到该QWebElement进而得到它的值并显示在自己的窗体控件里， 代码如下：

void FormExtractor::submit()
{
QWebFrame *frame = ui.webView->page()->mainFrame();

QWebElement firstName = frame->findFirstElement(“#firstname”);
QWebElement lastName = frame->findFirstElement(“#lastname”);
QWebElement maleGender = frame->findFirstElement(“#genderMale”);
QWebElement femaleGender = frame->findFirstElement(“#genderFemale”);
QWebElement updates = frame->findFirstElement(“#updates”);

ui.firstNameEdit->setText(firstName.evaluateJavaScript(“this.value”).toString());
ui.lastNameEdit->setText(lastName.evaluateJavaScript(“this.value”).toString());

if (maleGender.evaluateJavaScript(“this.checked”).toBool())
ui.genderEdit->setText(maleGender.evaluateJavaScript(“this.value”).toString());
else if (femaleGender.evaluateJavaScript(“this.checked”).toBool())
ui.genderEdit->setText(femaleGender.evaluateJavaScript(“this.value”).toString());

if (updates.evaluateJavaScript(“this.checked”).toBool())
ui.updatesEdit->setText(“Yes”);
else
ui.updatesEdit->setText(“No”);
}

javascript和QtWebkit的交互就是怎么简单。

顺便再说两句题外话。 Qt自带的例子很多， 而且呈现越来越多的趋势， 要想在这一堆例子里找到和自己的需求符合的有点麻烦， 一个一个例子编译运行未免太罗嗦了。 grep关键字当然是一个不错的主意。 这里再推荐一个更直观的方法， 先到Qt文档网站上浏览关于Qt例子的文档。 该文档按照Qt的类将例子程序归档， 基本上每个例子都提供了截图、代码样例和代码分析， 很容易一眼看到自己需要的东西， 比到代码里瞎翻方便多了。
例子文档的地址是： http://doc.trolltech.com/4.6/examples.html