1) 该结构其实是FrameLoaderClientQt::createFrame接口的参数集合
PassRefPtr<Frame> FrameLoaderClientQt::createFrame
(const KURL& url, const String& name,
HTMLFrameOwnerElement* ownerElement,
const String& referrer, bool allowsScrolling,
int marginWidth, int marginHeight)
2) url记录网页请求的url,在发起网络请求的时候调用,和referer一起,作为ResourceRequest的参数
1) name:frametree的名字,调用WebCore::Frame->loader()àload的时候会用到
2) ownerElement::当前帧的元素指针,在创建子帧的时候,会作为子帧的父帧存在,调用Frame::create的时候会用到。如果是第一次创建,初始化为0。
3) referrer:请求的referer。
4) allowsScrolling:是否允许滚动
5) marginWidth:留边的宽度
6) marginHeight:留边的高度
Note:这个结构体应该是可要可不要的,其实从代码上来看,不要这个结构体可能对代码的理解上会更好一些。仅仅在FrameLoaderClient::createFrame接口中调用相应的接口更好。
1) horizontalScrollBarPolicy和verticalScrollBarPolicy描述了滚动条的滚动策略,在qt的实现中,初始化为Qt::ScrollBarAsNeeded,这个值会在MG_Frame:: createView的时候转化成ScrollbarMode作为参数传入。
2) QWebFrame和QWebFramePrivate是相互包含的关系,可以理解为QWebFrame将私有成员封装到了QWebFramePrivate类中,两个类之间相互索引,QWebFramePrivate类通过q成员可以访问qwebframe,qwebframe类通过d成员包含QWebFramePrivate类。Qwebframe在初始化的时候调用QWebFramePrivate::init设置QWebFrameData的q成员。
3) frameLoaderClient:这个成员其实可以从该类中去除,qwebframe或者QWebFramePrivate都不需要记录改变量,frameLoaderClient只是在QWebFramePrivate::int创建WebCore::Frame时需要作为参数创建的。
4) frame:初始化(init)的时候调用Frame::create创建出来的内核Frame。静态接口QWebFramePrivate::core可以返回该成员。
5) page:qwebpage和qwebframe是包含关系,一个qwebpage可以包含几个qwebframe,qwebpage通过mainFrame可以访问到主帧,再通过主帧就能访问到所有子帧。而qwebframe通过QWebFramePrivate的page成员访问到qwebpage类。在qwebframe的构造函数中初始化这个成员。
6) allowsScrolling,marginWidth,marginHeight这三个成员在目前的移植中没有任何作用。
7) parentFrame接口返回父帧。
8) 静态接口QWebFramePrivate::kit提供了通过内核WebCore::Frame指针得到qwebframe的方式。这个接口为什么不放到qwebframe类而放到QWebFramePrivate类,搞不懂。
9) horizontalScrollBar返回内核WebCore::Scrollbar指针,WebCore::Scrollbar类是将滚动条中同平台无关的属性抽象出来形成了一个类,这个接口提供了访问这些属性的一个方法。verticalScrollBar类似。
10)renderPrivate:这是非常重要的一个接口。当平台触发控件或者区域刷新的时候(paintEvent),会调用主帧的render函数,也就调用到renderPrivate,在该接口中调用WebCore::FrameView的layoutIfNeededRecursive接口进行排版,然后再调用paint或者paintContents进行绘制。