手持电子产品嵌入式软件API

手持电子产品嵌入式软件API

国家标准 GB/25654一2010 手持电子产品嵌入式软件API EmbeddedsoftwareAPIforhandheldeleetronieproduet 2010-12-01发布 2011-04-01实施 国家质量监督检验检疫总局 发布 国家标准化管理委员会国家标准
GB/T25654一2010 目 次 前言 范围 规范性引用文件 术语和定义、缩略语 术语和定义 缩略语 概述 基础层 RTL函数 操作系统函数 应用支撑层 6.1图形人机交互界面 5 Java接口 安全 54 输 6 人法 68 应用层 71 电话功能 71 消息类功能 78 桌面系统 86 7.4lnternet编程接口 90 7.5多媒体 106 数据交换 16 8.1信息交换接口 16 数据管理 19 8. 2 电源管理 131 参考文献 135
GB/T25654一2010 前 言 本标准由工业和信息化部提出 本标准由全国信息技术标准化技术委员会(SAC/TC28)归口 本标准起草单位;浙江大学、北京凯思昊鹏软件工程技术有限公司、北京科银京成技术有限公司、中 国电子技术标准化研究所、中兴通讯技术有限公司、宁波波导股份有限公司,普天信息技术研究院 本标准主要起草人:吴朝晖、袁玉宇、陈天洲、张肠肠、李允、李云翔、张倪、刘胤兵、王四清、罗蕾、 朱明远、马力、嵇智源、黄江伟、戴鸿君、胡威、赵建东

