VB的API编程精粹

2022-07-15 80酷酷网 80kuku.com

　　编程第一节：API基础

API说到底就是一系列的底层函数，是系统提供给用户用于进入操作系统核心，进行高级编程的途径。通过在Visual Basic应用程序中声明外部过程就能够访问Windows API(以及其它的外部DLLs)。在声明了过程之后，调用它的方法与调用Visual Basic自己的过程相同。要声明一个DLL过程，需要在代码窗口的"声明"部分增加一个Declare语句，如果该过程返回一个值，应将其声明为Function。例如：

Declare Function publicname Lib "libname" [Alias "alias"] [([[ByVal] variable [As type] [,[ByVal] variable [As type]]...])] As Type

如果过程没有返回值，可将其声明为Sub。

缺省情况下，在标准模块中声明的DLL过程，可以在应用程序的任何地方调用它。在其他类型的模块中定义的DLL过程是模块私有的，必须在它们前面加上Private关键字，以示区分。特别提请注意的是，在32位的Visual Basic中过程名是区分大小写的。而在以前的16位版本中并不区分大小写，这是初学者容易出错的地方。

Declare语句中的Lib子句用来告诉Visual Basic如何找到包含该过程的dll文件。如果引用的过程属于Windows核心库(User32、Kernel32或 GDI32)，则可以不包含文件扩展名。例如：

Declare Function GetTickCount Lib "kernel32" Alias "GetTickCount"() As Long。对于其它DLL， Lib子句须指定文件的路径及扩展名。

如果调用的Windows API过程要使用字符串，那么在声明语句中必须增加一个Alias子句，以指定正确的字符集。包含字符串的Windows API函数实际有两种格武ANSI格式Unicode格式。因此，在 Windows头文件中，每个包含字符串的函数都同时有 ANSI版本和Unicode版本。

例如，下面是SetWindowText函数的两种C语言描述。可以看到，第一个描述将函数定义为SetWindowTextA, 尾部的"A"表明它是一个ANSI函数：

SetWindowTextA(HWND hWnd,LPCSTR lpString);

第二个描述将它定义为SetWindowTextW，尾部的 "w"表明它是一个Unicode函数：

SetWindowTextW(HWND Hwnd,LPCWSTR lpString);

因为两个函数实际的名称都不是"SetWindow Text"，要引用正确的函数就必须增加一个Alias子句：

Private Declare Function SetwindowText Lib "user32" Alias "SetWindowTextA"(ByVal hwnd As Longg，ByVal lpString As String) As Long

请注意， Alias子句后面的字符串必须是过程的真正名称，必须是区分大小写的。事实上，您只需要记住，只有Windows NT才支持Unicode格式，而 Windows 95只支持ANSI格式就行了。至于两者的区别，作一般的应用程序开发是不需要了解的。

VB5专业版在VB目录的\Winapi子目录下，用几个文件提供了关于API的信息。 Win32api.txt文件中包含了32位Windows API函数中用到的函数和类型的结构声明以及全局常量的值。用户可以用VB本身带的外接程序"API浏览器"来方便地使用Win32api．Txt，如下所示：

点击菜单文件项的"加载文本文件…"从VB目录下的WINAPI目录中选择"WIN32API.TXT"，就可以查看WINDOWS 95系统的API函数的声明、常数定义和数据类型了。例如，我们打算查看函数InverRect() 的声明。首先，点击"搜索"按钮，输入字符串 "InverRect"。在"可选项"栏中，兰色的亮度条将移动到"InverRect"项上。再点按"添加"按钮，在"选定项"中就出现"InverRect"在Visual Basic中的声明了。接下来自然是点按"复制"按钮，然后将窗口切换到Visual Basic开发环境中，在需要声明API 函数的地方Ctrl＋V（粘贴）即可。

上面所讲的声明方法虽然简单，但只有使用WIN DOWS本身的API函数才能这样。对于第三方提供的动态链接库（DLL）您只有用键盘老老实实地敲了。

第二节：牛刀小试

