当前位置：首页 > 实用文档 > 其他范文> dbmsxplan之display函数的使用

dbmsxplan之display函数的使用

时间：2024-02-06 07:26:04 其他范文收藏本文下载本文

dbmsxplan之display函数的使用（推荐7篇）由网友“长蜜蜂”投稿提供，以下是小编为大家准备的dbmsxplan之display函数的使用，欢迎大家前来参阅。

篇1：dbmsxplan之display函数的使用

DBMS_XPLAN包包括一系列函数，主要是用于显示SQL语句的执行计划，且不同的情形下使用不同的函数来显示，如预估的执行计划则使用

display函数,而实际的执行计划则是用display_cursor函数，对于awr中的执行计划，则是用display_awr函数，而SQL tuning集合中的执行计划

则由display_sqlset来完成，本文主要描述DBMS_XPLAN包中display函数的使用，尽管可以通过SQL语句来查询缺省表plan_table来获得执行计划，

事实上，使用display函数更便捷，且display函数提供了多种不同的显示格式。

有关执行计划中各字段模块的描述请参考：执行计划中各字段各模块描述

有关由SQL语句来获取执行计划请参考：使用EXPLAIN PLAN获取SQL语句执行计划

有关使用autotrace来获取执行计划请参考：启用AUTOTRACE功能

有关display_cursor函数的使用请参考： /database/02/120814.html

一、DBMS_XPLAN包中的函数

[sql] view plaincopyprint?

SQL>desc dbms_xplan -->列出几个常用的

FUNCTION DISPLAY RETURNS DBMS_XPLAN_TYPE_TABLE

Argument Name Type In/Out Default?

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

TABLE_NAME VARCHAR2 IN DEFAULT

STATEMENT_ID VARCHAR2 IN DEFAULT

FORMAT VARCHAR2 IN DEFAULT

FILTER_PREDS VARCHAR2 IN DEFAULT

FUNCTION DISPLAY_AWR RETURNS DBMS_XPLAN_TYPE_TABLE

Argument Name Type In/Out Default?

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

SQL_ID VARCHAR2 IN

PLAN_HASH_VALUE NUMBER(38) IN DEFAULT

DB_ID NUMBER(38) IN DEFAULT

FORMAT VARCHAR2 IN DEFAULT

FUNCTION DISPLAY_CURSOR RETURNS DBMS_XPLAN_TYPE_TABLE

Argument Name Type In/Out Default?

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

SQL_ID VARCHAR2 IN DEFAULT

CURSOR_CHILD_NO NUMBER(38) IN DEFAULT

FORMAT VARCHAR2 IN DEFAULT

二、display函数

1、display函数的几个参数

table_name

指定计划表的名字，缺省值为'PLAN_TABLE'.

statement_id

SQL语句的ID号，是在生成执行计划时使用set statement_id名令设定的值，默认值为NULL,当使用默认值时，将显示最近

插入计划表中的执行计划(filter_preds参数的值为空时)

format

用于控制display函数输出的内容。其常用取值为basic,typical,serial,all,advanced。其中typical为缺省值

除了上述几个取值外，还可以配合一些额外的修饰符来显示不同的内容。如：

alias、bytes、cost、note、outline、parallel、paration、predicate等

常用取值组合修饰符的例子：

basic +predicate、basic +outline(需要某个修饰符使用“+”号来连接)

typical -bytes、typical +alias -bytes -cost(不需要某个修饰符使用“-”号来连接)

注：“+”号与“-”号前面应保留空格

filter_preds

过滤谓词。用于过滤从plan_table表中返回的记录。当该值为NULL时，执行计划显示最近插入计划表中的执行计划。

如：filter_preds=>'plan_id = 223'

2、format参数常用值描述

basic 仅仅显示最少的信息。基本上包括操作和操作的对象

typical 显示大部分信息。基本上包括除了别名，提纲和字段投影外的所有信息，此为缺省值。

serial 类似于typical，但不显示并行操作

all 显示除提纲之外的所有信息

advanced 显示所有信息

3、format参数修饰符

alias 控制包含查询块与别名的显示部分

bytes 控制执行计划表中字段bytes的显示

cost 控制执行计划表中字段cost的显示

note 控制包含注释信息的显示部分

outline 控制包含提纲信息的显示部分

parallel 控制包含并行处理信息的提示

partition 控制并行处理信息的显示，尤其是执行计划表中字段TQ、IN-OUT、PQ Distrib的显示

peeked_binds 控制包含绑定变量窥探部分的显示。仅当生成执行计划时使用了绑定变量是可见

predicate 控制包含谓词filter和access显示部分

projection 控制包含投影信息的显示部分

remote 控制远程执行的SQL语句的显示

rows 控制执行计划表中字段rows的显示

三、演示使用display函数获取执行计划(演示版本Oracle 10g R2)

1、使用EXPLAIN PLAN加载预估的执行计划

[sql] view plaincopyprint?

SQL>EXPLAIN PLAN SET STATEMENT_ID='TSH' FOR

