第8章 ActiveX控件和自定义组件开发

Size: px

Start display at page:

Download "第8章 ActiveX控件和自定义组件开发"

匆邬
5 years ago
Views:

1 第 8 章 ActiveX 控件和自定义组件开发在 Windows 窗体应用程序中用户除了可以使用基本控件外, 还可以自己创建控件从而使之更加符合程序功能的要求用户控件在形式上同单个基本控件一样, 开发人员可以在这种控件中创建自定义的属性和事件用户控件可以包含一个或多个 Windows 窗体控件组件或者代码块它们能够通过验证用户输入修改显示属性或执行用户所需的其他任务来扩展功能本章主要介绍了 ActiveX 控件和无界面组件的开发和使用方法, 并给出了详实的实例说明学习目标 : 1. ActiveX 控件的生成和调用 2. 无界面组件的生成和访问本章重点 : 1. 掌握在 VS.NET 2008 中创建和使用 ActiveX 控件的基本步骤 2. 掌握在 VS.NET 2008 中无界面组件的生成和访问方法 8.1 一个简单 ActiveX 控件的开发 ActiveX 是 Microsoft 对一系列策略性面向对象程序技术和工具的称呼, 是成品的软件模块 ActiveX 控件是在 OLE 控件对象链接与嵌入控件和 OCX 控件的基础发展起来的, 其重要作用是可以插入到网页或应用程序中使用 ActiveX 控件可以用各种编程语言来开发, 如 C C++, 也包括.NET 中的 C# VB.NET 等开发 ActiveX 控件的方法最简便的是通过继承 UserControl 类来实现创建 ActiveX 控件的操作步骤 : (1) 选择文件新建项目命令, 在打开的新建项目对话框的模板框中选择 Windows 窗体控件库, 并设置控件名称, 确定 (2) 在打开的用户控件设计界面中添加控件, 并进行适当的设置 (3) 编写相应控件的事件处理函数 (4) 选择生成生成解决方案菜单命令 ActiveX 控件通常以 dll 或 ocx 文件的形式存在, 它不能独立运行, 相应的依赖程序称为 ActiveX 控件宿主程序宿主程序在使用控件和组件时, 不需要编译, 只需要按照既定的格式说明进行调用即可用户控件一般只在同一个项目中使用使用步骤如下 : (1) 在 ActiveX 控件成功编译后, 选择文件添加新建项目菜单命令, 新建一个 Windows 窗体应用程序 (2) 工具箱窗口中自动显示刚才创建的 ActiveX 控件, 将该控件拖到窗体上, 并进行适当的设置创建 ActiveX 控件程序 ActiveX 控件可以简单理解为能够实现特定功能的成品控件例 8.1 下面通过创建简单的窗体控件 MyFirstActiveX 和其窗体应用程序来体会 ActiveX 控件程序的创建和使用方法 : (1) 在 VS 2008 界面中, 选择文件新建项目命令, 在打开的新建项目对话框的模板框中选择 Windows 窗体控件库, 并设置程序的名称为 MyFirstActiveX:

图 8-1 (2) 单击确定按钮, 创建名为 MyFirstActiveX 的 ActiveX 控件程序然后在打开的界面中添加一个 Button 控件和一个 TextBox 控件, 并进行适当的设置 : 图 8-2 (3) 在设计界面中双击我的控件按钮, 进入该按钮的事件处理函数, 并编写相应代码, 结果如下 : private void

$"; (4) 运行控件程序, 或者选择生成生成解决方案菜单命令 ( 也可以按 F6 键 ) 时, 自动生成与程序名同名的 dll 文件, 该文件位于程序目录的程序名 \bin\debug 子目录或程序名 \bin\release 下 8.1.$