现在读者一定很想自己亲自试一下，下面举两个实际应用的例子让大家体会一下API的妙用吧！

1．使一个窗体始终保持在屏幕的最上面

我们知道VB本身自带的函数是难以完成此功能的，我们可以通过调用Windows的API函数： SetWindowPos达到我们的要求。操作步骤如下：

（1）启动VB5建立一个新工程，在该工程中添加一个模块（Moudel），在该模块中用上述的"API例览器" 添加如下的该API函数的函数声明和常量声明部分：

'API函数声明

Declare Function SetWindowPos Lib "user32" Alias "SetWindowPos" (ByVal hwnd As Long, ByVal hWndInsertAfter As Long, ByVal x As Long, ByVal y As Long, ByVal cx As Long, ByVal cy As Long, ByVal wFlags As Long) As Long

'常量声明

Global Const SWP_HIDEWINDOW = &H80

Global Const SWP_NOACTIVATE = &H10

Global Const SWP_NOCOPYBITS = &H100

Global Const SWP_NOMOVE = &H2

Global Const SWP_NOOWNERZORDER = &H200

Global Const SWP_NOREDRAW = &H8

Global Const SWP_NOREPOSITION = SWP_NOOWNERZORDER

Global Const SWP_NOSIZE = &H1

Global Const SWP_NOZORDER = &H4

Global Const SWP_SHOWWINDOW = &H40

Global Const HWND_BOTTOM = 1

Global Const HWND_BROADCAST = &HFFFF&

Global Const HWND_DESKTOP = 0

Global Const HWND_NOTOPMOST = -2

Global Const HWND_TOPMOST = -1

Global Const HWND_TOP = 0

Global Const Flags=SWP_NOMOVE Or SWP_NOSIZE

这里以"SWP_"开头的常量是表示窗体所具有的风格，这些常量可以通过VB中的"OR"操作符组合在一起。而以"HWND_"开头的常量表示窗体在桌面上的位置。从这些常量的英文单词的意义上读者应该很容易理解他们所具有的风格了。所以笔者就不一一去说明了。至于为什么要添加这些常量而不是别的这就要您去查看Windows SDK关于该函数的帮助文档了。当然这对于初学者来说有一定的难度，但不要畏惧，只要您仔细看帮助就会慢慢搞懂的。因为这些API函数是为C和C＋＋的编程人员编写的，所以如果您懂一点 C++的话会很容易理解的。

（2）现在只要在您想要此功能的地方调用该函数就可以了，调用的方法如：

Dim Success as Long

SuccesS＝SetwindowPos(me.HWnd. HWND_TOPMOST,0,0,0,0,FLAGS)

若Success返回的值不等于零则表示调用成功。

比如在某个窗体的Load事件中加入上述的两行代码，就可以达到使该窗体始终位于屏幕最上面的目的。

细心的读者可能已经发现上面的例子中的模块声明中声明了好几个常量，可为什么只用到三个呢？现在您可以试着改变一下API函数"SetWindowPos"中的第二个参数或常量FLAGS中的项，看看您的窗体会出现什么样的效果？

2．VB5中如何屏蔽掉win95中的CTRL_ALT_DEL， CTRL_ESC, ALT_TAB三组热键通过调用API函数"SystemParametersInfo"来实现。

首先创建一新工程；在此工程中添加一个窗体和一个模块；在窗体上拖放两个按钮分别命名为 "cmdDisable","cmdEnable"；Copy如下代码入模块中：

Public Declare Function SystemParametersInfo Lib "user32" Ahias "SystemParametersInfoA" (ByVal uAction As Long,ByVal uParam As Long, lpvParam As Any，ByVal fuWinIni As Long)AS Long

Public Const SPI_SCREENSAVERRUNNING=97

在窗体的代码编辑区Copy如下代码：

'使三组热键失效

Private Sub cmdDisable_click()

SystemParametersInfo

SPI_SCREENSAVERRUNNING,True,byVal 1&,0

End Sub

Private Sub Form_Unload(Cancel As Integer)

'程序退出前是热键有效

CndEnable_Click

