注册 登录
编程论坛 C++ Builder

TWebBrowser編程簡述

Knocker 发布于 2006-03-27 12:47, 3176 次点击

1、初始化和終止化(Initialization & Finalization)

  大家在執行TWebBrowser的某個方法以進行期望的操作,如ExecWB等的時候可能都碰到過“試圖激活未注冊的丟失目標”或“OLE對象未注冊”等錯誤,或者並沒有出錯但是得不到希望的結果,比如不能將選中的網頁內容復制到剪貼板等。以前用它編程的時候,我發現ExecWB有時侯起作用但有時侯又不行,在Delphi生成的缺省工程主窗口上加入TWebBrowser,運行時並不會出現“OLE對象未注冊”的錯誤。同樣是一個偶然的機會,我才知道OLE對象需要初始化和終止化(懂得的東東實在太少了)。
  我用我的前一篇文章《Delphi程序窗口動畫&正常排列平舖的解決》所說的方法編程,運行時出了上面所說的錯誤,我便猜想應該有OleInitialize之類的語句,於是,找到並加上了下面幾句話,終於搞定!究其原因,我想大概是由於TWebBrowser是一個嵌入的OLE對象而不算是用Delphi編寫的VCL吧。

  initialization
   OleInitialize(nil);
  finalization
   try
    OleUninitialize;
   except
   end;

  這幾句話放在主窗口所有語句之後,“end.”之前。

---------------------------------------------------------------------------------------------

2、EmptyParam

  在Delphi 5中TWebBrowser的Navigate方法被多次重載:

  procedure Navigate(const URL: WideString); overload;
  procedure Navigate(const URL: WideString; var Flags: OleVariant); overload;
  procedure Navigate(const URL: WideString; var Flags: OleVariant; var TargetFrameName:     OleVariant); overload;
  procedure Navigate(const URL: WideString; var Flags: OleVariant; var TargetFrameName:     OleVariant; var PostData: OleVariant); overload;
  procedure Navigate(const URL: WideString; var Flags: OleVariant; var TargetFrameName:     OleVariant; var PostData: OleVariant; var Headers: OleVariant); overload;

  而在實際應用中,使用後幾種方法調用時,由於我們很少用到後面幾個參數,但函數聲明又要求是變量參數,一般的做法如下:

  var
   t:OleVariant;
  begin
   webbrowser1.Navigate(edit1.text,t,t,t,t);
  end;

  需要定義變量t(還有很多地方要用到它),很麻煩。其實我們可以用EmptyParam來代替(EmptyParam是一個公用的Variant空變量,不要對它賦值),隻需一句話就可以了:

  webbrowser1.Navigate(edit1.text,EmptyParam,EmptyParam,EmptyParam,EmptyParam);

  雖然長一點,但比每次都定義變量方便得多。當然,也可以使用第一種方式。

  webbrowser1.Navigate(edit1.text)

---------------------------------------------------------------------------------------------

3、命令操作

  常用的命令操作用ExecWB方法即可完成,ExecWB同樣多次被重載:

  procedure ExecWB(cmdID: OLECMDID; cmdexecopt: OLECMDEXECOPT); overload;
  procedure ExecWB(cmdID: OLECMDID; cmdexecopt: OLECMDEXECOPT; var pvaIn:
    OleVariant); overload;
  procedure ExecWB(cmdID: rOLECMDID; cmdexecopt: OLECMDEXECOPT; var pvaIn:
    OleVariant; var pvaOut: OleVariant); overload;

  打開: 彈出“打開Internet地址”對話框,CommandID為OLECMDID_OPEN(若瀏覽器版本為IE5.0,
      則此命令不可用)。
  另存為:調用“另存為”對話框。
      ExecWB(OLECMDID_SAVEAS,OLECMDEXECOPT_DODEFAULT, EmptyParam,
           EmptyParam);


  打印、打印預覽和頁面設置: 調用“打印”、“打印預覽”和“頁面設置”對話框(IE5.5及以上版本才支持打
                印預覽,故實現應該檢查此命令是否可用)。
      ExecWB(OLECMDID_PRINT, OLECMDEXECOPT_DODEFAULT, EmptyParam,
           EmptyParam);
      if QueryStatusWB(OLECMDID_PRINTPREVIEW)=3 then
       ExecWB(OLECMDID_PRINTPREVIEW, OLECMDEXECOPT_DODEFAULT,
           EmptyParam,EmptyParam);
      ExecWB(OLECMDID_PAGESETUP, OLECMDEXECOPT_DODEFAULT, EmptyParam,
           EmptyParam);


  剪切、復制、粘貼、全選: 功能無須多說,需要注意的是:剪切和粘貼不僅對編輯框文字,而且對網頁上的非編
               輯框文字同樣有效,用得好的話,也許可以做出功能特殊的東東。獲得其命令使能狀
               態和執行命令的方法有兩種(以復制為例,剪切、粘貼和全選分別將各自的關鍵字替
               換即可,分別為CUT,PASTE和SELECTALL):
   A、用TWebBrowser的QueryStatusWB方法。
     if(QueryStatusWB(OLECMDID_COPY)=OLECMDF_ENABLED) or
      OLECMDF_SUPPORTED) then
      ExecWB(OLECMDID_COPY, OLECMDEXECOPT_DODEFAULT, EmptyParam,
           EmptyParam);
   B、用IHTMLDocument2的QueryCommandEnabled方法。
     var
      Doc: IHTMLDocument2;
     begin
      Doc :=WebBrowser1.Document as IHTMLDocument2;
      if Doc.QueryCommandEnabled('Copy') then
       Doc.ExecCommand('Copy',false,EmptyParam);
     end;

  查找: 參考第九條“查找”功能。