2 图 8-1 (2) 单击确定按钮, 创建名为 MyFirstActiveX 的 ActiveX 控件程序然后在打开的界面中添加一个 Button 控件和一个 TextBox 控件, 并进行适当的设置 : 图 8-2 (3) 在设计界面中双击我的控件按钮, 进入该按钮的事件处理函数, 并编写相应代码, 结果如下 : private void button1_click(object sender, EventArgs e) textbox1.text = " 这是我的第一个 ActiveX 控件!"; (4) 运行控件程序, 或者选择生成生成解决方案菜单命令 ( 也可以按 F6 键 ) 时, 自动生成与程序名同名的 dll 文件, 该文件位于程序目录的程序名 \bin\debug 子目录或程序名 \bin\release 下调用 ActiveX 控件 ActiveX 控件本身不是一个程序, 因此它不能独立运行, 而应嵌入其他应用程序中才能发挥其作用对应上例中的 MyFirstActiveX, 使用步骤如下 : (1) 创建窗体应用程序 testmyfirstactivex, 方法是 : 在已打开程序 MyFirstActiveX 的 VS 2008 中选择文件添加新建项目菜单命令, 然后在打开的添加新项目对话框选择创建窗体应用程序, 设置程序名为 testmyfirstactivex (2) 在形成的程序 testmyfirstactivex 中, 其工具箱中自动显示刚才创建的 ActiveX 控件, 将该控件拖到窗体上, 并做适当的设置 :

图 8-3 (3) 运行该程序, 并单击运行界面上的我的控件按钮, 将出现如下图所示的界面这表明, 所创建的 ActiveX 控件确实已经在该窗体应用程序中工作了图 8-4 8.2.2 ActiveX 控件开发实例 1. 电子时钟控件例 8.

MyAccutronControl, 这涉及到三个地方的修改 :UserControl1.cs 文件代码中, 将自动形成的类名和构造函数名 UserControl1 都改为 MyAccutronControl ;UserControl1.Designer.

3 图 8-3 (3) 运行该程序, 并单击运行界面上的我的控件按钮, 将出现如下图所示的界面这表明, 所创建的 ActiveX 控件确实已经在该窗体应用程序中工作了图 ActiveX 控件开发实例 1. 电子时钟控件例 8.2 开发一个具有电子时钟功能的 ActiveX 控件, 该自定义控件还提供用于获取或设置时间的属性 (1) 新建项目, 选择 Windows 窗体控件库 ; ( 2 ) 为使在宿主程序中显示具有特定意义的控件名, 需要将类名更改为 MyAccutronControl, 这涉及到三个地方的修改 :UserControl1.cs 文件代码中, 将自动形成的类名和构造函数名 UserControl1 都改为 MyAccutronControl ;UserControl1.Designer.cs 代码文件中的类名由原来的 UserControl 改为 MyAccutronControl (3) 双击节点 UserControl1.cs, 打开自定义控件的设计界面, 添加一个 Label 控件和 Timer 组件, 并进行设置, 结果控件的设计界面如下 : 图 8-5

4 (4) 为开发的控件编写代码其中, 先在 MyAccutronControl 类中声明三个成员变量 : private int hour = 0; // 作小时计数器 private int minute = 0; // 分钟计数器 private int second = 0; // 秒计数器 (5) 在 Timer 组件的 Tick 事件处理函数中编写实现 hour minute 和 second 之间计数关系的代码 : private void timer1_tick(object sender, EventArgs e) string hs,ms,ss,timestr; hs = ms = ""; second++; if (second == 60) second = 0; minute++; if (minute == 60) minute = 0; hour++; if (hour == 24) hour = 0; hs = hour.tostring(); if (hs.length == 1) hs = "0" + hs; // 保证以两个字符显示分钟数 ms = minute.tostring(); if (ms.length == 1) ms = "0" + ms; // 保证以两个字符显示分钟数 ss = second.tostring(); if (ss.length == 1) ss = "0" + ss; // 保证以两个字符显示秒数 timestr = hs + ":" + ms + ":" + ss; label1.text = timestr; 为了让宿主程序能够对时间的各种成份 ( 小时分秒 ) 进行设置, 还分别定义三种属性 : public int hours // 获取或设置小时数的属性 get return hour; set hour = value; public int minutes // 获取或设置分钟数的属性 get return minute; set minute = value; public int seconds // 获取或设置秒数的属性 get return second; set second = value; (6) 生成控件选择菜单生成生成解决方案命令 ( 也可以按 F6), 将生成名为 AccutronControl.dll 的文件, 它们默认位于程序目录下的 AccutronControl\bin\Debug 子目录下注意 : 控件名是由对应的类名来决定的