End Sub

若将此功能和屏幕保护程序结合到一起，那您的屏幕保护程序一定增色许多。

API函数的简单调用例子就是这么容易，相信现在您对API的调用已不再感到神秘了，接下来我们就看看一个比较复杂的应用。

第三节：高手进阶

上面的关于API的调用的例子只是为了带您去Win dows API世界中去探索一下。相信您已探索到了一点眉目并想去实现一些更"好玩"的东西了。好！下面就向您介绍一个很"好玩"同时又会使您的程序看起来更专业化的一个API调用。

相信您的机器上一定装有"金山词霸"，试着启动它您发现了什么？启动画面过后它"不见了"。把鼠标移到桌面的右下角，原来它以图标的形式"藏在" Windows 的托盘中。用鼠标右击它还会弹出一个菜单功能项供您选择。现在您一定想把自己的程序也放到托盘，这样您的程序多具有专业水准！

下面是此功能的实现步骤：

1．这里我们调用的API函数是： "Shell_NotifyIcon"，在您的模块中添加如下的函数声明和常量声明：

'以下常量告诉系统在托盘中您的图标上发生了什么操作

'常量声明

Public Const WM_MOUSEMOVE = &H200 '在图标上移动鼠标

Public Const WM_LBUTTONDOWN = &H201 '鼠标左键按下

Public Const WM_LBUTTONUP = &H202 '鼠标左键释放

Public Const WM_LBUTTONDBLCLK = &H203 '双击鼠标左键

Public Const WM_RBUTTONDOWN = &H204 '鼠标右键按下

Public Const WM_RBUTTONUP = &H205 '鼠标右键释放

Public Const WM_RBUTTONDBLCLK = &H206 '双击鼠标右键

Public Const WM_SETHOTKEY = &H32 '响应您定义的热键

'API函数声明

Public Declare Function Shell_NotifyIcon Lib "shell32.dll" Alias " Shell_NotifyIconA" (ByVal dwMessage As Long, lpData As NOTIFYICONDATA) As Long

'自定义一个调用API Shell_NotifyIcon要用到的类型"NOTIFYICONDATA"

Public Type NOTIFYICONDATA

cdSize As Long 'NOTIFYICONDATA类型的大小

hwnd As Long '你的应用程序窗体的名柄

uId As Long '应用程序图标资源的ID号

uFlags As Long '使那些参数有效它是以下枚举类型中的

'NIF_MESSAGE、NIF_ICON、NIF_TIP三组的组合

uCallbackMessage As Long '鼠标移动时把此消息发给该图标的窗体

hIcon As Long '图标名柄

szTip As String*64 '当鼠标在图标上时显示的Tip文本

End Type

'这是一个枚举类型它告诉API Shell_NotifyIcon去做什么操作

Public Enum enm_NIM_Shell

NIM_ADD=&H40 '在“金碟”中加一图标

NIM_MODIFY=&H1 '修改“金碟”中的图标

NIM_DELETE=&H2 '删除“金碟”中的图标

NIF_MESSAGE=&H1 '使类型"NOTIFYICONDATA"中的uCallbackMessage有效

NIF_ICON=&H2 '使类型"NOTIFYICONDATA"中的hIcon有效

NIF_TIP=&H4 '使类型"NOTIFYICONDATA"中的szTip有效

WM_MOUSEMOVE=&H200 '使鼠标移动消息有效

End Enum

'定义一个"NOTIFYICONDATA"类型的变量

Public nidProgramData As NOTIFYICONDATA

以上是函数及常量声明和自定义的一个类型变量，下面是此API函数的调用方法：

2. 在窗体上用菜单编辑一个具有如下信息的菜单项：

主菜单：无标题、名称(mainMenu)

子菜单：标题(API编程)、名称(submnul);

标题(退出)、名称(submnu2).

这里只是举个例子，具体的功能你可以根据你的具体需要来编辑此菜单项

3. 在窗体的Load事件中添加如下代码：

Private Sub Form_Load()

'隐藏窗体

With Me

.Top =-10000

.Left = -10000