---------------------------------------------------------------------------------------------

4、字體大小

  類似“字體”菜單上的從“最大”到“最小”五項(對應整數0~4,Largest等假設為五個菜單項的名字,Tag 屬性分別設為0~4)。
   A、讀取當前頁面字體大小。
     var
      t: OleVariant;
     Begin
      WebBrowser1.ExecWB(OLECMDID_ZOOM, OLECMDEXECOPT_DONTPROMPTUSER,
       EmptyParam,t);
      case t of
      4: Largest.Checked :=true;
      3: Larger.Checked :=true;
      2: Middle.Checked :=true;
      1: Small.Checked :=true;
      0: Smallest.Checked :=true;
      end;
     end;
   B、設置頁面字體大小。
     Largest.Checked :=false;
     Larger.Checked :=false;
     Middle.Checked :=false;
     Small.Checked :=false;
     Smallest.Checked :=false;
     TMenuItem(Sender).Checked :=true;
     t :=TMenuItem(Sender).Tag;
     WebBrowser1.ExecWB(OLECMDID_ZOOM, OLECMDEXECOPT_DONTPROMPTUSER,
      t,t);

---------------------------------------------------------------------------------------------

5、添加到收藏夾和整理收藏夾

     const
     CLSID_ShellUIHelper: TGUID = '{64AB4BB7-111E-11D1-8F79-00C04FC2FBE1}';

    var
     p:procedure(Handle: THandle; Path: PChar); stdcall;

    procedure TForm1.OrganizeFavorite(Sender: Tobject);
    var
     H: HWnd;
    begin
     H := LoadLibrary(PChar('shdocvw.dll'));
     if H < > 0 then
     begin
    p := GetProcAddress(H, PChar('DoOrganizeFavDlg'));
      if Assigned(p) then p(Application.Handle, PChar(FavFolder));
     end;
     FreeLibrary(h);
    end;
    
    procedure TForm1.AddFavorite(Sender: TObject);
    var
     ShellUIHelper: ISHellUIHelper;
     url, title: Olevariant;
    begin
     Title := Webbrowser1.LocationName;
     Url := Webbrowser1.LocationUrl;
     if Url < > '' then
     begin
      ShellUIHelper := CreateComObject(CLSID_SHELLUIHELPER) as IShellUIHelper;
      ShellUIHelper.AddFavorite(url, title);
     end;
    end;

  用上面的通過ISHellUIHelper接口來打開“添加到收藏夾”對話框的方法比較簡單,但是有個缺陷,就是打開的窗口不是模式窗口,而是獨立於應用程序的。可以想象,如果使用與OrganizeFavorite過程同樣的方法來打開對話框,由於可以指定父窗口的句柄,自然可以實現模式窗口(效果與在資源管理器和IE中打開“添加到收藏夾”對話框相同)。問題顯然是這樣的,上面兩個過程的作者當時隻知道shdocvw.dll中DoOrganizeFavDlg的原型而不知道DoAddToFavDlg的原型,所以隻好用ISHellUIHelper接口來實現(或許是他不夠嚴謹,認為是否是模式窗口無所謂?)。
  下面的過程就告訴你DoAddToFavDlg的函數原型。需要注意的是,這樣打開的對話框並不執行“添加到收藏夾”的操作,它隻是告訴應用程序用戶是否選擇了“確定”,同時在DoAddToFavDlg的第二個參數中返回用戶希望放置Internet快捷方式的路徑,建立.Url文件的工作由應用程序自己來完成。

    procedure TForm1.AddFavorite(IE: TEmbeddedWB);
     procedure CreateUrl(AUrlPath, AUrl: PChar);
     var
      URLfile: TIniFile;
     begin
      URLfile := TIniFile.Create(String(AUrlPath));
     ▓RLfile.WriteString('InternetShortcut', 'URL', String(AUrl));
     ▓RLfile.Free;
     end;
    var
     AddFav: function(Handle: THandle;
      UrlPath: PChar; UrlPathSize: Cardinal;
      Title: PChar; TitleSize: Cardinal;
      FavIDLIST: pItemIDList): Bool; stdcall;
     FDoc: IHTMLDocument2;
     UrlPath, url, title: array[0..MAX_PATH] of char;
     H: HWnd;
     pidl: pItemIDList;
     FRetOK: Bool;
    begin
     FDoc := IHTMLDocument2(IE.Document);
     if FDoc = nil then exit;
     StrPCopy(Title, FDoc.Get_title);
     StrPCopy(url, FDoc.Get_url);
     if Url < > '' then
     begin
      H := LoadLibrary(PChar('shdocvw.dll'));
      if H < > 0 then
      begin
       SHGetSpecialFolderLocation(0, CSIDL_FAVORITES, pidl);
       AddFav := GetProcAddress(H, PChar('DoAddToFavDlg'));
       if Assigned(AddFav) then
        FRetOK :=AddFav(Handle, UrlPath, Sizeof(UrlPath), Title, Sizeof(Title), pidl)
      end;
      FreeLibrary(h);
      if FRetOK then
       CreateUrl(UrlPath, Url);
     end
    end;