myaccutroncontrol1 的控件实例选择该控件, 可以在属性编辑器中有控件 MyAccutronControl 的可读可写属性 hours

5 使用控件 MyAccutronControl 的步骤如下 : (1) 新建一个窗体应用程序, 程序名设置为 testaccutroncontrol (2) 创建后, 将自动在工具箱中显示已创建的控件 MyAccutronControl : 图 8-6 (3) 将控件 MyAccutronControl 拖到窗体中, 形成名为 myaccutroncontrol1 的控件实例选择该控件, 可以在属性编辑器中有控件 MyAccutronControl 的可读可写属性 hours minutes 和 seconds( 其他属性方法和事件是继承而来的 ): 图 8-7 (4) 将这三个属性设置为相应的值 ( 也可以用代码动态设置和引用 ), 然后运行该窗体应用程序 :

图 8-8 2 Window Media Player 控件简介 Window Media Player 是一种媒体播放器, 可以播放当前最流行的音频视频文件和大多数混合型的多媒体文件,VS 2008 继承开发环境提供了 Windows Media Player 控件, 并且提供了相关的属性方法, 开发者根据提供的属性方法完全可以实现 Windows Media Player

6 图 Window Media Player 控件简介 Window Media Player 是一种媒体播放器, 可以播放当前最流行的音频视频文件和大多数混合型的多媒体文件,VS 2008 继承开发环境提供了 Windows Media Player 控件, 并且提供了相关的属性方法, 开发者根据提供的属性方法完全可以实现 Windows Media Player 播放器的所有功能在使用控件开发前, 需要将 Windows Media Player 控件添加到工具箱中,Windows Media Player 控件主要属性和方法如表 8-1: 表 8-1 属性 / 方法说明 Ctlcontrols 获取一个 IWMPControls 接口 Ctlenabled currentmedia currentplaylist playlistcollection URL versioninfo Close() newmedia(string bstrurl) newplaylist(string bstrname) 获取或设置一个值来表示 Windows Media Player 控件是否可用获取或设置一个和当前媒体对应的 IWMPMedia 接口获取或设置当前播放列表 IWMPPlaylist 接口获取一个 IWMPplaylistCollection 接口获取和设置播放的文件名表 8-1 中出现的 IWMPPlaylistCollection 常用方法如表 8-2: 表 8-2 属性说明获取一个指明 Windows Media Player 控件版本的值源释放 Windows Media Player 控件所占用的资 bstrurl 表示一个媒体文件的 URL, 方法为一个媒体文件返回一个 IWMPMedia 接口为一个新的播放列表返回一个 IWMPPlaylist 接口, bstrname 为列表名称 GetAll 提供一个访问媒体库中所有播放列表的对象 IWMPPlaylistArray