2 SELECT *

3 FROM emp e, dept d

4 WHERE e.deptno = d.deptno

5 AND e.ename = 'SMITH';

Explained.

2、使用display函数查看执行计划

[sql] view plaincopyprint?

/*------------- 使用了basic模式，且指定了table_name，statement_id -----------------*/

/**************************************************/

/* Author: Robinson Cheng */

/* Blog: blog.csdn.net/robinson_0612 */

/* MSN: robinson_0612@hotmail.com */

/* QQ: 645746311 */

/**************************************************/

SQL>SET LINESIZE 130

SQL>SELECT *

2 FROM TABLE(DBMS_XPLAN.DISPLAY('PLAN_TABLE','TSH','BASIC'));

PLAN_TABLE_OUTPUT

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

Plan hash value: 351108634

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

| Id | Operation | Name |

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

| 0 | SELECT STATEMENT | |

| 1 | NESTED LOOPS | |

| 2 | TABLE ACCESS FULL | EMP |

| 3 | TABLE ACCESS BY INDEX ROWID| DEPT |

| 4 | INDEX UNIQUE SCAN | PK_DEPT |

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

11 rows selected.

/*---------------- 使用basic +predicate模式--------------------*/

SQL>set pagesize 0

SQL>select * from table(dbms_xplan.display(null,'TSH','basic +predicate'));

Plan hash value: 351108634

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

| Id | Operation | Name |

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

| 0 | SELECT STATEMENT | |

| 1 | NESTED LOOPS | |

|* 2 | TABLE ACCESS FULL | EMP |

| 3 | TABLE ACCESS BY INDEX ROWID| DEPT |

|* 4 | INDEX UNIQUE SCAN | PK_DEPT |

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

Predicate Information (identified by operation id):

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

2 - filter(“E”.“ENAME”='SMITH')

4 - access(“E”.“DEPTNO”=“D”.“DEPTNO”)

17 rows selected.

/*--------------- 使用typical模式当format为null时的缺省模式 ------------*/

SQL>select * from table(dbms_xplan.display(null,'TSH','typical'));

Plan hash value: 351108634

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

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

| 0 | SELECT STATEMENT | | 1 | 117 | 4 (0)| 00:00:01 |

| 1 | NESTED LOOPS | | 1 | 117 | 4 (0)| 00:00:01 |

|* 2 | TABLE ACCESS FULL | EMP | 1 | 87 | 3 (0)| 00:00:01 |

| 3 | TABLE ACCESS BY INDEX ROWID| DEPT | 1 | 30 | 1 (0)| 00:00:01 |

|* 4 | INDEX UNIQUE SCAN | PK_DEPT | 1 | | 0 (0)| 00:00:01 |

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

Predicate Information (identified by operation id):

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

2 - filter(“E”.“ENAME”='SMITH')

4 - access(“E”.“DEPTNO”=“D”.“DEPTNO”)

Note

-----

- dynamic sampling used for this statement

21 rows selected.

/*------------- 查看plan_table中STATEMENT_ID为TSH的PLAN_ID值-------------------*/

SQL>select statement_id,plan_id from plan_table where rownum<2;

STATEMENT_ID PLAN_ID

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

TSH 223

/*-------------- 使用了advanced -bytes模式,且指定了filter_preds为223 -------------*/

SQL>select * from table(dbms_xplan.display(null,null,'advanced -bytes','plan_id = 223'));

Plan hash value: 351108634

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

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

| 0 | SELECT STATEMENT | | 1 | 4 (0)| 00:00:01 |

| 1 | NESTED LOOPS | | 1 | 4 (0)| 00:00:01 |

|* 2 | TABLE ACCESS FULL | EMP | 1 | 3 (0)| 00:00:01 |

| 3 | TABLE ACCESS BY INDEX ROWID| DEPT | 1 | 1 (0)| 00:00:01 |

|* 4 | INDEX UNIQUE SCAN | PK_DEPT | 1 | 0 (0)| 00:00:01 |

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

Query Block Name / Object Alias (identified by operation id):

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

1 - SEL$1

2 - SEL$1 / E@SEL$1

3 - SEL$1 / D@SEL$1

4 - SEL$1 / D@SEL$1

Outline Data

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