.WindowState = vbMinimized

End With

'设置类型NOTIFYICONDATA所具有的特征

With nidprogramData

.cbSize = Len(nidProgramData)

.hwnd = Me.hwnd .uld = vbNull

.uFlags = NIF_ICON Or NIF_TIP Or NIF_MESSAGE

'触发鼠标移动消息

.uCallbackMessage = WM_MOUSEMOVE

.hIcon = Me.Icon '“托盘”中放入窗体图标，你可以把窗体的图标换成你所喜欢的图标

.szTip ="VB 的 Win32 API 编程" & vbNullChar

End With

'调用该函数

Shell_NotifyIcon NIM_ADD,nidprogramData

End Sub

'根据不同的鼠标消息做不同的操作

Private Sub Form_MouseMove(Button As inte ger, Shift As lnteger, x As Single, Y As Single)

On Error GoTo Form_MouseMove_err:

Dim Result As Long

Dim msg As Long

'X的值依赖与显示模式的设置

If Me.ScaleMode = vbpixels Then

msg = x

Else

msg = x/Screen.TwipsPerPixe1X

End If

Select Case msg

Case WM_LBUTTONUP

'在这里加入鼠标左键释放时你想做的操作

Case WM_LBUTTONDBLCLK

'在这里加入双击鼠标左键时你想做的操作

Case WM_RBUTTONUP

'通常这里弹出你的功能菜单

PopupMenu mainMenu

Case WM_MOUSEISMOVING

'在这里加入鼠标正在移动时你想做的操作

End Select

Exit Sub

Form_MouseMove_err:

'在这里加入你的处理异常错误的代码

End Sub

4.Run你的程序，您是不是看到了象“金山词霸”一样的功能？相信你此时的感觉一定特别“爽”！

API的世界j是丰富多彩的，只要你肯细心地去探索它你一定会获得许多意想不到的好东西。所以笔者觉得定值得每一个具有“好奇”精神的人去探索它。后续的期刊笔者会向读者详细介绍一些更好更“牛”的API调用。

一. 注册表的API编程

关于注册表的知识相信您通过前面专题的介绍已经有了较深入的了解。系统有六个预定义好的关键字，这六个关键字是用户或系统访问注册表的入口点。我们常用到的只有前四个关键字。而在编程时我们一般用到只是HKEY_CURRENT_USER和HKEY_LOCAL_MACHINE这两个关键字，因为与应用程序相关的数据存在于这两个关键字下。

许多商品化的软件或专业化的软件在您的机器上首次安装的时候都会通过改写注册表来完成软件的正确安装运行，梦想成为编程高手的你当然需要掌握读写注册表这一技术。利用好注册表会为您的应用程序增色不少。

虽然VB本身提供了四个关于注册表的函数GetSetting，SaveSetting、GetAllSettings、DeleteSetting（这四个函数的使用比较简单读者可以参考VB的联机帮助），但是这四个函数只能在“HKEY_CURRENT_USER\Software\VB and VBA ProgramSettings”下读取、删除、修改键值。对于一般的应用程序利用它们可以达到您的目的，对于特殊的要求利用它们就显的无能为力了。下面举一个例子说明它们的局限性。

熟悉DOS操作系统的读者都知道，可以编写一个“Autoexec.bat”的批处理文件来实现某一个应用程序在系统启动的时候自动运行，在Win95中我们可以把应用程序的快捷方式放到系统的启动组中来达到同样的效果。但是，假如我需要在我的应用程序首次安装以后就能自动达到这种效果，那该如何呢？其实，注册表中提供了三个这样的键：

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Run

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\RunOnce

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\RunServices

这三个键字的区别是：

Run：此键字下的应用程序在系统启动的时候会自动运行；

RunOnce：此键字下的应用程序在系统下一次启动的时候会自动运行，以后不再运行；

RunServices：功能和“Run”一样，只是应用程序被启动的时候不同而已。