7 getbyname newplaylist Remove 获取一个访问具有指定名称的播放列表对象 IWMPPlaylistArray 在媒体库中创建一个新的播放列表从媒体库中移除播放列表表 8-1 中出现的 IWMPPlaylist 常用方法如表 8-3: 表 8-3 属性说明 GetAll getbyname newplaylist Remove 提供一个访问媒体库中所有播放列表的对象 IWMPPlaylistArray 获取一个访问具有指定名称的播放列表对象 IWMPPlaylistArray 在媒体库中创建一个新的播放列表从媒体库中移除播放列表表 8-1 中出现的 IWMPPlaylist 常用方法如表 8-4: 表 8-4 属性 attributecount 说明获取和媒体文件相关的属性个数 Duration 获取当前媒体文件的播放时间 ( 以秒为单位 ) durationstring imagesourceheight/ imagesourcewidth sourceurl Name 获取当前媒体文件的播放时间 ( 以时分秒为单位 ) 获取当前媒体文件的高度宽度 ( 以像素为单位 ) 获取当前媒体文件的 URL 获取或设置当前媒体文件的文件名 3. 视音频控件的创建和使用例 8.3 创建一个能够播放视频和音频的 ActiveX 控件, 提供多个媒体文件的选择和连续播放功能 (1) 在工具箱中添加 AxWindowsMediaPlayer 控件需要手动添加, 具体步骤是 : 右击工具箱中的位置, 在弹出的菜单中选择选择项 ; 在打开的选择工具箱项对话框中选择 COM 组件选项卡, 在其中选择 Windows Media Player 项, 如图 8-9 所示, 最后单击确定按钮在公共控件一栏末尾添加一项 Windows Media Player

图 8-9 (2) 将工具箱中新出现的 Windows Media Player 控件添加到窗体上, 然后继续添加两个 Button 控件一个 ListBox 控件一个 Label 控件和一个 OpenFileDialog 对话框组件, 并适当调整它们的位置和大小以及设置它们的有关属性

$button1_click(object sender, EventArgs e) openfiledialog1.initialdirectory = @"D:\VS2008\ 第 8 章 \AVI"; openfiledialog1.filter = "avi 文件 (*.avi) *.$

8 图 8-9 (2) 将工具箱中新出现的 Windows Media Player 控件添加到窗体上, 然后继续添加两个 Button 控件一个 ListBox 控件一个 Label 控件和一个 OpenFileDialog 对话框组件, 并适当调整它们的位置和大小以及设置它们的有关属性 : 图 8-10 (3) 添加代码有三个地方需要添加代码 : 选择媒体文件按钮的 Click 事件处理函数播放媒体文件按钮的 Click 事件处理函数 AxWindowsMediaPlayer 控件的 MediaChange 事件处理函数 // 选择媒体文件 private void button1_click(object sender, EventArgs e) openfiledialog1.initialdirectory 第 8 章 \AVI"; openfiledialog1.filter = "avi 文件 (*.avi) *.avi mp3 文件 (*.mp3) *.mp3 All files (*.*) *.*"; openfiledialog1.multiselect = true; openfiledialog1.filename = ""; openfiledialog1.title = " 选择媒体文件 ";

9 listbox1.items.clear(); if (openfiledialog1.showdialog() == DialogResult.OK) string[] URLs = openfiledialog1.safefilenames; for (int i = 0; i < URLs.Length; i++) listbox1.items.add(urls[i]); int pos = openfiledialog1.filename.lastindexof('\\'); dirpath = openfiledialog1.filename.substring(0, pos); // 播放媒体文件按钮 private void button2_click(object sender, EventArgs e) if (dirpath == "") MessageBox.Show(" 请选择媒体文件 "); return; // 创建播放列表 WMPLib.IWMPPlaylist pl = axwindowsmediaplayer1.playlistcollection.newplaylist("mylist"); WMPLib.IWMPMedia im; for (int i = 0; i < listbox1.items.count; i++) im = (WMPLib.IWMPMedia) axwindowsmediaplayer1.newmedia( dirpath + "\\" + listbox1.items[i].tostring()); pl.appenditem(im); axwindowsmediaplayer1.currentplaylist = pl; //AxWindowsMediaPlayer 控件的 MediaChange 事件处理函数 private void axwindowsmediaplayer1_mediachange(object sender, AxWMPLib._WMPOCXEvents_MediaChangeEvent e) string curmedial = axwindowsmediaplayer1.currentmedia.sourceurl; this.text = " 正在播放 " + curmedial; for (int i = 0; i < listbox1.items.count; i++) if (curmedial == dirpath + "\\" + listbox1.items[i].tostring()) listbox1.selectedindex = i; // 加亮显示正在播放的媒体文件名 return; 8.2 自定义组件开发严格来说,ActiveX 控件指的是提供用户界面接口 (UI) 功能的组件, 而一般所说的组件是无用户界面组件, 此类组件定义时只需定义为宿主程序所调用的属性和方法, 无需考虑如何显示界面