---------------------------------------------------------------------------------------------

6、使WebBrowser獲得焦點

  TWebBrowser非常特殊,它從TWinControl繼承來的SetFocus方法並不能使得它所包含的文檔獲得焦點,從而不能立即使用Internet Explorer本身具有得快捷鍵,解決方法如下:<

  procedure TForm1.SetFocusToDoc;
  begin
   if WebBrowser1.Document < > nil then
    with WebBrowser1.Application as IOleobject do
     DoVerb(OLEIVERB_UIACTIVATE, nil, WebBrowser1, 0, Handle, GetClientRect);
  end;

  除此之外,我還找到一種更簡單的方法,這裡一並列出:

  if WebBrowser1.Document < > nil then
   IHTMLWindow2(IHTMLDocument2(WebBrowser1.Document).ParentWindow).focus

  剛找到了更簡單的方法,也許是最簡單的:

  if WebBrowser1.Document < > nil then
   IHTMLWindow4(WebBrowser1.Document).focus

  還有,需要判斷文檔是否獲得焦點這樣來做:

  if IHTMLWindow4(WebBrowser1.Document).hasfocus then

---------------------------------------------------------------------------------------------

1 回复
#2
Knocker2006-03-27 12:48

7、點擊“提交”按鈕

  如同程序裡每個窗體上有一個“缺省”按鈕一樣,Web頁面上的每個Form也有一個“缺省”按鈕──即屬性為“Submit”的按鈕,當用戶按下回車鍵時就相當於鼠標單擊了“Submit”。但是TWebBrowser似乎並不響應回車鍵,並且,即使把包含TWebBrowser的窗體的KeyPreview設為True,在窗體的KeyPress事件裡還是不能截獲用戶向TWebBrowser發出的按鍵。
  我的解決辦法是用ApplicatinEvents構件或者自己編寫TApplication對象的OnMessage事件,在其中判斷消息類型,對鍵盤消息做出響應。至於點擊“提交”按鈕,可以通過分析網頁源代碼的方法來實現,不過我找到了更為簡單快捷的方法,有兩種,第一種是我自己想出來的,另一種是別人寫的代碼,這裡都提供給大家,以做參考。

  A、用SendKeys函數向WebBrowser發送回車鍵
    在Delphi 5光盤上的Info\Extras\SendKeys目錄下有一個SndKey32.pas文件,其中包含了兩個函數SendKeys和AppActivate,我們可以用SendKeys函數來向WebBrowser發送回車鍵,我現在用的就是這個方法,使用很簡單,在WebBrowser獲得焦點的情況下(不要求WebBrowser所包含的文檔獲得焦點),用一條語句即可:

   Sendkeys('~',true);// press RETURN key

   SendKeys函數的詳細參數說明等,均包含在SndKey32.pas文件中。

  B、在OnMessage事件中將接受到的鍵盤消息傳遞給WebBrowser。

   procedure TForm1.ApplicationEvents1Message(var Msg: TMsg; var Handled: Boolean);
   {fixes the malfunction of some keys within webbrowser control}
   const
    StdKeys = [VK_TAB, VK_RETURN]; { standard keys }
    ExtKeys = [VK_DELETE, VK_BACK, VK_LEFT, VK_RIGHT]; { extended keys }
    fExtended = $01000000; { extended key flag }
   begin
    Handled := False;
    with Msg do
    if ((Message > = WM_KEYFIRST) and (Message < = WM_KEYLAST)) and
     ((wParam in StdKeys) or
     {$IFDEF VER120}(GetKeyState(VK_CONTROL) < 0) or {$ENDIF}
     (wParam in ExtKeys) and
     ((lParam and fExtended) = fExtended)) then
    try
     if IsChild(Handle, hWnd) then { handles all browser related messages }
     begin
      with {$IFDEF VER120}Application_{$ELSE}Application{$ENDIF} as
        IOleInPlaceActiveObject do
       Handled := TranslateAccelerator(Msg) = S_OK;
       if not Handled then
       begin
        Handled := True;
        TranslateMessage(Msg);
        DispatchMessage(Msg);
       end;
       end;
    except
    end;
   end; // MessageHandler

  (此方法來自EmbeddedWB.pas)