现在您一定知道该如何利用注册表达到您的要求了。实际上许多安装软件在安装向导完成后要您重新启动才能完成最终的安装。它就是把安装向导所需做的最后工作的程序写到“RunOnce”下实现的。但是，若只利用VB本身的那四个函数显然是无法实现此功能的。笔者在实践中通过调用API函数很好地解决了VB本身访问注册表的局限性，并把它做成了一个类模块。所以调用起来非常方便。由于篇幅有限我只能从中抽取一部分来讲，这一部分也是可以独立运行的。读者想要完整的源代码请与我联系（yue_xiang263.net）。

下面是应该放到您的模块中的声明部分代码：

Option Explicit

'注册表的入口常量

Public Const HKEY_CLASSES_ROOT = &H80000000

Public Const HKEY_CURRENT_USER = &H80000001

Public Const HKEY_LOCAL_MACHINE = &H80000002

Public Const HKEY_USERS = &H80000003

'注册表的访问权限常量

Public Const KEY_QUERY_VALUE = &H1

Public Const KEY_SET_VALUE = &H2

Public Const KEY_CREATE_SUB_KEY = &H4

Public Const KEY_ENUMERATE_SUB_KEYS = &H8

Public Const KEY_NOTIFY = &H10

Public Const KEY_CREATE_LINk = &H20

Public Const KEY_ALL_ACCESS = &H3F

'打开/建立键值的可选项常量

Public Const REG_OPTION_NON_VOLATILE = 0&

Public Const REG_OPTION_VOLATILE = &H1

'建立新键或打开已存在的键常量

Public Const REG_CREATED_NEW_KEY = &H1

Public Const REG_OPENED_EXISTING_KEY = &H2

'预先定义的访问注册表的权限常量

Public Const STANDARD_RIGHTS_ALL = &H1F0000

Public Const SPECIFIC_RIGHTS_ALL = &HFFFF

'API的返回代码常量

Public Const ERROR_SUCCESS = 0&

Public Const ERROR_ACCESS_DENIED = 5

Public Const ERROR_NO_MORE_ITEMS = 259

'返回数值类型常量

Public Const REG_NONE = (0)

Public Const REG_SZ = (1)

Public Const REG_EXPAND_SZ = (2)

Public Const REG_BINARY = (3)

Public Const REG_DWORD = (4)

PubliC ConSt REG_DWORD_LITTLE_ENDIAN = (4)

Public Const REG_DWORD_BIG_ENDIAN = (5)

Public Const REG_LINK = (6)

Public Const REG_MULTI_SZ = (7)

Public Const REG_RESOURCE_LIST = (8)

Public Const REG_FULL_RESOURCE_DESCRIPTOR = (9)

Public Const REG_RESOURCE_REQUIREMENTS_LIST = (10)

'访问注册表的API函数要用到的结构类型

Type SECURITY_ATTRIBUTES

nLength As Long

lpSecurityDescriptor As Long

bInheritHandle As Boolean

End Type

Type FILETIME

dwLowDateTime As Long

dwHighDateTime As Long

End Type

'要用到的API函数声明

…………

（鉴于篇幅这里只介绍一下各API的作用而不再一一列其声明；相关声明请读者查阅API浏览器）

下面简单地介绍一下这几个API：

RegOpenKeyEx()：打开指定的关键字（32位）；

RegSetValueEx()：在打开的注册表关键字的值域中存储数据；

RegCloseKey():释放指定的关键字的句柄；

RegQueryValueEx()：在注册表中查找与您指定的键值相关的值；

RegCreateKeyEx()：建立并打开指定的关键字，若已存在则打开它；

RegEnumKeyEx()：枚举指定的打开注册表关键字的子关键字（32位）；

RegEnumKey()：同上功能一样，区别在于它是16位的；

RegEnumValue()：每次调用枚举指定的打开注册表关键字的值复制一个带索引的值的名称和数据块；

RegDeletekey():删除一个关键字以及它的子关键字；

RegDeleteValue()：在指定的注册表关键字中删除一个带名字的值。

通过调用这些API我们可以轻松实现注册表的任意关键字的读取、查询、建立、删除。笔者在这里只打算介绍一下如何建立和删除一个特定的关键字。其它操作读者可以自己去发挥。

