關鍵字：itravellogstg, ienumtravellogentry, itravellogentry

1、概述

internet explorer的瀏覽歷史菜單在4.0版本開始出現，但直到5.5之前，微軟都未公布用于訪問瀏覽歷史的com接口，如今已是ie6.0大行其道的年代，用于訪問瀏覽歷史的接口也早已公布多時，本文的目的則是試圖拋磚引玉，簡單介紹用于訪問瀏覽歷史的travel log接口，并用一個小小的類cietravellog來實現對travel log的封裝。

2、iomhistory接口

在早些時候的msdn中，我們能夠查閱到關于瀏覽歷史的接口僅有iomhistory，而該接口實際上對應的是瀏覽器中可以通過腳本訪問的“history”對象。對于“history”對象，msdn中是這樣說的：

for security reasons, the history object does not expose the actual urls in the browser history. it does allow navigation through the browser history by exposing the back, forward, and go methods. a particular document in the browser history can be identified as an index relative to the current page. for example, specifying -1 as a parameter for the go method is the equivalent of clicking the back button.

this object is available in script as of microsoft internet explorer 3.0.

即為了安全的原因，iomhistory接口僅提供了有限的幾個方法來完成在瀏覽器中前進、后退等操作，并沒有提供訪問歷史列表url的能力。這也難怪，該接口在ie 3.0時代已經存在，而當時ie并不成熟，可編程能力也不甚強大。一直到ie 4.0通過與windows 98捆綁銷售一統天下之后，相關的文檔才逐漸豐富，多窗口瀏覽器等基于internet explorer/webbrowser control的應用軟件也才鋪天蓋地開來。但在ie 5.5接口公布之前，要完全模擬ie的travel log行為，并不是一件容易的事。最容易想到的方法就是在beforenavigate、documentcomplete等事件發生之時記錄/修改url并加以保存（我在早些時候也這樣做過），但是效果不甚理想，尤其是瀏覽包含frame的網頁時，處理更是麻煩。當然，要完全模擬亦非難事，只不過開發人員都知道微軟公布接口是早晚的事，所以也沒有人花大力氣在模擬ie的travel log行為上。

3、travel log簡介

internet explorer 5.5推出以后，travel log接口也就開始出現在msdn中，它是專門為ole嵌入webbrowser control的應用程序設計的，其目的是“提高和加強用戶的訪問日志體驗”（improve and enhance the user's travel log experience）。事實上，稍后我會提到，travel log接口正日益成為應用程序中的重要接口之一。

微軟公布的travel log共包含三個接口：itravellogstg, ienumtravellogentry和itravellogentry。

itravellogstg——該接口提供了用于在travel log中添加、刪除、枚舉日志（瀏覽歷史）的方法，本文需要用到的幾個方法列舉如下：
方法名     用途

enumentries 為訪問日志項創建枚舉器（ienumtravellogentry接口指針）

getrelativeentry 返回一個日志項

travelto 訪問一個日志項

ienumtravellogentry——該接口提供用于枚舉日志項所必需的方法，本文只用到一個方法：
方法名     用途

next   枚舉下一個日志項（返回itravellogentry接口指針）

itravellogentry——該接口只有兩個方法，分別用于返回日志項的title和url：
方法名     用途

gettitle 返回日志項的title

geturl 返回日志項的url

接口準備好了，我們也就很容易得知它們之間的關系：

要得到相對于當前頁面的日志項列表，首先應通過itravellogstg接口創建一個枚舉器（ienumtravellogentry接口）。
通過ienumtravellogentry枚舉器的next方法枚舉出一個個的日志項（itravellogentry接口）。
由itravellogentry接口獲取日志項所代表的網頁的title和url并加以處理。
訪問相對于當前頁面的某個日志項時，首先由itravellogstg的getrelativeentry方法根據與當前頁的距離得到itravellogentry接口，再將后者傳入itravellogstg的travelto方法以達到訪問日志項的目的（如前進和后退）。

也許不是太恰當，我對uml也不熟悉，借用一個偽uml序列圖表示其關系如下：

4、封裝travel log

接下來，我們就用一個簡單的類來完成對travel log的封裝。如下所示，tlogstg.h包含了travel log的相關接口聲明，該頭文件可以在platform sdk中找到。