/*+

BEGIN_OUTLINE_DATA

USE_NL(@“SEL$1” “D”@“SEL$1”)

LEADING(@“SEL$1” “E”@“SEL$1” “D”@“SEL$1”)

INDEX_RS_ASC(@“SEL$1” “D”@“SEL$1” (“DEPT”.“DEPTNO”))

FULL(@“SEL$1” “E”@“SEL$1”)

OUTLINE_LEAF(@“SEL$1”)

ALL_ROWS

OPTIMIZER_FEATURES_ENABLE('10.2.0.3')

IGNORE_OPTIM_EMBEDDED_HINTS

END_OUTLINE_DATA

Predicate Information (identified by operation id):

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

2 - filter(“E”.“ENAME”='SMITH')

4 - access(“E”.“DEPTNO”=“D”.“DEPTNO”)

Column Projection Information (identified by operation id):

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

1 - (#keys=0) “E”.“EMPNO”[NUMBER,22], “E”.“ENAME”[VARCHAR2,10],

“E”.“JOB”[VARCHAR2,9], “E”.“MGR”[NUMBER,22], “E”.“HIREDATE”[DATE,7],

“E”.“SAL”[NUMBER,22], “E”.“COMM”[NUMBER,22], “E”.“DEPTNO”[NUMBER,22],

“D”.“DEPTNO”[NUMBER,22], “D”.“DNAME”[VARCHAR2,14],

“D”.“LOC”[VARCHAR2,13]

2 - “E”.“EMPNO”[NUMBER,22], “E”.“ENAME”[VARCHAR2,10],

“E”.“JOB”[VARCHAR2,9], “E”.“MGR”[NUMBER,22], “E”.“HIREDATE”[DATE,7],

“E”.“SAL”[NUMBER,22], “E”.“COMM”[NUMBER,22], “E”.“DEPTNO”[NUMBER,22]

3 - “D”.“DEPTNO”[NUMBER,22], “D”.“DNAME”[VARCHAR2,14],

“D”.“LOC”[VARCHAR2,13]

4 - “D”.ROWID[ROWID,10], “D”.“DEPTNO”[NUMBER,22]

Note

-----

- dynamic sampling used for this statement

60 rows selected.

/*---------------- 既有“+”也有“-”修饰符的情形-----------------------*/

SQL>select * from table(dbms_xplan.display(null,null,'typical +alias -bytes -cost'));

Plan hash value: 351108634

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

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

| 0 | SELECT STATEMENT | | 1 | 00:00:01 |

| 1 | NESTED LOOPS | | 1 | 00:00:01 |

|* 2 | TABLE ACCESS FULL | EMP | 1 | 00:00:01 |

| 3 | TABLE ACCESS BY INDEX ROWID| DEPT | 1 | 00:00:01 |

|* 4 | INDEX UNIQUE SCAN | PK_DEPT | 1 | 00:00:01 |

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

Query Block Name / Object Alias (identified by operation id):

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

1 - SEL$1

2 - SEL$1 / E@SEL$1

3 - SEL$1 / D@SEL$1

4 - SEL$1 / D@SEL$1

Predicate Information (identified by operation id):

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

2 - filter(“E”.“ENAME”='SMITH')

4 - access(“E”.“DEPTNO”=“D”.“DEPTNO”)

Note

-----

- dynamic sampling used for this statement

29 rows selected.

四、总结

1、display函数仅仅针对预估的执行计划，而不是实际的执行计划

2、display函数显示了预估的执行计划且显示格式灵活，可以以不同的输出格式呈现

3、当所有参数为null的情况下，显示执行计划表中(缺省为plan_table)最后一条语句的执行计划

4、尽管可以通过SQL语句查询plan_table来获取执行计划，建议直接使用display函数，这足够说明一切问题

5、当SQL语句中使用了绑定变量时，由explain plan获得的执行计划是不可靠的

篇2：在VB中使用API函数 (之四)VB

在VB中使用API函数 (之四) 回调(CallBacks) 所谓回调,就是你自己定义一个函数,并告诉Windows何时为何调用.你可以写一个有特定数量和类型参数的函数,然后告诉Windows何时调用,并传递给它所需的参数.Windows就会调用你定义的函数,处理参数,并给你返回值. 回调

在VB中使用API函数 (之四)

回调(CallBacks)

所谓回调,就是你自己定义一个函数,并告诉Windows何时为何调用.你可以写一个有特定数量和类型参数的函数,然后告诉Windows何时调用,并传递给它所需的参数.Windows就会调用你定义的函数,处理参数,并给你返回值.

回调的一个典型应用是从Windows获得连续的数据流.这里是一个需要回调的函数的声明:

Declare Function EnumWindows Lib “User32”ByVal lpEnumFunc As Long, ByVal lParam As Long) As Long

第一个参数是你的回调函数的地址,第二个参数是你想传递的的任意数值.该值将被传递到你的函数,于是你就知道了它要调用什么.

VB 5.0已经提供了一个很有用的操作符 AddressOf ,可以得到一个函数的地址.当你调用一个函数时它只能用在参数的前面,下面这种用法是错误的并且会导致出错:

FuncP = AddressOf MyFunction

因此你必须这样调用EnumWindows函数:

Suclearcase/“ target=”_blank“ >ccess& = EnumWindows(AddressOf cbFunc, 58&)

你必须也要自己写回调函数.问题是有很多不同类别的回调并且有各种各样的参数,有关这些参数的描述可以在SDK帮助或MS SDK文档中找到.这里是一个回调的声明:

Function cbFunc (ByVal Hwnd, ByVal lParam) as Long

这里是一个回调的例子:

