關(guān)鍵字：ITravelLogStg, IEnumTravelLogEntry, ITravelLogEntry
1、概述
Internet Explorer的瀏覽歷史菜單在4.0版本開始出現(xiàn)，但直到5.5之前，微軟都未公布用于訪問瀏覽歷史的COM接口，如今已是IE6.0大行其道的年代，用于訪問瀏覽歷史的接口也早已公布多時(shí)，本文的目的則是試圖拋磚引玉，簡單介紹用于訪問瀏覽歷史的Travel Log接口，并用一個(gè)小小的類CIETravelLog來實(shí)現(xiàn)對(duì)Travel Log的封裝。
2、IOmHistory接口
在早些時(shí)候的MSDN中，我們能夠查閱到關(guān)于瀏覽歷史的接口僅有IOmHistory，而該接口實(shí)際上對(duì)應(yīng)的是瀏覽器中可以通過腳本訪問的“history”對(duì)象。對(duì)于“history”對(duì)象，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接口僅提供了有限的幾個(gè)方法來完成在瀏覽器中前進(jìn)、后退等操作，并沒有提供訪問歷史列表Url的能力。這也難怪，該接口在IE 3.0時(shí)代已經(jīng)存在，而當(dāng)時(shí)IE并不成熟，可編程能力也不甚強(qiáng)大。一直到IE 4.0通過與Windows 98捆綁銷售一統(tǒng)天下之后，相關(guān)的文檔才逐漸豐富，多窗口瀏覽器等基于Internet Explorer/WebBrowser Control的應(yīng)用軟件也才鋪天蓋地開來。但在IE 5.5接口公布之前，要完全模擬IE的Travel Log行為，并不是一件容易的事。最容易想到的方法就是在BeforeNavigate、DocumentComplete等事件發(fā)生之時(shí)記錄/修改Url并加以保存（我在早些時(shí)候也這樣做過），但是效果不甚理想，尤其是瀏覽包含F(xiàn)rame的網(wǎng)頁時(shí)，處理更是麻煩。當(dāng)然，要完全模擬亦非難事，只不過開發(fā)人員都知道微軟公布接口是早晚的事，所以也沒有人花大力氣在模擬IE的Travel Log行為上。
3、Travel Log簡介
Internet Explorer 5.5推出以后，Travel Log接口也就開始出現(xiàn)在MSDN中，它是專門為OLE嵌入WebBrowser Control的應(yīng)用程序設(shè)計(jì)的，其目的是“提高和加強(qiáng)用戶的訪問日志體驗(yàn)”（improve and enhance the user's travel log experience）。事實(shí)上，稍后我會(huì)提到，Travel Log接口正日益成為應(yīng)用程序中的重要接口之一。
微軟公布的Travel Log共包含三個(gè)接口：ITravelLogStg, IEnumTravelLogEntry和ITravelLogEntry。
- ITravelLogStg——該接口提供了用于在Travel Log中添加、刪除、枚舉日志（瀏覽歷史）的方法，本文需要用到的幾個(gè)方法列舉如下：
方法名 用途
EnumEntries 為訪問日志項(xiàng)創(chuàng)建枚舉器（IEnumTravelLogEntry接口指針）
GetRelativeEntry 返回一個(gè)日志項(xiàng)
TravelTo 訪問一個(gè)日志項(xiàng)
- IEnumTravelLogEntry——該接口提供用于枚舉日志項(xiàng)所必需的方法，本文只用到一個(gè)方法：
方法名 用途
Next 枚舉下一個(gè)日志項(xiàng)（返回ITravelLogEntry接口指針）
- ITravelLogEntry——該接口只有兩個(gè)方法，分別用于返回日志項(xiàng)的Title和Url：
方法名 用途
GetTitle 返回日志項(xiàng)的Title
GetURL 返回日志項(xiàng)的Url
接口準(zhǔn)備好了，我們也就很容易得知它們之間的關(guān)系：
- 要得到相對(duì)于當(dāng)前頁面的日志項(xiàng)列表，首先應(yīng)通過ITravelLogStg接口創(chuàng)建一個(gè)枚舉器（IEnumTravelLogEntry接口）。
- 通過IEnumTravelLogEntry枚舉器的Next方法枚舉出一個(gè)個(gè)的日志項(xiàng)（ITravelLogEntry接口）。
- 由ITravelLogEntry接口獲取日志項(xiàng)所代表的網(wǎng)頁的Title和Url并加以處理。
- 訪問相對(duì)于當(dāng)前頁面的某個(gè)日志項(xiàng)時(shí)，首先由ITravelLogStg的GetRelativeEntry方法根據(jù)與當(dāng)前頁的距離得到ITravelLogEntry接口，再將后者傳入ITravelLogStg的TravelTo方法以達(dá)到訪問日志項(xiàng)的目的（如前進(jìn)和后退）。
也許不是太恰當(dāng)，我對(duì)UML也不熟悉，借用一個(gè)偽UML序列圖表示其關(guān)系如下：
4、封裝Travel Log
接下來，我們就用一個(gè)簡單的類來完成對(duì)Travel Log的封裝。如下所示，tlogstg.h包含了Travel Log的相關(guān)接口聲明，該頭文件可以在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的實(shí)例
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();
}
}
//創(chuàng)建瀏覽歷史菜單，bForward指明是前進(jìn)還是后退菜單
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條歷史菜單，可根據(jù)實(shí)際情況修改
{
LPOLESTR pszTitle;
m_pTravalLogEntry->GetTitle( &pszTitle );
CString strTitle = pszTitle;
if ( bForward )
{
//ID_IEHISTORY_MIDDLE是預(yù)定義的某個(gè)菜單項(xiàng)ID，從該ID開始前后可以創(chuàng)建10個(gè)菜單項(xiàng)，參見下一節(jié)
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();
}
}
}
//根據(jù)與當(dāng)前頁面的相對(duì)距離來訪問歷史網(wǎng)頁
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
假設(shè)是在我們自己編寫的多窗口瀏覽器中使用Travel Log。為簡單起見，我們聲明一個(gè)CIETravelLog的全局對(duì)象g_IETravelLog，以便在任何地方調(diào)用。然后在適當(dāng)?shù)牡胤剑鏑MainFrame的TBN_DROPDOWN消息（工具條菜單下拉消息）處理函數(shù)OnDropDown中，添加下面的代碼，用以創(chuàng)建瀏覽歷史菜單：
//GetActiveWebBrowserPtr返回活動(dòng)的瀏覽器IWebBrowser2接口指針
IETravelLog.SetWebBrowser( GetActiveWebBrowserPtr );
//bForward為true則創(chuàng)建“前進(jìn)”菜單，否則創(chuàng)建“后退”菜單
IETravelLog.BuildHistoryMenu( &Menu, 10, bForward);
以下定義為菜單項(xiàng)ID的范圍，前后共可以容納10個(gè)菜單項(xiàng)，可根據(jù)實(shí)際情況修改。
#define ID_IEHISTORY_FIRST 60200
#define ID_IEHISTORY_MIDDLE 60210
#define ID_IEHISTORY_LAST 60220
添加命令處理函數(shù)OnTravelHistoryUrl用以響應(yīng)從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即為要訪問的瀏覽歷史到當(dāng)前頁面的距離
g_IETravelLog.TravelTo( nID - ID_IEHISTORY_MIDDLE );
}
6、再談Travel Log
前面我提到“Travel Log接口正日益成為應(yīng)用程序中的重要接口之一”，此處加以說明。從微軟平臺(tái)的開發(fā)模式及導(dǎo)向來看，基于Internet Explorer/WebBrowser Control的應(yīng)用勢必會(huì)成為主流。在下一代的操作系統(tǒng)Longhorn中，應(yīng)用程序界面的描述將完全由XML的一個(gè)特化——XAML來完成，而XAML的解析將由瀏覽器完成。微軟說未來應(yīng)用程序的部署將會(huì)十分容易，本地應(yīng)用和基于瀏覽器的應(yīng)用之間的差異將會(huì)被逐漸淡化，而實(shí)現(xiàn)這一目標(biāo)的一個(gè)重要表現(xiàn)就是，在將來的操作系統(tǒng)平臺(tái)上，應(yīng)用程序?qū)嶋H上時(shí)刻都將運(yùn)行在Internet Explorer中，Internet Explorer在某種程度上來說變成了一個(gè)容器。
于是，扎根于Internet Explorer的Travel Log自然而然地就被整合到了我們的應(yīng)用程序中。君不見，我們每天在資源管理器和瀏覽器上完成的工作，不就是在Travel Log中來來回回地跑嗎？如果所有的應(yīng)用程序都嵌入到Internet Explorer中運(yùn)行，那么我們?cè)趹?yīng)用程序中所作的操作便自然得到了記錄，“前進(jìn)”和“后退”也就很Easy了。
很多軟件都已經(jīng)或多或少地開始采用基于Internet Explorer的模式，如Microsoft Money、Microsoft Encarta、Visual Studio.net的安裝程序等等，都是很好的范例。所以，就目前來說，將我們的應(yīng)用程序按這種模式編寫（可參考《利用瀏覽器實(shí)現(xiàn)程序界面與實(shí)現(xiàn)的分離》），不是可以早一點(diǎn)獲得“訪問日志的體驗(yàn)”嗎？
何樂而不為。
引用地址：《Internet Explorer 編程簡述（八）實(shí)現(xiàn)瀏覽歷史菜單》
Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=308620