10 自定义组件的创建步骤是 : (1) 选择文件新建项目命令, 在打开的新建项目对话框的模板框中选择类库模版, 并设置组件名称, 确定 (2) 在对应的类文件中, 添加具有一定功能的 public 方法作为组件访问接口 (3) 选择生成生成组件名称菜单命令, 即可在程序根目录的组件名称 \bin\release 或组件名称 \bin\debug 子目录下生成以文件组件名称.dll 存在的组件自定义组件的使用是 : (1) 创建窗体应用程序 (2) 选择菜单项目添加引用命令, 在打开的添加引用对话框中打开浏览选项卡, 定位到组件名称.dll 文件所在的目录, 选择该文件, 确定, 引入已创建的组件 (3) 在应用程序中创建组件类的对象调用其接口方法例 8.4 开发具有对英文文本进行加密和解密功能的组件设计思想 : 这里假设英文文本是由大小写字母逗号点号和空格组成加密的原理是, 先将这些字符随机地排成一圈, 为叙述方便, 不妨假设排成如下的圈 ( 表示空格 ): 令 key 表示密钥 ( 这里为整数 ), 对于英文文本 ( 明文 ) 中的每个字符, 用其在圈中所在位置后面的第 key 个字符表示例如, 如果 key 为 4, 则文本 I am a boy. 加密后就变成密文 MdeqdedfsCc 解密方法是显然的, 只需将密文中的字符用其在圈中所在位置前面的第 key 字符来表示即可解密用户必须知道密钥 key 设计步骤如下 : (1) 新建项目, 选择类库, 然后将项目名设置为 EnDecrypting, 单击确定按钮 (2) 命名空间采用默认设置 EnDecrypting, 而将类名改为 EnDecryptingClass; 然后在该类中添加一个私有成员 : private string matrix = "abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyz,. "; (3) 接着在 EnDecryptingClass 类中添加两个方法, 分别用于实现加密和解密 : public string Encrypting(string plaintext, int keycode) // 加密 public string Decrypting(string ciphertext, int keycode) // 解密 public string Encrypting(string plaintext, int keycode) // 加密方法 char[] chars = matrix.tochararray(); char[] ciphertext_arr = plaintext.tochararray(); // 将明文散列到字符数组中 int i = 0, j = 0; for (i = 0; i < ciphertext_arr.length; i++) for (j = 0; j < chars.length; j++) if (matrix[j] == ciphertext_arr[i]) break; if (j == matrix.length) throw new Exception(" 明文中包含非法字符!"); int k = 0; while (k < keycode)

11 k++; j++; if (j == matrix.length) j = 0; ciphertext_arr[i] = matrix[j]; // 明文转换为密文 return new String(ciphertext_arr); // 返回密文 public string Decrypting(string ciphertext, int keycode) // 解密方法 char[] chars = matrix.tochararray(); char[] plaintext_arr = ciphertext.tochararray(); // 将密文散列到字符数组中 int i = 0, j = 0; for (i = 0; i < plaintext_arr.length; i++) for (j = 0; j < chars.length; j++) if (matrix[j] == plaintext_arr[i]) break; if (j == matrix.length) throw new Exception(" 密文中包含非法字符!"); int k = keycode - 1; while (k >= 0) k--; j--; if (j == -1) j = matrix.length - 1; plaintext_arr[i] = matrix[j]; // 密文转换为明文 return new String(plaintext_arr); // 返回明文 (4) 生成加密解密组件 : 选择菜单生成生成 EnDecrypting 命令, 即可在程序根目录的 EnDecrypting\bin\Release 子目录下生成以文件 EnDecrypting.dll 存在的加密解密组件例 8.5 调用在例 8.4 中创建的加密解密组件 EnDecrypting, 实现对给定英文文本的加密和解密功能创建名为 testendecrypting 的窗体应用程序, 然后选择菜单项目添加引用命令, 在打开的添加引用对话框中打开浏览选项卡, 定位到 EnDecrypting.dll 文件所在的目录, 并选择该文件, 确定按钮即可引入已创建的组件, 以后就可以直接调用它了图 8-11