Private Declare Function GetWindowText Lib ”user32“ Alias ”GetWindowTextA“(ByVal hwnd As Long,ByVal lpString As String,ByVal cch As Long) As Long

Success& = EnumWindows(AddressOf cbFunc, 58&)

Function cbFunc (ByVal Hwnd, ByVal lParam) as Long

If lParam = 58 then 注释：enum windows

Str$ = Space(255)

Ret& = GetWindowText(Str$, Len(Str$))

Debug.Print Left(Str$, Ret&)

End If

End Function

这个例子将列出窗口的标题,(不包含子窗体)

窗口程序

Windows并不知道事件. 这些是VB特有的隐藏Windows获取你的窗口发生事件的真正方法的一种方式.VB很像是一个将Windows语言翻译成VB语言的解释器.

但是事实并非如此,你很快就会遇到.设想你想知道用户何时加亮了菜单选项(不是点击,只是加亮即选择了)VB并不提供这种事件,但你可能见到其他的程序,但你浏览它的菜单时状态栏会出现相应的文字.如果他们能,你为何不能?

OK,这里是大致的真实情况.每个窗口都有一个特殊的程序叫做窗口程序.它实际上是一个回调函数.该函数将在你的窗口发生事件的任何时间发送消息.这样当用户加亮一个菜单项时就会发送一条消息(WM_COMMAND).

那为什么我看不到这条消息呢?这是因为是VB创建窗口程序而不是你.当Windows发送消息时,该程序将为之分派特定的事件,并将其参数转换为比较容易用的事件的参数.但是在有些情况下,它会忽略有些消息而不能收到真实的输入.如果你真的想得到这些消息,你必须对你的窗体进行子类处理,我们将在另外一个主题中谈到.

这里是一个回调窗口程序的声明:

Function WindowProc(ByVal Hwnd As Long, ByVal wMsg As Long,ByVal wParam As Long, ByVal lParam As Long) As Long

第一个参数指定窗口的句柄,第二个参数是消息的标识符(如WM_COMMAND或WM_MOUSEMOVE),wParam和lParam时两个32位的数值,它们的意义依赖于消息的类型.

原文转自：www.ltesting.net

篇3：在VB中使用API函数 (之五)VB

在 VB 中使用API函数 (之五) 子类处理当你一最大限度利用了VB所给你的并且还想知道更多的东西,或只是想更多地了解你自己的窗口,你将会发现子类处理的优势. 子类处理是指用一个新的窗口函数来取代当前活动窗口函数.这个用户自定义函数能处理任何需要的消息,

在VB中使用API函数 (之五)

子类处理

当你一最大限度利用了VB所给你的并且还想知道更多的东西,或只是想更多地了解你自己的窗口,你将会发现子类处理的优势.

子类处理是指用一个新的窗口函数来取代当前活动窗口函数.这个用户自定义函数能处理任何需要的消息,并能调用原来的窗口函数,它将在原来的窗口函数之前收到各种消息.但原来的那个窗口处理函数依然存在,并没有消失.如果你不想处理某条消息,你应该让原来的窗口函数去处理它.

子类处理是通过调用SetWindowLong函数实现的,该函数将改变指定窗口的特殊属性.下面是它的声明:

Declare Function SetWindowLong Lib ”user32“ Alias ”SetWindowLongA“(ByVal hwnd As Long, ByVal nIndex As Long,ByVal dwNewLong As Long) As Long

第一个参数代表要进行子类处理的窗口,第二个参数应该是GWL_WNDPROC(-4),第三个参数是新的窗口函数的地址.参见回调和窗口函数一节.

此函数将在窗口取得焦点,发生事件,或其他情况下(如其他进程改变了系统的某些参数)被随时调用.

如果发生错误SetWindowLong函数将返回0,否则将返回原来的窗口函数的地址.这个地址特别重要,你应该把它保存在一个变量中或其他地方.当你不处理某些消息时(实际上,你可能只处理不到1%的消息,其他的都将由原窗口函数处理),调用原来的窗口函数就需要该地址.

调用原窗口函数将由CallWindowProc来完成.这里是它的声明:

Declare Function CallWindowProc Lib ”user32“ Alias”CallWindowProcA“(ByVal lpPrevWndFunc As Long,ByVal hWnd As Long,ByVal Msg As Long,ByVal wParam As Long, ByVal lParam As Long) As Long

第一个参数是原窗口函数的地址,其他的同你接收到的四个参数一样.你可以改变其中的值来控制对消息的处理.例如,当你收到了一条WM_MOUSEMOVE消息时,你从lParam中得到鼠标所在位置的坐标并将其改成了其他的坐标.那么原窗口函数就会认为鼠标位于其他的位置从而做出一些有趣的事如显示其他控件的Tooltip.

你指定的返回值也是有意义的,它依赖于发送的消息.

在结束你的程序时将控制权交回给原窗口函数是很重要的,通常在Form_Unload中完成如下:

Ret& = SetWindowLong(Me.Hwnd, GWL_WNDPROC, oldWndProcAddress)

