Wednesday, January 12, 2005

 

Use IE in pure SDK environment

By 土星站了一晚
From http://blog.csdn.net/lsaturn/archive/2004/07/20/46061.aspx

因为工作关系,需要在sdk下面嵌入一个web浏览器,但是程序是sdk开发的,网上有很多文章,但是都是设计mfc的,后来在网友帮助下面得到了两种实现方法.

1.是基于atl的:

#include
CComModule _Module;
#include
#pragma comment(lib,"atl")


int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd )

{

MSG msg;


//初始化com和atl
CoInitialize(NULL);
AtlAxWinInit();

HWND hwnd = CreateDialog(hInstance, MAKEINTRESOURCE(IDD_UNLIMITED), 0, MainDlgProc);
if(!hwnd)
{
MessageBox(NULL, TEXT("Fail to create the dialog!"),
"Test", MB_ICONERROR);
return 0;
}

ShowWindow(hwnd, SW_SHOW);

while(GetMessage(&msg, NULL, 0, 0))
{
if(hwnd == 0 || !IsDialogMessage(hwnd, &msg))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
CoUninitialize();
return msg.wParam;
}


BOOL CALLBACK MainDlgProc(HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam)
{

RECT rc;
IWebBrowser2* WebBrowser;
VARIANT varMyURL;
static CAxWindow WinContainer;//这个是atl提供的com容器

switch(message)
{
case WM_INITDIALOG:
rc.top = 8;
rc.left = 8;
rc.bottom = 250;
rc.right = 180;
WinContainer.Create(hDlg, rc, LPCTSTR("Microsoft.IExplorer.4"),
WS_CHILD|WS_VISIBLE|WS_VSCROLL );//create a browser control
WinContainer.QueryControl( __uuidof(IWebBrowser2), (void**)&WebBrowser);
VariantInit(&varMyURL);
varMyURL.vt = VT_BSTR;
#ifndef UNICODE
{
wchar_t *buffer;
DWORD size;

size = MultiByteToWideChar(CP_ACP, 0, "www.xxx.com", -1, 0, 0);
if (!(buffer = (wchar_t *)GlobalAlloc(GMEM_FIXED, sizeof(wchar_t) * size))) return FALSE;
MultiByteToWideChar(CP_ACP, 0, "www.xxx.com", -1, buffer, size);
varMyURL.bstrVal = SysAllocString(buffer);
GlobalFree(buffer);
}
#else
varMyURL.bstrVal = SysAllocString("www.xxx.com");
#endif
WebBrowser->Navigate2(&varMyURL, 0, 0, 0, 0);

VariantClear(&varMyURL);
WebBrowser->Release();

break;
}//end switch(message)
return FALSE;
}

2.
下面是一个英文文章的翻译,出处是
http://www.codeguru.com/Cpp/I-N/ieprogram/article.php/c4379/

如何在Win32下面使用纯C来显示一个web页面
作者:Jeff Glatt
时间:December 12, 2002
环境:Win32, VC6 (推荐但不是必须), IE 4.0 + (或者其它一些支持OLE在线编辑自动化 的其它浏览器).

介绍:
在网上有很多文章介绍了如何在自己的程序中嵌入一个IE浏览器。但是这些文章的例子一般都是基于MFC,.NET,C#或者至少是WTL,因为这些框架本身就做了大量的工作使你可以轻松的嵌入一个浏览器。但是如果你仅仅使用纯C和Win32的话(甚至不用C++),那么这些例子对你来说就没有什么用处。这篇文章就是教你如何在纯C和Win32环境下面嵌入一个浏览器的,更普遍来说的话就是教你如何在纯C和Win32环境下面和OLE/COM对象进行交互并且创建自己的OLE/COM对象。
我甚至在我给出了已经编译好了的DLL,只要你愿意你甚至不用和任何OLE/COM打交道,你仅仅需要调用它的引出函数就可以显示一个web页面,除非你想要修改源代码。
使用Static, Edit, Listbox, Combobox等等windows的标准控件,你可以获得这些控件的句柄(比如HWND),通过SendMessage来传递消息就可以控制它们,并且当这些控件想传给一些信息或一些数据的时候它也会给你消息(它们会把消息放到窗口的消息队列里面,你可以通过GetMessage来获得这些消息).
但对于OLE/COM对象并不是这样的。你和它们之间不存在消息交流。OLE/COM对象会给你一些函数指针,通过这些函数指针你就可以控制这些对象。比如IWebBrowser2对象就给出一个函数指针使你可以读取并在你的程序中显示某个页面。反过来,如果OLE/COM对象想要给你一些数据或者通知,你需要写一些函数,并把这些函数指针提供给OLE/COM对象,这样OLE/COM对象可以通过调用这些函数来完成数据传输或者事件通知。换句话说,你在自己的程序中定制某个OLE/COM对象。所以,在纯C中最麻烦的是如何使嵌入的OLE/COM对象能够与你的程序充分的交互。
总的说来,就是你调用OLE/COM对象中的函数,OLE/COM对象在你的程序中调用你提供的函数。就好象是调用DLL的导出函数,但这个DLL也能调用你C程序中条工的函数(有点类似于回调函数)。但是和DLL不同的是,你不需要使用 LoadLibrary()和 GetProcAddress()来获得某个COM对象的函数,而是通过系统函数来获得某个对象的指针,然后通过这个对象来获得它的函数指针。
OLE/COM对象和它的VTable
简单来说,一个COM对象确实就是一个包含一些可以被外部调用的函数指针的C结构。这些指针必须是该结构的第一个成员变量,之后可以是一些其它的数据,但是函数指针必须是第一个成员变量。这个大家必须注意(因为我们将要在我们的C程序中创建自己的OLE/COM对象,所以你必须要了解如何声明和建立一个COM"结构")。
实际上,这第一个成员变量是一个指向另外一个结构的指针,在这个结构中才真正存放了那些函数指针。本质上来说,这个二级结构实际上就是一个存放了这些不同的函数指针的数组。我们把这个数组称为VTable。另外VTable中的前三个函数指针必须是这三个特定的函数指针:QueryInterface(), AddRef(), 和Release()(当你创建你自己的对象的时候,你可以随便起什么名字,只要这个函数符合稍后提到的规则)。
下面是这三个函数的定义:

HRESULT STDMETHODCALLTYPE QueryInterface(IUnknown FAR* This,
REFIID riid, LPVOID FAR* ppvObj);
HRESULT STDMETHODCALLTYPE AddRef(IUnknown FAR* This);
HRESULT STDMETHODCALLTYPE Release(IUnknown FAR* This);

我们来看看这些参数和HRESULT到底是些什么意思。
OLE/COM对象的第一个成员变量必须是指向VTable的指针,VTable中至少要包含QueryInterface(), AddRef(), 和Release()三个函数指针(它们都跟IUnknown接口有关),并且三者都要像我上面给出的原型一样定义。
这里有个我称为“MyObject”的关于OLE/COM对象的最简单的例子,我先定义了一个称为“MYOBJECT_VTBL”的VTable结构,然后再定义“MyObject”对象。

/* This is the VTable for MYOBJECT. It must start out with at
* least the following three pointers.
*/
struct MYOBJECT_VTBL {
(HRESULT STDMETHODCALLTYPE *)QueryInterface(IUnknown FAR* This,
REFIID riid, LPVOID FAR* ppvObj);
(HRESULT STDMETHODCALLTYPE *)AddRef(IUnknown FAR* This);
(HRESULT STDMETHODCALLTYPE *)Release(IUnknown FAR* This);
/* There would be other pointers here if this object had more
* functions. */
}

/* This is the MYOBJECT structure */
struct MYOBJECT {
/* The first thing in the object must be a pointer
* to its VTable! */
struct MYOBJECT_VTBL *lpVtbl;

/* The Object may have other embedded objects here, or some
* private data.
* But all that must be after the above VTable pointer.
*/
}

从例子可见,一个COM对象第一个成员变量总是指向它的VTable的指针,而且VTable的前三个指针一般命名为QueryInterface, AddRef,和Release,一个对象有哪些函数指针取决于这个对象的功能,比如一个浏览器对象的函数指针绝对和一些播放音乐的对象的函数指针不一样,但是所有的OLE/COM对象的第一个成员变量总是指向它的VTable的指针,而且VTable的前三个指针总是为QueryInterface, AddRef,和Release,这是规则,你只能遵守。
当你创建你自己的COM对象,你必须要把这三个“IUnknown”函数在你的函数里面实现。比如,你可能有名为MyQueryInterface(), MyAddRef(),和MyRelease()的如下三个函数:

HRESULT STDMETHODCALLTYPE MyQueryInterface(IUnknown FAR* This,
REFIID riid, LPVOID FAR* ppvObj)
{
return(S_OK);
}

HRESULT STDMETHODCALLTYPE MyAddRef(IUnknown FAR* This)
{
return(S_OK);
}

HRESULT STDMETHODCALLTYPE MyRelease(IUnknown FAR* This)
{
return(S_OK);
}

同时你要把你的COM对象用这三个函数指针来初始化,下面是我们把名为“MYOBJECT”COM对象的VTabel用名为“ExampleTable”的MYOBJECT_VTBL结构进行初始化的例子:

int main()
{
struct MYOBJECT Example;
struct MYOBJECT_VTBL ExampleTable;

ExampleTable.QueryInterface = MyQueryInterface;
ExampleTable.AddRef = MyAddRef;
ExampleTable.Release = MyRelease;
Example.lpVtbl = &ExampleTable;
}

现在我们创建了一个Vtabel被正确初始化了的OLE/COM对象(就是例子中的Example),现在我们要做的就是把这个结构的指针传递给相关的系统函数,这样其他的对象(比如浏览器对象)可以调用我们的C编译的可执行文件中的MyQueryInterface(), MyAddRef(),和MyRelease()函数,听起来还不错吧?

QueryInterface(), AddRef(),和Release()
我们除了上面的还有些东西需要知道。让我们看看这三个函数的定义,你就会发现这三个函数的第一个参数都是IUnknown结构的指针。这里我们需要把这些定义根据我们的MYOBJECT对象来修改如下:

HRESULT STDMETHODCALLTYPE QueryInterface(MYOBJECT FAR* This,
REFIID riid, LPVOID FAR* ppvObj);
HRESULT STDMETHODCALLTYPE AddRef(MYOBJECT FAR* This);
HRESULT STDMETHODCALLTYPE Release(MYOBJECT FAR* This);

我们的MYOBJECT_VTBL应该像下面这样:

struct MYOBJECT_VTBL {
(HRESULT STDMETHODCALLTYPE *QueryInterface)(MYOBJECT FAR*
This, REFIID riid, LPVOID FAR*
ppvObj);
(HRESULT STDMETHODCALLTYPE *)AddRef(MYOBJECT FAR* This);
(HRESULT STDMETHODCALLTYPE *)Release(MYOBJECT FAR* This);
}

你可能会有疑问“是不是上面说的意思是这三个函数的第一个参数都应该是MYOBJECT结构的指针?”确实,我就是这个意思。比如当我们把MYOBJECT对象Example传递给浏览器对象,并且这个浏览器对象要通过Example来调用MyQueryInterface(),这样第一个参数就是Example的指针。这样我们就可以知道是结构的哪个实例在调用MyQueryInterface()。此外我们可以在这个结构的后面添加一些关于实例独立的成员变量。这样我们就不需要使用任何全局变量,就保证了结构的可重入性----我们可以生成任意多的这个结构的实例。
你可能会叫到:“等等!现在这样看起来有点像是C++了。这个传入的结构的指针好象是C++中类的对象中暗含的'this'指针。”你真是天才,什么都被你说中了。这个正是COM建立的基础。这样你就可以用C代码来有效的实现C++的类而不用背负一些C++的额外负担。
综上,(在COM中)你的一个函数被调用的时候,第一个参数总是包含VTable的结构或者对象的指针。这是对C+类机制的模拟,对COM机制的模拟。
你获得一个COM对象的指针以后,比如说一个浏览器对象吧,你就可以用上面类似的方法来调用对象的成员函数。你可以通过对象的VTable来找到你想要的函数。调用这些函数的时候第一个参数总是这个COM对象的指针。

COM的基本类型(BSTR和VARIANT)
你可能会认为有点复杂。这里还有个难以理解的地方。许多OLE/COM对象都是被设计为语言无关的(就是任何语言都可以使用)。为了这个目的COM对象就必须试图把数据类型进行抽象。我这么说是什么意思呢?拿ANSI C的string来说明吧,一个C的string是一系列以0结尾的8bit字节串,但是在Pascal中string并不是这样的。Pascal中string的开始有一个byte存储了后面所跟的字节数。也就是Pascal的string是从一个表示长度的字节开始,后面就是实际的字符,这样它的结尾就不是也没有必要是0了。那么Unicode又是怎么保存的呢?一个Unicode的每个字符都是用两个byte来储存(或者是C的short类型)。
为了支持所有的语言以及每个语言的扩展类型,COM对象总是使用可以使用于每个语言的COM基本类型。比如如果一个COM要传递一个string总是使用BSTR类型。什么是BSTR?可以认为它是一种Pascal的Unicode string,每个字符都是用两个字节来保存,并且在string的开始用一个无符号short来保存后面所跟的short个数。这样可以使“string”类型在所有语言都适用。但是这也意味着当你把C string传递给一个COM对象的时候你必须要把它变成BSTR。幸运的使操作系统本身就提供了SysAllocString来帮助完成这种转换。
当然还有其他的COM基本类型,比如能通过某种方式来储存数值以便在各种语言中都能使用的基本类型。
实际中有些COM对象需要操作各种各样的数据类型,它们使用另外一种称之为Variant的结构。比如我们假设有一个有Print()成员函数的Printer类。并且Print()可以接受各种数据并进行打印。如果传递一个string给它它就可以把string打印出来,如果传递一个DWORD给它它就先把DWORD转换为string然后打印这个string。因此Print()需要知道传递给它的是string还是DWORD。因此我们可以使用VARIANT来包装这个string(或者说BSTR)和DWORD以及各种各样的类型。我们需要根据传递来的类型设置这个VARIANT的vt成员变量,BSTR的话把它设置为VT_BSTR,DWORD的话把它设置为VT_DECIMAL。这样Print()就能根据传进来的VARIANT的vt成员变量来判断该采取怎样的操作。
综上,当你操作某个COM对象的时候(比如我们的浏览器对象),你可能需要转换/填充原来的类型到COM的基本类型,甚至可能需要使用VARIANT类型。

你的IStorage/IOleInPlaceFrame/IOleClientSite/IOleInPlaceSite对象
现在你已经知道了一些COM的背景知识,让我们继续看看你需要什么来使浏览器COM对象运行起来。在你读了下面的文章之后你就会熟练的使用CWebPage.c中的源代码了。
首先,你要提供四个对象给浏览器对象:IStorage, IOleInPlaceFrame, IOleClientSite, 和IOleInPlaceSite。这是四个结构,每个都有自己的VTable,这些结构和他们的VTable都在头文件中用C定义好了。他们每个都有自己的一系列成员函数。
让我们先看看IStorage对象,它定义了称为IStorageVtbl的Vtable结构。在这个VTable中一共有18个函数指针(也就是说IStorage本身就有18个特定的函数,这也是为什么大家更多的使用MFC,.NET,WTL以便来使工作更简单轻松)。当然前三个函数也必须为QueryInterface(), AddRef(),和Release()。在CWebPage.c中我把这三个函数命名为Storage_QueryInterface(), Storage_AddRef(),和Storage_Release(),后面的15个方程我都是用Storage_来开头的,它们是Storage_OpenStream(), Storage_CopyTo()等等,IStorage的函数的作用是管理程序和磁盘的读写的,具体的作用和参数可以参考MSDN关于IStorage的文档。
所以创建IStorage的最简单的办法是把它声明为全局变量,并且用18个函数指针来初始化它,我的代码如下:

IStorageVtbl MyIStorageTable = {Storage_QueryInterface,
Storage_AddRef,
Storage_Release,
Storage_CreateStream,
Storage_OpenStream,
Storage_CreateStorage,
Storage_OpenStorage,
Storage_CopyTo,
Storage_MoveElementTo,
Storage_Commit,
Storage_Revert,
Storage_EnumElements,
Storage_DestroyElement,
Storage_RenameElement,
Storage_SetElementTimes,
Storage_SetClass,
Storage_SetStateBits,
Storage_Stat};

现在我就有了一个全局的初始化好了的IStorage的VTable----MyIStorageTable。
下一步就是创建我的IStorage对象。最简单的还是把它声明为全局的变量并且初始化它,它只有一个VTable:

IStorage MyIStorage = { &MyIStorageTable };

现在就有了IStorage的被初始化好了的全局对象MyIStorage。现在操作系统的函数随时可以调用这个对象并把它交给浏览器对象这样它就可以调用上面的18个函数了。在CWebPage.c里面也可以找到这18个函数。(实际上很多函数都是空函数,因为浏览器对象并不会使用它,但是我们还是提供了一些存根来占位,以便有些聪明人利用我们源代码来实现它自己的代码)。
在CWebPage.c中,我把其他对象的VTable也设置为了全局变量,有的对象我也添加了一些成员变量。值得注意的是,我把成员变量都是添加在VTable指针的后面,这个非常重要,Vtable指针必须在第一位。另外这些成员变量是窗口相关的,因此对于不同的窗口我都需要不同的IOleInPlaceFrame, IOleClientSite, 和IOleInPlaceSite结构。基于这个原因当我创建一个窗口我都会为它分配相应的一系列对象(或者我可以在AddRef中为每个实例分配这些对象,但是这样做的话在初始化这些对象的时候会很复杂,所以我并没有这么来做)。
IOleInPlaceFrame, IOleClientSite, 和IOleInPlaceSite的VTable你可以查询MSDN,在CWebPage.c中,我只使用了显示web页面所需的函数。



<< Home

This page is powered by Blogger. Isn't yours?