中输入的数据能传递到 Form1 中, 需要编写相关代码 : public partial class Form2 : Form public Form2() InitializeComponent(); private int keycode =

12 (2) 在窗体上分别添加三个 TextBox 控件和三个 Label 控件以及两个 Button 控件, 并对它们的有关属性位置和大小作适当的设置和调整, 并将窗体的 Text 属性值设置为加密解密程序, 结果如下图所示图 8-12 (3) 制作用于输入密钥的对话框方法是 : 在程序中再添加一个窗体, 形成窗体 Form2, 并在该窗体上添加一个 TextBox 控件和一个 Label 控件, 并作适当的调整和设置, 结果如图 8-13 所示图 8-13 (4) 为了使窗体 Form2 中输入的数据能传递到 Form1 中, 需要编写相关代码 : public partial class Form2 : Form public Form2() InitializeComponent(); private int keycode = -1; public int keycodevalue //Form1 利用该属性可以访问 Form2 中输入的数据 get return keycode; private void button1_click(object sender, EventArgs e)

13 keycode = Convert.ToInt16(textBox1.Text); this.close(); (5) 编写相关事件的处理函数, 需要做以下两项工作 : 编写显示用于输入密钥的对话框的实现函数 ShowForm2Dia ( ) 和为加密和解密按钮编写事件处理函数 : // 显示用于输入密钥的对话框的实现代码 private int ShowForm2Dia() Form2 frm2 = new Form2(); frm2.maximizebox = false; frm2.minimizebox = false; frm2.formborderstyle = FormBorderStyle.FixedSingle; frm2.text = " 密钥 "; frm2.showdialog(); return frm2.keycodevalue; // 加密按钮事件处理函数 private void button1_click(object sender, EventArgs e) int keycode = ShowForm2Dia(); try EnDecrypting.EnDecryptingClass obj = new EnDecrypting.EnDecryptingClass(); textbox2.text = obj.encrypting(textbox1.text, keycode); catch (Exception ex) MessageBox.Show(ex.ToString()); // 解密按钮事件处理函数 private void button2_click(object sender, EventArgs e) int keycode = ShowForm2Dia(); try EnDecrypting.EnDecryptingClass obj = new EnDecrypting.EnDecryptingClass(); textbox3.text = obj.decrypting(textbox2.text, keycode); catch (Exception ex) MessageBox.Show(ex.ToString()); 执行该程序运行结果如图 8-14 所示 :

14 图 8-14

// HDevelopTemplateWPF projects located under %HALCONEXAMPLES%\c# using System; using HalconDotNet; public partial class HDevelopExport public HTuple

$// HDevelopTemplateWPF projects located under %HALCONEXAMPLES%\c# using System; using HalconDotNet; public partial class HDevelopExport public HTuple$ halcon 与 C# 混合编程之 Halcon 代码调用写在前面完成 halcon 与 C# 混合编程的环境配置后, 进行界面布局设计构思每一个按钮所需要实现的功能, 将 Halcon 导出的代码复制至相应的 C# 模块下即可 halcon 源程序 : dev_open_window(0, 0, 512, 512, 'black', WindowHandle) read_image (Image,