如果你在VB中启动程序时忘掉了这一行,结果将是VB崩溃并会丢失尚未保存的数据.千万要小心.

这里是子类处理的一个简单示例:

Dim oldWndProc As Long

Private Sub Form_Load

ldWndProc = SetWindowLong(Me.Hwnd, GWL_WNDPROC, AddressOf MyWndProc)

End Sub

Private Sub Form_Unload()

Ret& = SetWindowLong(Me.Hwnd, GWL_WNDPROC, oldWndProc)

End Sub

Function MyWndProc(ByVal Hwnd As Long,ByVal wMsg as Long,ByVal wParam As Long,ByVal lParam As Long)

Debug.Print wMsg & ” “ & wParam & ” “ & lParam

Ret& = CallWindowProc(oldWndProc, Hwnd, wMsg, wParam, lParam)

End Function

处理参数

有时函数并不以你所需的方式返回信息.一个典型的例子是将两个代表鼠标位置的整形(2 byte)数合并为一个4 Byte的数.还有一个例子是判断一个数的某位是否为1.你还可能得到一个代表一个结构地址的Long型数.

合并和分离一个数并不需要过多的描述.你能在我们的网站(www.geocities.com/SiliconValley/Lab/1632/)上找到APIMacro.bas,它包含了你需要的多种函数.

可以用一下方法检查一个数的第N位是否为1:

If Value and (2^N) then ...

置1

Value = Value Or 2^N

置0

Value = Value And Not 2^N

如果你想设定或取得预先知道的某位的信息,用1024代替2^10要快的多.因为这样VB无需自己进行计算(VB憎恨 ”^“ ?).

如果你接收到一个类型的指针,你要做的工作将稍多一点.你可以使用CopyMem函数来取得信息.下面是它的声明:

Declare Sub CopyMem Lib ”kernel32“ Alias ”RtlMoveMemory“ (pDest As Any, pSource As Any, ByVal ByteLen As Long)

如果你接收到了一个指向RECT 类型的指针并存在Long型变量Addr 中,可以这样处理:

Dim Info As Rect

Call CopyMem(Info, ByVal Addr, len(Info))

注意ByVal关键字.现在,如果你想把信息写回,使用:

Call CopyMem(ByVal Addr, Info, Len(Info))

原文转自：www.ltesting.net

篇4：在VB中使用API函数 (之一)VB

