查看: 3407|回复: 0

在程序中嵌入浏览器

字体大小: 正常放大

韩冰

823 主题	3 听众	4048 积分

我的地盘我做主

该用户从未签到

电梯直达

1^#

发表于 2005-1-26 12:57 |只看该作者 |倒序浏览

|招呼Ta 关注Ta

# i: S5 J& \2 g: t; l% F2 \* t 深圳市邮政储汇局(518040): R& ~9 L$ ]$ E' T 王发军

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

一、在Delphi 中引入IE 浏览器控件 # x: X5 J( q3 `" _---- 由于IE 浏览器控件需要提供显示功能才能使用，所以不能在程序中用CreateOleObject 取得一个实例后直接使用其属性和方法，否则程序在运行时会引起错误；这时需要用Delphi 中提供的"Import ActiveX Control" 功能，操作方法如下所述。

----在"Components" 菜单中，调用"Import ActiveX Control" 功能，在Registered Controls( 注册控件) 列表中选择"Microsoft Internet Controls(Version1.1)"，下方的提示栏中显示出其路径为 C:\PWin98\System\SHDOCVW.DLL，在Class Names( 类型列表) 中列出了可注册的三个控件：TWebBrowser_V1、TWebBrowser 和TShellFolderViewOC，分别为IE3 浏览器控件、IE4 浏览器控件和"Microsoft 外壳文件夹查看路由器" 控件。单击Install 进行安装。安装完成后，在"ActiveX" 控件栏中，将增加三个控件，分别为TWebBrowser_V1、TWebBrowser 和TShellFolderViewOC；在Delphi 的Imports 目录下，将创建一个文件SHDocVw_TLB.PAS，其中有这三个控件的包装细节，当然含控件的属性和方法说明了，它可以作为我们使用控件的参考资料。

