本文详细为大家分享了C#多选项卡的浏览器控件的设计与实现,供大家参考,具体内容如下
1. 为什么我们需要多选项卡的浏览器控件
项目中需要使用WinForm应用程序来包装BS应用程序的浏览器外壳,在.NET的WebBrowser中没有多选项卡浏览的自带配置属性,我们需要实现多选项卡的浏览器控件来实现包装BS应用程序的目的,而不会弹出IE浏览器窗口。
2. 我们需要了解哪些知识点
2.1. WebBrowser控件
WebBrowser 控件为 WebBrowser ActiveX 控件提供了托管包装。托管包装使您可以在 Windows 窗体客户端应用程序中显示网页。使用 WebBrowser 控件,可以复制应用程序中的 Internet Explorer Web 浏览功能,还可以禁用默认的 Internet Explorer 功能,并将该控件用作简单的 HTML 文档查看器。
l 如何:使用 WebBrowser 控件定位到 URL
this.webBrowser1.Navigate("http://www.microsoft.com");
l WebBrowser的 CreateSink 方法和DetachSink 方法
CreateSink方法使基础 ActiveX 控件与可以处理控件事件的客户端相关联。
DetachSink方法使从基础 ActiveX 控件中释放附加在 CreateSink 方法中的事件处理客户端。
下面的代码示例演示如何在派生自 WebBrowser 的类中使用此方法,该方法使用 OLE DWebBrowserEvents2 接口中的 NavigateError 事件对常规 WebBrowser 事件进行补充。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
|
using System;
using System.Windows.Forms;
using System.Runtime.InteropServices;
using System.Security.Permissions;
namespace WebBrowserExtensibility
{
[PermissionSetAttribute(SecurityAction.Demand, Name= "FullTrust" )]
public class Form1 : Form
{
[STAThread]
public static void Main()
{
Application.Run( new Form1());
}
private WebBrowser2 wb = new WebBrowser2();
public Form1()
{
wb.Dock = DockStyle.Fill;
wb.NavigateError += new
WebBrowserNavigateErrorEventHandler(wb_NavigateError);
Controls.Add(wb);
wb.Navigate( "www.widgets.microsoft.com" );
}
private void wb_NavigateError(
object sender, WebBrowserNavigateErrorEventArgs e)
{
// Display an error message to the user.
MessageBox.Show( "Cannot navigate to " + e.Url);
}
}
public class WebBrowser2 : WebBrowser
{
AxHost.ConnectionPointCookie cookie;
WebBrowser2EventHelper helper;
[PermissionSetAttribute(SecurityAction.LinkDemand, Name= "FullTrust" )]
protected override void CreateSink()
{
base .CreateSink();
helper = new WebBrowser2EventHelper( this );
cookie = new AxHost.ConnectionPointCookie(
this .ActiveXInstance, helper, typeof (DWebBrowserEvents2));
}
[PermissionSetAttribute(SecurityAction.LinkDemand, Name= "FullTrust" )]
protected override void DetachSink()
{
if (cookie != null )
{
cookie.Disconnect();
cookie = null ;
}
base .DetachSink();
}
public event WebBrowserNavigateErrorEventHandler NavigateError;
protected virtual void OnNavigateError(
WebBrowserNavigateErrorEventArgs e)
{
if ( this .NavigateError != null )
{
this .NavigateError( this , e);
}
}
private class WebBrowser2EventHelper :
StandardOleMarshalObject, DWebBrowserEvents2
{
private WebBrowser2 parent;
public WebBrowser2EventHelper(WebBrowser2 parent)
{
this .parent = parent;
}
public void NavigateError( object pDisp, ref object url,
ref object frame, ref object statusCode, ref bool cancel)
{
// Raise the NavigateError event.
this .parent.OnNavigateError(
new WebBrowserNavigateErrorEventArgs(
(String)url, (String)frame, (Int32)statusCode, cancel));
}
}
}
public delegate void WebBrowserNavigateErrorEventHandler( object sender,
WebBrowserNavigateErrorEventArgs e);
public class WebBrowserNavigateErrorEventArgs : EventArgs
{
private String urlValue;
private String frameValue;
private Int32 statusCodeValue;
private Boolean cancelValue;
public WebBrowserNavigateErrorEventArgs(
String url, String frame, Int32 statusCode, Boolean cancel)
{
urlValue = url;
frameValue = frame;
statusCodeValue = statusCode;
cancelValue = cancel;
}
public String Url
{
get { return urlValue; }
set { urlValue = value; }
}
public String Frame
{
get { return frameValue; }
set { frameValue = value; }
}
public Int32 StatusCode
{
get { return statusCodeValue; }
set { statusCodeValue = value; }
}
public Boolean Cancel
{
get { return cancelValue; }
set { cancelValue = value; }
}
}
[ComImport, Guid( "34A715A0-6587-11D0-924A-0020AFC7AC4D" ),
InterfaceType(ComInterfaceType.InterfaceIsIDispatch),
TypeLibType(TypeLibTypeFlags.FHidden)]
public interface DWebBrowserEvents2
{
[DispId(271)]
void NavigateError(
[In, MarshalAs(UnmanagedType.IDispatch)] object pDisp,
[In] ref object URL, [In] ref object frame,
[In] ref object statusCode, [In, Out] ref bool cancel);
}
}
|
l WebBrowser. DocumentCompleted 事件
在 WebBrowser 控件完成加载文档时发生。
处理 DocumentCompleted 事件,在新文档完成加载时接收通知。如果 DocumentCompleted 事件发生,则新文档已完全加载,这意味着可以通过 Document、DocumentText 或 DocumentStream 属性访问该文档的内容。
2.2. TabControl控件
TabControl 控件是Windows 窗体多个选项卡控件,这些选项卡类似于笔记本中的分隔卡和档案柜文件夹中的标签。选项卡中可包含图片和其他控件。您可以使用该选项卡控件来生成多页对话框,这种对话框在 Windows 操作系统中的许多地方(例如控制面板的“显示”属性中)都可以找到。
l 如何:将控件添加到选项卡页
tabPage1.Controls.Add(new Button());
l 如何:使用 Windows 窗体 TabControl 添加和移除选项卡
添加选项卡
1
2
3
4
5
|
string title = "TabPage " + (tabControl1.TabCount + 1).ToString();
TabPage myTabPage = new TabPage(title);
tabControl1.TabPages.Add(myTabPage);
|
移除选项卡
tabControl1.TabPages.Remove(tabControl1.SelectedTab);
l TabControl.DrawItem 事件
如果将 DrawMode 属性设置为 OwnerDrawFixed,则每当 TabControl 需要绘制它的一个选项卡时,它就会引发 DrawItem 事件。若要自定义选项卡的外观,请在用于 DrawItem 事件的处理程序中提供自己的绘制代码。
下面的代码示例创建一个包含一个 TabPage 的 TabControl。本示例声明一个事件处理程序,并用来在 tabPage1 的选项卡上绘制字符串和 Rectangle。该事件处理程序绑定到 DrawItem 事件。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
using System.Drawing;
using System.Windows.Forms;
public class Form1 : Form
{
private Rectangle tabArea;
private RectangleF tabTextArea;
public Form1()
{
TabControl tabControl1 = new TabControl();
TabPage tabPage1 = new TabPage();
tabControl1.DrawMode = TabDrawMode.OwnerDrawFixed;
tabControl1.SizeMode = TabSizeMode.Fixed;
tabControl1.Controls.Add(tabPage1);
tabControl1.ItemSize = new Size(80, 30);
tabControl1.Location = new Point(25, 25);
tabControl1.Size = new Size(250, 250);
tabPage1.TabIndex = 0;
ClientSize = new Size(300, 300);
Controls.Add(tabControl1);
tabArea = tabControl1.GetTabRect(0);
tabTextArea = (RectangleF)tabControl1.GetTabRect(0);
tabControl1.DrawItem += new DrawItemEventHandler(DrawOnTab);
}
private void DrawOnTab( object sender, DrawItemEventArgs e)
{
Graphics g = e.Graphics;
Pen p = new Pen(Color.Blue);
Font font = new Font( "Arial" , 10.0f);
SolidBrush brush = new SolidBrush(Color.Red);
g.DrawRectangle(p, tabArea);
g.DrawString( "tabPage1" , font, brush, tabTextArea);
}
static void Main()
{
Application.Run( new Form1());
}
}
|
3. 我们怎么设计多选项卡的浏览器控件
需要实现的功能特性:
l 实现打开BS应用程序的链接或窗口跳转到选项卡中而不是新窗口。
l 实现选项卡的关闭和新建,注意只有一个选项卡得时候不可以选项卡不可以出现关闭图片按钮。
我们主要采用TabControl和WebBrowser来实现多选项卡浏览器控件开发。
现介绍主要控件实现代码。
u 新建选项卡页面代码实现如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
public void CreateNewTabPage( string url)
{
ExtendedWebBrowser web = new ExtendedWebBrowser();
web.Name = "WebBroswer" + _webBrowserLists.Count.ToString();
web.Dock = DockStyle.Fill;
web.Margin = new Padding(0, 0, 0, 0);
web.DocumentCompleted += new WebBrowserDocumentCompletedEventHandler(webBrowser1_DocumentCompleted);
web.BeforeNewWindow += new EventHandler(webBrowser1_BeforeNewWindow);
web.Navigate(url);
_webBrowserLists.Add(web);
TabPage tbp = new TabPage();
tbp.Name = "TabPage" + tabControl1.TabCount.ToString();
tbp.Text = "空白页" ;
tbp.Padding = new Padding(0, 3, 0, 0);
tbp.Margin = new Padding(0, 3, 0, 0);
tbp.ImageIndex = 0;
tbp.Controls.Add(web);
this .tabControl1.Controls.Add(tbp);
this .tabControl1.SelectedTab = tbp;
}
u 把网页标题及图片关闭按钮的绘制选项卡中代码实现如下:
private void tabControl1_DrawItem( object sender, DrawItemEventArgs e)
{
try
{
Graphics g = e.Graphics;
Rectangle tabRectangle = this .tabControl1.GetTabRect(e.Index);
//先添加TabPage属性
g.DrawString( this .tabControl1.TabPages[e.Index].Text
, this .Font, SystemBrushes.ControlText, tabRectangle.X + 3, tabRectangle.Y + 3);
if (tabControl1.TabCount > 1)
{
//再画一个矩形框
using (Pen p = new Pen(SystemColors.Control))
{
tabRectangle.Offset(tabRectangle.Width - (CLOSE_SIZE + 3), 2);
tabRectangle.Width = CLOSE_SIZE;
tabRectangle.Height = CLOSE_SIZE;
g.DrawRectangle(p, tabRectangle);
}
g.DrawImage(e.State == DrawItemState.Selected ? imageList1.Images[ "closeSelected" ] : imageList1.Images[ "close" ], new Point(tabRectangle.X, tabRectangle.Y));
}
g.Dispose();
}
catch (Exception ex)
{
throw (ex);
}
}
|
u Webbrowser控件完成时及Webbrowser控件新建窗口时代码实现如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
private void webBrowser1_DocumentCompleted( object sender, WebBrowserDocumentCompletedEventArgs e)
{
ExtendedWebBrowser web = (ExtendedWebBrowser)(sender);
string title = web.Document.Title.Trim();
TabPage tb = (TabPage)web.Parent;
tb.Text = title.Length > 6 ? title.Substring(0, 6) + "..." : title;
if (tabControl1.SelectedTab == tb)
{
this .Text = title;
}
}
private void webBrowser1_BeforeNewWindow( object sender, System.EventArgs e)
{
WebBrowserExtendedNavigatingEventArgs eventArgs = e as WebBrowserExtendedNavigatingEventArgs;
CreateNewTabPage(eventArgs.Url);
eventArgs.Cancel = true ;
}
|
以上就是本文的全部内容,希望对大家的学习有所帮助。