GB/T25654一2010 手持电子产品嵌入式软件API 范围 本标准规定了手持电子产品嵌人式软件AP规范 本标准适用于手持电子产品嵌人式软件的设计与开发 规范性引用文件 下列文件中的条款通过本标准的引用而成为本标准的条款 凡是注日期的引用文件,其随后所有 的修改版(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究 是否可使用这些文件的最新版本 凡是不注日期的引用文件,其最新版本适用于本标准 GB/T1988一1998信息技术信息交换用七位编码字符集(eqISo/IEC646:1991 GB/T14246.1一1993信息技术可移植的操作系统界面第1部分:系统应用程序界面 (POSIX.1)(API(idtIsO/IEC9945-1;1990 GB/T15272一1994程序设计语言CidtIsO/IEC9899:1990 GB/T16264.8一2005信息技术开放系统互连目录第8部分:公钥和属性证书框架(ISO/ IEC9594-8:2001,IDT 信息技术嵌人式系统术语 GB/T220332008 YD/T12292002可移动终端数据同步协议及信息交换数据格式技术要求 so/IEc14515(所有部分)信息技术可移植操作系统接口(POsIx) 术语和定义、缩略语 术语和定义 GB/T14246.1一1993,GB/T16264.8-2005,GB/T220332008中确立的以及下列术语和定义 适用于本标准 3.1.1 手持电子产品handheldelectronicproduet 便于携带,并且可以在移动环境下使用的电子产品 3.1.2 嵌入式数据管理embeddeddatamanagemment 在手持电子产品上,应用计算机数据管理技术,实现对数据的分类、存取、检索等功能 3.1.3 动态电源管理(DPdynamicpowermanageentDM 动态电源管理是指在操作系统运行过程中,动态的根据运行状态,调整系统整体和部分的状态,进 行电源管理 3.1.4 oPT 操作点(oPToperatingpont 由CPU电压、,CPU总线频率以及外围设备的状态参数来描述 3.2缩略语 下列缩略语适用于本标准 API Interface 应用编程接口ApplicationProgramming
GB/I25654一2010 StandardD AVS 数字音视频编解码技术标准(AudioVideo oding" 1.Authority) 证书颁发机构(Certifie CA ication CRIt 作废证书列表(CertifieateRevocationLists) DOM 文档对象模型(Do ObjectModel cument EMAL电子邮件(eletronicmail 最后的装配号码(FinalAssemblyCode) 图形用户接口(GraphicalUserInterface) M 超文本置标语言(HyperTextMarkupLanguage Hrm 超文本传输协议HypertextTransferProtocol 移动电话国家代码(MobileCountryCode) 三 乐器数字接口(MusicalInstrumentDigitalInterface) 用途互联网邮件扩展同步多媒体集成语言(MultipurposelnternetMailExtensions) 多 s 多媒体短信服务 MultimediaMessagingService) MNC 移动电话网络代码(MobileNetworkCode) 个人信息管理(PersonalInformationManagement) 个人识别码(PersonalldentifieationNumber) lnternetMailExtensions 多用途互联网邮件扩展同步多媒体集成语言Muluipurposel 个人解锁码(Per PersonalUnbloekingCode) untimeLibrary 实时运行库(Ru ynchronizedMultimediaIn 同步多媒体集成语言(sy ntegrationLanguage) sMs 短信服务(shortmessageservice 安全套接层(SecuritySocketLayer) syneML同步置标语言(Sym eronizationMarkupLanguage 语音合成系统(Text TTs Speech URL 统一资源定位器(UniformmResourcel.ocator) UTc 协调世界时(UniversalTimecoordinated) wAP 无线应用协议(wirelessApplicationProtocol wML 无线置标语言(wirelessMarkupLanguage) wsP 无线会话协议(webServiceProvide) XHTML可扩展超文本置标语言(eXtensibleHyperTextMarkupl.anguage) 概述 手持电子产品嵌人式软件API可以分为基础层API,应用支撑层AP1与应用层API,其中应用层 提供了应用API,数据交换AP1与电源管理API,如图1所示 应用包括电话、消息、 数据交换包括信息交换、 电源 应用层 嵌入式数据管理 桌面系统、 管理 Intenet、多媒体 应用支撑层 图形人机交互界面、Java接口、安全和输入法 基础层 R与嵌入式操作系统 图1手持电子产品嵌入式软件AP示意图 基础层描述了RTL与嵌人式操作系统,提供了系统底层向上层软件的API接口
GB/T25654一2010 应用支撑层AP标准使得在上层软件开发过程中,可以无需调用基础层API,而在应用支撑层 AP1上进行软件设计 应用支撑层规定了用于手持电子产品的嵌人式软件中应用支撑层所应提供的应 用编程接口,包括图形人机交互界面、Java接口、安全和输人法等方面的API 应用层是在应用支撑层之上面向不同领域,不同功能的手持电子产品的典型应用的API,包括应用 AP1、数据交换API电源管理API 应用API规定了手持电子产品应用软件的API规范,如针对移动通讯手持电子产品,定义了电话、 短消息等典型应用的编程接口,包括了电话,消息,桌面系统、Internet,多媒体的API 数据交换API为了在手持电子产品的嵌人式软件中实现数据交换,定义了手持电子产品数据管 理、交换的编程接口,包括电子名片、电子日历、电话、记事等数据存储交换，以及嵌人式数据管理 的API 电源管理AP提供了能耗管理的应用编程接口,使用DPM!定义了手持电子产品在电源管理方面 的A接口,适用于手持电子产品嵌人式软件中的电源管理模块 基础层 RTL函数 RL丽数是符合GB/T1272一191实时运行库 根帮岚人式系继的特点以及手持电子产品应 用的实际需要，本条规定了RTI 中基本的和必须实现的AP要求 根据系统的不同实现 GB/T152721994的其他内容可作为本条的可选项 本标准规定的RTL丽数如表1所示,丽数定义见GB/T15272一1994,函数中涉及的七位编码字 符集见GB/T1988一1998 表1RTL函数 字符测试丽数 isalnum、,isapha、,isasci、iscntrlisdigit、,isgraph,islower、 er、isprint、ispunct、isspace、isupper、isxdigit 存储管理丽数 calloc,free,malloe,realloe、memchr、mememp,memepy,memmove,memset striemp、strcat、strchr、strcmp、strepy、strcspn、strdup、strlen、strniemp、streat、strnemp 字符串处理丽数 strncpy strrchr、strspn、strstr、strtok asctime、ctime、difftime、gettimeofday、gmtime、localtime、mktime、settimeofday、strftime、 时间函数 time、clock 数据转换函数 atoi,atol,atof,strtol,strtoul,strtod,tolower,toupper,strupr,strlwr,ecvt,fcvt、gcvt elearer、fclose、fdopen、feof、ferror、fflush、igetc、ftell、fgets、ffleno、fopen、fputc、fputs、fread、 输人输出丽数 freopen,fseek、fsetpos、ftell、fwrite婚getc、getchar、gets、 ts、putc、putchar、puts、remove、rename rewind、ungetc、fprintf、fscanf、printf、scanf、sprintf、Snprintf、sscanf、vfprintf、vprintf、vsprint 随机数函数 rand,srand 数学丽数 absacos,asin,atan,ceil,cos,exp,abs,、loor、fmod,labs,log,logl0,modf,pow,sin,sqrttan 跳转函数 longjmp,setijmp 可变参数 va_start,va_arg、va_end 操作系统函数 操作系统函数是指用于手持电子产品的单进程多线程的实时嵌人式操作系统 内存管理采用线性 内存地址空间 采用虚拟文件系统,把普通文件、目录、设备统一以文件形式进行管理 操作系统API 遵循1so/IEc14515 根据嵌人式系统的特点以及手持电子产品应用的实际需要,本条规定了POsIX 中基本的和必须实现的API;根据系统的不同实现,Is/IECc14515的其他内容可作为本条的可选项 本标准规定的操作系统函数参见Iso/IEc14515,如表2所示
GB/T25654一2010 表2操作系统函数 线程函数 pthread_ereate,pthreaddetach、pthread_equalpthread_exit、pthreadjoin、pthread_self pthread_attr_init、pthread_attr_destroy、pthread_attr_getdetachstate、pthread_attr_getschedparam、 线程属性函数 pthreadattr_getstackaddr、pthread_attr_getstacksize、pthread_attr_setdetachstate、pthread_attr setschedparam,pthread_attr_setstackaddr,pthreadattr_setstacksize 时序控制函数 pthread_yield pthread_mutex_init、pthread_mutex_destroy、pthread_mutex_lock、pthread_mutex_timedlock、 互斥锁函数 pthread_mutex_trylock、pthread_mutex_unlock pthread_mutexattr_init、pthread_mutexattr_destroy、pthread_mutexattr_getlkind_np、pthread 互斥锁属性函数 setkind np、pthread_mutexattr_setprotocol、pthreadmutexattr-getprotoeol muteXattr ing、pthread_mutexattrgetprioceiling pthread setprioceiing 线程私有数据函数 pthread_key_ecreate,pthread_key_delete、pthread_getspecifiec、pthread_setspecifie sem_elose,sem_destroy、sem_getvalue,sem_init,sem_open,sem_post,sem_timmedwait,sem 信号量 trywait,sem_unlink,sem_wait clock_getres、clock_gettime、clock_settime、sleep、timer_cancel、timer_connect、timer_create、 时钟和定时器 timer_delete,timer_gettime、timer_settime,usleep mg dlose、mq-getattr、mq-open、mq send、mq setattr、mq-timeddreceive、mg 消息队列 timedsend,mq_unlink chdir,chmod.closedir、getcwd,mkadir、opendir、readir、rewinddir、rmdir、close.create.dup、 文件系统函数 dup2、feutl、Isyne,link、lseek,open、read,syne,write、Istat,fstatfs、ioetl,mknod,mount,stat statfs,truncate,umount,unlink,utime,utimmes 应用支撑层 6 图形人机交互界面 6.1.1图形人机交互界面的分层 图形人机接口分为3个层次向开发者提供AP以支持不同硬件平台环境的图形开发,分别为图形 引擎,窗口机制与图形设备接口以及扩展的控件层 图形引擎层针对framebuffer进行操作,提供基础绘图函数 窗口机制提供遵循win32消息循环机制,图形设备接口提供对图形设备的驱动封装,本层API与 Win32兼容 控件层提供了各种控件以及控件操作,本层AP与win32AHI兼容 6.1.2 图形引擎 DrawPixel DrawPixel描述如下 函数名 DrawPixel 说明 在指定的设备上根据指定位置画一个点 参数 绘图设备结构的描述符 a 点的横坐标 b 点的纵坐标 c 风格设定 d 无 返回值
GB/T25654一2010 6.1.2.2rawLine DrawLine描述如下 Dr 函数名 )rawline 说明 在指定两个坐标之间画一条直线 参数 绘图设备结构的描述符 a b 起始点横坐标 起始点纵坐标 d 终点横坐标 终点纵坐标 e f 风格设定 无 返回值 6.1.2.3DrawReet DrawRect描述如下: 函数名 DrawReect 说明 在指定的设备上根据指定大小画一个矩形 参数 绘图设备结构的描述符 a b 矩形绘图区域 颜色 c d 风格设定 无 返回值 6.1.2.4DrawCirecle DrawCirele描述如下 丽数名 DrawCircle 说明 在指定设备上根据指定的圆心和半径画圆 参数 绘图设备结构的描述符 a b 圆心横坐标 圆心纵坐标 c d 圆的半径 无 返回值 6.1.2.5DrawPoly DrawPoly描述如下 函数名 DrawPoly 说明 在指定设备上根据指定风格和坐标画一个多边形 参数 a 绘图设备结构的描述符 b 多边形的顶点点对 风格设定 返回值 无
GB/T25654一2010 6.1.2.6GetDevC; apcity GetDevCapeity描述如下: 函数名 GetDevCapcity 说明 取得指定设备的设备信息 参数 绘图设备结构的描述符 a b 存放设备信息结构的描述符 返回值 指定设备的设备信息 6.1.2.7GetPixel GetPixel描述如下 丽数名 GetPixel 说明 取得指定点的颜色值 参数 a 点的横坐标 b 点的纵坐标 返回值 指定点的32位颜色值 6.1.2.8SerolISereen SerolIseren描述如下 函数名 ScrolScreen 说明 在指定设备上按指定参数进行屏幕滚动 参数 绘图设备结构的描述符 aa 待滚动的矩形结构的描述符 b 滚动后矩形的左上角位置 返回值 无 6.1.2.9UpdateSereen UpdateScreen描述如下 函数名 UpdateScreen 说明 该操作只对非直接写屏设备有效,直接写屏的显示设备不用提供该操作 有些特别 设计的显示设备其显示刷新内存区是不可直接访问的或是只能写而不能读的,这就 需要显示设备驱动程序利用一个访问工作内存的操作,在必要时将工作内存用特定 方法传送到刷新内存区中 为了避免过量的数据传送,这种设备的驱动程序必须记 录下工作内存更新的区域,在必须传送数据时只需传送工作内存中更新区域的内容 参数 绘图设备结构的描述符 刷新区域的描述符 无 返回值 openDevitee 6.1.2.10 OpenDevice描述如下:
GB/T25654一2010 函数名 OpenDeviee 说明 打开显示物理设备 参数 显示设备结构的描述符 a b 显示设备的标示符 返回值 与该设备对应的显示设备结构的长度,为负值表示错误,其绝对值是错误代码 6.1.2.11 CloseDevice CloseDevice描述如下 丽数名 CloseDevice 说明 关闭显示设备 参数 显示设备结构的描述符 返回值 无 6.1.2.12CreateMemoryDeyiee CreateMemoryDevice描述如下 函数名 CreateMemoryDevice 说明 创建一个与物理显示设备显示缓存类似的内存显示设备 用于绘图操作之后快速地 写人到物理显示设备上,减少绘图过程中的闪烁 参数 物理显示设备结构的描述符 a 内存设备的水平像素数 b 内存设备的垂直像素数 c 内存显示设备结构的描述符 d 返回值 内存显示设备结构的长度 6.1.2.13DestroyMemoryDevice DestroyMemoryDeviee描述如下: 函数名 DestroyMemoryDevice 说明 删除一个内存显示设备 结构中有由驱动程序分配的内存区的描述符,将这些内存 区释放 参数 指向内存设备结构的描述符 返回值 无 6.1.2.14DIBitBt DIBitBt描述如下 函数名 DIBitBlt 说明 将 一个设备无关位图贴到显示设备上 参数 显示设备结构的描述符 a 设备贴图操作矩形区域的描述符
GB/T25654一2010 参数 设备无关位图的描述符 c d 待贴图的图形左上角在位图中的坐标 绘图参数结构的描述符 e 返回值 无 .1.2.15IextBt o TextBHt描述如下 函数名 TextBlt 说明 将文字点阵的单色位图的数据经二元ROP操作之后输出到指定的显示设备上 参数 物理显示设备或内存显示设备结构的描述符 a b 指定在显示设备上输出位置的坐标 设备无关位图的描述符 d 绘图参数结构的描述符 无 返回值 6.1 3 窗口机制层 6.1.3.1 消息处理 6.1.3.1 CalIWindowProc CallwindowProe描述如下 函数名 CalIWindowProc 说明 将消息信息传递到指定的窗口函数 参数 前一个窗口函数 aa b 指定接收消息的窗口描述符 指定消息 c 指定传给窗口函数的参数1 d 指定传给窗口函数的参数2 返回值 函数调用成功返回消息处理的结果,否则返回0 6.1.3.1.2DispatehMessage D)ispatchMessage描述如下 函数名 DispatchMessage 将指定的消息发送到当前窗口的窗口函数 说明 参数 当前消息结构的描述符 返回值 返回窗口函数返回的值,这个值取决于实际消息的传送 6.1.3.1.3Geesage GetMe lessage描述如下:
GB/T25654一2010 函数名 GetMessage 说明 从消息队列中获取发送给指定窗口的消息 参数 保存获取到的消息 a b 指定窗口 指定消息的范围的最小值 c d 指定消息的范围的最大值 返回值 成功/失败 PostMessage PostMessage描述如下 函数名 PostMessage 将指定消息放置到应用程序的消息队列中 说明 指定接收消息的窗口 a 参数 指定消息类型 b 指定消息的附带参数1 c 指定消息的附带参数2 d 返回值 成功/失败 6.1.3.1.5SendMessage SendMessage描述如下 SendMes 丽数名 :ssage 说明 直接发送指定的消息给指定的窗口 参数 指定接收消息的窗口 aa 指定发送的消息类型 b 指定消息的附带参数1 c d 指定消息的附带参数2 接收消息的窗口丽数处理后的所返回的值,其值由所发送消息决定 返回值 6.1.3.1.6IranslateMessage TranslateMessage描述如下 函数名 TranslateMessage 说明 将虚拟键代码消息翻译成字符消息,并将该字符消息加人到消息队列中 参数 指定虚拟键代码消息 成功/失败 返回值 6.1.3.1.7Peek.Mesuge PeekMe lessage描述如下
GB/I25654一2010 函数名 PeekMessage 说明 在消息队列中查找指定的消息,并进行相应的处理 参数 指定消息 a b 指定接收要查找的消息的窗口 指定消息的范围的最小值 d 指定消息的范围的最大值 指定如何处理指定的消息(如果找到),处理方法有以下两种 消息经过查找处理之后不会从队列中删除 22 消息经过查找会从队列中删除 返回值 成功/失败 6.1.3.2 窗口创建 6.1.3.2.1 CreateWindow CreateWindow描述如下 函数名 CecwImaow 说明 根据参数所指定的窗口属性创建窗口 参数 指定窗口类的类名 a b 指定窗口的名称 e 指定窗口的格式 指定窗口左上角的r坐标 d 指定窗口左上角的y坐标 指定窗口的宽度 指定窗口的高度 g 指定窗口的父窗口或拥有者窗口 h 指定窗口的菜单或子窗口 指定窗口所属的应用程序实例 指定传递给要创建的窗口的数据 k 返回值 新创建的窗口的描述符/失败 6.1.3.2.2CreatewindowEx CreatewindowEx描述如下: 函数名 CreatewindowEx 说明 根据指定的扩展风格和参数指定的其他窗口属性创建窗口 参数 指定扩展风格 aa b 指定窗口类的类名 指定窗口的名称 d 指定窗口的格式 指定窗口左上角的工坐标 指定窗口左上角的y坐标 指定窗口的宽度 10
GB/T25654一2010 参数 指定窗口的高度 h 指定窗口的父窗口或拥有者窗口 指定窗口的菜单或子窗口 kk 指定窗口所属的应用程序实例 指定传递给要创建的窗口的数据 返回值 新窗口的描述符/失败 6.1.3.2.3DefWindowProc DefwindowProc描述如下 函数名 DefWindowProc 对指定窗口的窗口函数不处理的消息进行缺省处理 说明 参数 指定窗口 a b 指定要处理的消息的类型 c 指定消息的附带参数1 指定消息的附带参数2 d 返回值 返回消息处理结果,具体意义取决于由参数b)指定的消息 6.1.3.2.4DestroyWindow DestroyWindow描述如下: 丽数名 DestroyWindow 说明 删除指定的窗口 参数 指定要删除的窗口 返回值 成功/失败 6.1.3.2.5RegisterClass RegisterClass描述如下 丽数名 RegisterClass 说明 根据参数所指定的窗口类信息注册一个新窗口类 参数 指向包含各种窗口类信息的数鹅结构 返回值 成功/失败 .1.3.2.6RegisterClassEx o RegisterClassEx描述如下: 函数名 RegisterClassEx 说明 根据参数所指定的窗口类信息注册一个新窗口类 本函数的参数所指定的窗口类信 息比RegisterClass函数包含更多的内容 参数 指向包含各种窗口类信息的数据结构 返回值 成功/失败
GB/T25654一2010 erClass 6.1.3.2.7Umregtster UnregisterClass描述如下: 函数名 UnregisterClass 说明 从窗口类表中注销指定的窗口类 指定要注销的窗口类 参数 返回值 成功/失败 6.1.3.2.8GetClasslnfo GetClassInfo描述如下 函数名 GetClasslnfo 获取指定窗口类的信息 说明 参数 指定创建窗口类的应用程序实例 a b 指定窗口类 指向用于保存窗口类信息的数据结构 C 返回值 成功/失败 6.1.3.2.9GetClassLong GetClassLong描述如下 函数名 GetClassLong 说明 从窗口的窗口类结构中获取32位的窗口类信息 参数 指定要获取类数据的窗口 a b) 指定要检取的32位值 返回值 所要求的32位值/失败 6.1.3.2.10SeClassL.ong SetClassL.ong描述如下 函数名 SetClassL.ong 说明 设置窗口的窗口类结构中的32位的窗口信息 参数 指定要设置类数据的窗口 aa 指定要设置的内容 b 指定替换的值 返回值 指定信息的32位整数的原值/失败 6.1.3.2.11GetwindowL.ong GetwindowL.ong描述如下 函数名 GetWindowlLong 说明 获取窗口的信息,该信息是32位的 参数 指定要获取数据的窗口 a 指定被检取值的偏移量 返回值 指定的32位整数的原值/失败 12
GB/T25654一2010 6.1.3.2.12SetwindowLong SewimdowLong描述如下 丽数名 Setwindowl.ong 说明 设置窗口的信息,该信息是32位的 参数 a 指定要设置数据的窗口 b 指定被检取值的偏移量 指定替换的值 c 返回值 指定的32位整数的原值/失败 6.1.3.3显示和移动 6.1.3.3.1MowewindowIolop MoveWindowToTop描述如下 函数名 MovewindowToTop 说明 把指定的窗口放在重叠窗口堆栈的顶部 参数 指定要移到最上层的窗口 成功/失败 返回值 6.1.3.3.2GetClientReet GetClientRect描述如下 函数名 GetClientRect 说明 获得指定窗口客户区的大小 参数 指定窗口 aa b) 指向用于保存客户区的矩形尺寸的数据结构 返回值 成功/失败 6.1.3.3.3GetwindowRceet GetwindowRect描述如下: 函数名 GetWindowReet 说明 获得指定窗口的大小 参数 指定窗口 a 指向用于保存窗口的矩形尺寸的数据结构 返回值 成功/失败 GetwindowR KetE 6.1.3.3.4 GetwindowRetEx描述如下 函数名 GetWindowRectEx 说明 获得指定窗口的指定矩形部分的大小 13
GB/T25654一2010 参数 指定窗口 a b 指向用于保存函数所获得的矩形尺寸的数据结构 指出要获得窗口哪一部分的矩形尺寸 c d 指定矩形坐标的相对位置 返回值 成功/失败 6.1.3.3.5GetWindowText GetwindowText描述如下 GetWindowText 函数名 说明 获得指定窗口的标题 参数 指定窗口 aa 指定接收文本的缓冲区 b 缓冲区可以容纳的最大字符数 给出函数实际拷贝的字符串的长度 如果窗口没有标题或标题为空,则返回o 返回值 6 1.3.3.6GetwindowIextL.ength GetwindowTextLength描述如下: 函数名 twindowTextl.ength Yet 说明 获得指定窗口的标题的长度(以字符计 参数 指定窗口 返回值 标题的长度 如果窗口没有标题或标题为空,则返回0 6.1.3.3.7SetwindowIext SetwindowText描述如下 函数名 SetwindowText 说明 设置指定窗口的标题 参数 指定窗口 a b 指定要设置的标题文本 返回值 成功/失败 6.1.3.3.8IsWindowVisible IswindowVisible描述如下 丽数名 swindowVisible 说明 判断指定窗口是否可见 参数 指定窗口 返回值 可见/不可见 6.1.3.3.9Movewindow Movewindow描述如下 14
GB/T25654一2010 函数名 Movewindow 说明 改变指定窗口的大小和位置 参数 指定窗口 a b 指定窗口左上角的新r坐标 指定窗口左上角的新y坐标 d 指定窗口的新宽度 指定窗口的新高度 指定在移动后是否重画窗口 返回值 成功/失败 6.1.3.3.10ShowWindow ShowWindow描述如下 函数名 Showwindow 说明 显示或隐藏指定窗口 参数 指定窗口 a 指定窗口新的显示状态 b 返回值 成功,返回窗口原来的显示状态/失败 6.1.3.3.11ShowOwnedPopups showOwnedPopups描述如下 ShowOw wnedlPopups 丽数名 说明 显示或隐藏属于指定窗口的所有弹出式窗口 参数 指定窗口 a 指定显示还是隐藏弹出式窗口 b 返回值 成功/失败 6.1.3.4窗口绘制 6.1.3.4.t BeginPaint BeginPaint描述如下: 函数名 BeginPaint 说明 为窗口的重画做准备 填充由参数b)所指定的数据结构,该结构中包含了与窗口重 画有关的信息;并获得绘图时使用的设备描述表 参数 指定即将进行重画操作的窗口 aa b 指定一个可以容纳与窗口重画有关的信息的数据结构 返回值 绘图时使用的设备描述表的描述符/空 6.1.3.4.2GetDc GetDC描述如下 15
GB/I25654一2010 函数名 GetD 说明 获取指定窗口的客户区的设备描述表 该设备描述表可用于在客户区中绘图 参数 指定要获取其设备描述表的窗口 返回值 函数所获取的设备描述表的描述符/失败 6.1.3.4.3GetWindowDC GetWindowDC描述如下 函数名 GetwindowDC 说明 获取指定窗口的设备描述表 这个设备描述表可用于在整个窗口上绘图 参数 指定要获取其设备描述表的窗口 返回值 函数所获取的设备描述表的描述符/失败 6.1.3.44malidateReet lnvalidateReet描述如下 函数名 InvalidateRect 说明 使指定窗口的指定矩形区域失效 此失效区域将和窗口的原来的更新区域合并,成 为响应绘图消息时被重画的区域 参数 指定要增加其失效区域的窗口 a 指向放有将失效的区域的尺寸的数据结构 b 指定更新区域的背景是否被擦去 返回值 成功/失败 1.3.4.5ReenseDc 6. ReleaseDC描述如下: 函数名 ReleaseDC 说明 释放指定的设备描述表 参数 指定窗口,该窗口的设备描述表将被释放 a b 指定要释放的设备描述表 返回值 成功/失败 6.1.3.4.6EndPaint EndPaint描述如下 函数名 EndPaint 说明 表示在指定窗口中的重画操作结束,本函数必须与BeginPaint丽数配合使用 参数 指定窗口 aa 指向一个数据结构,该数据结构中含有调用BeginPaint函数时获得的信息 b 返回值 成功/失败 6.1.3.4.7 YalidateReet ValidateRect描述如下 16
GB/T25654一2010 函数名 ValidateReet 说明 从指定窗口的更新区域中删除指定的矩形区域 参数 指定其更新域将被修改的窗口 a b 指向放有区域的尺寸的数据结构 返回值 成功/失败 6.1.3.4.8Updatewindow Updatewindow描述如下 函数名 UpdateWindow 说明 使指定窗口需要重新绘制的部分被重画 参数 指定窗口 返回值 成功/失败 6. .1.3.5滚动 6.1.3.5.1SetSsecronfo SetSerolInfo描述如下 SetScrollInfo 函数名 说明 设置指定滚动条的参数,包括最大值、最小值、页大小和滚动框的位置,并根据需要重 画滚动条以反映滚动框的新位置 参数 指定一个滚动条控件或带有滚动条的窗口 是前者还是后者由参数b)的值 a 确定 指定如何解释参数a) b 指向一个数据结构 该结构中包含滚动条的参数值 指定是否重画滚动条 d 返回值 滚动框的原位置/失败 6.1.3.5.2GetSerollInfo GetserolInfo描述如下 函数名 GetSerollInfo 说明 获得指定滚动条的参数,包括最大最小滚动位置、页大小和滚动框的位置 指定一个滚动条控件或带有滚动条的窗口 是前者还是后者由参数b)的值 参数 a 确定 指定如何解释参数a) b 指向一个数据结构 获得的参数值将保存在该结构中 返回值 成功/失败 6.1.3.5.3EnableSerollBar EnableSerolBar描述如下: EnableScrollBar 函数名 说明 将指定滚动条的一个或两个箭头设置为允许或禁止状态 17
GB/T25654一2010 参数 指定一个滚动条控件或带有滚动条的窗口 是前者还是后者由参数b)的值 a 确定 b 指定如何解释参数a) 指定将滚动条的箭头设置为允许还是禁止状态,并指定是哪个或哪些个箭头 返回值 成功/失败 6.1.3.5.4ScrolIWindow SerolWindow描述如下 函数名 SerolIwindow 说明 滚动指定窗口的客户区中的内容 a 参数 指定窗口 指定在水平方向上滚动的像素数 b c 指定在垂直方向上滚动的像素数 指向一个数据结构,这个结构描述了一个矩形区域,该个矩形区域指定了将滚 d 动哪部分客户区 指向一个数据结构,这个结构描述了勇裁矩形的坐标 只有在剪裁矩形中的内 容才被滚动 返回值 成功/失败 6.1.3.6窗口信息 6.1.3.6.1EnummWindows Enumwindows描述如下 函数名 Enumwindows 说明 以屏幕上所有顶层窗口的描述符做为参数调用指定的回调函数,直到所有顶层窗口 已被遍历一遍或回调函数返回“假”为止 参数 指向自定义的回调丽数 aa b) 指向一个传送给回调丽数的32位值 返回值 成功/失败 6.1.3.6.2Getwindow Getwindow描述如下: 函数名 GetWindow 说明 获得与指定窗口有指定关系的窗口描述符 参数 指定一个窗口,要获取其描述符的窗口与该窗口之间存在某种关系,具体关系取 a 决于参数b)的值 指定参数a)所指定窗口与要获取其句柄的窗口之间的关系 返回值 函数获得的窗口描述符/不存在与a)所指定窗口具有指定关系的窗口返回失败 6.1.3.6.3IsWindow IsWindow描述如下: 18
GB/T25654一2010 函数名 swindow 说明 判断指定的窗口是否是一个已存在的窗口 参数 指定窗口 返回值 成功/失败 GetUserData 6.1.3.6.4 GetUserData描述如下: 函数名 GetUserData 说明 获取指定窗口的窗口结构中用户数据的起始地址 参数 指定要获得用户数据起始地址的窗口 返回值 用户数据的起始地址/失败 6.1.3.7资源管理 6.1.3.7.t RegisterResource RegisterResource描述如下 函数名 RegisterResource 说明 在使用一个资源之前注册资源 参数 指定资源所属的程序模块的描述符 a" 指定要注册的资源的资源文件名 b 指定资源的描述在整个文件中的偏移 c 指定是以文件的格式还是以数据的格式注册资源 d 返回值 程序模块的描述符/失败 6.1.3.7.2UnRegisterResource UnRegisterResource描述如下 函数名 UnRegisterResource 说明 在使用资源之后注销资源 RegisterResource函数所返回的程序模块描述符 参数 返回值 成功/失败 6 FindResouree FindResource描述如下: 函数名 FindResource 说明 在指定的程序模块中查找具有指定类型和名称的资源 参数 a 指定程序模块的描述符 b 指定资源的名称 指定资源的类型 返回值 数据结构的描述符(该数据结构中包含查找到资源的信息/失败 19
GB/T25654一2010 L0oadResouree 6.1.3.7.4 L.oadResource描述如下 LoadResource 函数名 说明 将指定的资源装人内存 参数 标识其可执行文件中包含资源的模块 a b 指定要装人的资源的描述符 返回值 成功,返回值为包含与此资源相关的数据的全局内存块的设备描述符 a b 否则,返回值为NULL 6.1.3.7.5LockResource lockResource描述如下 函数名 LockResource 说明 将指定的资源在内存中加锁 指定将被加锁的资源的描述符 参数 返回值 如果装人资源被加锁,则返回值为该资源首字节的描述符 a 返回失败 b 6.1.3.7.6FreeResource FreeResource描述如下 丽数名 FreeResource 说明 将已经装载的资源释放 参数 指定将被删除的资源的描述符 返回值 该资源是以文件的形式装载进来的,返回TRUE aa 返回FALSE b 6.1.3.7.7Loadstring LoadString描述如下: 函数名 LoadString 说明 装人与指定模块相关的字符串资源,将此字符串拷贝到一个缓冲区中,并附加一个结 尾的NULL字符 参数 指定资源所属的模块实例 aa b 指定要装人的字符串的整数标识符 指向用来接收字符串的缓冲区 指定缓冲区的大小(按字符计 d 返回值 成功,返回值为被拷贝到缓冲区中的字符数目,不包含结尾的NULL字符 字符串资源不存在,则返回o 6.1.3.7.8LoadstringPtr LoadStringPur描述如下 20
GB/T25654一2010 函数名 LoadStringPtr 说明 返回指定模块相关的字符串资源的描述符 参数 指定资源所属的模块实例的设备描述符 a b 指定要装人的字符串的整数标识符 返回值 成功,返回指向该资源的描述符 b 否则,返回NULL 6.1.3.7.9LoadImage lLoadllmm mage描述如下 函数名 Loadlmage 说明 装人光标、图标或位图 指定要装人图像的模块实例 a 参数 指定装人图像的名称 b 指定图像的类型,包括;位图类型、光标类型、图标类型 c 指定图像的宽度(以像素为单位y d 指定图像的高度(以像素为单位 D 指明该图像来自一个特定文件名的文件 返回值 成功,返回刚装人的图像设备描述符 a 否则,返回NULL b 6.1.3.7.10L.0adBitmap ILoaadBitmap描述如下 函数名 LoadBitmap 说明 从给定模块的可执行文件中装人指定的位图资源 标识其可执行文件中包含要装人位图的模块实例 参数 aa 指向一个以NUL1终止的、包含要装人的位图资源名称的字符串 除此之外， b 该参数还可以在其低位字中包含此资源标识符,在其高位字中置零 返回值 成功,返回刚装人的位图的设备描述符 aa 否则,返回NULL b 6.1.3.7.11 LoadCursor I.oadCursor描述如下 函数名 LoadCursor 说明 从与给定应用程序实例相关的可执行文件中装人指定光标资源 参数 标识其可执行文件中包含要装人光标的模块实例 aa b 指向一个以NULL终止的,包含要装人的光标资源的名称的字符串 除此之 外,这个参数也可以在其低位字中包含资源标识符,在其高位字中置零 成功,返回刚装人的光标的设备描述符 返回值 否则,返回NULL
GB/T25654一2010 6.1.3.7.12LoadMenu LomadMenu描述如下 丽数名 LoadMenu 说明 装人与给定的应用程序实例相关的的菜单资源 参数 标识其可执行文件中包含要装人菜单的模块实例 a 指向一个以NULL终止的、包含要装人的菜单资源名称的字符串 除此之外， b 该参数还可以在其低位字中包含此资源标识符,在其高位字中置零 返回值 成功,返回刚装人的菜单的设备描述符 aa 否则,返回NULL 6.1.3.7.13LoadMenulndirect LoadMenulndirect描述如下 函数名 L.oadMenulndireet 说明 装人指定的菜单模板 参数 指向一个菜单模板 成功,返回刚装人的菜单的设备描述符 返回值 a b 否则,返回NULL 6.1.3.7.14L.oadlcon" Loadlcon描述如下 Loadlcon 丽数名 说明 装人与给定的应用程序实例相关的的图标资源 参数 a 标识其可执行文件中包含要装人光标的模块实例 b 指向一个以NULL终止的、包含要装人的图标资源名称的字符串 除此之外 该参数还可以在其低位字中包含此资源标识符,在其高位字中置零 返回值 a 成功,返回刚装人的图标的设备描述符 否则,返回NULL 6.1.3.8系统函数 6.1.3.8.1GetSysCoon GetSysColor描述如下: 函数名 GetSysColor 说明 获取由参数指定的显示元素的缺省系统颜色 参数 指定要获取颜色的显示元素 返回值 返回指定显示元素颜色的RGB值 6.1.3.8.2GetSystemMetries GetSystemMetries描述如下 22
GB/T25654一2010 函数名 GetSystemMetrics 说明 检取系统度量， ,系统度是日系统所妹示的各种显示单元的宽度和高 参数 指定要检取的系统度量,所有度量按像素给出 返回值 成功,返回所求的系统度量 aa 否则,返回检取失败 b 6.1.3.8.3SetSsysColors SetSysColors描述如下 函数名 SetSysColors 说明 改变一个或多个系统颜色 参数 a 指定改变的系统颜色数 指向一整数索引数组,该数组指定了将要改变的元素 b -个颜色数组,该数组包含了每个元素新的RGB颜色值 指向 返回值 成功/失败 图形设备接口 6 1.4.1 设备描述表 CreateCompatibleDc CreateCompatibleDC描述如下 函数名 CreateCompatibleDC 说明 创建与指定设备兼容的内存设备描述表 指定设备描述符 参数 返回值 成功,返回内存设备描述表的设备描述符 aa b)否则,返回NUl 6.1.4.1.2CreateMemmoryDc CreateMemoryDC描述如下: CreateMemoryDC 函数名 说明 创建内存设备描述表 参数 指定要创建的内存设备描述表的宽度 a 指定要创建的内存设备描述表的高度 b 返回值 成功,返回内存设备描述表的设备描述符 a 否则,返回NULL CreateScreenDC CreateSereenDC描述如下 CreateScreenDC 函数名 说明 创建屏幕设备描述表 无 参数 返回值 成功,返回屏幕设备描述表的设备描述符 a 否则,返回NUlLL 23
GB/T25654一2010 6.1.4.1.4 DeleteDc DeleteDC描述如下 丽数名 DeleteDc 说明 删除指定的设备描述表 参数 指定要删除的设备描述符 返回值 成功.返回TRUE aa 否则,返回FAL.SE 6.1.4.1.5 GeDeiteCu GetDeviceCaps描述如下 函数名 GetDeviceCaps 检取有关给定设备的特定信息 说明 参数 指定标识设备描述符 a b 指定返回的项 返回值 成功,返回指定项的值 a 失败,返回0 6.1.4.2绘图工具 6.1.4.2.1CreateBrush CreateBrush描述如下 CreateBrushlndirect 丽数名 说明 创建一个逻辑刷子,这个刷子可由任何设备选择为当前刷子 参数 a 刷子的样式 b 刷子的颜色 刷子填充效果 返回值 成功,返回创建的逻辑刷子的设备描述符 a b 否则,返回NULL 6.1.4.2.2CreateBrushlndreet reateBrushlndireet描述如下 函数名 CreateBrushlndirect 说明 创建一个具有指定式样、,颜色和模式的逻辑刷子 参数 刷子信息的结构描述符 返回值 成功,返回创建的逻辑刷子的设备描述符 a 否则,返回NULL b 6.1.4.2.3CreateHatchBrush CreateHatchBrush描述如下 214
GB/T25654一2010 函数名 CreateHatchBrush 说明 创建一个具有指定的阴影图案和颜色的逻辑刷子 参数 指定刷子的阴影类型 a b 指定刷子的前景颜色(阴影的颜色 成功,返回创建的逻辑刷子的设备描述符 返回值 a b 否则,返回NULL 6.1.4.2.4CreatePatternBrush CreatePatternBrush描述如下 CreatePatternBrush 函数名 说明 创建一个具有内存位图定义图案的逻辑刷子 指定被用来创建此逻辑刷子的位图的描述符 参数 返回值 成功,返回创建的逻辑刷子的设备描述符 a b)否则,返回NULL 6.1.4.2.5CreatePen CreatePen描述如下 函数名 CreatePen 说明 用指定的类型,宽度和颜色创建一个逻辑笔 这个笔能被选择为任何设备的当前笔 参数 笔的类型 a 笔的宽度 b 笔的颜色(可以使用RGB宏来指定) 返回值 成功,返回创建的逻辑笔的设备描述符 a 否则,返回NULL b 6.1.4.2.6CreatePenlndirect CreatePenlndirect描述如下 函数名 CreatePenlndirect 说明 创建一个逻辑笔它具有在给定结构中指定笔的类型,宽度和颜色 参数 包含指定笔的类型,宽度和颜色的结构的描述符 返回值 成功,返回创建的逻辑笔的设备描述符 aa 否则,返回NULL b 6.1.4.2.7 CreateSolidBruush CreateSolidBrush描述如下 CreateSolidBrush 函数名 说明 创建一个具有指定颜色的逻辑刷子 指定刷子的颜色 参数 返回值 成功,返回创建的逻辑刷子的设备描述符 否则,返回NULL 25
GB/T25654一2010 6.1.4.2.8DeleteObjeet Delete(Object描述如下 函数名 DeleteObject 说明 删除逻辑画笔、刷子字库、位图和所有与它们有关的系统资源 参数 指定要删除的对象设备描述符 返回值 若目标被删除返回值为非0值 a 如果参数无效,或者当前被选人设备描述表而没被选出,则返回值为0 6.1.4.2.9GeOjeet GetObject描述如下 函数名 Get(Object 说明 获得指定对象的有关信息,其内容依赖于对象的类型 标识一对象,可以是下列之一;逻辑位图、笔、刷子或字体 参数 a 指定被拷贝到缓冲区的字节数目 b 指向用于接收信息的缓冲区 返回值 如果参数c)是一个合法描述符并且函数成功,则返回值为返回的字节数目 aa 如果参数e)为NULL并且函数成功,则返回值为保存对象所需的字节数目;否 b 则返回o 6.1.4.2.10 UnrealizeObjeet UnrealizeObjeet描述如下: 函数名 UnrealizeObjeet 说明 重置逻辑调色板 参数 指明将被重置的逻辑调色板 返回值 成功,返回非0值 否则返回o 6.1.4.2.11GetStockObject GetStockObject描述如下 函数名 GetStockObject 说明 该函数获取预定义的画笔、刷子或字体的设备描述符 参数 指定预定义的对象类型 返回值 成功,返回预定义对象的设备描述符 aa 否则,返回NULL 6.1.4.2.12sSeleetOhjeet SelectObject描述如下 26