二、使用IE 浏览器控件 C3 o! l. E( M: [& c8 `* {- U9 n----以TWebBrowser(IE4 浏览器控件) 为例子。

----TWebBrowser 的常见属性和方法主要有：

GoBack：方法，后退到上一个页面。' G% j# N0 Y: r4 x GoForward：方法，前进到下一个页面。! p! z0 X0 u" c0 z" c& k0 Z5 D6 x$ m" \ GoHome：方法，调用默认的主页页面，4 i/ W- K" }# x0 O+ S 该页面在IE 的选项中设定。4 S+ N. t H; W7 y GoSearch：方法，调用默认的搜索页面， 0 v1 [5 C+ Z9 z8 m+ I1 S- i' ^ 该页面在IE 的选项中设定。

---- Navigate(const URL: WideString; var Flags, TargetFrameName, PostData, Headers: OleVariant)：方法，调用指定页面，具体参数如下：

URL：指定页面的URL。 . [5 w9 m7 n" ^% ~ Flags：Word 类型，作用还不清楚， % H; M. [/ a* O" ]( x0 F! O/ \ 可设为0。

---- TargetFrameName：WideString，打开页面所在的Frame，为空字符串时在当前的Frame 中打开；TargetFrameName 指定的 Frame 存在时在Frame 中打开；

----TargetFrameName 指定的Frame 不存在时则新建一个窗口打开，此时就相当于调用外部的IE 浏览器了。

PostData：boolean，是否允许发送数据。5 n- X& }7 E+ O5 l Headers：WideString，3 s! D; W P2 G3 ?( [0 _ 要发送的URL 请求的头部数据。 ; v( }: h2 O+ s& @9 P( G Refresh：方法，刷新当前页面。9 }6 s# x5 P. e; ]9 \ Stop：方法，停止调用或打开当前页面。# ^0 c- k& E) ~ F, _) r LocationName：属性(WideString)，当前位置的名称。- w4 y$ e! |9 w LocationURL：属性(WideString)，当前位置的URL。 4 t- a! K4 K' I4 S3 _8 e u+ t Busy: 属性(Boolean)，是否正忙。: v5 w% W* E% d$ p3 O' i* p/ @2 T Visible: 属性(Boolean)，浏览器窗口是否可见。

---- ( 以下属性为在TWebBrowser 新增， TWebBrowser_V1 中没有，其作用有待探索)

StatusBar: 属性(Boolean)，是否显示状态栏。 " S$ V: [' o& ^8 d* B StatusText: 属性(WideString)，状态栏内容。: D# d8 k7 i' U! q; Y ToolBar: 属性(SYSINT)，工具栏中的内容。 : Q0 i. h2 p+ T0 \- j7 o% A MenuBar: 属性(Boolean)，是否显示菜单条。- g9 ?- H4 A! {% N FullScreen: 属性(Boolean)，是否全屏显示。. l' o5 p- i0 D# T Offline: 属性(Boolean)，是否脱机浏览。3 d7 K$ n" ^( f- p; p# K* d8 o AddressBar: 属性(Boolean)，是否显示地址栏。

----TWebBrowser 的常见事件主要有：

----OnStatusTextChange = procedure(Sender: TObject; const Text: WideString) of object;

----在状态栏提示信息变化时发生，参数 Text 为当前状态栏提示信息，我们可以根据该信息来更新我们自己的状态栏提示信息或处理其它的事务。

----OnProgressChange = procedure(Sender: TObject; Progress, ProgressMax: Integer) of object;

----在打开页面的进度变化时发生，参数 Progress 为当前进度，ProgressMax 为总进度，我们可以根据这两个参数来更新我们自己的状态栏提示信息或处理其它的事务。

OnCommandStateChange = procedure(Sender: ' Z6 m, N# X. o1 M, W5 \5 m& _TObject; Command: Integer; Enable: WordBool) of object;

----当执行新的命令时发生，Command 为命令标识，Enable 为是否允许执行该命令。

OnTitleChange = procedure(Sender: TObject; " K" s; C" W2 q: v# U6 d% q/ A const Text: WideString) of object;

----在页面的标题发生变化时发生，Text 为当前标题。

OnPropertyChange = procedure(Sender: TObject;& V' E1 L5 q: E" c; { const Property_: WideString) of object;

----在页面的属性发生变化时发生，Property_ 为属性名称

OnDownloadComplete: TNotifyEvent. s0 X' F" K5 o8 [7 @ 在下载页面完成后发生。 ) X: E7 k/ n& R u& K OnDownloadBegin: TNotifyEvent " P0 V1 V! D, b [+ L 　　在下载页面开始前发生。

三、两个例子 ) |# c4 P2 h- E5 U* K' S ----1. 制作自己的帮助系统

----我们利用IE 浏览器控件为用户制作了一个帮助系统，帮助文件由多个HTML 文件组成，一个主题对应一个 HTML 文件(Topic.HTM)，每个主题下的项目对应HTML 文件中的一个标签( ＃Item)。这样在我们的系统中，就不必再调用IE 浏览器或 WinHelp 程序来为用户提供帮助了。相信大家知道HTML 帮助文件与传统的HLP 帮助文件相比的优势所在吧。

----在下面例子中，演示了TWebBrowser(IE4 浏览器控件) 的Navigate 方法的使用方法。请注意程序中的注释。下面为程序的主要片段。{ 根据主题和项目调用帮助文件}

procedure ShowHelp( HelpTopic,HelpItem : String ); ) Z, J, x4 N; c+ E$ I% Hvar A8 Z1 c5 i# q* S/ b2 H/ r TargetFrameName,PostData,Heads,Flags : OleVariant; / d; M; P" v# x URL : widestring;# I) i. g% r/ v begin : P& I3 M2 w6 o* D- F3 _, V TargetFrameName := '';/ Y0 F& x% R% {( {1 p { 指定Frame 的空字符串时, 7 X& |- A5 b1 K. a0 S2 y& Q% F; S* h 则在当前Frame 中打开帮助文件}9 K3 {. _' F M( ~3 F$ r; l PostData := false;{ 不发送数据} $ ]7 M7 m8 v5 g$ B2 |9 p) A Heads := '';{Header 信息为空} : W% _6 u" Z9 L9 r2 b Flags := 0;{Flags 设为0}( e! N# K" w5 {# }0 o( M; ` URL := HelpTopic ＋ '.HTM ＃' ＋HelpItem;, i2 q. V. M- I# \5 u+ }& v5 u5 J- S { 帮助信息的URL}- B( F$ |9 P5 k i2 U' t. q9 _ with formHelp.webbrowser do 1 q) t. N2 ^1 J/ z8 } { 在帮助窗口中的IE 浏览器 $ b7 F2 y4 W2 D2 r9 i% d/ e# h 控件中显示帮助信息}: j/ `. `+ {6 S8 A3 I! L; Y5 T begin' [( g9 D2 P9 m7 ]! ^ navigate(URL,Flags,TargetFrameName," z# F4 C. J5 J! f PostData,Heads);{ 显示帮助信息} ! j) U8 W" E3 O' o9 X( @/ t end; 5 a& |( U1 I5 x3 Z8 B7 K6 ^end;

----2. 显示一个GIF 动画

----假如你还没有一个适合的动画显示控件，不妨试用一下下面的方法。

procedure ShowGIF( GIFFileName : String );3 }3 ]5 f" E2 R0 F: O- _7 w/ ? var7 Y, _" q8 y+ n& {, z$ K- [ TargetFrameName,PostData,Heads,Flags : OleVariant; ( P5 D& D `& w URL : widestring;+ g# P8 |- M7 [0 `& M% _ begin 5 J, B2 L d2 e TargetFrameName := ''; - i9 T; J- y$ \ { 指定Frame 的空字符串时, 9 `: P( D. W" Q# |' g8 M* j 则在当前Frame 中打开动画文件}9 i: s( ^) t1 l" P+ ` PostData := false;{ 不发送数据} # x4 c A7 H4 k Heads := '';{Header 信息为空} - Y0 r) P c8 I& }, [' J Flags := 0;{Flags 设为0} ( T8 @, G0 F5 x: H/ R URL := GIFFileName;6 D2 f% z/ a3 g8 U) ] with formGIF.webbrowser do6 K. e+ J* A: @ { 在指定窗口中的IE 浏览器控件中显示动画}9 Q9 v5 Z- X! L, z- t begin / t/ {+ L+ W9 g, i& b navigate(URL,Flags,TargetFrameName,Post ?7 S) |- P4 ]% W8 K+ v! H Data,Heads);{ 显示动画文件}+ X9 f9 A) w5 J+ ?/ E1 Z5 q1 s6 Y end;* ?2 Q0 w( D ^6 q; S) w, d3 _, _ end;