声明:该内容开源于《指令字典2005XT.exe》,下载于http://www.skycn.com
如有侵权行为,请管理员或版主删除
AbortDoc
eclare Function AbortDoc Lib "gdi32" Alias "AbortDoc" (ByVal hdc As Long) As Long
说明
取消一份文档的打印。自上次调用StartDoc函数以来的所有输出都会被取消。如对打印机进行了配置,令其在正式打印文档之前先在打印缓冲区内对文档进行排队,那么文档的任何一部分都不会打印;否则,就可能出现文档打印到一半被取消的情况
返回值
Long,大于零表示成功,SP_ERROR表示失败。会设置GetLastError
参数表
参数 类型及说明
hdc Long,设备场景的句柄
在VB里使用
如将这个函数用于由打印机对象的hDC属性指定的打印机设备场景,那么它可以正常发挥作用。然而,倘若之后调用了EndDoc方法,却有可能得到一条打印机出错消息。当大家结合API打印函数与VB打印机方法的时候,强烈建议对打印机的错误进行跟踪捕获;或干脆避免这种结合
AbortPath
Declare Function AbortPath Lib "gdi32" Alias "AbortPath" (ByVal hdc As Long) As Long
说明
抛弃选入指定设备场景中的所有路径。也取消目前正在进行的任何路径的创建工作
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
hdc Long,设备场景
AbortPrinter
Declare Function AbortPrinter Lib "winspool.drv" Alias "AbortPrinter" (ByVal hPrinter As Long) As Long
说明
删除与一台打印机关联在一起的缓冲文件
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
hPrinter Long,一个已打开的打印机对象的句柄(用OpenPrinter获得)
注解
如打印机没有使用后台打印缓冲文件,那么该函数将无法发挥作用。例如,后台打印程序可将数据直接发给打印机
ActivateKeyboardLayout
Declare Function ActivateKeyboardLayout Lib "user32" Alias "ActivateKeyboardLayout" (ByVal HKL As Long, ByVal flags As Long) As Long
说明
激活一个新的键盘布局。键盘布局定义了按键在一种物理性键盘上的位置与含义
返回值
Long,如执行成功,返回前一个键盘布局的句柄;零表示失败。会设置GetLastError
参数表
参数 类型及说明
HKL Long,指定一个键盘布局的句柄。这个布局是随同LoadKeyboardLayout 或 GetKeyboardLayoutList函数载入的。也可用HKL_NEXT常数激活下一个已装载布局;或用HKL_PREV载入前一个布局
flags Long,将指定的键盘移至内部键盘布局列表的起始处
AddFontResource
Declare Function AddFontResource Lib "gdi32" Alias "AddFontResourceA" (ByVal lpFileName As String) As Long
说明
在Windows系统中添加一种字体资源。添加完毕后,该字体即可由任何Windows应用程序调用
返回值
Long,添加的字体数量,零表示失败。会设置GetLastError
参数表
参数 类型及说明
lpFileName String,字体资源文件的文件名。可以是.FON, .FNT, .TTF 或 .FOT文件
注解
添加了一种资源后必须调用下述API函数:
di% = SendMessageBynum(HWND_BROADCAST, WM_FONTCHANGE, x, y)
其中,HWND_BROADCAST、WM_FONTCHANGE使用来自API32.TXT文件的值。这样便可告诉所有Windows应用程序字体列表已发生了变化
示例
Call AddFontResource("myfont.ttf")
Call SendMessage(HWND_BROADCAST, WM_FONTCHANGE, 0, 0)
AddForm
Declare Function AddForm& Lib "spoolss.dll" Alias "AddFormA" (ByVal hPrinter As Long, ByVal Level As Long, pForm As FORM_INFO_1)
说明
为打印机的表单列表添加一个新表单。“表单”描述了一个页面大小及布局,提供了一种与设备无关的机制,可实现Windows NT下的纸张尺寸的标准化
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
hPrinter Long,一个已打开的打印机对象的句柄(用OpenPrinter获得)
Level Long,设为1
pForm FORM_INFO_1,对表单进行描述的一个结构
适用平台
Windows NT
其他
在VB的API文本查看器里复制的声明如下:
Declare Function AddForm Lib "winspool.drv" Alias "AddFormA" (ByVal hPrinter As Long, ByVal Level As Long, pForm As Byte) As Long
AddJob
Declare Function AddJob Lib "winspool.drv" Alias "AddJobA" (ByVal hPrinter As Long, ByVal Level As Long, pData As Byte, ByVal cdBuf As Long, pcbNeeded As Long) As Long
说明
用于获取一个有效的路径名,以便用它为作业创建一个后台打印文件。它也会为作业分配一个作业编号
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
hPrinter Long,一个已打开的打印机对象的句柄(用OpenPrinter获得)
Level Long,设为1
pData Byte,缓冲区会引用一个ADDJOB_INFO_1结构
cdBuf Long,pData缓冲区中的字符数量
pcbNeeded Long,指向一个Long型变量的指针,该变量用于保存请求的缓冲区长度,或者实际读入的字节数量
注解
调用这个函数以后,可创建指定的文件,向其中写入数据,然后用API函数ScheduleJob令其将数据发给打印机
ADDJOB_INFO_1
Type ADDJOB_INFO_1 ' 8 Bytes
lpPath As Long
JobId As Long
End Type
说明
Contains information regarding a print job
字段表
字段 类型及说明
lpPath Long,到文件名的一个路径
(Contains the path and filename that the application can use to store the print job.)
JobId Long,一个作业编号
AddMonitor
Declare Function AddMonitor Lib "winspool.drv" Alias "AddMonitorA" (ByVal pName As String, ByVal Level As Long, pMonitors As Byte) As Long
说明
为系统添加一个打印机监视器
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
pName String,欲在其中安装监视器的一个服务器的名字。对于本地(本机)监视器,请设置成vbNullString
Level Long,设为2
pMonitors Byte,指定一个结构中的第一个字节。那个结构又包含了一个MONITOR_INFO_2结构
Declare Function AddMonitor Lib "winspool.drv" Alias "AddMonitorA" (ByVal pName As String, ByVal Level As Long, pMonitors As Byte) As Long
说明
为系统添加一个打印机监视器
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
pName String,欲在其中安装监视器的一个服务器的名字。对于本地(本机)监视器,请设置成vbNullString
Level Long,设为2
pMonitors Byte,指定一个结构中的第一个字节。那个结构又包含了一个MONITOR_INFO_2结构
AddPort
Declare Function AddPort Lib "winspool.drv" Alias "AddPortA" (ByVal pName As String, ByVal hwnd As Long, ByVal pMonitorName As String) As Long
说明
启动“添加端口”对话框,允许用户在系统可用端口列表中加入一个新端口
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
pName String,欲在其中安装端口的一个服务器的名字。对本地(本机)端口,请设置成vbNullString
hwnd Long,指定AddPort对话框的父窗口的句柄
pMonitorName String,用于指定端口的一个监视器的名称
AddPrinter
Declare Function AddPrinter Lib "winspool.drv" Alias "AddPrinterA" (ByVal pName As String, ByVal Level As Long, pPrinter As Any) As Long
说明
在系统中添加一台新打印机
返回值
Long,如执行成功,返回一台新打印机的句柄;零表示失败。会设置GetLastError
参数表
参数 类型及说明
pName String,欲在其中安装打印机的一个服务器的名字。对本地打印机,设为vbNullString
Level Long,设为2
pPrinter Any,指定一个缓冲区的第一个条目。该缓冲区包含了一个PRINTER_INFO_2结构。结构中的下述字段会设为有效值:pPrinterName, pPortName, pDriverName, pPrintProcessor 和 pDataType。也可象PRINTER_INFO_2那样设置pPrinter字段。也可以设置下述字段:Attributes, DefaultPriority, pComment, pDevMode, pLocation, pParameters, Priority, pSecurityDescriptor, pSepFile, pShareName, StartTime 和 UntilTime。而其他字段都应置空
注解
在NT下,调用者必须有足够的权限对指定服务器上的打印机进行配置
AddPrinterConnection
Declare Function AddPrinterConnection Lib "winspool.drv" Alias "AddPrinterConnectionA" (ByVal pName As String) As Long
说明
连接指定的打印机
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
pName String,网络上的一台打印机的名字
AddPrinterDriver
Declare Function AddPrinterDriver Lib "winspool.drv" Alias "AddPrinterDriverA" (ByVal pName As String, ByVal Level As Long, pDriverInfo As Any) As Long
说明
为指定的系统添加一个打印驱动程序
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
pName String,指定要在其中安装驱动程序的一台服务器的名字。对于本地系统,设为vbNullString
Level Long,2或3(2仅适用于NT 3.51)
pDriverInfo Any,指定一个缓冲区,其中包含了一个DRIVER_INFO_2 或 DRIVER_INFO_3结构,它们指定了要添加的驱动程序
注解
在调用这个函数之前,所有驱动程序文件都必须位于适当的目录
AddPrintProcessor
Declare Function AddPrintProcessor Lib "winspool.drv" Alias "AddPrintProcessorA" (ByVal pName As String, ByVal pEnvironment As String, ByVal pPathName As String, ByVal pPrintProcessorName As String) As Long
说明
为指定的系统添加一个打印处理器
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
pName String,指定要在其中安装驱动程序的一台服务器的名字。对于本地系统,设为vbNullString
pEnvironment String,要在其中添加打印处理器的一个环境(如“Windows NT x86”)。对于当前(本地)系统环境,则设为vbNullString
pPathName String,包含了打印管理器的一个文件的名字。文件必须位于打印处理器目录中
pPrintProcessorName String,打印处理器的名字
AddPrintProvidor
Declare Function AddPrintProvidor Lib "winspool.drv" Alias "AddPrintProvidorA" (ByVal pName As String, ByVal Level As Long, pProvidorInfo As Byte) As Long
说明
为系统添加一个打印供应商
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
参数表
参数 类型及说明
pName String,指出要在其中安装打印供应商的一台服务器的名字。对于本地系统,设为vbNullString
Level Long,设为1
pProvidorInfo Byte,包含了一个PROVIDOR_INFO_1结构的缓冲区
AdjustWindowRect
Declare Function AdjustWindowRect Lib "user32" Alias "AdjustWindowRect" (lpRect As RECT, ByVal dwStyle As Long, ByVal bMenu As Long) As Long
Declare Function AdjustWindowRectEx Lib "user32" Alias "AdjustWindowRectEx" (lpRect As RECT, ByVal dsStyle As Long, ByVal bMenu As Long, ByVal dwEsStyle As Long) As Long
说明
在给定一种窗口样式的前提下,计算获得目标客户区矩形所需的窗口大小
返回值
Long,如执行成功,则返回非零值;如失败,返回零值。会设置GetLastError
参数表
参数 类型及说明
lpRect RECT,最初包含要求的客户区。由函数设为目标窗口矩形大小
dwStyle Long,窗口样式
bMenu Long,如窗口有菜单,则设为TRUE(非零)
dwEsStyle Long,扩展窗口样式(只适用于AdjustWindowRectEx)
注解
在调用本函数前,先用GetWindowLong取得一个窗体的样式。如菜单占用两行以上的空间,则函数不能正确计算大小。如程序使用了多行标题,则应使用GetSystemMetrics
AdjustWindowRectEx
Declare Function AdjustWindowRect Lib "user32" Alias "AdjustWindowRect" (lpRect As RECT, ByVal dwStyle As Long, ByVal bMenu As Long) As Long
Declare Function AdjustWindowRectEx Lib "user32" Alias "AdjustWindowRectEx" (lpRect As RECT, ByVal dsStyle As Long, ByVal bMenu As Long, ByVal dwEsStyle As Long) As Long
说明
在给定一种窗口样式的前提下,计算获得目标客户区矩形所需的窗口大小
返回值
Long,如执行成功,则返回非零值;如失败,返回零值。会设置GetLastError
参数表
参数 类型及说明
lpRect RECT,最初包含要求的客户区。由函数设为目标窗口矩形大小
dwStyle Long,窗口样式
bMenu Long,如窗口有菜单,则设为TRUE(非零)
dwEsStyle Long,扩展窗口样式(只适用于AdjustWindowRectEx)
注解
在调用本函数前,先用GetWindowLong取得一个窗体的样式。如菜单占用两行以上的空间,则函数不能正确计算大小。如程序使用了多行标题,则应使用GetSystemMetrics
AdvancedDocumentProperties
Declare Function AdvancedDocumentProperties Lib "winspool.drv" Alias "AdvancedDocumentPropertiesA" (ByVal hwnd As Long, ByVal hPrinter As Long, ByVal pDeviceName As String, pDevModeOutput As DEVMODE, pDevModeInput As DEVMODE) As Long
说明
启动打印机文档设置对话框。这个函数几乎完全等价于调用DocumentProperties函数,同时将fMode设为DM_IN_PROMPT。请参考对DocumentProperties函数的说明,了解这个函数的详细情况
返回值
Long,非零表示成功,零表示失败。会设置GetLastError
注解
将pDevModeOutput设为0后可得到要求的DEVMODE结构的大小
AngleArc
Declare Function AngleArc Lib "gdi32" Alias "AngleArc" (ByVal hdc As Long, ByVal x As Long, ByVal y As Long, ByVal dwRadius As Long, ByVal eStartAngle As Double, ByVal eSweepAngle As Double) As Long
说明
用一个连接弧画一条线,参考注解
返回值
Long,非零表示成功,零表示失败
参数表
参数 类型及说明
hdc Long,要在其中作图的设备场景
x,y Long,对弧进行描述的一个圆的中心点坐标
dwRadius Long,圆的半径
eStartAngle Double,线同圆连接时的角度(以度数为单位)
eSweepAngle Double,弧在圆上占据的范围(以度数为单位)
注解
注意eStartAngle和eSweepAngle参数是以度数为单位指定的,而且应该是单精度数(Single)而不是双精度。相应的函数声明为:Declare Function AngleArc& Lib "gdi32" (ByVal hdc As Long, ByVal x As Long, ByVal y As Long, ByVal dwRadius As Long, ByVal eStartAngle As Single, ByVal eSweepAngle As Single)。
我的理解:本文开头的函数声明复制于vb的api文本查看器,此处的声明来自于我的参考资料,也不知谁对谁错。参数表的说明,按vb的api文本查看器中复制来的声明中的数据类型。请使用者注意
AnyPopup
Declare Function AnyPopup Lib "user32" Alias "AnyPopup" () As Long
说明
判断屏幕上是否存在任何弹出式窗口
返回值
Long,如存在弹出式菜单,则返回TRUE(非零)
注解
对该函数来说,弹出式菜单包含所有可见的包容顶级窗口,无论弹出式还是重叠窗口
[此贴子已经被作者于2007-7-25 19:53:45编辑过]