当前位置：文档之家 › pb009参考手册API函数的声明和调用

pb009参考手册API函数的声明和调用

  • 格式：doc
  • 大小：222.50 KB
  • 文档页数：25

第2章API函数的声明和调用在PowerBuilder中，API函数的调用属于外部函数的范畴。

外部函数的调用与PowerBuilder的内部函数有许多不同之处，如在调用前必须预先声明、为函数传入正确的参数、指明函数传递的方式，以及定义函数返回值的类型等等。

2.1 PowerBuilder中API函数声明2.1.1 PowerBuilder与API函数数据类型的转换在微软出版的MSDN中给出了每个API函数C语言格式，函数的格式及参数的数据类型完全是按照C的要求定义的。

例如检索打印设备驱动性能的API函数DeviceCapabilities，在MSDN中的C定义如下：DWORD DeviceCapabilities(LPCTSTR pDevice, // printer nameLPCTSTR pPort, // port nameWORD fwCapability, // device capabilityLPTSTR pOutput, // output bufferCONST DEVMODE *pDevMode // device data buffer);该声明中还包括一个名为DEVMODE的结构，在结构中包含打印机设备的初始化和环境信息，结构的C语言定义如下：typedef struct _devicemode {BCHAR dmDeviceName[CCHDEVICENAME];WORD dmSpecVersion;WORD dmDriverVersion;WORD dmSize;WORD dmDriverExtra;DWORD dmFields;union {struct {short dmOrientation;short dmPaperSize;short dmPaperLength;short dmPaperWidth;};19POINTL dmPosition;};short dmScale;short dmCopies;short dmDefaultSource;short dmPrintQuality;short dmColor;short dmDuplex;short dmYResolution;short dmTTOption;short dmCollate;BCHAR dmFormName[CCHFORMNAME];WORD dmLogPixels;DWORD dmBitsPerPel;DWORD dmPelsWidth;DWORD dmPelsHeight;union {DWORD dmDisplayFlags;DWORD dmNup;}DWORD dmDisplayFrequency;#if(WINVER >= 0x0400)DWORD dmICMMethod;DWORD dmICMIntent;DWORD dmMediaType;DWORD dmDitherType;DWORD dmReserved1;DWORD dmReserved2;#if (WINVER >= 0x0500) || (_WIN32_WINNT >= 0x0400)DWORD dmPanningWidth;DWORD dmPanningHeight;#endif#endif /* WINVER >= 0x0400 */} DEVMODE;在上述定义中，包含了各种各样的C的数据类型，由于这些数据类型无论从形式上还是从内在含义上都与PB中的数据类型有一定的差异，要在PB中调用这些过程，需要将它们转换成合法的PB外部函数声明语句，并使用正确的参数调用它们。

表2－1中列出了API函数的C原型的数据类型与PB中相应的数据类型对应关系。

C语言中的远指针，如LPBYTE、LPDWORD、LPRINT、LPLONG、LPVOID和LPWORD在PB中20被声明为Long的数据类型。

用于指示对象的句柄HANDLE表示环境设备的hDC被定义为一个32位无符号数，在PB中声明为无符号长整形ulong。

在PB中并不支持C语言中诸如PSTR 和NPSTR的近指针，并且关键字REF只适用于32位远指针。

Windows中的32位远指针LPCTSTR、LPSTR在PB中被声明为String，LBYTE有时也声明为String。

Windows中的BOOL是16位有符号数，在PB中被声明为Boolean或Long型。

Windows中定义的WORD在PB中声明为UnsignedInteger型，Windows中定义的DWORD在PB中声明为UnsignedLong。

PB中不支持Windows的80位双精度浮点数。

PB中的Date、DateTime和Time有其特定的格式，与C中的数据类型没有直接的对应关系。

表2－1 C数据类型与PB数据类型的转换2.1.2 API函数的声明约定对于PowerBuilder应用程序来讲，动态链接库中的函数是外部函数，为了调用这些函数，必须按照固定格式的约定向应用程序提供必要的信息，这种提供信息的的操作称为外部函数的声明。

在PowerBuilder任何脚本中使用外部函数之前，必须首先声明外部函数。

PowerBuilder就是通过这种声明来访问动态库中的。

声明的作用就是“告知”PB系统，可以使用外部函数了。

PB系统为窗口、菜单、函数、用户对象提供了一个声明区域，专门用于声明外部函数和21变量，同PowerBuilder中的用户自定义函数一样，用户可以声明以下两种类型的外部函数: （1）全局外部函数（Global External Functions）：可以在应用的任意位置调用;（2）对象级外部函数（Local External Functions）：在窗口、菜单、用户对象或用户自定义函数等对象中定义。

在应用的开发过程中可以根据以下原则决定使用全局外部函数或局部对象级外部函数：（1）若外部函数作为一般用途并适用于整个应用，则定义为全局外部函数；（2）若外部函数作为特殊用途只适用于特定对象，则将函数定义为对象级外部函数。

对于对象级外部函数，用户仍可在应用的任何位置调用，只是需要把它作为一个特定的对象类型。

PB中外部函数的声明书写必须符合一定的约定，否则PB将警告错误调用外部函数。

在PB中根据外部函数代表的过程是否有返回值，函数的声明书写有所不同。

外部函数的声明以两个关键字FUNCTION或SUBROUTINE之一为开始，如果函数代表的过程返回一个值，应将其声明为FUNCTION，声明语法如下：{Access}FUNCTION ReturnDataType FunctionName ({REF}{DataTypel Arg1，...，DataTypeN ArgN})LIBRARY LibName {ALIAS FOR ExternalName}如果函数代表的过程无返回值，或者在C语言中返回一个Void数据类型，声明的语法是:{Access} SUBROUTINE SubroutineName({REF}{DataType1 Arg1，...，DataTypeN ArgN})LIBRARY LibName {ALIAS FOR ExternalName}在上面声明语句中，大括号中的内容是可选的。

此外，PB对上面语句中的各个部分大小写不敏感，如FUNCTION与Function是一样的。

声明中的其它各个关键字作用如下：Access ：表示函数的访问级别，用户可以为对象级外部函数指定Public、Protected 或Private三个类型的访问级别，缺省为Public，此参数只能在对象级外部函数中使用；ReturnDataType：表示函数返回值的数据类型。

返回值的数据类型必须与PB支持的数据类型相匹配；FunctionName/SubroutineName：在PowerScript脚本中引用的外部函数或过程的名称。

该名称可以由用户自己定义，但如果指定了与动态库中函数不一致的名称，就必须通过Alias For子句给出动态库中函数过程的真正名称；REF：标明变量通过引用方式传递；DataType：外部函数中参数的数据类型；Arg：外部函数的参数名。

对于具有多个参数的过程，各参数以逗号分开；LibraryName：表示外部函数的动态库DLL或EXE的文件名。

如果引用的过程属于Windows 核心库（User32、Kernel32 或 GDI32），则可以不包含文件扩展名；ExternalName：表示在DLL库中的外部函数或子程序名。

如果调用的 Windows API 过程要使用字符串，或为函数指定别名，那么在声明语句中必须增加一个Alias For子句，以指定正确的字符集。

Alias For关键词后面的字符串必须是动态库中函数过程的真正名称。

Alias For的使用大致可分为以下四种情况：1. 区别ANSI和Unicode字符集22如果调用的 API函数或过程要使用字符串，那么在声明语句中必须增加一个 Alias For 子句，以指定正确的字符集。

包含字符串的API函数实际有两种版本，即ANSI版本和 Unicode 版本。

因此，在Windows头文件中，每个包含字符串的函数都同时定义了 ANSI 版本和Unicode 版本。

Windows NT、Windows 2000 、Windows XP同时支持 Unicode 和ANSI字符集，而 Windows 95/98 只支持ANSI字符集。

请注意，Alias For子句后面的字符串必须是过程的真正名称。

例如，下面是 SetWindowText 函数的两种 C 语言描述。

可以看到，第一个描述将函数定义为 SetWindowTextA，尾部的“A”表明它是一个 ANSI 函数：SetWindowTextA(HWND hWnd，LPCSTR lpString);第二个描述将它定义为 SetWindowTextW，尾部的“W”表明它是一个 Unicode 函数：SetWindowTextW(HWND hWnd，LPCWSTR lpString);因为两个函数实际的名称都不是“SetWindowText”，要引用正确的函数就必须增加一个Alias For子句:FUNCTION Long SetWindowText(Long hwnd，REF String lpString) LIBRARY "user32.dll" ALIAS FOR "SetWindowTextA"为了保证使用PB开发的应用系统能在所有主流Windows操作系统下运行，无论是Windows NT、Windows 2000还是Windows 95／98，可统一使用Alias For子句指定为ANSI 格式的版本。

合集下载

PB调用外部程序及判断其完成的方法

PB调用外部程序及判断其完成的方法

PB调用外部程序及判断其完成的方法关键：API函数FindWindowA和IsWindow在PB中常常需要运行一些外部的程序或命令，并等待其执行完成后，才接下来运行剩余的代码。

我们可以有两种方法：先定义全局外部函数：Function long ShellExecuteA (long hwnd, string lpOperation ,String lpFile, String lpParameters, String lpDirectory, Long nShowCmd) Library"shell32.dll"Function long FindWindowA (String lpClassName , String lpWindowName ) Library "user32.dll"Function boolean IsWindow (Long hwnd ) Library "user32.dll"第一种方式用Run() 函数，可在窗口上建立按扭，clicked事件中包含如下Script:ulong ll_handleint li_loopSetPointer(HourGlass!)//最小化执行xxx.batrun("xxx.bat", Minimized!)//循环到窗口打开，根据程序执行打开所需的时间设定li_loop的循环次数，可预留长一些。

for li_loop= 1 to 10000ll_handle = FindWindowA("tty","xxx")yield() //函数作用详见“PB技巧”中《Pb中Yield()函数的使用》if ll_handle <> 0 thenexitend if//一直循环到窗口关闭 Do While isWindow(ll_handle)Yield()Loop//应用执行完成messagebox(‘ok’, ‘执行完成!’)这种方法的缺点是不能隐藏外部应用程序窗口，只能最小化。

API函数(中文)

API函数(中文)

IO操作函数函数原型：IORD(BASE, REGNUM)输入参数：BASE为寄存器的基地址，REGNUM为寄存器的偏移量函数说明：从基地址为BASE的设备中读取寄存器中偏移量为REGNUM的单元里面的值。

寄存器的值在地址总线的范围之内。

返回值：－函数原型：IOWR(BASE, REGNUM, DATA)输入参数：BASE为寄存器的基地址，REGNUM为寄存器的偏移量，DATA为要写入的数据函数说明：往偏移量为REGNUM寄存器中写入数据。

寄存器的值在地址总线的范围之内。

返回值：－函数原型：IORD_32DIRECT(BASE, OFFSET)输入参数：BASE为寄存器的基地址，OFFSET为寄存器的的偏移量函数说明：从地址位置为BASE+OFFSET的寄存器中直接读取32Bit的数据返回值：－函数原型：IORD_16DIRECT(BASE, OFFSET)输入参数：BASE为寄存器的基地址，OFFSET为寄存器的的偏移量函数说明：从地址位置为BASE+OFFSET的寄存器中直接读取16Bit的数据返回值：－函数原型：IORD_8DIRECT(BASE, OFFSET)输入参数：BASE为寄存器的基地址，OFFSET为寄存器的的偏移量函数说明：从地址位置为BASE+OFFSET的寄存器中直接读取8Bit的数据返回值：－函数原型：IOWR_32DIRECT(BASE, OFFSET, DATA)输入参数：BASE为寄存器的基地址，REGNUM为寄存器的偏移量，DATA为要写入的数据函数说明：往地址位置为BASE+OFFSET的寄存器中直接写入32Bit的数据返回值：－函数原型：IOWR_16DIRECT(BASE, OFFSET, DATA)输入参数：BASE为寄存器的基地址，REGNUM为寄存器的偏移量，DATA为要写入的数据函数说明：往地址位置为BASE+OFFSET的寄存器中直接写入16Bit的数据返回值：－函数原型：IOWR_8DIRECT(BASE, OFFSET, DATA)输入参数：BASE为寄存器的基地址，REGNUM为寄存器的偏移量，DATA为要写入的数据函数说明：往地址位置为BASE+OFFSET的寄存器中直接写入8Bit的数据返回值：－Dma：函数原型：int alt_dma_rxchan_close (alt_dma_rxchan rxchan)输入参数：rxchan为接收信道函数说明：函数 alt_dma_rxchan_close ()通知系统：应用程序已经完成DMA 接收信道rxchan，目前执行是成功的返回值：成功返回为0，反之为－1函数原型：alt_dma_rxchan_depth(alt_dma_rxchan dma)输入参数：dma函数说明：函数alt_dma_rxchan_depth ()返回传送到特别DMA的最大数量(深度)的接收请求返回值： DMA的最大数量函数原型：int alt_dma_rxchan_ioctl (alt_dma_rxchan dma, int req, void* arg)输入参数：dma直接存储器名, req为请求操作的列举, arg由请求决定函数说明：通过DMA接收信道执行设备的具体I/O操作返回值：成功返回请求具体值，反之返回为负数请求类型请求类型请求类型说明ALT_DMA_SET_MODE_8 传输以8Bit为单位的数据，arg值忽略ALT_DMA_SET_MODE_16 传输以16Bit为单位的数据，arg值忽略ALT_DMA_SET_MODE_32 传输以32Bit为单位的数据，arg值忽略ALT_DMA_SET_MODE_64 传输以64Bit为单位的数据，arg值忽略ALT_DMA_SET_MODE_128 传输以128Bit为单位的数据，arg值忽略ALT_DMA_TX_ONLY_ON (1) 软件控制下只能发送ALT_DMA_TX_ONLY_OFF (1) 自定义模式，软件控制下可以接收，发送ALT_DMA_RX_ONLY_ON (1) 软件控制下只能接收ALT_DMA_RX_ONLY_OFF (1) 自定义模式，软件控制下可以接收，发送函数原型：alt_dma_rxchan alt_dma_rxchan_open (const char* name)输入参数：name为常数字符指针，如/dev/dma_0函数说明：为DMA接收信道获得一个alt_dma_rxchan描述符返回值：成功返回非0，反之返回为0函数原型：int alt_dma_rxchan_prepare (alt_dma_rxchan dma, void* data, alt_u32 length, alt_rxchan_done * done, void* handle)输入参数：dma使用的信道；data接收数据位置的指针；length最大的接收数据长度；done一旦数据被接收，调用返回函数；handle，非透明值传到done 函数说明：发送一个接收请求到DMA接收信道，返回值：成功返回0，反之返回为负数函数原型：int alt_dma_rxchan_reg (alt_dma_rxchan_dev * dev)输入参数：dev接收信道设备名函数说明：给系统寄存DMA接收信道返回值：成功返回0，反之返回为负数函数原型：int alt_dma_txchan_close (alt_dma_txchan txchan)输入参数：txchan发送信道名函数说明：通知系统：应用程序已经完成DMA发送信道txchan返回值：成功返回0，反之返回为负数函数原型：int alt_dma_txchan_ioctl (alt_dma_txchan dma, int req, void* arg)输入参数：dma直接存储器名；req为请求操作的列举；arg请求的额外参数，由请求决定函数说明：通过DMA发送信道执行设备的具体I/O操作返回值：成功返回请求具体值，反之返回为负数函数原型：alt_dma_txchan alt_dma_txchan_open (const char* name)输入参数：name为常数字符指针，如/dev/dma_0函数说明：为DMA发送信道获得一个alt_dma_rxchan描述符返回值：成功返回非0，反之返回为0函数原型：int alt_dma_txchan_reg (alt_dma_txchan_dev* dev)输入参数：dev接收信道设备名函数说明：给系统寄存DMA发送信道返回值：成功返回0，反之返回为负数函数原型：int alt_dma_txchan_send (alt_dma_txchan dma, const void* from, alt_u32 length, alt_txchan_done* done, void* handle)输入参数：dma使用的信道；data接收数据位置的指针；length最大的接收数据长度；done一旦数据被接收，调用返回函数；handle，非透明值传到done函数说明：发送一个发送请求到DMA发送信道，返回值：发送成功返回0，反之返回为负数函数原型：nt alt_dma_txchan_space (alt_dma_txchan dma)输入参数：dma 直接存储器名函数说明：返回被传送到具体DMA发送信道的发送请求数目返回值：返回发送请求数目Flash函数原型：int alt_erase_flash_block(alt_flash_fd* fd, int offset, int length)输入参数：fd为具体的flash设备；offset擦除的flash模块的偏移量；length 擦除的flash模块的长度函数说明：擦除单独的一个flash模块返回值：发送成功返回0，反之返回为负数函数原型：void alt_flash_close_dev(alt_flash_fd * fd)输入参数：fd为具体的flash设备函数说明：关闭flash设备返回值：－函数原型：alt_flash_fd * alt_flash_open_dev(const char* name)输入参数：函数说明：打开flash设备。

pb+api实际应用

pb+api实际应用

（转）pb+api实际应用（一）2010-09-13 23:45:22| 分类：PB学习资料 | 标签：pb api实例 |字号订阅1、利用Api函数计算Windows从启动后所运行的总时间Function long GetTickCount() Library "kernel32.dll" //获取windows 从启动开始的总微秒数窗口w_example的open事件：timer(0.05)//触发timer事件窗口的timer事件：long hour , minute ,secondhour = GetTickCount() \ 1000 \ 60 \ 60//获取小时数st_1.text = String(hour) + "小时"minute = (GetTickCount() - hour * 60 * 60 * 1000) \ 1000 \ 60//获取分钟数st_2.text = Str(minute) + "分钟"second = (GetTickCount() - long(st_1.text) * 60 * 60 * 1000 -long(st_2.text) * 60 * 1000) \ 1000//获取总秒数st_3.text = String(second) + "秒钟"2、GetSystemMetrics函数Function long GetSystemMetrics (long nIndex ) Lib “user32.dll”其中nIndex的不同取值可以使该函数实现不同的功能。

例如返回Win桌面中各种显示单元的宽度和高度、是否安装鼠标、是否调换了鼠标左右键的定义等。

当nIndex = 67（SM_CLEANBOOT）时，该函数的返回值表示Windows9x的当前运行模式。

在以下的示例中我们可以看到GetSystemMetrics函数的用法和作用。

pb 自动调用resize函数

pb 自动调用resize函数

pb 自动调用resize函数【原创实用版】目录1.PB 自动调用 resize 函数的概念2.PB 自动调用 resize 函数的方法3.PB 自动调用 resize 函数的应用实例4.PB 自动调用 resize 函数的优点与局限性正文在计算机编程领域，PB（PowerBuilder）是一款广泛应用的快速开发工具，它具有可视化的用户界面设计和强大的数据处理能力。

在 PB 中，resize 函数是一种常用的函数，用于调整窗口的大小。

为了让 PB 窗口能够根据需要自动调整大小，我们可以使用 PB 自动调用 resize 函数的方法。

首先，我们需要了解 PB 自动调用 resize 函数的概念。

所谓自动调用，是指在特定条件下，PB 会自动执行 resize 函数，而不需要程序员显式地调用。

这样可以实现窗口的智能调整，提高用户体验。

接下来，我们来探讨 PB 自动调用 resize 函数的方法。

实现这一功能，可以通过创建自定义事件处理程序来完成。

具体操作步骤如下：1.打开 PB 开发环境，选择“事件”菜单，点击“新建事件”。

2.在弹出的“新建事件”对话框中，选择“窗口对象”作为事件源，并设置事件类型为“Resize”。

3.编写事件处理程序，调用 resize 函数，并设置相应的参数。

例如，可以按照以下格式编写：```FUNCTION Window_Resize:// 获取窗口对象的实例oWindow = OBJECT(g_window)// 判断窗口的宽度和高度是否发生变化bWidthChanged = (oWindow.Width!= oWindow.OldWidth) OR (oWindow.Height!= oWindow.OldHeight)// 如果窗口大小发生变化，则调用 resize 函数IF bWidthChanged THENoWindow.resize(oWindow.Width, oWindow.Height)END IFEND FUNCTION```通过上述方法，当窗口大小发生变化时，PB 会自动调用 resize 函数进行调整。