在 VB 中使用API函数 (之一) 什么是API? API(Advanced Programmers Interface,高级程序员接口)(注:API实际是指Application Programming Interface,应用程序编程接口;此处疑为原文错误,不过在VB中也可以这么说吧!)是一套用来控制 Windows 的各个部件(从桌面

在VB中使用API函数 (之一)

什么是API?

API(Advanced Programmers Interface,高级程序员接口)(注:API实际是指Application Programming Interface,应用程序编程接口;此处疑为原文错误,不过在VB中也可以这么说吧!)是一套用来控制Windows的各个部件(从桌面的外观到位一个新进程分配的内存)的外观和行为的一套预先定义的Windows函数.用户的每个动作都会引发一个或几个函数的运行以Windows告诉发生了什么.

这在某种程度上很象Windows的天然代码.其他的语言只是提供一种能自动而且更容易的访问API的方法.VB在这方面作了很多工作.它完全隐藏了API并且提供了在Windows环境下编程的一种完全不同的方法.

这也就是说,你用VB写出的每行代码都会被VB转换为API函数传递给Windows.例如,Form1.Print...VB 将会以一定的参数(你的代码中提供的,或是默认参数)调用TextOut 这个API函数.

同样,当你点击窗体上的一个按钮时,Windows会发送一个消息给窗体(这对于你来说是隐藏的),VB获取这个调用并经过分析后生成一个特定事件(Button_Click).

API函数包含在Windows系统目录下的动态连接库文件中(如User32.dll,GDI32.dll,Shell32.dll...).

API 声明

正如在”什么是API“中所说,API函数包含在位于系统目录下的DLL文件中.你可以自己输入API函数的声明,但VB提供了一种更简单的方法,即使用API Text Viewer.

要想在你的工程中声明API函数,只需运行API Text Viewer,打开Win32api.txt(或.MDB如果你已经把它转换成了数据库的话,这样可以加快速度.注:微软的这个文件有很多的不足,你可以试一下本站提供下载的api32.txt),选择”声明“,找到所需函数,点击”添加(Add)“并”复制(Copy)“,然后粘贴(Paste)到你的工程里.使用预定义的常量和类型也是同样的方法.

你将会遇到一些问题:

假设你想在你的窗体模块中声明一个函数.粘贴然后运行,VB会告诉你:编译错误...Declare 语句不允许作为类或对象模块中的 Public 成员...看起来很糟糕,其实你需要做的只是在声明前面添加一个Private(如 Private Declare Function...).--不要忘了,可是这将使该函数只在该窗体模块可用.

在有些情况下,你会得到”不明确的名称“这样的提示,这是因为函数.常量或其他的什么东西共用了一个名称.由于绝大多数的函数(也可能是全部,我没有验证过)都进行了别名化,亦即意味着你可以通过Alias子句使用其它的而不是他们原有的名称,你只需简单地改变一下函数名称而它仍然可以正常运行.

你可以通过查看VB的Declare语句帮助主题来获取有关Alias的详细说明.

消息(Messages)

好了,现在你已经知道什么是API函数了,但你也一定听说过消息(如果你还没有,你很快就会)并且想知道它是什么.消息是Windows告诉你的程序发生了哪些事件或要求执行特定操作的基本方法.例如,当用户点击一个按钮,移动鼠标,或是向文本框中键入文字时,一条消息就会被发送给你的窗体.

所有发送的消息都有四个参数--一个窗口句柄(hwnd),一个消息编号(msg)还有两个32位长度(Long)的参数.

hwnd即要接受消息的一个窗口的句柄,msg即消息的标识符(编号).该标识符是指引发消息的动作类型(如移动鼠标),另外两个参数是该消息的附加参数(例如当鼠标移动时光标的当前位置)

但是,当消息发送给你时你为什么看不到呢--就象有人在偷你的信一样?请先别恼火,让我告诉你.

小偷其实是Visual Basic.但它并没有偷走你的信,而是在阅读了之后挑出重要的以一种好的方式告诉你.这种方式就是你代码中的事件(Event).

这样,当用户在你的窗体上移动鼠标时,Windows会发送一条WM_MOUSEMOVE消息给你的窗口,VB得到这条消息以及它的参数并运行你在事件MouseMove中的代码,同时VB会把这条消息的第二个32位数(它包含了x,y坐标,单位为像素(Pixel),每个位16位)转换为两个单精度数,单位为缇(Twip).

现在,如果你需要光标坐标的像素表示,然而VB已经把它转换成了缇,因此你需要重新把它转换为以像素为单位.在这里,Windows给了你所需要的,但VB”好意地“进行了转换而使你不得不重新转换.你可能会问--我难道不能自己接收消息吗?答案是肯定的,你可以使用一种叫做子类处理(Subclass)的方法.但你除非必须否则最好不要使用,因为这与VB的安全程序设计有一点点的违背.(注:子类处理确实有很大的风险,但如果使用得当,是很有用处的.不过有一点一定要注意,即千万不要使用VB的断点调试功能,这可能会导致VB崩溃!)

需要补充说明的是:你可以发送消息给你自己的窗口或其他的窗口,只需调用SendMessage或PostMessage(SendMessage会使接受到消息的窗口立刻处理消息,而PostMessage是把消息发送到一个称为消息队列的队列中去,等候处理(它将会在该消息处理完后返回,例如有些延迟)).你必须制定接受消息的窗口的句柄,欲发送消息的编号(所有的消息的编号均为常量,你可以通过API Text Viewer查得)以及两个32位的参数.

原文转自：www.ltesting.net

篇5：在VB中使用API函数 (之三)VB

在 VB 中使用API函数 (之三) Any 有些消息的参数声明为Any.这表示该参数是一种可变的类型(你可以以整型,字符串,用户自定义或其他的类型来传递). 这有一个这样的例子: Public Declare Function SendMessage Lib ”User32“ Alias ”SendMessageA“ ByVal Hwnd as

在VB中使用API函数 (之三)

Any

有些消息的参数声明为Any.这表示该参数是一种可变的类型(你可以以整型,字符串,用户自定义或其他的类型来传递).

这有一个这样的例子:

Public Declare Function SendMessage Lib ”User32“ Alias ”SendMessageA“ ByVal Hwnd as Long, ByVal wMsg as Long, ByVal wParam as Long, lParam as Any) as Long

lParam 声明为Any并按引用(ByRef)传递.

这里是在这个函数中如果lParam是不同类型的值时应遵循的规则:

如果该值是传递形式

numeric ByVal(as Long,or as Any)

Null ByVal(as Long,or as Any)

String ByRef(as String,or as Any)

Type ByRef(as Any)

array of Type ByRef(as Any)

如果你的函数声明同上面的一个而且你想传递一个Long型数,你应该这样写:

Call SendMessage(Me.Hwnd,WM_XXXX,0&,ByVal LongValue)

注意尽管头三个参数也是数值,但它们前边并没有ByVal.这是因为在函数声明中它们已经被声明为按值传递(ByVal).第四个参数,由于是按引用传递(ByRef)(VB并不知道你要传递参数的类型),因此你必须加上ByVal 你可以使用别名技术来传递不同类型的参数:

Public Declare Function SendMessageLng Lib ”User32“ Alias ”SendMessageA“(ByVal Hwnd as Long, ByVal wMsg as Long, ByVal wParam as Long, ByVal lParam as Long) as Long

或:

Public Declare Function SendMessageStr Lib ”User32“ Alias ”SendMessageA“(ByVal Hwnd as Long, ByVal wMsg as Long, ByVal wParam as Long, lParam as String) as Long