---------------------------------------------------------------------------------------------

8、直接從TWebBrowser得到網頁源碼及Html

  下面先介紹一種極其簡單的得到TWebBrowser正在訪問的網頁源碼的方法。一般方法是利用TWebBrowser控件中的Document對象提供的IPersistStreamInit接口來實現,具體就是:先檢查WebBrowser.Document對象是否有效,無效則退出;然後取得IPersistStreamInit接口,接?取得HTML源碼的大小,分配全局堆內存塊,建立流,再將HTML文本寫到流中。程序雖然不算復雜,但是有更簡單的方法,所以實現代碼不再給出。其實基本上所有IE的功能TWebBrowser都應該有較為簡單的方法來實現,獲取網頁源碼也是一樣。下面的代碼將網頁源碼顯示在Memo1中。

   Memo1.Lines.Add(IHtmlDocument2(WebBrowser1.Document).Body.OuterHtml);

  同時,在用TWebBrowser瀏覽HTML文件的時候要將其保存為文本文件就很簡單了,不需要任何的語法解析工具,因為TWebBrowser也完成了,如下:

   Memo1.Lines.Add(IHtmlDocument2(WebBrowser1.Document).Body.OuterText);

---------------------------------------------------------------------------------------------

9、“查找”功能

  查找對話框可以在文檔獲得焦點的時候通過按鍵Ctrl-F來調出,程序中則調用IOleCommandTarget對象的成員函數Exec執行OLECMDID_FIND操作來調用,下面給出的方法是如何在程序中用代碼來做出文字選擇,即你可以自己設計查找對話框。

   var
    Doc: IHtmlDocument2;
    TxtRange: IHtmlTxtRange;
   begin
    Doc :=WebBrowser1.Document as IHtmlDocument2;
    Doc.SelectAll;    //此處為簡寫,選擇全部文檔的方法請參見第三條命令操作
                //這句話尤為重要,因為IHtmlTxtRange對象的方法能夠操作的前提是
                //Document已經有一個文字選擇區域。由於接?執行下面的語句,所以不會
                //看到文檔全選的過程。
    TxtRange :=Doc.Selection.CreateRange as IHtmlTxtRange;
    TxtRange.FindText('Text to be searched',0.0);
    TxtRange.Select;
   end;

  還有,從Txt.Get_text可以得到當前選中的文字內容,某些時候是有用的。

---------------------------------------------------------------------------------------------

10、提取網頁中所有鏈接

  這個方法來自大富翁論壇hopfield朋友的對一個問題的回答,我本想自己試驗,但總是沒成功。

  var
   doc:IHTMLDocument2;
   all:IHTMLElementCollection;
   len,i:integer;
   item:OleVariant;
  begin
   doc:=WebBrowser1 .Document as IHTMLDocument2;
   all:=doc.Get_links;             //doc.Links亦可
   len:=all.length;
   for i:=0 to len-1 do begin
    item:=all.item(i,varempty);        //EmpryParam亦可
    memo1.lines.add(item.href);
   end;
  end;

---------------------------------------------------------------------------------------------

11、設置TWebBrowser的編碼

  為什麼我總是錯過很多機會?其實早就該想到的,但是一念之差,便即天壤之別。當時我要是肯再多考慮一下,多試驗一下,這就不會排到第11條了。下面給出一個函數,搞定,難以想象的簡單。

  procedure SetCharSet(AWebBrowser: TWebBrowser; ACharSet: String);
  var
   RefreshLevel: OleVariant;
  Begin
   IHTMLDocument2(AWebBrowser.Document).Set_CharSet(ACharSet);
   RefreshLevel :=7;              //這個7應該從注冊表來,幫助有Bug。
   AWebBrowser.Refresh2(RefreshLevel);
  End;

1