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