注意API参数类型本身是不会改变的.例子中的第四个参数总是一个4字节的长型数.当你按值(ByVal)传递一个Long或 Null时,该4字节长的数值就直接传递给函数.如果你传递一个String或其他的什么,你是按引用(ByRef)传递,VB传递的实际上是变量的地址,也是4个字节.

参数传递

你已经知道如何传递参数了,只需把他放到调用的函数中即刻.然而,当你使用API函数时,在传递参数是有一些你应该注意的细节. ByVal还是ByRef. 通常情况下,你不用为此担心,VB的API浏览器已经为你做好了一切,只需你输入数值它就会照所声明的方式传递.总的来说,ByVal是把实际的数值传递给函数,而ByRef是把地址传给函数.唯一的麻烦就是 Any 类型. 把字符串传递给API函数也并不难.API函数需要的是字符串首字符的地址,然后读取该地址直到遇到一个Null字符.听起来很糟糕,但只是VB处理字符串的实际方法.你唯一要记住的是一定要按引用传递(ByRef)字符串当你想得到所需的函数返回值信息时,情况有稍微的一点不同.

这里是GetComputerName函数的声明:

Declare Function GetComputerName Lib ”kernel32“ Alias ”GetComputerNameA“(ByVal lpBuffer As String, nSize As Long) As Long

第一个参数是一个指向字符串的远程指针,第二个参数是字符串的长度.

如果你只是简单的声明一个字符串类型的变量并把它传递给函数,就会出现错误.因此,你首先需要初始化字符串.这里是如何得到计算机名字的例子: Dim Buffer As String

Buffer = Space(255)

Ret& = GetComputerName(Buffer, Len(Buffer))

if Ret& >0 then CompName$ = Left(Buffer, Ret&)

在这里,待传递的字符串被初始化为有255个空格的字符串.我们把它传递给函数同时还有它的长度.如果出错则返回值为0.

CompName中将保存计算机名. 有些函数也需要传递数组,这里是一个例子:

Declare Function SetSysColors Lib ”user32“ Alias ”SetSysColors“ (ByVal nChanges As Long, lpSysColor As Long, lpColorValues As Long) As Long

最后两个参数是Long型数组.为了传递数组,你只需传递它的第一个元素.下面是示例代码:

Const COLOR_ACTIVECAPTION = 2

Const COLOR_INACTIVECAPTION = 3

Const COLOR_CAPTIONTEXT = 9

Const COLOR_INACTIVECAPTIONTEXT = 19

Dim SysColor(3) As Long

Dim ColorValues(3) As Long

Dim Ret& SysColor(0) = COLOR_ACTIVECAPTION

SysColor(1) = COLOR_INACTIVECAPTION

SysColor(2) = COLOR_CAPTIONTEXT

SysColor(3) = COLOR_INACTIVECAPTIONTEXT

ColorValues(0) = RGB(58, 158, 58) 注释：深绿

ColorValues(1) = RGB(93, 193, 93) 注释：浅绿

ColorValues(2) = 0 注释：黑色

ColorValues(3) = RGB(126, 126, 126) 注释：灰色

Ret& = SetSysColors(4&, SysColor(0), ColorValues(0))

该程序将改变所有活动和非活动窗口的标题栏背景和文本的颜色.

原文转自：www.ltesting.net

篇6：在VB中使用API函数 (之二)VB

在VB中使用API函数 (之二) Windows的一些特别之处这个主题是要告诉你Windows 的一些与在VB中的不同的细节 Windows通过句柄(Handle)识别每个窗体,控件,菜单,菜单项或其他任何你能想得到的东西.当你的程序运行时,它所包含的每个部件都有一个唯一确定的句柄用

在VB中使用API函数 (之二)

Windows的一些特别之处

这个主题是要告诉你Windows 的一些与在VB中的不同的细节

Windows通过句柄(Handle)识别每个窗体,控件,菜单,菜单项或其他任何你能想得到的东西.当你的程序运行时,它所包含的每个部件都有一个唯一确定的句柄用来同其他的部件相区别.例如,某个按钮得句柄就与其他部件不同,当你想要通过API来执行有关该按钮的某种操作时就必须使用这个句柄.从哪儿得到它呢?VB 为每个拥有Windows句柄的控件都提供了Hwnd属性来表示其句柄.

Windows 使用像素(Pixel)而不是缇(Twip).因此,把涉及API函数调用的控件的ScaleMode属性设为3--(Pixel)是个不错的主意,这样你可以通过ScaleXXX属性得到它们的公制单位值.尽管这样,你可能有时仍需要进行从Twip到Pixel的转换(反之亦然),你可以通过Screen对象的TwipsPerPixelX和TwipsPerPixelY来实现.举例如下:

PixelXValue=TwipXValueScreen.TwipsPerPixelX

PixelYValue=TwipYValueScreen.TwipsPerPixelY