#include "tlogstg.h"
class cietravellog
{
private:
itravellogstg *m_ptravellogstg;
ienumtravellogentry *m_penumlogentry;
itravellogentry *m_ptravallogentry;
iwebbrowser2* m_pwebbrowser;
public:
cietravellog(void);
~cietravellog(void);
void setwebbrowser(iwebbrowser2* pwebbrowser);
void buildhistorymenu(cmenu * pmenu, unsigned char ncount, bool bforward);
void travelto(int nposition);
};
cietravellog::cietravellog(void)
: m_ptravellogstg(null), m_penumlogentry(null), m_ptravallogentry(null), m_pwebbrowser(null)
{
}
cietravellog::~cietravellog(void)
{
if ( m_ptravellogstg != null )
{
m_ptravellogstg->release();
}
if ( m_penumlogentry != null )
{
m_penumlogentry->release();
}
if ( m_ptravallogentry != null )
{
m_ptravallogentry->release();
}
if ( m_pwebbrowser != null )
{
m_pwebbrowser->release();
}
}
//將瀏覽器的iwebbrowser2接口指針賦予cietravellog的實例
void cietravellog::setwebbrowser(iwebbrowser2* pwebbrowser)
{
if ( (m_pwebbrowser == pwebbrowser) || (m_pwebbrowser == null) )
{
return;
}
if ( m_pwebbrowser != null )
{
m_pwebbrowser->release();
}
m_pwebbrowser = pwebbrowser;
iserviceprovider *psp;
hresult hr = m_pwebbrowser->queryinterface(iid_iserviceprovider, (lpvoid*)&psp);
m_pwebbrowser->release();
if (succeeded(hr))
{
hr = psp->queryservice(sid_stravellogcursor, iid_itravellogstg, (lpvoid*)&m_ptravellogstg);
psp->release();
}
}
//創建瀏覽歷史菜單，bforward指明是前進還是后退菜單
void cietravellog::buildhistorymenu(cmenu * pmenu, unsigned char ncount, bool bforward)
{
if ( m_ptravellogstg == null )
{
return;
}
tlenumf eflag = bforward ? tlef_relative_fore : tlef_relative_back;
if ( failed(m_ptravellogstg->enumentries( eflag, &m_penumlogentry ) ) )
{
return;
}
ulong ufetched;
int i=0;
if ( m_penumlogentry !=null )
{
while ( succeeded( m_penumlogentry->next( 1, &m_ptravallogentry, &ufetched ) ) &&
m_ptravallogentry && i<10 )//我們最多只需要10條歷史菜單，可根據實際情況修改
{
lpolestr psztitle;
m_ptravallogentry->gettitle( &psztitle );
cstring strtitle = psztitle;
if ( bforward )
{
//id_iehistory_middle是預定義的某個菜單項id，從該id開始前后可以創建10個菜單項，參見下一節
pmenu->insertmenu( 0, mf_string, id_iehistory_middle + ++i, strtitle );
}
else
{
pmenu->insertmenu( 0, mf_string, id_iehistory_middle - ++i, strtitle );
}
cotaskmemfree( psztitle );
m_ptravallogentry->release();
}
}
}
//根據與當前頁面的相對距離來訪問歷史網頁
void cietravellog::travelto(int nposition)
{
if ( m_ptravellogstg == null )
{
return;
}
if succeeded(m_ptravellogstg->getrelativeentry( nposition, &m_ptravallogentry ))
{
m_ptravellogstg->travelto( m_ptravallogentry );
}
}

5、使用cietravellog

假設是在我們自己編寫的多窗口瀏覽器中使用travel log。為簡單起見，我們聲明一個cietravellog的全局對象g_ietravellog，以便在任何地方調用。然后在適當的地方，如cmainframe的tbn_dropdown消息（工具條菜單下拉消息）處理函數ondropdown中，添加下面的代碼，用以創建瀏覽歷史菜單：

//getactivewebbrowserptr返回活動的瀏覽器iwebbrowser2接口指針

ietravellog.setwebbrowser( getactivewebbrowserptr );

//bforward為true則創建“前進”菜單，否則創建“后退”菜單

ietravellog.buildhistorymenu( &menu, 10, bforward);

以下定義為菜單項id的范圍，前后共可以容納10個菜單項，可根據實際情況修改。

#define id_iehistory_first  60200

#define id_iehistory_middle 60210

#define id_iehistory_last   60220

添加命令處理函數ontravelhistoryurl用以響應從id_iehistory_first到id_iehistory_last的菜單命令。

on_command_range(id_iehistory_first, id_iehistory_last, ontravelhistoryurl)
void cmainframe::ontravelhistoryurl(uint nid /* command id */)
{
//nid - id_iehistory_middle即為要訪問的瀏覽歷史到當前頁面的距離
g_ietravellog.travelto( nid - id_iehistory_middle );
}

6、再談travel log

前面我提到“travel log接口正日益成為應用程序中的重要接口之一”，此處加以說明。從微軟平臺的開發模式及導向來看，基于internet explorer/webbrowser control的應用勢必會成為主流。在下一代的操作系統longhorn中，應用程序界面的描述將完全由xml的一個特化——xaml來完成，而xaml的解析將由瀏覽器完成。微軟說未來應用程序的部署將會十分容易，本地應用和基于瀏覽器的應用之間的差異將會被逐漸淡化，而實現這一目標的一個重要表現就是，在將來的操作系統平臺上，應用程序實際上時刻都將運行在internet explorer中，internet explorer在某種程度上來說變成了一個容器。

于是，扎根于internet explorer的travel log自然而然地就被整合到了我們的應用程序中。君不見，我們每天在資源管理器和瀏覽器上完成的工作，不就是在travel log中來來回回地跑嗎？如果所有的應用程序都嵌入到internet explorer中運行，那么我們在應用程序中所作的操作便自然得到了記錄，“前進”和“后退”也就很easy了。

很多軟件都已經或多或少地開始采用基于internet explorer的模式，如microsoft money、microsoft encarta、visual studio.net的安裝程序等等，都是很好的范例。所以，就目前來說，將我們的應用程序按這種模式編寫（可參考《利用瀏覽器實現程序界面與實現的分離》），不是可以早一點獲得“訪問日志的體驗”嗎？何樂而不為。