例如：要在HKEY_LOCAL_MACHINE\Network下建一个“MyApi”子键并在它的下面建立一个称为“yx”的值域，把它的值设为“yue1975”。我们应该按如下的方法调用API：

Dim phkResult As Long '保存建立的关键字句柄

Dim Iresult As Long

Dim SA As SECURITY_ATTRIBUTES

Dim 1Create As Long

'建立一个指定的关键字

caII RegCreateKeyEx(HKEY_LOCAL_MACHINE,"Network\MyApi",0,"",REG_OPTION_NON_VOLATILE, _

KEY_ALL_ACCESS,SA,phkResult,1Create)

1Result=RegSetValueEx(phkResult,"yx",0,REG_SZ,"yue1975",Clng(Len("yue1975")+1))

'关闭关键字

RegCloseKey phkResult

现在用注册表编辑器去查看一下注册表，一定生成了您所需的键值。

再例如：现在我想把刚才建立的键值删掉，那您只需如下调用即可：

dim success as long

success=RegDeleteKey(HKEY_LOCAL_MACHINE,"Network\MyApi")

二. 用API生成平面工具条

相信许多VB爱好者都曾千方百计地想使自己的工具条像Word97中的工具条一样COOL起来。往往我们不得不去借用别人做好的ActiveBar控件，这样先不说自己的程序变得大了，而且说实话那个控件并不好用。笔者在用VC5编程的时候用基类函数SendMessageLong()、FindWindowEx()轻松实现了这种COOL的效果。受此启发在VB5中调用这两个API也实现了同样的效果。下面是源代码：

把以下程序加到您的模块中：

'----------------------

'常量声明

'----------------------

Public Const WM_USER = &H400

'用户自定义消息的起点

Public Const TB_SETSTYLE = WM_USER + 56

'设置工具条风格消息

Public Const TB_GETSTYLE = WM_USER + 57

'取得工具条风格消息

Public Const TBSTYLE_FLAT = &H800

'使工具条COOL起来

Public Const TBSTYLE_TOOLTTPS = &H100

Public Const TBSTYLE_WRAPABLE = &H200

Public Const TBSTYLE_ALTDRAG = &H400

Public Const TBSTYLE_LIST = &H1000

Public Const TBSTYLE_CUSTOMERASE = &H2000

'-----------------

'API函数声明

'-----------------

Public Declare Function SendMessageLong Lib "user32" Alias "SendMessageA" (ByVal hwnd As Long,

ByVal wMsg As Long,ByVal wParam As Long,ByVal 1Param As Long) As Long

Public Declare Function FindWindowEx Lib "user32" Alias "FindWindowExA" (ByVal hWnd1 As Long,

ByVal hWnd2 As Long,ByVal 1psz1 As String,ByVal 1psz2 As String) As Long

'-----------------------

'通用生成平面工具条过程

'入口:工具条的名字

'-----------------------

Public Sub FlatBar(ByVal tb As Toolbar)

Dim style As Long

Dim hToolbar As Long

Dim r As Long

'获的工具条窗口句柄

hToolbar = FindWindowEx(tb.hwnd,0&,"ToolBarWindow32",vbNullString)

'获的当前工具条的风格

style = SendMessageLong(hToolbar,TB_GETSTYLE,0&, 0&)

If style And TBSTYLE_FLAT Then

style = style Xor TBSTYLE_FLAT

Else

style = style or TBSTYLE_FLAT

End If

'设置工具条的平面风格

r=SendMessageLong(hToolbar,TB_SETSTYLE,0, style)

tb.Refresh

End Sub

过程FlatBar()的调用方法：

1 . 在你的窗体上添加Toolbar控件（命名为：myTB）和ImageList控件。按通常的方法一样在ImageList中播入几个图标并和Toolbar绑定建立一个平常的工具条。

2 . 在窗体的Load()事件中调用FlatBar()

Call FlatBar(myTB)

3. 运行，您的工具条一定COOL起来了。