TwipXValue=PixelXValue*Screen.TwipsPerPixelX

TwipYValue=PixelYValue*Screen.TwipsPerPixelY

我并没有在实际中见到过TwipsPerPixelX 和 TwipsPerPixelY 的值有什么不同,但你最好是把它们区别开来而不是混用,这至少是一种好的程序设计风格.另外需要注意的是,这里用的是” “(整除) 而不是 ” / “ ,这是因为像素值必须是整数.

另外需要提到的是,Windows函数中用到了不同的坐标系统,因此需要注意.

最后要注意的是,一旦你使用了API 函数,VB就可能不再可靠了---API调用中一个简单的语法错误就会导致VB 崩溃!(请经常保存您的工程).VB 并不能识别API调用中的错误,因此一旦你的程序出现异常,要先检查API调用---是否缺少 ByVal,或者是错误的类型,参数等等.

从哪里得到有关函数的说明?

这个主题不会告诉你如何通过API函数改变按钮文字或如何快速查找一个文件.这不是一个API函数文档.

为了得到有关函数的说明,你需要SDK帮助或微软的SDK文档(至少有40M---我怎么可能放在这里?).这些SDK帮助通常都包含在BorlandDephli 3.0开发包或者MS Visual C++中.到网上去或找您的朋友要一个,版本越新越好

注意Win3.x 的SDK 帮助对你并没有用,因为很多函数已经过于陈旧甚至废弃不用,尽管他们中的大多数由于与 Windows95兼容而依然存在.

API参数类型

如果你已经有了一个SDK帮助,你肯定主意到了函数的返回之或参数有很多奇怪的类型如VOID,LPCSTR, 和DWORD.如果你对C语言比较熟悉的话,那你肯定明白它们的意思.对于其他不熟悉C语言的人,这里有一张摘自 VB

Books Online(标题是:C语言声明到Visual Basic的转换)

C 语言数据类型在VB中的声明 Call with

ATOM ByVal variable As Integer An expression that evaluates to an Integer

BOOL ByVal variable As Long An expression that evaluates to a Long

BYTE ByVal variable As Byte An expression that evaluates to a Byte

CHAR ByVal variable As Byte An expression that evaluates to a Byte

COLORREF ByVal variable As Long An expression that evaluates to a Long

DWORD ByVal variable As Long An expression that evaluates to a Long

HWND, HDC,HMENU,etc.(Windows handles) ByVal variable As Long An expression that evaluates to a Long

INT, UINT ByVal variable As Long An expression that evaluates to a Long

LONG ByVal variable As Long An expression that evaluates to a Long

LPARAM ByVal variable As Long An expression that evaluates to a Long

LPDWORD variable As Long An expression that evaluates to a Long

LPINT, LPUINT variable As Long An expression that evaluates to a Long

LPRECT variable As type Any variable of that user-defined type

LPSTR, LPCSTR ByVal variable As String An expression that evaluates to a String

LPVOID variable As Any Any variable (use ByVal when passing a string)

LPWORD variable As Integer An expression that evaluates to an Integer

LRESULT ByVal variable As Long An expression that evaluates to a Long

NULL As Any orByVal variable As Long ByVal Nothing or ByVal 0& orvbNullString

SHORT ByVal variable As Integer An expression that evaluates to an Integer

VOID Sub procedure Not applicable

WORD ByVal variable As Integer An expression that evaluates to an Integer

WPARAM ByVal variable As Long An expression that evaluates to a Long

注释:

你应该注意到了BOOL类型(Boolean)求出的值为Long而不是Boolean.因此0表示”假“(False),其他任何值表示”真“(True).

HWND,HDC,HMENU,etc.---etc.指其他所有与于前面所述相似的类型.它们都以”H“开头来表示不同对象的句柄.举例来说,HBITMAP表示一副位图的句柄,HBRUSH标是一个刷子的句柄等等.它们均为Long而且要按值传递(ByVal).

同样要注意LPVOID被声明为Any型变量,本文将会有独立的一个主题用来论述Any类型.

有些类型以”LP“开头.LP 是Long Pointer的缩写.因此LPWORD实际表示数据所存的内存地址.不过,你并没有必要调用某个函数来获取这个地址.当你按引用(ByRef)传递参数时,你实际上传递的就是它的地址.在这里你只需记住:如果某个参数的类型以”LP“开头,应该按引用(ByRef)传递.顺便说一句,LPARAM 与 Lparam 很相似但不是Lparam,Lparam不是一个指针,在这里你必须传递它的真实值,因此要按值(ByVal)传递.

NULL也是一种奇怪的类型.你可以从 VB 中了解到有关它的描述,这里我不去讨论它.按你需要的形式传递它吧,在大多数情况下,可以用 ByVal 0& 或 vbNullString.

最后,VOID是用来指那些没有返回值的函数的.API中没有SUBs,这就是它们的标志.只要记住:如果一个函数被声明为VOID ,你必须在 VB 中把它声明为 SUB.

原文转自：www.ltesting.net