我想在我的对话框里画一个圆,要求能够覆盖所有的控件。

snollow 2003-05-09 09:04:48
我想在我的对话框里画一个圆,要求能够覆盖所有的控件。即能够在我指定的空件上画图。除拉重载我指定空件的Onpaint之外还有没有别的方法??
...全文
27 2 打赏 收藏 转发到动态 举报
写回复
用AI写文章
2 条回复
切换为时间正序
请发表友善的回复…
发表回复
BinaryTreeEx 2003-05-09
  • 打赏
  • 举报
回复
定义一个透明的窗口,然后在透明窗口中画,再把透明窗口显示在对话框中。随便说说,见笑见笑。
goodboyyxh 2003-05-09
  • 打赏
  • 举报
回复
OnDrawItem函数。
1,mruxdzip.exe
在菜单上最近打开文件的历史记录控件(1453KB)
2,applogger.zip
具有删除到回收站、读写 INI 文件、计算剩余磁盘空间,复制文件和添加到 Windows 文档列表(57KB)
3,ccrpbd10.zip
Windows 游览对话框控件(75KB)
4,ccrpdrg.zip
增强了的列表框控件(71KB)
5,ccrpfd.zip
Windows 文件对话框控件,功能强劲,可制作出 VB 的文件对话框(95KB)
6,ccrphky.zip
键盘控件(69KB)
7,ccrpprg.zip
进程杆控件(150KB)
8,ctlist.exe
一个增强的 ListView 控件(376KB)
9,ctlistbar.exe
Microsoft Outlook 风格的列表框控件(287KB)
10,cttree.exe
一个增强的 TreeView 控件(424KB)
11,dprogressw.exe
DameWare 公司出品进程杆控件(177KB)
12,proplistw.exe
DameWare公司出品类似 VB 中的属性列表控件(291KB)
13,buttnbar6.zip
Outlook 列表框控件(700KB)
14,fsi.zip
系统信息控件(24KB)
15,fsshr20d.exe
应用程序交换数据控件,不需要使用 DDE,COM 和剪贴板(289KB)
16,gbarocx.zip
进程杆控件(171KB)
17,graphic.zip
不需要调用 API ,创建一个 Office Ani 精灵助手(50KB)
18,ctlbar.ZIP
用过Oicq的用户,一定熟悉这个控件(59KB)
19,big2gb.zip
一个BIG5码<=>GB码互换的完全免费的ActiveX控件(81KB)
20,capscreen.zip
这是一个屏幕拷贝的控件,可以实现全屏的拷贝并支持另存为位图类型的文件 (28KB)
21,digital.zip
能够以液晶字体方式显示数字的一个控件(15KB)
22,eqpro.zip
一个调整系统音量的控件,控制音量包括;很方便地控制,控件也很小巧(15KB)
23,flatbar.zip
一个工具栏控件,可变VB5.0的工具栏为Office或IE类型的平面工具栏(27KB)
24,lyftools.zip
这是一个封装了500多个Windows API的控件(229KB)
25,masflc.zip
一个用来播放 FLC,FLI 的 3DS 动格式控件(60KB)
26,xzipdemo.zip
Xceed Zip控件 (98KB)
27,lfbb.zip
兰花打印控件(预览及打印输出,它支持多列,文本自动换行,页头和页尾,表格及段落)(186KB)
28,keyboard.zip
检测键盘按键控件(13KB)
29,winapi.zip
这是一个封装了部分Windows API的控件(例如:发EMail、改变分辨率等)(92KB)
30,dbdemo.zip
3D立体按钮控件(138KB)
31,spelltxt.zip
一个文档拼音检查的控件(337KB)
32,swflash.zip
播放的Flash文件的控件(160KB)
33,185.zip
EasySound 一个封装了DirectSound API的控件 (565KB)
34,157.zip
子分类控件,包含控件源码(44KB)
35,132.zip
MikoUtil系列控件(184KB)
36,109.zip
GB-Big5语言编码转换的控件源码(39KB)
37,108.zip
微软的DirectX 7 for VB开发库文件(187KB)
38,11.zip
MsgHook 用于子分类、截获消息的控件(147KB)
39,c1.zip
Windows 9x注册表控件(35KB)
40,c8.zip
只要点击就可以打开超连接的控件(10KB)
41,c9.zip
GIF98(24KB)
42,c10.zip
sysmenu(9KB)
43,c11.zip
小型控件集(40KB)
44,c12.zip
anigif(40KB)
45,cst.zip
盘仪表控件 V3.1(4143KB)
46,EZX.zip
让你能在VB中使用DirectX的控件,附例子和源代码(1619KB)
47,NCTDesignBox.exe
NCTDesignBox 1.01(513KB)
48,c_arp.zip
Activereport 1.1的破解文件(1KB)
49,clock.zip
显示时间和日期信息控件(5KB)
50,InputeDate.zip
日期输入框控件(13KB)
51,api21.zip
封装了500多个Windows API的控件覆盖了网络、系统、界面、多媒体、图形、文字等各个方面(261KB)
52,ARRegistry.zip
访问系统注册表的控件(25KB)
53,isysinfo.zip
一个可以获得系统信息的ActiveX控件,该控件是由VB5.0编写,使用这个控件可以获得系统的内存大小、CPU类型、显示器的分辩率、颜色数系统中各个驱动器、CPU占用率、Windows版本等信息 (19KB)
54,MsgHoo32.zip
同样是Windows消息处理控件(22KB)
55,MsgBlst32.zip
这是一个拦截、处理消息的控件(18KB)
56,threed32.zip
一个3D控件(73KB)
57,vfoutbar.zip
还有另一个控件 OutLook 风格的 BAR(39KB)
58,ovalbutton.zip
形按钮控件(8KB)
59,3dbdemo.zip
3D立体按钮控件(138KB)
60,tubPrinter.zip
可直接打印DataGrid,ListView,MsFlexGrid(53KB)
61,shape.zip
、三角、星...形按钮控件(131KB)
62,command.zip
千千平面按钮(35KB)
63,Chat.zip
Chat控件(16KB)
NEAT 开 发 指南 文档 适用于 PT80 系列 移动数据终端 版本记录 版本号 版本描述 发布日期 V 1.0 初始版本。 2012-04-12 V1.1 修改前三章内容 2012-09-25 目录 第一章 关于本手册........................................................................................................................................ 1 简介 ........................................................................................................................................................ 1 相关文档 ................................................................................................................................................. 1 章节介绍 ................................................................................................................................................. 1 版权和许可条款 ...................................................................................................................................... 1 第二章 PT80 开发入门 .................................................................................................................................. 2 开发环境搭建 ......................................................................................................................................... 2 使用 NEAT 工程向导建立应用程序 ........................................................................................................ 5 编译及运行程序(模拟器下) ................................................................................................................ 7 编译及运行程序(PT80) .................................................................................................................... 11 下载 PT80 应用程序 ............................................................................................................................. 12 第三章 PT80 NEAT 编程基础 ..................................................................................................................... 17 事件驱动和消息响应机制 ..................................................................................................................... 17 建立一个应用程序 ................................................................................................................................ 17 应用程序的关闭 .................................................................................................................................... 19 框架窗口 ............................................................................................................................................... 19 完整的例子 ........................................................................................................................................... 20 NEAT 程序一般执行过程 ..................................................................................................................... 20 第四章 窗口 ................................................................................................................................................ 21 窗口的概念 ........................................................................................................................................... 21 窗口的创建和删除 ................................................................................................................................ 22 窗口类型 ............................................................................................................................................... 23 窗口事件 ............................................................................................................................................... 24 窗口类概览 ........................................................................................................................................... 24 基础窗口类 ........................................................................................................................................... 26 窗口类 CNeatWnd ................................................................................................................................ 26 窗口类 CNeatView 视图类 ................................................................................................................... 26 CNeatControl 类 ................................................................................................................................... 26 CNeatFrame 类 .................................................................................................................................... 26 第五章 消息与消息处理 .............................................................................................................................. 27 消息驱动的编程模型 ............................................................................................................................ 27 消息及消息处理过程 ............................................................................................................................ 27 第六章 在窗口中绘 .................................................................................................................................. 30 设备上下文 ........................................................................................................................................... 30 绘工具 ............................................................................................................................................... 32 绘制基本图形 ....................................................................................................................................... 34 绘制文本 ............................................................................................................................................... 34 第七章 处理用户输入 .................................................................................................................................. 36 PT80 的按键所对应的键值 .................................................................................................................. 36 输入事件相应 ....................................................................................................................................... 36 第八章 对话框编程基础 .............................................................................................................................. 37 模态和非模态对话框编程 ..................................................................................................................... 37 通用对话框 ........................................................................................................................................... 38 对话框示例 ........................................................................................................................................... 38 对话框资源 ........................................................................................................................................... 40 第九章 NEAT 控件 ...................................................................................................................................... 41 控件综述 ............................................................................................................................................... 41 静态框 .................................................................................................................................................. 41 编程示例 ............................................................................................................................................... 42 按钮 ...................................................................................................................................................... 43 列表框 .................................................................................................................................................. 45 组合框 .................................................................................................................................................. 46 编辑框 .................................................................................................................................................. 48 进度条 .................................................................................................................................................. 50 滑块 ...................................................................................................................................................... 51 旋钮 ...................................................................................................................................................... 52 第十章 资源及资源模板 .............................................................................................................................. 53 概述 ...................................................................................................................................................... 53 图标 ...................................................................................................................................................... 53 对话框 .................................................................................................................................................. 54 菜单 ...................................................................................................................................................... 54 第十一章 编写国际化程序 ........................................................................................................................... 57 国际化简介 ........................................................................................................................................... 57 如何实现国际化 .................................................................................................................................... 57 使用 NEAT 平台开发国际化应用程序 .................................................................................................. 59 小结 ...................................................................................................................................................... 61 第十二章 编写多线程程序 ........................................................................................................................... 62 多线程简介 ........................................................................................................................................... 62 如何使用 wxThread 线程类 .................................................................................................................. 62 线程同步对象 ....................................................................................................................................... 64 编程实例 ............................................................................................................................................... 69 小结 ...................................................................................................................................................... 69 第十三章 网络编程...................................................................................................................................... 70 使用 wxSocket 编程 ............................................................................................................................. 70 Socket 类和功能概览 ........................................................................................................................... 70 Socket 及其基本处理介绍 .................................................................................................................... 70 Socket 标记 .......................................................................................................................................... 75 使用 Socket 流 ..................................................................................................................................... 78 第十四章 数据库编程 .................................................................................................................................. 81 wxSqlite3 简介 ..................................................................................................................................... 81 如何使用 wxSqlite3 .............................................................................................................................. 81 编程实例 ............................................................................................................................................... 92 小结 ...................................................................................................................................................... 92 第十五章 设备编程...................................................................................................................................... 93 PT80 设备操作类 ................................................................................................................................. 93 PT88WIFI 操作类 ................................................................................................................................. 93 PT88BT 操作类 .................................................................................................................................... 93 PT88 配置信息操作类 .......................................................................................................................... 93 第十六章 wxBase 编程接口 ........................................................................................................................ 94 概述 ...................................................................................................................................................... 94 时间日期 ............................................................................................................................................... 94 动态库 .................................................................................................................................................. 94 字符串 .................................................................................................................................................. 94 文件、文件夹、流 ................................................................................................................................ 95 附录 1 系统调用 .......................................................................................................................................... 97 1 第一章 关于本手册 简介 NEAT 是 Newland Embedded Application Toolkit 的缩写,由福建新大陆电脑股份有限公司开发,其目标是为开发者提供一套可 靠、高效、易用的跨平台应用开发支撑系统。PT80 使用 NEAT 这个软件做为 PT80 应用程序的开发工具,开发人员通过 NEAT 可 以快速开发出在 PT80 上运行的应用程序。 本手册详细讲述了利用 NEAT 的基础知识、技术资料和开发技巧,以及 NEAT 当前。 相关文档 章节介绍 版权和许可条款 2 第二章 PT80 开发 入门 开发环境搭建 运行环境 NEAT 做为 Microsoft 开发工具 Visual Studio 2005 的插件存在, 开发人员首先要安装 Microsoft Visual Studio 2005, 当前版本 NEAT 只 v0.2.0 只支持 Visual Studio 2005。开发人员需要使用 Visual Studio 中的 Visual C++ 进行 NEAT 应用程序的开发。 NEAT 简介 NEAT 系统大概包含以下几部分内容:  各种库及头文件  交叉编译工具及各种辅助工具  Windows 端的模拟器  帮助文档及示例代码 NEAT 安装步骤 运行安装包,弹出如下界面: 3 \image html chapter2_setup1.jpg 点击―下一步‖,进入安装准备状态: \image html chapter2_setup2.jpg 点击安装,即进入安装过程,安装程序将在 D:\NEAT(默认安装路径,可修改)下安装所有内容。 \image html chapter2_setup3.jpg 安装完成后,有以下界面: 4 \image html chapter2_setup4.jpg 点击完成即可。安装程序将生成 NEAT 开发向导,NEAT 开发手册,NEAT 模拟器的快捷方式。 5 使用 NEAT 工程向导建立应用程序 使用 NEAT ―工程向导‖(NeatProjectWiz)来快速建立 NEAT 应用程序。启动方法:点击“开始”、“程序”;选择“Neat 嵌 入式应用开发套件”中的“工程向导”(如下图)。 NEAT 工程向导使用步骤: 1. 设置开发环境,目前只支持 VS2005 2. 设置平台,目前只支持 PT80 3. 设置程序类型,分为两大类:  应用程序:即当前 PT80 系统菜单头的应用程序,应用程序是做为系统菜单的插件而运行。  系统程序:类似 PT80 的整体程序(当前 NEAT 版本不支持,保留功能,新建工程时请勿选择此模式)。 注:每类又包含两种模式,及对话框模式和非对话框模式。  非对话框模式:开发人员需要用代码确定图形控件的放置位置和大小。 6  对话框模式:开发人员可以将图形控件从 Visual Studio 中‖Control Toolbar‖中拖放到 PT80 可视化对话框界面,不 需要使用代码确定图形界面的放置位置和大小,推荐开发人员新建应用程序时使用此模式。 \image html chapter2_projWiz1.jpg 4. 填写工程名称及工程所在的路径。 \image html chapter2_projWiz2.jpg 7 5. 点击确定,NEAT 工程向导会开始创建 VC 工程。 6. 工程创建后会提示是否要打开新建工程,点击确定打开(如下图) 注意:1. 如果点击‘ 是’ 后打不开工程 , 请设置在 在 Windows 操作系统中设置 VS2005 的环境变量 ,即将 VS2005 的启动路径添 加到系统的”Path” 环境变量中 。 2. 如果在工程目录下已经存在工程名和新生成的工程名相同的工程时,会被新的工程覆盖。 编译及运行程序(模拟器下) 使用 NEAT “ 工程向导” (NeatProjectWiz )来快速建 编译和运行 应用程序 创建完成 PT80 应用程序工程后,可以参考下列编译和运行应用程序: Step1: 使用 VC 打开已建立好的 NEAT VC 工程。 Step2: 打开当前工程的配置管理器(如下图) 8 9 针对当前项目,―配置‖选择―WIN32‖,―平台‖选择―Win32‖。如果你脱离主控系统程序,独立运行应用程序,请在―配置‖中 选择―WIN32-Alone‖。 \image html chapter2_appProjCfg.jpg “配置管理器的配置” 检查工程属性的―调试‖项,在―命令‖栏中填写―d:\neat\pt880system.exe‖(默认安装路径)。 \image html chapter2_appProjDebugCfg.jpg “调试的配置” 编译并运行程序。PT80 模拟器将自动被打开,脱离主控系统程序运行的应用程序,接下来请直接看 Step4。 Step4: (1)在模拟器上,选择―系统菜单‖的―系统设置‖项,进入―系统设置‖界面,选择"1.设定程序"项; 10 选择"系统设置"项进入 选择"设定程序"项进入 (2)进入"设定程序"项后,在插件栏按"OK"键显示可选插件后,选择要运行的程序。然后在"开机运行"项设置为"是"; 选择好需要运行的程序后 将"开机自动运行"设为"是" (3)选择设定后会自动回到"系统设置"界面。按"ESC"退出到"系统菜单"界面后选择"1 运行程序"项即可; 选择"运行程序"项后即运行已设定的程序 (4)下一次编辑运行时即自动进入程序。 11 应用程序成功启动。你可以点击模拟器上的按钮进行操作,你也可以在程序中添加断点等工具,进行调试。 \image html chapter2_appProjDebuging.jpg “调试应用程序” 编译程序(PT80 ) 在模拟器上编译运行PT80应用程序正常后, 需要使用NEAT编译工具编译在PT80应用程序。 点击NEAT工具栏上的―Compile‖ 按钮,如果没找到 NEAT 工具栏,请右键当前工具栏空白区域,选择―NEAT‖。成功编译后,可以看到―输出‖窗口中关于.so 文件或 可执行文件的信息。 \image html chapter2_NEATtoolbar.jpg “NEAT 工具栏” 12 \image html chapter2_NEAToutput.jpg “成功编译后输出窗口的内容” 下载 PT80 应用程序 在编译完成 PT80 应用程序后,有两种方法将编译完成的 PT80 应用程序下载到 PT80 上:“USB 模式下载”和“NEAT 插件 下载”。 USB 模式下载应用程序 Step1: 在 PT80 上将 USB 数据通讯方式设置为“U 盘”(具体设置方式可参考《PT80 用户手册》)。 Step2: 将 PT80 和 PC 用 USB 线缆连接 Step3: 将编译完成的 *.so 文件复制到 U 盘下的“app”目录中(如下图): 13 Step4: 在 PT80 的系统菜单选择刚下载的应用程序运行(运行以下载应用程序的方法可参考《PT80 用户手册》)。 使用 NEAT 插件工具下载应用程序 Step1: 在 PT80 上将 USB 数据通讯方式设置为“串口下载模式”(具体设置方式可参考《PT80 用户手册》)。 Step2: 将 PT80 和 PC 用 USB 线缆连接 Step3: 在 PC 端安装“USB 转串口”驱动(PT80 USB 转串口驱动请访问新大陆自动识别网站 www.nlscan.com 上下载) Step4: 驱动安装完成后,在 PC 上会新增一个虚拟串口,在 PC 上的“设备管理器”中可以查看虚拟串口号(如下图),记录 下这虚拟串口号。 14 Step5: 点击“下载”按键(如下图) 在下载对话框中(入下图)按照以下步骤下载 PT80 应用程序到 PT80  选择正确的虚拟串口  选择需要下载 PT80 应用程序,应用程序在 VC 工程目录下的“NEAT_OBJ”目录,应用程序是以“.so”为后缀名 的文件  点击“下载”按键 15 下载成功后,在下载对话框上会提示下载成功(如下图): 16 Step6: 至此下载 PT80 应用程序完成, 可以在 PT80 上开始运行应用程序 (具体运行应用程序的方法可参考 《PT80 用户手册》 ) 。 17 第三章 PT80 NEAT 编程基础 事件驱动和消息响应机制 NEAT 程序设计是一种事件驱动的程序设计模式,在程序提供给用户的界面中有许多可操作的可视对象。用户可以从所有可 能的操作中任意选择,被选择的操作会产生某些特定的事件,这些事件发生后的结果是向程序中的某些对象发出消息,然后这些对 象调用相应的消息处理函数来完成特定的操作。NEAT 应用程序最大的特点就是程序没有固定的流程,而只是针对某个事件处理有 特定的子流程,NEAT 应用程序是由许多这样的子流程构成的。 NEAT 应用程序是面向对象的。程序提供给用户界面的可视对象在程序的内部一般也被看成一个对象,用户对可视对象的操 作通过事件驱动模型触发相应的消息处理函数。 程序的运行过程就是用户的外部操作不断产生事件, 这些事件又不断被处理的过程。 NEAT 这种事件驱动模型源于消息响应机制。在 NEAT 系统中,事件产生消息,消息对应事件,所谓事件响应,其实就是对 各种消息的响应。NEAT 系统会不断的捕捉各种消息,并把捕捉到的消息发送到应用程序,应用程序将消息再传递给相关的消息处 理函数做相应的处理。这种等待消息、响应消息的操作方式就是 NEAT 的消息处理机制,类似于 Windows 的消息处理机制。 下面是 NEAT 应用程序的工作原理示意图。 \image html neat-message.jpg "NEAT 消息处理机制" 建立 一个应用程序 每一个 NEAT 程序都需要定义一个 \ref CNeatApp 类的派生类,并需要且只能构造一个这个类的实例,这个实例控制着整个 程序的执行。你的这个继承自 \ref CNeatApp 的子类至少需要定义一个 OnInit 函数,当 NEAT 准备好运行你写的代码的时候,它 将会调用这个函数(和一个典型的 Win32 程序中的 main 函数或者 WinMain 函数类似)。 你定义这个子类的代码可能和下面的代码类似: \code class MyApp : public CNeatApp { public: virtual bool OnInit(int args, const char* arg[]); 18 virtual int OnExit(); }; \endcode 在这个 OnInit 函数中,你通常应该创建至少一个窗口,对传入的命令行参数进行解析,为应用程序进行数据设置和其它的一 些初始化的操作。然后 NEAT 将开始消息循环,用来处理用户输入并且在必要的情况下处理这些输入。如果 OnInit 函数返回假, NEAT 将会释放它内部已经分配的资源,然后结束整个程序的运行。 接下来我们看一个最简单的 OnInit 函数的实现: \code CMyFrame m_FrameWnd; // 应用程序初始化函数 bool CMyApp::OnInit(int args, const char* arg[]) { \code CMyFrame m_FrameWnd; // Initialization function of the application program bool CMyApp::OnInit(int args, const char* arg[]) { // 调用 Create 函数来创建主框架窗口 m_FrameWnd.Create(_("Minimal"), WS_THINFRAME|WS_CAPTION ); // Call the Create function to create the frame window m_FrameWnd.Create(_("Minimal"), WS_THINFRAME|WS_CAPTION ); // 显示主窗口 m_FrameWnd.ShowWindow(SW_SHOW); return true; } // Show the window m_FrameWnd.ShowWindow(SW_SHOW); return true; } \endcode \endcode 你可能还会注意到上面例子中的_()这个宏,在接下来的例子中,这个宏还会被频繁用到。它的作用是用来告诉 NEAT 将其 中的字符串翻译成其它语言的版本,参见―编写国际化程序‖。 那么创建 MyApp 实例的代码在哪呢?实际上, 这是在 NEAT 内部实现的, 不过你仍然需要告诉 NEAT 需要创建哪一个 App 类的实例,所以你还需要增加下面的一个宏: \code IMPLEMENT_APP(MyApp) \endcode 如果没有实现这个类,NEAT 就不知道怎样创建一个新的应用程序对象。这个宏除了上述的功能以外,还会检查编译应用程 序使用的库文件是否和当前的库文件的版本相匹配,如果没有这种检查,由此而产生的一些运行期的错误可能很难被查出原因。 19 应用程序的关闭 当框架窗口关闭后,应用程序也跟着关闭了,在应用程序关闭前,它会调用 \ref CNeatApp::OnExit 函数,可以在这增加 应用程序退出前的操作。 举个例子: \code class MyApp : public CNeatApp { public: CNeatWnd *m_helpCtrl; ... }; bool MyApp::OnInit(int argc,const char* argv[]) { ... m_helpCtrl = new CNeatWnd; ... return true; } int MyApp::OnExit() { delete m_helpCtrl; return 0; } \endcode 框架窗口 我们来看一看自定义的派生至 CNeatFrameWnd 窗口类的 MyFrame。一个 \ref CNeatFrameWnd 窗口是一个可以容纳别的 窗口的顶级窗口,通常拥有一个标题栏和一个状态栏和一个客户视图。下面是我们的例子中这个类的定义,可以将其放在 MyApp 的定义之前: \code // 从 CNeatFrameWnd 派生一个框架窗口类,做为该应用程序的框架窗口 class CMyFrame : public CNeatFrameWnd { public: // 窗口刷新事件的处理函数 virtual int OnPaint(); }; \endcode \code // Derive a frame window class from CNeatFrameWnd and use it as the frame window for the application program class CMyFrame : public CNeatFrameWnd { 20 public: // handler function for the window refreshing events virtual int OnPaint(); }; \endcode 这个窗口类的中只定义了一个用来把窗口刷新事件的处理函数。 完整的例子 现在把所有的代码放在一起了,通常,我们应该把头文件和实现文件分开,但是对于这样小的一个程序,就没有这个必要了。 \include minimal\minimal.cpp \image html demo-minimal.jpg "NEAT 最小应用程序" NEAT 程序一般执行过程 下面大概描述一下整个程序的执行过程: 1. 程序执行时,main 函数被调用,NEAT 初始化它自己的数据结构并且创建一个 MyApp 的实例。 2. NEAT 调用 MyApp::OnInit 函数, 这个函数会创建一个 MyFrame 的实例,MyFrame 通过调用 Create 来创建一个窗口, MyApp::OnInit 函数显示主窗口并且返回真。 3. NEAT 开始进入消息循环,等待事件发生并且将事件分发给相应的处理过程。 4. 应用程序会在以下情况下退出:主窗口被关闭,用户选择退出菜单或者系统按钮和系统菜单中的关闭选项(这些系统菜 单和系统按钮在不同的系统中就往往千差万别了)。 21 第四章 窗口 你当然大略的知道一个窗口指的是什么,但是为了更好的理解 NEAT 窗口相关的 API,你应该更精通 NEAT 所使用的窗口模 型的细节。它可能和你在某个特定平台上的窗口概念有些许的不同。下图演示了一个窗口中的各个基本元素: \image html neat-window.jpg "NEAT 窗口" 窗口的概念 一个窗口指的是屏幕上的任何一个拥有以下特征的规则区域:它可以被改变大小,可以自我刷新,可以被显示和隐藏等等。 它可以包含别的窗口(比如 frame 窗口就可以包含菜单条窗口,工具条窗口以及状态条窗口),也可以子窗口(比如一个静态的文本或 者一副静态图片)。通常你在使用 NEAT 编写的程序运行的屏幕上看到的窗口,都和一个 \ref CNeatWnd 类或者它的派生类对应。 客户区和非客户区 当我们谈到窗口的大小,我们通常指的是它整个的大小,包括一些用于修饰的边框和标题栏等。而当我们谈到一个窗口的客 22 户区大小,通常都只意味着窗口面那些能被绘制或者它的子窗口能被放置的位置的大小。例如一个 frame 窗口的客户区大小就不 包括那些菜单栏,状态栏和工具栏所占用的地方。 滚动条 大多数窗口都有显示滚动条的能力,这些滚动条通常是窗口自己增加的而不是由应用程序手动增加的。在这种情况下,客户 区的大小还应该减去滚动条所占用的空间。 为了优化性能, 只有那些拥有 WS_HSCROLL 和 WS_VSCROLL 类型的窗口才会自动生 成它们自己的滚动条。 座标体系 窗口的座标体系通常是左上角为原点(0,0),单位是象素。 窗口绘制 当一个窗口需要重绘的时候,它将收到两个事件,MSG_ERASEBKGND 事件用于通知应用程序重新绘制背景,对应的消息处 理函数为OnEraseBkgnd, MSG_PAINT则用于通知重新绘制前景, 对应的消息处理函数为OnPaint。 那些常用控件比如CNeatButton(按 钮)已经处理这两个事件,但是如果你是要创建自己的窗口控件,你就需要自己处理这两个事件。通过获取窗口的变动区域你可以 优化你的绘制代码。 颜色和字体 每一个窗口都有一个前景色和一个背景色。默认的背景擦除函数会使用背景色来清除窗口背景,如果没有设置背景色,则会 使用系统默认的背景颜色进行背景的清除。前景色为文本输出的字体颜色。每一个窗口也拥有一个字体设置,是否用到这个字体设 置要取决于这个窗口本身的类型。 改变大小 当一个窗口的大小,无论是来自用户还是应用程序本身的原因,发生变化时,它将收到一个 MSG_SIZE 事件,对应的消息处理 函数为 OnSize。 输入 只有当前处于活动状态的窗口才可以接收键盘事件。应用程序自己可以设置自己为活动状态,NEAT 也会在用户点击某个窗 口的时候将其设置为活动状态。正变成活动状态的窗口会收到 MSG_SETFOCUS 事件,对应的消息处理函数为 OnSetFocus,而正 失去焦点的窗口会收到 MSG_KILLFOCUS 事件,对应的消息处理函数为 OnKillFocus。 窗口的创建和删除 大多数的窗口类都可以需要两步来创建,首先定义一个窗口类对象,然后调用 Create 函数来创建窗口。下面演示一个创建窗 口的代码片段: \code CNeatWnd *mywnd = new CNeatWnd; 23 mywnd->Create( ―mywindow‖, WS_CHILD, 10, 10, 100, 100,parent); \endcode 你可以传递一个字符串的名字,一个类型 (接下来会提到),位置和大小参数给这个窗口。除非是 frame 或者 dialog 窗口,对 于别的窗口, 都必须在 Create 函数中传入一个非空的父窗口, 这会把这个新窗口作为这个父窗口的子窗口, 当父窗口被释放的时候, 它的所有的子窗口也将被释放。 窗口在你调用 Create 函数的时候会收到 MSG_CREATE 事件,对应的消息函数为 OnCreate,你可以对这个事件进行进一步的 处理。 当你创建一个窗口类,或者其它任何非顶层窗口的派生类的时候,如果它的父窗口是可见的,那么它也总是可见的,你可以 通过 ShowWindow(SW_HIDE)来使它不可见或使用 ShowWindow(SW_SHOW)来使它可见。 你可以通过向窗口发送 MSG_CLOSE 消息(对应的消息处理函数为 OnClose)来关闭窗口。通过调用 DestroyWindow 函数来释 放窗口的资源,MSG_DESTROY 事件(对应的消息函数为 OnDestroy)会在窗口刚刚要被释放之前被调用。 窗口拥有一个类型和一个扩展类型。窗口类型是设置窗口创建时的行为和外观的一种简洁的方法。这些类型的值被设置成可 以使用类似比特位的方法操作,例如下面的例子: WS_CAPTION | WS_THICKFRAME|WS_VISIBLE CNeatWnd 类有一组基本的类型值,例如边框的类型等,每一个派生类可以增加它们自己的类型。需要特别指出的是,扩展类 型的值是不可以拿来给类型用的。 窗口类型 每一个窗口类都可以使用定义在下表中的这些的窗口类型。这些类型中不是所有的类些都被所有的控件所支持。需要注意的 是以 WS_开头的类型用于 dwStyle 的设置,以 WS_EX_开头的类型用于 dwExStyle 的设置,两个不能互用。 通用窗口类型: 风格标识 含义 备注 WS_VISIBLE 创建初始可见的窗口 WS_DISABLED 创建初始被禁止的窗口 WS_CAPTION 创建含标题栏的主窗口 仅用于主窗口 WS_SYSMENU 创建含系统菜单的主窗口 仅用于主窗口 WS_BORDER 在窗口周围显示一个边框 WS_THICKFRAME 创建具有厚边框的窗口 WS_THINFRAME 创建具有薄边框的窗口 WS_VSCROLL 创建带垂直滚动条的窗口 WS_HSCROLL 创建带水平滚动条的窗口 24 WS_MINIMIZEBOX 标题栏上带最小化按钮 仅用于主窗口 WS_MAXIMIZEBOX 标题栏上带最大化按钮 仅用于主窗口 WS_EX_TRANSPARENT 透明窗口风格 仅用于部分控件,如编辑框和滚动 窗口控件等 WS_EX_NOCLOSEBOX 主窗口标题栏上不带关闭按钮 窗口事件 窗口类和它的派生类可以产生下面的事件,在窗口有对应的事件处理函数,所有的事件处理函数的返回类型为 int,如果返 回值为 0 表示该事件处理函数返回后,继续执行 NEAT 对该事件的默认处理,如果返回值为非 0,表示不再执行系统的默认处理。 通用窗口事件及消息处理函数: 窗口事件 消息处理函数 备注 MSG_CREATE \ref CNeatWnd::OnCreate 窗口创建事件 MSG_CLOSE \ref CNeatWnd::OnClose 窗口关闭事件 MSG_DESTROY \ref CNeatWnd::OnDestroy 窗口销毁事件 MSG_ERASEBKGND \ref CNeatWnd::OnEraseBkgnd 窗口背景擦除事件 MSG_PAINT \ref CNeatWnd::OnPaint 窗口客户区刷新 MSG_KEYDOWN \ref CNeatWnd::OnKeyDown 按键按下事件 MSG_KEYUP \ref CNeatWnd::OnKeyUp 按键释放事件 MSG_CHAR \ref CNeatWnd::OnChar 字符事件 MSG_TIMER \ref CNeatWnd::OnTimer 定时器事件 MSG_COMMAND \ref CNeatWnd::OnCommand 命令事件 MSG_SETFOCUS \ref CNeatWnd::OnSetFocus 窗口获得焦点事件 MSG_KILLFOCUS \ref CNeatWnd::OnKillFocus 窗口失去焦点事件 MSG_SIZE \ref CNeatWnd::OnSize 窗口大小调整事件 MSG_SHOWWINDOW \ref CNeatWnd::OnShowWindow 窗口显示(不显示)事件 MSG_HSCROLL \ref CNeatWnd::OnHScroll 水平滚动事件 MSG_VSCROLL \ref CNeatWnd::OnVScroll 垂直滚动事件 MSG_ENABLE \ref CNeatWnd::OnEnable 窗口允许事件 MSG_IDLE \ref CNeatWnd::OnIdle 窗口进入 IDEL 事件 窗口类概览 在接下来的章节中,我们会介绍最常用的那些窗口类以便你可以在你的应用程序中使用它们。 25 基本窗口类 下面的这些基本的窗口类实现了一些最基本的功能,这些类主要是用来作为别的类型的基类以生成更实用的派生类。 窗口类 描述 \ref CNeatWnd 这是所有窗口类的基类。 \ref CNeatControl 所有控件(比如 CNeatButton)的基类。 顶层窗口类 顶层窗口类通常指那些独立的位于桌面上的类。 窗口类 描述 \ref CNeatFrame 一个可以包含其他窗口,并且大小可变的窗口类。 \ref CNeatDialog 是一种可变大小的用于给用户提供选项的对话框窗口类。 视图类 窗口类 描述 \ref CNeatView 这是所有视图类的基类。 \ref CNeatMenuView 一个实现菜单选择功能的视图,支持文本和图标模式。 \ref CNeatTreeView 一个实现树型功能的视图。 \ref CNeatListView 一个实现列表功能的视图。 控件窗口类 这些控件是用户可以操作或者编辑的。 窗口类 描述 \ref CNeatStatic 静态框 \ref CNeatButton 按钮 \ref CNeatEdit 编辑框 \ref CNeatProgressCtrl 进度条 \ref CNeatListBox 列表框 \ref CNeatComboBox 组合框 \ref CNeatScrollBar 滚动条 \ref CNeatMonthCalendar 日历 \ref CNeatSliderCtrl 滑块 \ref CNeatSpinButtonCtrl 旋钮 26 基础窗口类 虽然你不一定有机会直接使用基础窗口类(CNeatWnd),但是由于这个类是很多窗口控件的基类,它实现的很多方法在它的子 类型中都可以直接拿来使用,所以有必要介绍一下这个基础窗口类。 窗口类 CNeatWnd \ref CNeatWnd 窗口类既是一个重要的基类, 也是一个你可以直接在代码中使用的类。 当然, 前者使用的频度要比后者大很多。 CNeatWnd 类的成员函数。 因为 CNeatWnd 类是其它所有窗口类的基类,它拥有很多的成员函数。我们不在这作一一的说明,只能拣其中最重要的一 些作简要的说明。具体的内容参见\ref CNeatWnd 的接口说明,以便能够彻底了解 CNeatWnd 类提供的所有功能,以及要使用这个 功能你需要提供的参数等。 TODO:增加部分成员函数的使用介绍。 窗口类 CNeatView 视图类 CNeatControl 类 \ref CNeatControl 继承自\ref CNeatWnd 类, 用来作为控件的基类,所谓控件指的是那些可以显示数据项并且通常需要响应鼠 标或者键盘事件的那些窗口类。 CNeatFrame 类 顶层窗口直接被放置在桌面上而不是包含在其它窗口之内。如果应用程序允许,他们可以被移动或者重新改变大小。有两种 基础的顶层窗口类型。 CNeatFrameWnd 和 CNeatDialog 都是从 CNeatWnd 继承来的。一个对话框既可以是模态的也可以是非模态 的,而 frame 通常都是非模态的。模态对话框的意思是说当这个对话框弹出时,应用程序除了等待用户关闭这个对话框以外不再作 别的事情。对于那些要等待用户响应以后才能继续的操作来说,这是比较合适的。 顶层窗口通常都拥有一个标题栏,这个标题栏上有一些按钮或者菜单或者别的修饰用来关闭,或者最小化,或者恢复这个窗 口。而 frame 窗口则通常还会拥有菜单条,工具条和状态条。但是通常对话框则没有这些。 27 第五章 消息与消息处理 消息驱动的编程模型 所有的 GUI 程序都是事件驱动的。换句话说,应用程序一直停留在一个循环中,等待着来自用户或者其他地方(比如窗口刷 新或网络连接)的事件,一旦收到某种事件,应用程序就将其扔给处理这个事件的函数。虽然看上去不同的窗口是同时被刷新的, 但实际上,绝大多数的 GUI 程序都是单线程的,因此窗口的刷新是依次按顺序进行的。如果由于某种意外你的设备变得很慢导致 窗口刷新的过程变的很明显,你就会注意到这一点。 不同的 GUI 编程架构用不同的方法将它内部的事件处理机制展现给程序开发者。对于 NEAT 来说,消息函数重载是最主要的 方法。在下一小节我们会对此进行进一步的解释。 NEAT 应用程序通过接收消息来和外界交互。消息由系统或应用程序产生,系统对输入事件产生消息,系统对应用程序的响 应也会产生消息,应用程序可以通过产生消息来完成某个任务,或者与其它应用程序的窗口进行通讯。总而言之,NEAT 是消息驱 动的系统,一切运作都围绕着消息进行。 系统把消息发送给应用程序窗口过程,窗口过程有四个参数:窗口句柄、消息标识以及两个 32 位的消息参数。窗口句柄决定 消息所发送的目标窗口,NEAT 可以用它来确定向哪一个窗口过程发送消息。消息标识是一个整数常量,由它来标明消息的类型。 如果窗口过程接收到一条消息,它就通过消息标识来确定消息的类型以及如何处理。消息的参数对消息的内容作进一步的说明,它 的意义通常取决于消息本身,可以是一个整数、位标志或数据结构指针等。对其他不同的消息类型来讲,wParam 和 lParam 也具有 明确的定义。应用程序一般都需要检查消息参数以确定如何处理消息。 消息及消息处理过程 NEAT 事件处理系统采用通常的虚方法机制来实现。每一个 CNeatWnd 的派生类,例如 frame,按钮,对话框等,都会在其内 部重载消息处理函数,用来告诉 NEAT 事件和事件处理过程的对应关系。 要重载一个消息处理函数,你需要下面两个步骤: 1. 在派生类声明重载的消息函数,类型要和基类中定义的一样。 2. 实现该消息处理函数。 让我们来扩展一下前一章中的例子,来增加一个按键事件的处理。下面是扩展以后的 MyFrame 的定义: \code class CMyFrame : public CNeatFrameWnd { public: // 窗口刷新事件的处理函数 virtual int OnPaint(); // 按键事件的处理函数 virtual int OnKeyDown(UINT nKeyCode, UINT nRepCnt, UINT nFlags); 28 }; \endcode 增加处理的实现部分: \code // 按键按下事件的消息处理函数 int CMyFrame::OnKeyDown(UINT nKeyCode, UINT nRepCnt, UINT nFlags) { wxString str = _("OnKeyDown: "); // nKeyCode 按键的扫描码 switch (nKeyCode) { case KEY_0: str += "0"; break; case KEY_1: str += "1"; break; case KEY_2: str += "2"; break; case KEY_3: str += "3"; break; case KEY_4: str += "4"; break; case KEY_5: str += "5"; break; case KEY_6: str += "6"; break; case KEY_7: str += "7"; break; case KEY_8: str += "8"; break; case KEY_9: str += "9"; break; case KEY_UP: str += "UP"; break; case KEY_FUNC: str += "FN"; break; default: str += wxString::Format("0xX",nKeyCode); } CNeatPaintDC dc(this); str += " "; dc.TextOut(0,0,str); // 如果不要基类来处理一些默认的实现,可以在这直接返回 // return 1; // 交给基类来完成一些默认处理 return CNeatFrameWnd::OnKeyDown(nKeyCode,nRepCnt,nFlags); } \endcode 消息循环 在每个主窗口及对话框后面都存在一个消息循环,消息循环就是一个循环体,在这个循环体中,程序利用 GetMessage 函数不 停地从消息队列中获得消息,然后利用 DispatchMessage 函数将消息发送到指定的窗口,也就是调用指定窗口的窗口过程,并传递 消息及其参数。典型的消息循环如下所示: \code MSG Msg; while ( GetMessage(&Msg, m_hWnd) ) { 29 TranslateMessage (&Msg); DispatchMessage (&Msg); } \endcode 如上所示,应用程序在创建了主窗口之后开始消息循环。 GetMessage 函数从\a m_hWnd 窗口所属的消息队列当中获得消息,然后调用 TranslateMessage 函数将击键消息 MSG_KEYDOWN 和 MSG_KEYUP 翻译成字符消息 MSG_CHAR ,最后调用 DispatchMessage 函数将消息发送到指定的窗口。 GetMessage 函数直到在消息队列中取到消息才返回,一般情况下返回非 0 值;如果取出的消息为 MSG_QUIT,GetMessage 函数 将返回 0,从而使消息循环结束。结束消息循环是关闭应用程序的第一步,应用程序一般在主窗口的窗口过程中通过调用 PostQuitMessage 来退出消息循环。 消息事件相应函数 NEAT 在 NEAT 消息处理机制之上进行了进一步的封装,它把消息循环封装在\ref CNeatApp 和\ref CNeatWnd 等基类,从 应用程序的角度来看,它是看不到消息循环及消息派发的过程。NEAT 把每个消息的处理过程定义成消息事件响应函数,这些响应 函数大部分定义在\ref CNeatWnd 中,和控件通知消息相关的响应函数定义在\ref CNeatDialog 类面。 30 第六章 在窗口中绘 设备上下文 理解设备上下文 在 NEAT 中,所有的绘相关的动作,都是由设备上下文完成的。每一个设备上下文都是\ref CNeatDC 的一个派生类。每次 在窗口上绘,都要先创建一个窗口绘设备上下文,然后在这个上下文上绘。 可用的设备上下文 在 NEAT 中,所有的绘相关的动作,都是由设备上下文完成的。每一个设备上下文都是\ref CNeatDC 的一个派生类。每次 在窗口上绘,都要先创建一个窗口绘设备上下文,然后在这个上下文上绘。 下面列出了你可以使用的设备上下文: \ref CNeatDC 设备上下文的基类,其他各种设备上下文都是派生自这个类. \ref CNeatClientDC 用来在一个窗口的客户区绘。 \ref CNeatPaintDC 仅用在重绘事件的处理函数中,用来在窗口的客户区绘。 当使用\ref CNeatDC 中的输出函数在屏幕上图时,输出的某些特性并没有在函数调用过程中规定,它是通过设备上下文的 属性获得。 例如, 在调用 CNeatDC::DrawText 时, 要指定待输出的字符串和显示该字符串的矩形区域, 但没有指定文本颜色和字体, 因为颜色和字体是设备上下文的属性。 下面列出了一些设备上下文中最常用的属性和访问这些属性的 CNeatDC 函数。 Attribute Default Operation functions 文本颜色 Text Color Black(黑色) \ref CNeatDC::SetTextColor \ref CNeatDC::GetTextColor 背景颜色 Background Color White(黑色) \ref CNeatDC::SetBkColor \ref CNeatDC::GetBkColor 背景模式 Background Mode OPAQUE(覆盖) \ref CNeatDC::SetBkMode \ref CNeatDC::GetBkMode 当前位置 Current Position (0,0) \ref CNeatDC::MoveTo \ref CNeatDC::GetCurrentPosition 31 Attribute Default Operation functions 当前笔 Current Pen (黑色) (Black) \ref CNeatDC::SelectObject \ref CNeatDC::GetCurrentPen 当前刷 Current Brush (黑色) (Black) \ref CNeatDC::SelectObject \ref CNeatDC::GetCurrentBrush 当前字体 Current Font (黑色) (Black) \ref CNeatDC::SelectObject \ref CNeatDC::GetCurrentFont 下面我们描述一下怎样创建和使用这些设备上下文。 使用 CNeatClientDC 在窗口客户区进行绘。 \ref CNeatClientDC 用来在非重绘事件处理函数中对窗口的客户区进行绘制。下面的例子演示了按键时在窗口中随机线: \code int MyWindow::OnKeyDown(UINT nKeyCode, UINT nRepCnt, UINT nFlags) { int x, y; CNeatRect rect; // 创建一设备上下文 CNeatClientDC dc(this); // 创建一笔,使用默认属性(宽度为 1,颜色为黑色,实线) CNeatPen pen; // 将笔选进设备上下文,选进成功后,设备上下文后续的线将使用这个笔 dc.SelectObject(&pen); // 获得当前窗口的客户区尺寸,在客户区内随机定位一个点,然后线 GetClientRect( &rect ); x = rand()%rect.Width(); y = rand()%rect.Height(); dc.LineTo(x,y); } \endcode 使用 CNeatPaintDC 在窗口上绘 如果你定义了一个窗口重绘事件处理函数,则必须在这个处理函数中产生一个 CNeatPaintDC 设备上下文,并且使用它来进行 你需要的绘动作。 产生这个对象将告诉 NEAT 的窗口体系这个窗口的需要重的区域已经被重了, 这样窗口系统就不会重复的 发送重消息给这个窗口了。重事件是由于用户和窗口系统的交互造成的,但是它也可以通过调用 CNeatWnd::InvalidateRect 函 数手动产生。 下面的代码演示了如何在窗口正中位置一个黑边红色的矩形区域,并且会判断这个区域是否位于需要更新的区域范围内以 32 便决定是否需要重。 \code int MyWindow::OnPaint() { // 创建一设备上下文 CNeatPaintDC dc(this); // 获取窗口大小 CNeatRect rect; GetClientRect( &rect ); // 绘制一矩形框 dc.Rectangle(&rect); } \endcode 绘工具 笔 NEAT 使用\ref CNeatPen 来实现笔的功能,一个笔对象包含三个属性:笔的类型,颜色和线宽,默认为:实线,黑色, 1 个像素线宽。如果要使用自定义的笔,首先要定义一个 CNeatPen 的对象,并设置相关属性;使用时,先要调用\ref CNeatDC::SelectObject 将笔对象选进设备上下文中,如下面代码所示: \code CNeatPen pen(PT_SOLID,1,COLOR_black); dc.SelectObject(&pen); \endcode 下面给出一个笔及常用线(框)函数的示例代码: \include gdi\pen\src\gdi-pen.cpp \image html gdi-pen-normal.jpg ―笔 - 普通‖ \image html gdi-pen-width.jpg ―笔 - 不同线宽‖ \image html gdi-pen-color.jpg ―笔 - 不同颜色‖ \image html gdi-pen-dbdash.jpg ―笔 - 双虚线‖ \image html gdi-pen-dash.jpg ―笔 - 可定制虚线‖ 刷 NEAT 使用\ref CNeatBrush 来实现刷的功能,一个刷对象包含两个属性:刷的类型和颜色,默认为:纯色(黑色)填 充。 如果要使用自定义的刷, 首先要定义一个 CNeatBrush 的对象, 并设置相关属性; 使用时, 先要调用\ref CNeatDC::SelectObject 将笔对象选进设备上下文中,如下面代码所示: \code CNeatBrush brush(COLOR_black); dc.SelectObject(&brush); \endcode 下面给出一个刷及填充的示例代码: 33 \include gdi\brush\src\gdi-brush.cpp \image html gdi-brush-color.jpg ―刷 - 纯色填充‖ \image html gdi-brush-CROSS.jpg ―刷 - 预设类型填充‖ \image html gdi-brush-DIAGCROSS.jpg ―刷 - 预设类型填充‖ \image html gdi-brush-bmp1.jpg ―刷 - 位图填充‖ \image html gdi-brush-bmp2.jpg ―刷 - 位图填充‖ 字体 NEAT 使用\ref CNeatFont 来实现字体的功能,一个字体对象包含属性: 字符集及编码:多字节编码字符集:简体中文(gb2312,gbk),单字节编码字符集:ascii,iso8859-1,ISO8859-15 字体样式:中文默认为宋体,英文默认为(Arial) 字体大小:中文默认为宋体,英文默认为(Arial) 其他属性:下划线,穿透线,粗体,斜体等等 下面给出一个字体使用的示例代码: \include gdi\font\src\gdi-font.cpp 不同大小字体(12,16,24) \image html gdi-font-12.jpg \image html gdi-font-16.jpg \image html gdi-font-24.jpg 不同粗细 \image html gdi-font-bold.jpg \image html gdi-font-demibold.jpg \image html gdi-font-book.jpg \image html gdi-font-subpiexl.jpg 下划线及穿透线斜体 \image html gdi-font-underline.jpg \image html gdi-font-structout.jpg \image html gdi-font-slant.jpg 图标 NEAT 使用\ref CNeatIcon 来实现图标的功能。 位图 NEAT 使用\ref CNeatBitmap 来实现位图的功能。 34 绘制基本图形 下面列出 NEAT 支持的常见的图标图形操作: 函数 功能 备注 \ref CNeatDC::LineTo 线 当前笔 \ref CNeatDC::Rectangle 矩形框 当前笔 \ref CNeatDC::Circle 当前笔 \ref CNeatDC::CircleEx (支持线类型及线宽) 当前笔 \ref CNeatDC::Ellipse 当前笔 \ref CNeatDC::EllipseEx (支持线类型及线宽) 当前笔 \ref CNeatDC::CircleArc 弧线 当前笔 CNeatDC::SetPixel 设置像素点颜色 调用参数指定 \ref CNeatDC::FillSolidRect 区域填充 调用参数指定 \ref CNeatDC::FillRect 区域填充,使用当前刷 当前刷 \ref CNeatDC::FillCircle 填充,使用当前刷,只支持纯色模式 当前刷 \ref CNeatDC::FillCircleEx 填充,使用当前刷,支持刷的各个类型 当前刷 \ref CNeatDC::FillEllipse 椭填充,使用当前刷,只支持纯色模式 当前刷 \ref CNeatDC::FillEllipseEx 椭填充,使用当前刷,支持刷的各个类型 当前刷 \ref CNeatDC::FillArcEx 弧型填充,使用当前刷,支持刷的各个类型 当前刷 绘制文本 下面列出 NEAT 支持的绘制文本操作: 函数 功能 备注 \ref CNeatDC::TextOut 文本输出 当前笔 \ref CNeatDC::DrawText 文本格式化输出 当前笔 \ref CNeatDC::TabbedTextOut 文本输出,支持 TAB 当前笔 35 文本格式: 格式 备注 格式 备注 DT_TOP 顶部对齐 DT_LEFT 左对齐 DT_CENTER 中间对齐(设置 DT_SINGLELINE 时有效) DT_RIGHT 右对齐 DT_VCENTER 上下居中 DT_BOTTOM 底部对齐 DT_WORDBREAK 自动卷行时,判断单词边界 DT_SINGLELINE 单行 DT_EXPANDTABS TAB 扩展,默认为个空格 DT_TABSTOP 格式参数的高 8 位用来指定 TAB 键宽度 DT_NOCLIP 不进行边界切割 DT_CHARBREAK 当文本输出超过矩形区时按字 符换行输出 DT_CALCRECT 不作实际输出,只计算实际的输 出矩形大小 36 第七章 处理用户输入 PT80 的按键所对应的键值 输入事件相应 事件 消息处理函数 备注 MSG_KEYDOWN \ref CNeatWnd::OnKeyDown 按键按下事件 MSG_KEYUP \ref CNeatWnd::OnKeyUp 按键释放事件 标识 键值 标识 键值 标识 键值 KEY_0 11 KEY_8 9 KEY_OK 59 KEY_1 2 KEY_9 10 KEY_CANCEL 1 KEY_2 3 KEY_UP 103 KEY_POWER 68 KEY_3 4 KEY_DOWN 108 KEY_FUNC 60 KEY_4 5 KEY_LEFT 105 KEY_BACKSPACE 14 KEY_5 6 KEY_RIGHT 106 KEY_TAB 15 KEY_6 7 KEY_ENTER 28 KEY_ALPHA 66 KEY_7 8 KEY_DOT 52 37 第八章 对话框编程基础 使用资源编辑器编辑对话框 几乎每一个 NEAT 程序都会使用对话框与用户进行交互,对话框可能是一个简单的 OK 按钮,也可以是一个复杂的数据输入 表单。NEAT 目前只支持模态对话框方式,\ref CNeatDialog 是对话框的基类,使用模态对话框,在对话框关闭之前,用户不能在 同一应用程序的其他地方工作。 对话框和普通窗口的主要区别在于,对话框几乎始终与资源相关联,这些资源标识对话框元素,并指定它的布局。在 VC 开 发环境下,可以利用 VC 的对话框编辑器(资源编辑器之一)来创建和编辑对话框资源,所以,我们可以快速并且高效地以可视化 的方式生成对话框对话框包含许多名为控件的元素,对话框控件包括编辑控件、按钮、列表框、组合框、静态文本(标签)、进度条、滑块等。 控件发送通知消息到它的对话框,以响应键入文本或单击按钮之类的用户活动。 NEAT 已经对这些事件做了很好的封装,使用时,只要重载你关心的事件处理函数就可以了。在对话框创建的时候,要建立 对话框数据成员和这些控件的关联,然后就可以利用这些数据成员进行控件的数据操作了。 模态和非模态对话框编程 模态对话框是最常用的对话框。用户的操作打开一个对话框,用户在对话框中输入数据,然后关闭对话框。下面在当前工程 中增加一个模态对话框的步骤(在 VC 集成开发环境下): 1. 使用对话框编辑器来创建包含不同控件对话框资源。对话框编辑器更新工程的资源 脚本(RC)文件,以包含新的对话框资源,并且,它使用对应的#define 变量来更新该工程的 resource.h 文件。 2. 创建一个\ref CNeatDialog 的派生类。 3. 在创建的派生类中,添加要进行数据操作的控件数据成员。 4. 在创建的派生类中,添加要处理的控件事件处理函数。 5. 在创建的派生类中,重载\ref CNeatDialog::OnInitDialog 函数,并在此函数实现控件数据成员和相应控件的关联。 6. 在合适的位置编写代码来激活对话框。这个代码包括对对话框构造函数的调用,接着是对\ref CNeatDialog::DoModal 对 话框类成员函数的调用。只有当用户退出这个对话框窗口时,\ref CNeatDialog::DoModal 函数才返回。 38 通用对话框 对话框 示例 现在,我们将开始一个示例程序。 对话框资源编辑(有关 VC 资源编辑器的使用,已经超出了本帮助文档的范围,但有关 VC 资源编辑器使用介绍的文档 、书籍 很多,请用户去参考相关的使用介绍)。 \image html dialog1-rc.jpg "对话框资源" 创建一个\ref CNeatDialog 的派生类。 \code // CMyDialog // 资源头文件 #include "resource.h" // NEAT 对话框控件实现相关的头文件 #include // 定义一个对话框 // 创建一个\ref CNeatDialog 的派生类。 class CMyDialog : public CNeatDialog { public: // 构造函数 CMyDialog(UINT dlgid, CNeatWnd* parent); // 对话框创建初始化函数,用于控件的关联和控件数据的初始化。 virtual int OnInitDialog(); // 列表框选择发生改变的事件响应处理函数 virtual int OnLbnSelchange(UINT nID,HWND hwnd); // 确认退出前的事件响应处理函数 virtual int OnOK(); public: wxString m_str; protected: // 列表框控件对象 CNeatListCtrl m_listctrl; }; \endcode 在 OnInitDialog 中实现控件数据成员和相应控件的关联。 \code int CMyDialog::OnInitDialog() { CNeatDialog::OnInitDialog(); 39 // 实现列表控件和列表框对象的关联,IDC_LIST1 为列表框对应的资源 ID m_listctrl.Attach(GetDlgItem(IDC_LIST1)); // 利用列表框对象进行相关的数据操作,这添加一些字符串 m_listctrl.AddString( _("list string1") ); m_listctrl.AddString( _("list string2") ); m_listctrl.SetCurSel(0); return 0; } \endcode 重写你关心的一些事件处理函数 \code // 列表边框选择发生改变的事件处理函数 int CMyDialog::OnLbnSelchange(UINT nID,HWND hwnd) { if (hwnd==m_listctrl.GetSafeHwnd()) { int sel = m_listctrl.GetCurSel(); } } // 对话确认退出前的事件响应函数 void CMyDialog::OnOK() { int sel = m_listctrl.GetCurSel(); m_str = m_listctrl.GetText(sel); } \endcode 调用这个对话框,看看运行的效果。 \code // 按键事件处理函数 int CMyFrame::OnKeyDown(UINT nChar, UINT nRepCnt, UINT nFlags) { // 调用对话框 CMyDialog dlg(IDD_DIALOG1,this); if (dlg.DoModal()==IDOK) { NeatMessage( dlg.m_str ); } return 0; } \endcode \image html dialog1-emu.jpg "模拟器下运行效果" 40 对话框资源 在 VC 开发环境下的 NEAT, 可以利用 VC 的资源编辑工具进行资源的编辑, 但没有直接使用它的 rc 文件, 需要使用 neatrg 工 具进行资源的转换,转换后的资源称为资源模板,默认存在 res.cpp 文件中。 资源模板文件 在资源模板文件中,常包含有以下几种资源: 1. 对话框(Dialog)资源,资源数据利用数据结构\ref DLGTEMPLATE 来实现。 2. 位图(Bitmap)资源,资源数据为一个资源 ID 及对应的位图文件。 3. 图标(Icon)资源,资源数据为一个资源 ID 及对应图标文件。 4. 菜单(Menu)资源。 5. 版本信息(Version)资源。 用到了几个将资源数据和资源 ID 建立关联的数据结构: \ref DLGID_TEMPL 用于对话框资源和资源 ID 的关联。 \ref STRID_TEMPL 用于字符串(Bitmap,Icon,cursor 等)资源和资源 ID 的关联。 \ref MENU_TEMPL 用于菜单资源和资源 ID 的关联。 \ref MENUITEM_TEMPL 用于菜单项的关联。 41 第九章 NEAT 控件 控件综述 许多人对控件(或者部件)的概念已经相当熟悉了,控件可以理解为主窗口中的子窗口,这些子窗口的行为和主窗口一样, 既能够接收键盘和鼠标等外部输入,也可以在自己的区域内进行输出,只是它们的所有活动被限制在主窗口中。NEAT 也支持子窗 口,并且可以在子窗口中嵌套建立子窗口。我们将 NEAT 中的所有子窗口均称为控件。 静态框 静态框用来在窗口的特定位置显示文字、数字等信息,还可以用来显示一些静态的图片信息,比如公司徽标、产品商标等等。 就像其名称暗示的那样,静态框的行为不能对用户的输入进行动态的响应,它的存在基本上就是为了展示一些信息,而不会接收任 何键盘或鼠标输入。 静态框风格 静态框的风格由静态框种类和一些标志位组成。我们可将静态框控件按功能划分为标准型(只显示文本)、位图型(显示图 标或图片),以及特殊类型分组框。下面我们将分别介绍上述不同类型的静态框。 标准型 SS_SIMPLE 创建的控件只用来显示单行文本 SS_LEFT 风格创建的静态框可用来显示多行文本并左对齐 SS_CENTER 风格创建的静态框可用来显示多行文本并中对齐 SS_RIGHT 风格创建的静态框可用来显示多行文本并右对齐 SS_LEFTNOWORDWRAP 创建的静态框会扩展文本中的 TAB 符,但不做自动换行处理。 位图型 SS_BITMAP 显示一幅位图 SS_ICON 显示一幅图标 SS_REALSIZEIMAGE 取消缩放操作,并显示在静态框的左上方 SS_CENTERIMAGE 在控件中部显示位图或图标 分组框 SS_GROUPBOX 用来包含其他的控件 42 其他静态框类型 SS_WHITERECT 以白色填充静态框矩形 SS_GRAYRECT 以灰色填充静态框矩形 SS_BLACKRECT 以黑色填充静态框矩形 SS_GRAYFRAME 灰色边框 SS_WHITEFRAME 白色边框 SS_BLACKFRAME 黑色边框 编程示例 1. 手动创建: 直接在视图上创建\ref CNeatStatic 的对象,并调用 Create 方法。 2. 利用资源创建: 创建\ref CNeatStatic 的对象并调用 LoadTemplate(CNeatWnd * parent, PCTRLDATA templdata, const wxString & res = NEATAPPNAME) 函数 3. 对话框创建: 首先将 Picture Control 控件拖到模板上 \image html 9.2-static1.JPG 添加图标:设置 Type 熟悉对话框为 Icon,设置 Image 为所选图标的 ID。 添加位图:Type 为 Bitmap。 \image html 9.2-static2.JPG 添加静态框只需将控件拖到模板上即可 \image html 9.2-static3.JPG 部分示例代码: \include demo-static.cpp 显示效果截图: \image html demo-static-1.jpg "静态框示例 按键 1" \image html demo-static-2.jpg "静态框示例 按键 2" \image html demo-static-3.jpg "静态框示例 按键 3" \image html demo-static-4.jpg "静态框示例 按键 4" 43 按钮 按钮是除静态框之外使用最为频繁的一种控件。按钮通常用来为用户提供开关选择。NEAT 的按钮可划分为普通按钮、复选 框和单选钮等几种类型。用户可以通过键盘或者鼠标来选择或者切换按钮的状态。用户的输入将使按钮产生通知消息,应用程序也 可以向按钮发送消息以改变按钮的状态。 按钮风格 普通按钮 BS_PUSHBUTTON 普通按钮 BS_DEFPUSHBUTTON 默认选中普通按钮 复选框 复选框风格: BS_CHECKBOX 在选中和非选中状态之间切换 BS_AUTOCHECKBOX 控件会自动在选中和非选中状态之间切换 BS_3STATE 能显示第三种状态——复选框内是灰色的,应用程序来操作其状态 BS_AUTO3STATE 能显示第三种状态——复选框内是灰色的,由控件负责状态的自动切换 BS_PUSHLIKE 复选框以普通按钮的形式显示 文本对齐的风格: BS_LEFT 文本左对齐 BS_CENTER 文本水平居中 BS_RIGHT 文本右对齐 BS_TOP 文本上对齐 BS_VCENTER 文本垂直居中 BS_BOTTOM 文本下对齐 单选钮 显示用户的选择情况 BS_RADIOBUTTON 显示用户的选择情况 BS_AUTORADIOBUTTON 自动显示用户的选择情况 BS_PUSHLIKE 单选按钮以普通按钮的形式显示 44 文本对齐的风格: BS_LEFT 文本左对齐 BS_CENTER 文本水平居中 BS_RIGHT 文本右对齐 BS_TOP 文本上对齐 BS_VCENTER 文本垂直居中 BS_BOTTOM 文本下对齐 按钮事件响应 按钮事件 消息处理函数 备注 BN_CLICKED CNeatWnd::OnBnClicked 按钮单击事件的响应函数 BN_PUSHED CNeatWnd::OnBnPushed 按钮按下事件的响应函数 BN_UNPUSH
UIDesigner(腾讯公司出品) 在软件设计阶段,交互设计师或者产品经理等常常需要使用一些工具(比如Visio、Axure RP、Flash或者OmniGraffle等)制作出静态稿或者原型来表达设计思。这些工具是各有各的优势,当然也各有各的缺点啦。那么腾讯CDC是如何设计软件原型的呢?这向大家介绍我们正在研发的原型设计利器UIDesigner。   首先,先让我们来体验一下UIDesigner制作出来的原型效果。这个原型是一个设置窗体,主要由按钮、复选框、分组框和文本框等控件构成,其中一些按钮还具有响应的动作(如打开另一个界面,关闭窗体等)。如图一所示,这是使用Firework制作出来的交互图。 图一、使用Firework制作出来的设计稿   这种交互图的特点是简单明了,能够表示出各种控件的基本属性(如文本、位置和选中状态等),但它只是一个静态的图片,不能真实表现出每个控件的响应动作,如仅看这张图,是不清楚点击代理服务器设置分组框上的“设置…”按钮会有什么响应的。   那再看看你若使用UIDesigner制作出来的效果:最终输出的是一个EXE可执行文件(见图二左上角),双击运行后就会出现一个与最终实现效果完全一致的窗体(见图二右)。另外,它还是一个具有响应动作的真实原型,例如你若点击了“设置…”按钮,那就会弹出一个新的窗体(见图三)。 图二、使用UIDesinger制作出来的原型 图三、点击“设置…”按钮后弹出的另一窗体   实际上,这个新弹出的窗体都是一个独立的原型,也是由UIDesigner制作出来的。由于它面的控件同样可以设置下一步的响应动作,所以从总体上来看,众多原型就像一个树状结构,而其中的父节点就是图二中的设置窗体了。这种结构具有一个很大的好处:无论你完成了多个界面的原型,只需要它们之间有链接关系,最后输出的只是一个EXE可执行文件。这样,你可以很方便地与其它人员表达自己的设计思路,让沟通变得更加快捷。   接下来,我们看看这个原型是如何制作出来的。   第一步:建立空白窗体,调整它的大小、风格、标题和Icon 图四、使用UIDesigner制作原型—建立窗体   第二步:从工具箱中拖曳控件到窗体上,修改这些控件的属性(如Text等) 图五、使用UIDesigner制作原型—加入控件   由于UIDesigner具有自动对齐的功能,所以在拖动控件到窗体时就可以完成排版工作,不需要再逐个像素去调整。另外,不单单在加入控件到窗体时,在改变已存在于窗体内的控件的位置或者大小时,自动对齐功能一样会生效。这样,设计者在调整控件大小或者位置时(包括控件控件控件与窗体边缘等的距离等情况),工作变得很简单。 图六、使用UIDesigner制作原型—自动对齐功能   第三步:几分钟后,所有的控件都放到窗体并设置好属性了,如下图。 图七、使用UIDesigner制作原型—整体界面效果   此时,设计者就可以使用软件的导出图片或者导出原型功能分享你的设计成果了。当然,现在这种效果还只是一个没有响应动作效果的原型。接下来,我们再给“设置…”按钮加入响应动作。首先,选中“设置…”按钮,然后点击工具栏的“响应”按钮,你将会看到如图八的响应设置窗口。此时,你可以选择打开窗体、打开网页、弹出对话框、修改属性值和关闭本身窗体等五种效果,这我们选择“打开窗体”,然后在弹出的对话框指向弹出窗体的文件。最后,点击“完成”按钮即可。 图八、使用UIDesigner制作原型—设置控件的响应动作   到此为止,你就完成了一个与最终实现效果完全一致的高保真原型了。产品经理和开发人员等若了解你的设计思就不需要看着长长几页的说明文档了,而只需要运行你输出的原型文件,就可以对你的设计思路一目了然。   UIDesigner除了能让使用者能够快速地搭建起软件界面的高保真原型外,还提供了项目管理,让使用者能够方便地管理工程文件;提供了图片库和模板库功能,让使用者可以方便地重用以前的设计资源;提供了32个Windows客户端软件常用控件,满足使用者的设计需求;提供了多个属性设置入口,分别实现最常用属性设置、一般属性设置和高级属性设置功能。当然,UIDesigner不是专用来设计QQ的,其它的Windows客户端产品都在它的工作范围之内。总的来说呢,使用UIDesigner来制作原型是很高效的,而制作出来的原型也能够实现设计师、产品经理和程序开发工程师三者间的快速沟通,减少不必要的工作内耗。 ------------------------------------------------------------------ GUI_Design_Studio_3.5.94.0 在2008年,这款软件的作者从1,322位付费用户那获得了162,302美元的收入(其中仅12月份就有39,000美元),这令人鼓舞地证明了只要是提供真正价值的服务和软件,就能够创造很好的收入,即使在经济萧条的寒冬。 GUI Design Studio是一款图形用户界面设计工具,您能用它在不需要编写任何代码或脚本的情况下快速地创建演示原型。使用标准元素绘制个人化的屏幕、窗口以及控件;将它们整合以展示操作工作流然后运行模拟程序测试您的设计。 当您需要绘制一款应用程序的外观或显示怎样将程序的各个部分连接起来时,您就可以使用GUI Design Studio来实现,如: 将产品创意文档化 制作项目提案 需求记录 创建屏幕图样 为开发人员制作详细的规格 为现有产品提出加强方案 以及更多其它用途 为用户以及股东甚至您自己制作展示文件以: 验证设计 找出替代项 评估多个使用场景 系统需求 Microsoft Windows Vista/XP/NT/2000 至少15MB的硬盘空间 推荐不少于256MB的内存 工程 将您的工作组织放到工程。 每个工程都拥有它自己的文件夹结构。 可连接您计算机或网络上任何地方的其它库工程。 可连接到您计算机或网络上任何地方使您能够方便地获取图片以及其它文件。 创建您要的并独立于所有工程的个人化设计文件。 创建能重复使用的设计库以及工程之间的一致性。 将图片直接从剪贴板中粘贴到工程文件夹的文件中。 屏幕设计程序 可同时打开多个设计文档并能使用分页界面在文档间快速切换。 可使用标准Windows元素创建图形用户界面(GUI)屏幕,包括框架窗口、会话、菜单、工具栏、标签、按钮、复选框、单选按钮、滚动条、滑动调节框、微调框、组合框、树列表、列表框、编辑框以及静态文本等。 通过现有元素或其它自定义控件创建自定义控制组件。 在其它设计中创建将要使用的控件设计。 以常用的文件格式添加图标与图片。 从能够显示您将获得什么的控件面板中进行拖放操作。 属性编辑程序使您能将每个元素进行自定义。 元素的自动生成功能。 您能在任何地方放置任何元素。 Edge snapping能通过“点击”对屏幕元素进行统一记录。 设计网格向您提供了简单的制作具有一致性设计布局的方法。 只需单键点击就能排列元素组。 均衡地隔开元素组。 调整元素大小以适应其它元素或测量一组其它元素。 聚焦缩小以查看细节设计或聚焦放大以浏览设计概况。使用工具栏按键或键盘或鼠标的滑动缩小放大功能聚焦增量。 使用鼠标的滚动以及滚轮功能快速浏览设计的概况。 剪切、复制与粘贴。 使用可选的canvas向导显示可用的屏幕空间。 通过文本框与书签对您的设计进行注释。 为每个设计添加说明。 选择色彩主题以避免实际功能窗口的混淆。 图标 为图标面板提供快速的访问方式。 工程间可共享常用图标。 工程也能拥有它们独享的图标集。 使用将来在实际产品开发中可能用到的标准ICO文件。 包含的Icon Express编辑程序支持16色、256色以及最大尺寸为127 x 127的真彩图标。 如果愿意同样能整合任意其它的图标编辑应用程序。 展示与原型 在可导航元素(如按键与窗口)之间创建连接以显示控制流程。 为图象添加覆盖保护以及添加其它元素以创建可导航的热点。 支持形式化与非模态的窗口并支持显示、隐藏或微调窗口,以及窗口替换以实现切换效果。 锚点使您能对窗口进行准确定位。 能立即在模拟程序中测试或展示您的设计。 添加消息框以描述可能在真实应用程序中出现的功能。 可创建多种场景,如正常条件下的场景与多个出错场景。 选择要激活的场景或让模拟程序为您选择。 更改有效的屏幕分辨率以查看您的设计如何适应不同的屏幕大小。 在没有进行脚本或代码编写的情况下,所有操作都是以图形模式完成。 ------------------------------------------------------------------ Balsamiq_Mockups_1.8.4 1. 首先安装 AdobeAIRInstaller.exe 2. 安装主程序 MockupsForDesktop.air 3. 使用 keygen 进行注册 在Balsamiq Mockups中绘制界面原型,就像在纸张和白板上手工绘一样方便快速,而且不用担心出错,因为你完全可以进行回复/重做。在Balsamiq Mockups中设计原型比在纸张和白板可有趣多了! 丰富的控件支持 Balsamiq Mockups预先提供了丰富的控件,如浏览器窗口、媒体播放器组件、形图表等,让你信手拈来! 丰富的控件 方便的属性设置 当你选择一个控件时,会立刻出现该控件的属性选项,你可以随时编辑修改属性。 属性设定 无限的恢复/重做,不用担心出错,你可以无限制的进行回复和重做。 开放,可移植的数据 Balsamiq Mockups所生成的数据是易于阅读的XML格式数据,你可以进行方便的移植和重用集成。 开放的数据 多种方式的集成应用,你可以将Balsamiq Mockups集成倒Confluence, Jira, XWiki中. 集成应用 Balsamiq Mockups是一款免费的带有手绘风格的原型设计软件,可以帮助你设计桌面应用软件,Web 2.0 站点, RIA富网络应用程序, Web站点和Web应用软件。 功能和亮点: 操作方面:拖拽,控件分组,甚至元素之间的对齐都做得很到位; 预制了六十多个界面元素,从简单的输入框,下拉框,到经常用得到的导航条,日历,表格,到复杂的Tag Cloud,Cover Flow, 地图,WYSWYG的格式工具栏等,有了这些不用从头起,其实比用白板都快; 界面元素的修改很简单,比如导航条的几个标签页的label,就是用逗号分隔的文字,下拉框的选项就是分行的文字; 使用xml语言来记录和保存界面元素和布局,从而使其能够快速的导入到你所需的任何一个项目中,或其他工具中。 可以将设计导出成PNG格式的图片; 随着使用的熟练,快捷键便派上用场,超过一半的元素均有快捷方式,这更有助于原型的快速构造,几乎几分钟便可实现一个满意的而复杂的原型设计; 跨平台,Balsamiq Mokups是用Flex和Air实现的,所以在Mac OS, Linux和Windows下都能使用; 不仅仅有桌面版本,还有能集成在Confluence,JIRA,和XWiki中的版本,使得异地在线协作更方便有效。 可以用命令行进行导出操作,这样就能让我写个脚本,从svncheckout某个目录下的所有设计文件后,导出图片,打包后用邮件发到项目经理,工程师甚至客户那; 跨平台,Balsamiq Mokups是用Flex和Air实现的,所以在Mac OS, Linux和Windows下都能使用;不仅仅有桌面版本,还有能集成在Confluence,JIRA,和XWiki中的版本,使得异地在线协作更方便有效;据作者说,现在这款软件的设计就是用它自己来设计的,经典的“吃自己的狗粮”,这也让我对其更有信心,因为它是开发者为开发者写的软件。 还有值得一提的是Balsamiq Mokups的在GetSatisfaction上的用户支持和服务,作者Peldi对问题报告,新需求的回应很积极和及时。而且根据这个讨论上看,到月底就会有一个专门用来分享界面控件设计的社区网站了,很期待。 再要说的一点是这款软件是要付费的,79美元(也可以免费,具体如何免费,请看网站上的说明),相对于它能节省下来的时间和提高的效率,是很值得的。Peldi说在2008年,这款软件就从1,322位付费用户那获得了162,302美元的收入(其中仅12月份就有39,000美元),这令人鼓舞地证明了只要是提供真正价值的服务和软件,就能够创造很好的收入,即使在经济萧条的寒冬
PrintDefineFont() 功能定义打印作业使用的字体,对每个打印作业PowerBuilder支持八种字体。 语法PrintDefineFont(printjobnumber,fontnumber,facename,height,weight,fontpitch,fontfamily, italic,underline) 参数printjobnumber:用PrintOpen()函数打开的打印作业号fontnumber:指定赋给当前定义字体的编号,有效值在1到8之间 facename:string类型,指定字体名称,该字体应该是你的打印机支持的字体,比如“宋体”height:Integer类型,使用正值指定字体的高度,以千分之一英寸为单位;使用负值指定字体点数,比如,-18代表18点。一般来说,使用点数更精确些weight:指定字体的磅数,正常字体为400磅,粗体为700磅fontpitch:FontPitch枚举类型,指定字体标准。有效取值为:Default! - 缺省值;Fixed! - 固定形式;Variable! - 可变形式fontfamily:FontFamily枚举类型,指定字体系列。有效取值为:AnyFont!、Decorative!、Modern!、Roman!、Script!、Swiss!italic:boolean类型,指定是否使用斜体样式。有效取值为:TRUE - 使用斜体样式;FALSE - 不使用斜体样式。缺省值为FALSEunderline:boolean类型,指定是否加下划线。有效取值为:TRUE - 加下划线;FALSE - 不加下划线。缺省值为FALSE返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,PrintDefineFont()函数返回NULL。用法在一个打印作业中,应用程序能够最多同时定义8种字体。当应用程序需要使用更多的字体时,可以在使用了某个字体号输出内容后使用PrintDefineFont()函数将该字体号对应的字体更换为其它字体。 -------------------------------------------------------------------------------- PrintLine() 功能在当前打印页上绘出指定厚度的一条线。 语法PrintLine ( printjobnumber, x1, y1, x2, y2, thickness ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号x1:integer类型,指定直线起点的x坐标,以千分之一英寸为单位y1:integer类型,指定直线起点的y坐标,以千分之一英寸为单位x2:integer类型,指定直线终点的x坐标,以千分之一英寸为单位y2:integer类型,指定直线终点的y坐标,以千分之一英寸为单位thickness:integer类型,指定直线的厚度,以千分之一英寸为单位返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,PrintLine()函数返回NULL。用法应用程序执行了PrintLine()函数后,该函数并不改变打印光标的位置。 -------------------------------------------------------------------------------- PrintOpen() 功能启动打印作业并返回作业号。 语法PrintOpen ( { jobname } ) 参数jobname:string类型,可选项,指定要打开打印作业的名称,该名称将显示在打印管理器窗口中返回值Long。函数执行成功时返回打印作业号,发生错误时返回-1。如果任何参数的值为NULL,PrintOpen()函数返回NULL。用法应用程序执行PrintOpen()函数后,启动新的打印作业并走纸到下一页,同时将打印机缺省字体设置为该打印作业的字体。打印光标的位置位于打印区的左上角。其它同组的打印函数使用PrintOpen()函数返回的作业号来标识作业。需要注意的是,使用PrintOpen()函数打开打印作业、使用同组的其它函数完成打印任务后,必须使用PrintClose()关闭打印作业,或根据需要使用PrintCancel()函数取消打印作业。 -------------------------------------------------------------------------------- PrintOval() 功能在指定位置以指定线宽绘制椭。 语法PrintOval ( printjobnumber, x, y, width, height, thickness ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号x:integer类型,指定椭外形框左上角的x坐标,以千分之一英寸为单位y:integer类型,指定椭外形框左上角的y坐标,以千分之一英寸为单位width:integer类型,指定椭外形框的宽度,以千分之一英寸为单位height:integer类型,指定椭外形框的高度,以千分之一英寸为单位thickness:integer类型,指定椭外边线的厚度,以千分之一英寸为单位返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,PrintOval()函数返回NULL。用法应用程序执行了PrintOval()函数后,该函数并不改变打印光标的位置。PrintOval()函数绘出的椭是实心的,也就是说,执行该函数后,椭下面的文字或图像将完全被覆盖。如果在椭中输出文字或图形,那么应用程序应该首先绘制椭,然后使用其它函数在椭中输出文字或图形。 -------------------------------------------------------------------------------- PrintPage() 功能将当前页发送给打印机或打印池并在当前打印作业中启动一个新的打印页。 语法PrintPage ( printjobnumber ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,PrintPage()函数返回NULL。 -------------------------------------------------------------------------------- PrintRect() 功能在指定位置以指定线宽打印矩形。 语法PrintRect ( printjobnumber, x, y, width, height, thickness ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号x:integer类型,指定矩形左上角的x坐标,以千分之一英寸为单位y:integer类型,指定矩形左上角的y坐标,以千分之一英寸为单位width:integer类型,指定矩形的宽度,以千分之一英寸为单位height:integer类型,指定矩形的高度,以千分之一英寸为单位thickness:integer类型,指定矩形边线的厚度,以千分之一英寸为单位返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,PrintRect()函数返回NULL。用法应用程序执行了PrintRect()函数后,该函数并不改变打印光标的位置。PrintRect()函数绘出实心的矩形,也就是说,执行该函数后,矩形下面的文字或图像将完全被覆盖。如果在矩形中输出文字或图形,那么应用程序应该首先绘制矩形,然后使用其它函数在矩形中输出文字或图形。 -------------------------------------------------------------------------------- PrintRoundRect() 功能在指定位置以指定线宽打印角矩形。 语法PrintRoundRect(printjobnumber,x,y,width,height,xradius,yradius,thickness) 参数printjobnumber:用PrintOpen()函数打开的打印作业号x:integer类型,指定角矩形左上角的x坐标,以千分之一英寸为单位y:integer类型,指定角矩形左上角的y坐标,以千分之一英寸为单位width:integer类型,指定角矩形的宽度,以千分之一英寸为单位height:integer类型,指定角矩形的高度,以千分之一英寸为单位xradius:integer类型,指定角矩形角部分的x半径,以千分之一英寸为单位yradius:integer类型,指定角矩形角部分的y半径,以千分之一英寸为单位thickness:integer类型,指定角矩形边线的厚度,以千分之一英寸为单位返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,PrintRoundRect()函数返回NULL。用法应用程序执行了PrintRoundRect()函数后,该函数并不改变打印光标的位置。PrintRoundRect()函数绘出实心的角矩形,也就是说,执行该函数后,角矩形下面的文字或图像将完全被覆盖。如果角矩形中输出文字或图形,那么应用程序应该首先绘制角矩形,然后使用其它函数在角矩形中输出文字或图形。 -------------------------------------------------------------------------------- PrintScreen() 功能在打印作业中打印屏幕图像。 语法PrintScreen ( printjobnumber, x, y {, width, height } ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号x:integer类型,指定要打印屏幕图像左上角在打印页上的x坐标,以千分之一英寸为单位y:integer类型,指定要打印屏幕图像左上角在打印页上的y坐标,以千分之一英寸为单位width:integer类型,可选项,指定屏幕图像的打印宽度,以千分之一英寸为单位。如果省略了该参数,那么PowerBuilder按屏幕的原始宽度打印屏幕图像。如果指定了该参数,必须同时指定height参数height:integer类型,可选项,指定屏幕图像的打印高度,以千分之一英寸为单位。如果省略了该参数,那么PowerBuilder按屏幕的原始高度打印屏幕图像返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,PrintScreen()函数返回NULL。 -------------------------------------------------------------------------------- PrintSend() 功能直接向打印机发送任意字符串,通常用于发送打印机的控制代码。 语法PrintSend ( printjobnumber, string {, zerochar } ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号string:string类型,指定发送到打印机的字符串。在该字符串中,使用非打印字符的ASCII码值表示非打印字符zerochar:integer类型,可选项,指定在string参数中用于表示数值0的ASCII码值。有效取值在1到255之间返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,PrintSend()函数返回NULL。用法应用程序使用PrintSend()函数可以直接向打印机发送控制序列(换码序列),比如,设置打印文字的浓淡、打印页的四周空白等。不同类型的打印机使用不同的控制序列,你需要翻一翻你的打印机手册。由于PowerBuilder使用数值0(即ASCII码为0的字符)结束每个字符串,因此,如果打印控制序列中包含了数值0,应用程序需要使用其它字符在参数string中替代数值0,并用zerochar参数指明这个替代字符。一般来说,应该选择一个打印机控制序列中不使用的字符作为0值字符的替代字符。通常情况下,按下述次序组织打印作业:1. 使用PrintOpen()函数打开打印作业2. 使用PrintSend()函数设置打印机特性,比如打印方向、四周空白等3. 使用PrintDefineFont()和PrintSetFont()函数设置该打印作业使用的字体4. 使用该组的其它函数打印输出文字或图形5. 执行PrintClose()函数关闭打印作业 -------------------------------------------------------------------------------- PrintSetFont() 功能设置当前打印作业使用的字体。 语法PrintSetFont ( printjobnumber, fontnumber ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号fontnumber:指定该打印作业使用字体的字体编号,该编号与PrintDefineFont()函数中定义的编号应该对应,字体编号的有效取值在1到8之间,0表示使用打印机的缺省字体返回值Integer。函数执行成功时返回当前字体的高度,发生错误时返回-1。如果任何参数的值为NULL,PrintSetFont()函数返回NULL。 -------------------------------------------------------------------------------- PrintSetSpacing() 功能设置行间距因子,打印函数将使用该因子来决定行间距。 语法PrintSetSpacing ( printjobnumber, spacingfactor ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号spacingfactor:指定行间距因子,用字符高度的倍数表示,缺省值为1.2返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,PrintSetSpacing()函数返回NULL。用法在PowerBuilder应用程序中,行间距与字符的高度成正比,缺省值为字符高度的1.2倍。当Print组函数生成新行时,系统自动把打印光标的x坐标位置设置为0,y坐标位置在原有基础上增加当前行距值。使用PrintSetSpacing()函数可以改变当前打印作业的行距。 -------------------------------------------------------------------------------- PrintSetup() 功能打开打印机设置对话框。 语法PrintSetup ( ) 返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,PrintSetup()函数返回NULL。用法当系统中安装了多种打印机时,在Windows 95中PrintSetup()函数打开如图2-1所示的对话框,单击“Setup”按钮设置打印机各种特性。如果系统中只有一个打印机,则直接打开该打印机的打印设置对话框。需要注意的是,在Windows95和Windows NT 3.51以后的版本中,使用PrintSetup()函数设置的打印机设置只对当前应用起作用,并不影响其它应用的打印机设置。对Windows 3.1来说,使用PrintSetup()函数设置的打印机设置影响系统中的所有应用。 -------------------------------------------------------------------------------- PrintText() 功能在指定位置打印一行文本。 语法PrintText ( printjobnumber, string, x, y {, fontnumber } ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号string:string类型,指定要打印的文本x:integer类型,指定文本开始打印位置的x坐标,以千分之一英寸为单位y:integer类型,指定文本开始打印位置的y坐标,以千分之一英寸为单位fontnumber:可选参数,指定打印文本使用的字体号,该编号由PrintDefineFont()函数确定。省略该参数时,以打印作业的当前字体打印文本返回值Integer。函数执行成功时返回文本打印后打印光标的x位置,即参数x的值加上打印文本的宽度。发生错误时返回-1。如果任何参数的值为NULL,PrintText()函数返回NULL。 -------------------------------------------------------------------------------- PrintWidth() 功能确定一个字符串在指定打印作业中按当前字体所占的宽度,以千分之一英寸为单位。 语法PrintWidth ( printjobnumber, string ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号string:string类型,指定要决定其打印宽度的字符串返回值Integer。函数执行成功时返回按当前字体计算的字符串打印宽度,以千分之一英寸为单位,发生错误时返回-1。如果任何参数的值为NULL,PrintWidth()函数返回NULL。 -------------------------------------------------------------------------------- PrintX() 功能返回打印光标的x坐标位置。 语法PrintX ( printjobnumber ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号返回值Integer。函数执行成功时返回打印光标的x坐标位置,以千分之一英寸为单位,发生错误时返回-1。如果任何参数的值为NULL,PrintX()函数返回NULL。 -------------------------------------------------------------------------------- PrintY() 功能返回打印光标的y坐标位置。 语法PrintY ( printjobnumber ) 参数printjobnumber:用PrintOpen()函数打开的打印作业号返回值Integer。函数执行成功时返回打印光标的y坐标位置,以千分之一英寸为单位,发生错误时返回-1。如果任何参数的值为NULL,PrintY()函数返回NULL。  LibraryCreate() 功能创建一个空的PowerBuilder应用库,并可根据需要在创建应用库的同时添加库注解。 语法LibraryCreate ( libraryname{, comments } ) 参数libraryname:string类型,指定要创建应用库的名称,可以带上路径,不带路径时在当前目录下创建应用库comments:string类型,可选项,指定要创建的应用库的注解返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,LibraryCreate()函数返回NULL。用法LibraryCreate()函数在指定路径下创建一个空的PowerBuilder应用库(PBL)。如果在指定应用库名称时没有指定文件的扩展名,那么该函数自动加上扩展名.PBL。 -------------------------------------------------------------------------------- LibraryDelete() 功能删除应用库库文件或应用库中的数据窗口对象。 语法LibraryDelete ( libraryname{, objectname, objecttype } ) 参数libraryname:string类型,指定库名,可以带上路径,不带路径时在系统搜索路径下查找应用库objectname:string类型,可选项,指定要从库中删除的数据窗口对象的名称objecttype:LibImportType类型,可选项,指定要删除对象的类型,目前仅支持ImportDataWindow!返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,LibraryDelete()函数返回NULL。 用法执行LibraryDelete()函数时,如果未指定后两个参数,那么该函数删除指定的应用库;如果指定了后两个参数,那么该函数删除指定应用库中指定的数据窗口对象。LibraryDelete()函数只能删除应用库中的数据窗口对象,如果删除其它对象,那么只能在PowerBuilder开发环境中使用库管理笔(Library Painter)来实现了。 -------------------------------------------------------------------------------- LibraryDirectory() 功能 得到应用库中指定对象的信息列表,内容包括对象名称、最近修改日期和时间、以及对象的注释。 语法LibraryDirectory ( libraryname, objecttype ) 参数libraryname:string类型,指定PowerBuilder应用库的名称,如果名称中未指定路径,那么该函数根据操作系统标准的文件搜索路径查找指定文件objecttype:LibDirType枚举类型,指定希望函数列出的对象类型,有效取值请参看用法。返回值String。函数执行成功时返回一个字符串,每个对象占用一行,行中各信息之间使用Tab字符(~t)分隔。行中信息格式为:对象名~t修改日期/时间~t注释~n发生错误时函数返回空字符串("")。如果任何参数的值为NULL,LibraryDirectory()函数返回NULL。 用法LibraryDirectory()函数的objecttype参数是个LibDirType枚举类型的量,其有效取值为:DirAll!得到所有对象的信息DirApplication!得到应用对象的信息DirDataWindow!得到所有数据窗口对象的信息DirFunction!得到所有函数对象的信息DirMenu!得到所有菜单对象的信息DirPipeline!得到所有数据管道对象的信息DirProject!得到工程对象的信息DirQuery!得到所有查询对象的信息DirStructure!得到所有结构对象的信息DirUserObject!得到所有用户对象的信息DirWindow!得到所有窗口对象的信息使用LibraryDirectory()函数得到指定对象的名称、修改日期/时间以及可能的注释后,应用程序既可以使用Pos()函数进行定位和字符串分割,也可以使用数据窗口的ImportString()函数将结果显示在数据窗口中。 -------------------------------------------------------------------------------- LibraryExport() 功能从指定应用库中以对象的语法定义格式卸出对象。 语法LibraryExport ( libraryname, objectname, objecttype ) 参数libraryname:string类型,指定要移出对象的应用库的名称,如果名称中未指定路径,那么该函数根据操作系统标准的文件搜索路径查找指定文件objectname:string类型,指定要移出对象的名称objecttype :LibExportType枚举类型,指定要移出对象的类型,具体取值请参看用法返回值String。函数执行成功时返回指定对象的语法,该语法与使用库管理笔(Library Painter)移出对象时的语法相同,区别在于LibraryExport()函数省略了移出语法的头部。如果发生错误,则函数返回空字符串("")。如果任何参数的值为NULL,LibraryExport()函数返回NULL。 用法LibraryExport()的objecttype参数的可能取值为: ExportApplication!应用对象ExportDataWindow!数据窗口对象ExportFunction!函数对象ExportMenu!菜单对象ExportPipeline!数据管道对象ExportProject!工程对象ExportQuery!查询对象ExportStructure!结构对象ExportUserObject!用户对象ExportWindow!窗口对象 -------------------------------------------------------------------------------- LibraryImport() 功能将以语法格式表示的数据窗口对象装入指定的应用库中。 语法LibraryImport(libraryname,objectname,objecttype,syntax,errors{,comments } ) 参数libraryname:string类型,指定要移入对象的应用库的名称,如果名称中未指定路径,那么该函数根据操作系统标准的文件搜索路径查找指定文件objectname:string类型,指定要移入的数据窗口对象的名称 objecttype:LibImportType枚举类型,指定要移入对象的类型,目前该函数只支持ImportDataWindow!,表示只能向应用库中移入数据窗口对象syntax:string类型,指定要移入数据窗口对象的语法errors:string类型变量,用于在发生错误时保存出错信息comments:string类型,可选项,用于指定移入对象的注解返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,LibraryImport()函数返回NULL。 用法当应用程序在运行过程中动态创建数据窗口对象后,可以使用LibraryImport()函数把动态数据窗口对象的定义保存到应用库中,以后就可以直接使用该对象了。 FileClose() 功能关闭先前用FileOpen()函数打开的文件。 语法FileClose ( fileno ) 参数fileno:integer,指定要关闭文件的文件句柄,该句柄使用FileOpen()函数打开文件时得到返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果fileno参数的值为NULL,那么FileClose()函数返回NULL。 -------------------------------------------------------------------------------- FileDelete() 功能删除指定的文件。 语法FileDelete ( filename ) 参数filename:string类型,指定要删除文件的文件名,其中可以包含路径返回值Boolean。函数执行成功时返回TRUE,发生错误时返回FALSE。如果filename参数的值为NULL,那么FileDelete()函数返回NULL。 -------------------------------------------------------------------------------- FileExists() 功能检查指定的文件是否存在。 语法FileExists ( filename ) 参数filename:string类型,指定要检查存在性的文件的文件名,其中可以包含路径返回值Boolean。如果指定文件存在时返回TRUE,不存在时返回FALSE。如果filename参数的值为NULL,那么FileExists()函数返回NULL。用法如果filename参数指定的文件被另一个应用加锁锁住,那么FileExists()函数也将返回FALSE。 -------------------------------------------------------------------------------- FileLength() 功能得到指定文件的长度(以字节为单位)。 语法FileLength ( filename ) 参数filename:string类型,指定要得到其长度的文件的文件名,其中可以包含路径返回值Long。函数执行成功时返回指定文件的长度(以字节为单位)。如果指定的文件不存在,函数返回-1。如果filename参数的值为NULL,那么FileLength()函数返回NULL。 -------------------------------------------------------------------------------- FileOpen() 功能以指定的读写方式打开指定的文件,同时返回该文件的句柄。 语法FileOpen(filename{,filemode{,fileaccess{,filelock{,writemode,{creator,filetype}}}}}) 参数filename:string类型,指定要打开文件的名称,其中可以包含路径 filemode:FileMode枚举类型,可选项,指定文件打开方式。有效取值为:?LineMode! - 缺省值,行模式;?StreamMode! - 流模式fileaccess:FileAccess枚举类型,可选项,指定文件访问方式。有效取值为:?Read! - 缺省值,只读方式,这样打开的文件只能进行读操作;?Write! - 只写方式,这样打开的文件只能进行写操作?filelock:FileLock枚举类型,可选项,指定文件加锁方式。有效取值为:n LockReadWrite! - 缺省值,只有打开该文件的用户能够访问该文件,其它用 户对该文件的访问均被拒绝;n LockRead! - 只有打开该文件的用户能够读该文件,但其它任何用户均可写该文件;n LockWrite! - 只有打开该文件的用户能够写该文件,但其它任何用户均可读该文件;n Shared! - 所有用户均可读写该文件writemode:WriteMode枚举类型,可选项,当fileaccess参数指定为Write!时,该参数指定在指定文件已经存在时数据的添加方式。有效取值为:?Append! - 缺省值,将数据添加到原文件尾部;?Replace! - 覆盖原有数据creator:可选项,用于Macintosh机,使用四个字符的字符串指定文件的创建者。指定该参数后,必须同时指定filetype参数filetype:可选项,用于Macintosh机,使用四个字符的字符串指定文件类型返回值Integer。函数执行成功时返回打开文件的句柄,随后的文件操作函数利用该句柄完成对文件的操作。发生错误时函数返回-1。如果任何参数的值为NULL,那么FileOpen()函数返回NULL。用法当文件以行模式打开时,每执行一次FileRead()函数读取一行数据;每执行一次FileWrite()函数,该函数自动在写出的字符串末尾增加一个回车(CR)换行(LF)符(这是应用程序在Windows 系统中运行时的情况,在UNIX下只加一个换行字符)。当文件以流模式打开时,执行一次FileRead()函数读取32,765个字节的数据,如果余下数据没有这么多,那么FileRead()函数就读取所有余下的数据;执行一次FileWrite()函数时,最多可写入32,765个字节的数据,并且不添加回车换行字符。当文件以写方式使用FileOpen()函数打开时,如果指定的文件不存在,那么FileOpen()函数创建该文件。 -------------------------------------------------------------------------------- FileRead() 功能从指定文件中读取数据。 语法FileRead ( fileno, variable ) 参数fileno:integer类型,指定文件句柄(由FileOpen()函数得到)variable:string或blob类型的变量,用于保存读取的数据返回值Integer。函数执行成功时返回读取的字符数或字节数;如果在读取任何字符前读到了文件结束符(EOF),则FileRead()函数返回-100;当指定文件以行模式打开时,如果在读取任何字符之前遇到了回车(CR)或换行(LF)字符,则FileRead()函数返回0。如果发生其它错误,FileRead()函数返回-1。如果任何参数的值为NULL,那么FileRead()函数返回NULL。用法当指定文件以行模式(Line Mode)打开时,FileRead()函数一次读取一行数据,并把它保存到参数variable中,然后跳过行结束符(回车换行符,操作系统不同,使用的字符也不同),把文件指针移动到下一行的起始位置。当文件以流模式(Stream Mode)打开时,FileRead()函数或一直读取到文件结尾,或读取32,765字节的数据,决定于两者哪个数据长度更短些。 -------------------------------------------------------------------------------- FileSeek() 功能将文件指针移动到指定位置。读写文件时相应函数会自动移动文件指针。 语法FileSeek ( fileno, position, origin ) 参数fileno: integer类型,指定文件句柄(由FileOpen()函数得到) position:long类型,指定相对于origin参数指定位置的新位置偏移量,以字节为单位 origin:SeekType枚举类型,指定从哪开始移动文件指针,即指针移动的基准。有效取值为:?FromBeginning! - 缺省值,从文件开头移动指针;?FromCurrent! - 从当前位置移动文件指针;?FromEnd! - 从文件结尾处移动文件指针返回值Long。函数执行成功时返回指针移动后的指针位置。如果任何参数的值为NULL,那么FileSeek()函数返回NULL。 -------------------------------------------------------------------------------- FileWrite() 功能向指定文件中写数据。 语法FileWrite (fileno , variable ) 参数fileno:integer类型,指定文件句柄(由FileOpen()函数得到)variable:string或blob类型,其值将写入fileno参数指定的文件返回值Integer。函数执行成功时返回写入文件的字符或字节数,发生错误时返回-1。如果任何参数的值为NULL,那么FileWrite()函数返回NULL。用法FileWrite()函数从当前文件指针开始写入指定数据,写入之后,将文件指针调整到刚刚写入数据的下一个字节位置。当文件以writemode参数设置为Replace!方式打开时,文件指针最初位于文件的开头位置;当文件以writemode参数设置为Append!方式打开时,文件指针最初位于文件的结尾位置。当文件以行模式打开时,执行FileWrite()函数时,该函数自动在每次写入数据的后面加上回车换行符,并把文件指针移动到回车换行符后面。当文件以流模式打开时,FileWrite()函数一次最多写入32,765个字节。如果variable参数中数据的长度超过了32,765个字节,那么FileWrite()函数只向文件中写入前32,765个字符并返回32,765。 -------------------------------------------------------------------------------- GetFileOpenName() 功能显示打开文件对话框,让用户选择要打开的文件。 语法GetFileOpenName(title,pathname,filename{,extension{,filter}}) 参数title:string类型,指定对话框的标题pathname:string类型变量,用于保存该对话框返回的文件路径及文件名filename:string类型变量,用于保存该对话框返回的文件名extension:string类型,可选项,使用1到3个字符指定缺省的扩展文件名 filter:string类型,可选项,其值为文件名掩码,指定显示在该对话框的列表框中供用户选择的文件名满足的条件(比如*.*,*.TXT,*.EXE等)返回值Integer。函数执行成功时返回1;当用户单击了对话框上的“Cancel”按钮时函数返回0;发生错误时返回-1。如果任何参数的值为NULL,那么GetFileOpenName()函数返回NULL。 用法filter参数的格式为:description,*. ext缺省值为:"All Files (*.*),*.*"其中,description说明扩展名的意义,比如“所有文件”、“文本文件”等。你可以根据需要指定在打开文件对话框中显示的文件名类型。当需要指定多种文件类型时,各类型之间使用逗号分隔,例如:"PIF 文件, *.PIF, 批处理文件, *.BAT"需要注意的是,该函数只是得到一个文件名,而并没有打开文件,需要打开文件时,依然需要使用FileOpen()函数。 -------------------------------------------------------------------------------- GetFileSaveName() 功能显示保存文件对话框,让用户选择要保存到的文件。 语法GetFileSaveName(title,pathname,filename{,extension{,filter}}) 参数title:string类型,指定对话框的标题pathname:string类型变量,用于保存该对话框返回的文件路径及文件名filename:string类型变量,用于保存该对话框返回的文件名extension:string类型,可选项,使用1到3个字符指定缺省的扩展文件名filter:string类型,可选项,其值为文件名掩码,指定显示在该对话框的列表框中供用户选择的文件名满足的条件(比如*.*,*.TXT,*.EXE等)返回值Integer。函数执行成功时返回1;当用户单击了对话框上的“Cancel”按钮时函数返回0;发生错误时返回-1。如果任何参数的值为NULL,那么GetFileSaveName()函数返回NULL。 用法filter参数的格式为:description,*. ext缺省值为:"All Files (*.*),*.*"其中,description说明扩展名的意义,比如“所有文件”、“文本文件”等。你可以根据需要指定在打开文件对话框中显示的文件名类型。当需要指定多种文件类型时,各类型之间使用逗号分隔,例如:"PIF 文件, *.PIF, 批处理文件, *.BAT"需要注意的是,该函数只是得到一个文件名,而并没有打开文件,需要打开文件时,依然需要使用FileOpen()函数。 GetCommandDDE() 功能得到DDE客户应用发送的命令。 语法GetCommandDDE ( string ) 参数string:string类型的变量,用于保存DDE客户应用发送的命令返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果string参数的值为NULL, GetCommandDDE()函数返回NULL。用法当DDE客户应用向DDE服务器应用发送一条命令时,这个动作将触发DDE服务器应用活动窗口的RemoteExec事件,在这个事件的事件处理程序中,可以使用GetCommandDDE()函数得到DDE客户应用发送的命令。 -------------------------------------------------------------------------------- GetCommandDDEOrigin() 功能确定哪一个DDE客户应用向服务器发送了命令。 语法GetCommandDDEOrigin ( applstring ) 参数applstring:string变量,用于保存发送命令的DDE客户应用的名称返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果applstring参数的值为 NULL,GetCommandDDEOrigin()函数返回NULL。 -------------------------------------------------------------------------------- GetDataDDE() 功能得到DDE客户应用发送的数据。 语法GetDataDDE ( string ) 参数string:string类型变量,用于保存接收到的数据返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL, GetDataDDE()函数返回NULL。 -------------------------------------------------------------------------------- GetDataDDEOrigin()功能确定哪个DDE客户应用发送了数据。 语法GetDataDDEOrigin ( applstring, topicstring, itemstring ) 参数applstring:string类型变量,用于保存客户应用的名称topicstring:string类型变量,用于保存主题(比如,在Excel中,主题可以是REGION.XLS)itemstring:string类型变量,用于保存数据项标识(比如,在Excel中,数据项标识可能是R1C2)返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,GetDataDDEOrigin()函数返回NULL。 -------------------------------------------------------------------------------- RespondRemote() 功能向客户端应用指明最近的命令或数据是否已经接收。 语法RespondRemote ( boolean ) 参数boolean:其值为boolean量的逻辑表达式,TRUE表示接收先前收到的命令或数据,FALSE表示不接收先前收到的命令或数据返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果boolean参数的值为NULL,RespondRemote()函数返回NULL。 -------------------------------------------------------------------------------- SetDataDDE() 功能向DDE客户应用发送数据。 语法SetDataDDE ( string {, applname, topic, item } ) 参数string:指定要发送到DDE客户应用的数据applname:string类型,可选项,指定接收数据的客户应用的DDE名称topic:string类型,可选项,指定基础数据组item:string类型,可选项,指定基础数据组中的数据项返回值Integer。函数执行成功时返回1,发生错误时返回下述值之一:-1函数调用的环境不对-2数据未被接收如果任何参数的值为NULL,SetDataDDE()函数返回NULL。 -------------------------------------------------------------------------------- StartServerDDE() 功能将当前应用设置为DDE服务器。 语法StartServerDDE ( { windowname, } applname, topic {, item } ) 参数windowname:可选项,指定服务器窗口名,缺省值为当前窗口applname:当前应用的DDE名称topic:string类型,指定DDE客户应用能够引用的基本数据组item:由逗号(,)分隔的一个或多个字符串,指定服务器应用支持的数据项返回值Integer。函数执行成功时返回1,发生错误时返回-1,表示当前应用已经设置为DDE服务器。如果任何参数的值为NULL,StartServerDDE()函数返回NULL。 -------------------------------------------------------------------------------- StopServerDDE() 功能停止当前应用的DDE服务器功能。执行该函数后,发给该应用的任何DDE客户应用请求都将失败。 语法StopServerDDE ( { windowname, } applname, topic ) 参数windowname:可选项,指定要关闭服务器功能的服务器窗口名,缺省值为当前窗口,如果当前应用有多个服务器窗口,那么必须指定该参数applname:当前应用的DDE名称topic:string类型,应该与StartServerDDE()中对应参数相同返回值Integer。函数执行成功时返回1,发生错误时返回-1,表示当前应用未曾作为DDE服务器启动。如果任何参数的值为NULL,StopServerDDE()函数返回NULL。 CPU() 功能得到自当前应用程序启动后开始CPU所消耗的时间,以毫秒为单位。 语法CPU() 返回值Long。返回自当前应用程序启动后开始CPU所消耗的时间,以毫秒为单位。 -------------------------------------------------------------------------------- Idle() 功能该函数在用户每次活动(例如,按键盘、移动鼠标等)后重置定时器,n秒后触发应用对象的Idle事件。 语法Idle ( n ) 参数n:指定空闲时间间隔,以秒为单位。该参数的值设置为0时,停止空闲检测,不再触发应用对象的Idle事件返回值Integer。函数执行成功时返回1,此时启动定时器。如果不能启动定时器或定时器未启动而n的值指定为0时,函数返回-1。如果任何参数的值为NULL,Idle()函数返回NULL。用法利用Idle()函数,应用程序可以构造自己的屏幕保护程序,避免安全数据的泄露。当使用Idle()函数已经启动了定时器后,如果再次以非0参数调用Idle()函数,那么该函数重设时间间隔,但并不启动新的定时器。Idle()函数启动定时器后,如果在指定的时间间隔(从用户最近一次操作算起)内没有操作应用程序,那么就触发应用对象的Idle事件,在这个事件中可以编写关闭窗口、退出数据库登录等一系列代码,然后使用Restart()函数重新启动应用程序,起到保密的目的。发生下述任何情况时,系统自动重置定时器(即重新开始计时):n 用户在该应用程序的任何窗口内移动鼠标或单击鼠标(双击鼠标时首先触发单击事件)n 在该应用程序的某个窗口是当前窗口时用户按下了任意一个或多个键n 在该应用程序的窗口最小化时,用户在该应用的图标上单击鼠标或移动鼠标n 在该应用程序的窗口最小化并且该应用程序是当前应用程序(应用名称被加亮显示)时,用户按了任何按键n 可视数据窗口检索数据时引起的编辑控件(指漂浮在数据窗口当前行/列上的编辑控件)重绘操作 -------------------------------------------------------------------------------- Timer() 功能 在指定的时间间隔内反复触发指定窗口的定时器事件。 语法Timer ( interval {, windowname } ) 参数interval:指定两次触发Timer事件之间的时间间隔,有效值在0到65之间。如果该参数的值指定为0,那么关闭定时器,不再触发指定窗口的Timer事件windowname:窗口名,指定时间间隔到时要触发哪个窗口的Timer事件。省略该参数时,触发当前窗口的Timer事件返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,Timer()函数返回NULL。用法使用Timer()函数可以周期性地触发指定窗口的Timer事件,这样,每当时间间隔过去时,应用程序都可以完成一些周期性的工作,比如绘制简单动等。将Timer()的interval参数设置为非0值时启动定时器并开始计时;将该函数的interval参数设置为0时关闭定时器,终止计时任务。需要注意的是,在Microsoft Windows系统中,该函数能够计时的最小时间间隔为0.055秒(约1/18秒),如果把interval参数的值设置小于0.055,那么该定时器将每隔0.055秒触发一次窗口的Timer事件。Microsoft Windows 3.x最多只支持系统中同时启动16个定时器。 RegistryDelete() 功能删除Windows系统注册库中的一个键或键的某个值。 语法RegistryDelete ( key, valuename ) 参数key:string类型,指定键名,将删除该键或删除该键的某个值valuename:string类型,指定要删除的值的名称。如果删除键、键的值、以及其下的所有子键,那么将该参数指定为空字符串返回值Integer。函数执行成功时返回1,发生错误时返回-1。用法为了唯一地标识某个键,在key参数中,可以从根键开始依次指定各级父键,各键之间使用反斜杠(\)分隔。 -------------------------------------------------------------------------------- RegistryGet() 功能从系统注册库中得到指定键的值。 语法RegistryGet ( key, valuename, valuetype, valuevariable ) 参数key:string类型,指定键名valuename:string类型,指定要访问值的名称。每个键可以有一个未命名的值和多个命名的值。要访问未命名的值,把该参数指定为空字符串("")valuetype:RegistryValueType枚举类型,指定值的数据类型。有效取值请参看用法valuevariable:用于保存键值的变量,其数据类型应该与valuetype参数指定的类型相匹配返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果valuevariable的数据类型与valuetype参数指定的类型不匹配,将引发运行错误。 用法valuetype的可能取值为:RegString!以空字符结束的字符串RegExpandString!以空字符结束的字符串,其中包括了对环境变量的非扩展应用RegBinary!二进制数据ReguLong!32位数据ReguLongBigEndian!32位大数据RegLink!Unicode符号链RegMultiString!动态字符串数组为了唯一地标识某个键,在key参数中,可以从根键开始依次指定各级父键,各键之间使用反斜杠(\)分隔。 -------------------------------------------------------------------------------- RegistryKeys() 功能从系统注册库中得到指定键的有效子键。 语法RegistryKeys ( key, subkeys ) 参数key:string类型,指定键名subkeys:字符串数组变量,用于保存各子键返回值Integer。函数执行成功时返回1,发生错误时返回-1。用法在subkeys参数中可以使用定长数组,也可以使用动态数组。使用动态数组时,数组的上界反映了能够得到的子键个数。当使用定长数组时,其数组元素个数必须足够多,保证能够容纳所有子键,但是,在具体得到子键之前,没有办法能够预先知道实际子键个数。为了唯一地标识某个键,在key参数中,可以从根键开始依次指定各级父键,各键之间使用反斜杠(\)分隔。 -------------------------------------------------------------------------------- RegistrySet() 功能在系统注册库中设置或创建指定键。 语法RegistrySet ( key, valuename, valuetype, value ) 参数key:string类型,指定键名valuename:string类型,指定要访问值的名称。每个键可以有一个未命名的值和多个命名的值。要访问未命名的值,把该参数指定为空字符串("")。如果注册库中不存在指定值名,该函数将创建新的值名valuetype:RegistryValueType枚举类型,指定值的数据类型。有效取值请参看用法value:要设置的值,其数据类型应该与valuetype参数指定的类型相匹配返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果valuevariable的数据类型与valuetype参数指定的类型不匹配,将引发运行错误。用法valuetype的可能取值为:RegString!以空字符结束的字符串RegExpandString!以空字符结束的字符串,其中包括了对环境变量的非扩展应用RegBinary!二进制数据ReguLong!32位数据ReguLongBigEndian!32位大数据RegLink!Unicode符号链RegMultiString!动态字符串数组为了唯一地标识某个键,在key参数中,可以从根键开始依次指定各级父键,各键之间使用反斜杠(\)分隔。 -------------------------------------------------------------------------------- RegistryValues() 功能得到与指定键相关的一组值名。该函数在Windows 3.1中无效。 语法RegistryValues ( key, valuename ) 参数key:string类型,指定键名valuename:字符串数组变量,用于保存值名返回值Integer。函数执行成功时返回1,发生错误时返回-1。用法在valuename 参数中可以使用定长数组,也可以使用动态数组。使用动态数组时,数组的上界反映了能够得到的值名个数。当使用定长数组时,其数组元素个数必须足够多,保证能够容纳所有值名,但是,在具体得到值名之前,没有办法能够预先知道实际值名个数。为了唯一地标识某个键,在key参数中,可以从根键开始依次指定各级父键,各键之间使用反斜杠(\)分隔。  Clipboard() 功能提取或替换Windows系统剪贴板的文本内容。 语法Clipboard ( { string } ) 参数string:string类型,可选项,指定要复制到系统剪贴板上的文本。如果剪贴板上已有内容的话,该文本将取代剪贴板的当前内容返回值String。函数执行成功时,如果剪贴板上包含文本数据,那么函数返回剪贴板的当前内容;如果剪贴板上包含非文本数据(比如位图)或不包含任何数据,那么函数返回空字符串("")。如果string参数的值为NULL,Clipboard()函数返回NULL。用法无论是否指定string参数,Clipboard()都将返回剪贴板的当前内容。当指定string参数时,剪贴板的原有内容被string参数的值取代;省略string参数时,仅仅得到剪贴板的内容。 -------------------------------------------------------------------------------- CommandParm() 功能得到应用程序运行时指定的命令参数。 语法CommandParm ( ) 返回值String。函数执行成功时返回应用程序运行时的命令行参数,函数执行错误或没有命令行参数时函数返回空字符串("")。用法命令行参数是应用程序启动时跟在应用程序名称后面的任何参数,比如,在运行窗口中输入了下述命令:MyAppl C:\EMPLOYEE\EMPLIST.TXT那么MyAppl应用程序中使用CommandParm()函数得到的命令行参数为:C:\EMPLOYEE\EMPLIST.TXT当应用程序的命令行中包含几个参数时,CommandParm()函数作为一个字符串返回所有参数。利用字符串操作函数可以分离各参数。在应用对象的Open事件中没有必要执行CommandParm()函数。此时,Open事件的argument参数中包含了命令行参数。 -------------------------------------------------------------------------------- DoScript() 功能执行AppleScript程序段,该函数只在Macintosh平台上有效。 语法DoScript ( script, result ) 参数script:string类型,指定要运行的程序段(script)result:string类型,由AppleScript程序段返回的结果信息或出错信息返回值Integer。返回由AppleScript返回的结果代码。如果任何参数的值为NULL,DoScript()函数返回NULL。 -------------------------------------------------------------------------------- GetApplication() 功能得到当前应用对象的句柄,这样你可以查询或设置应用对象的属性(通常用于编写通用代码)。 语法GetApplication ( ) 返回值Application。返回当前应用对象的句柄。 -------------------------------------------------------------------------------- GetEnvironment() 功能得到操作系统、处理器、屏幕显示等与系统相关的信息。 语法GetEnvironment ( environmentinfo ) 参数environmentinfo:Environment对象名,用于保存系统环境信息返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果参数environmentinfo的值为NULL,GetEnvironment()函数返回NULL。用法当开发交叉平台项目时,利用GetEnvironment()函数,应用程序能够得到当前运行的操作系统、使用的CPU类型、操作系统的版本、屏幕的大小以及颜色数等信息,这些信息的具体表示请参阅本书环境对象(Environment Object)的介绍。 -------------------------------------------------------------------------------- GetFocus() 功能确定当前焦点位于哪个控件上。 语法GetFocus ( ) 返回值GraphicObject。函数执行成功时返回当前得到焦点控件的引用,发生错误时返回无效引用。用法应用程序利用IsValid()函数可以检测GetFocus()是否返回有效的控件引用。同时,使用TypeOf()函数可以确定控件的类型。 -------------------------------------------------------------------------------- Post() 功能将指定消息加入到某个窗口的消息队列中,这个窗口既可以是PowerBuilder应用的窗口,也可以是其它应用的窗口。 语法Post( handle, messageno, word, long ) 参数handle:long类型,指定窗口的系统句柄,将向该窗口邮寄消息messageno:UnsignedInteger类型,指定要邮寄的消息号 word:long类型,指定与消息一起邮寄的word类参数值。如果messageno参数指定的消息不使用该参数,那么将这个参数的值设置为0long:long类型或string,指定与消息一起邮寄的long型参数值或字符串返回值Boolean。如果任何参数的值为NULL,Post()函数返回NULL。 用法Post()函数用于向窗口发送非PowerBuilder预定义事件的消息,这个窗口可以是PowerBuilder应用的窗口,也可以是其它应用的窗口。Post()函数把发送的消息放置在指定窗口消息队列的尾部,然后返回到应用程序中,它并不等待相应事件事件处理程序的执行。这一点与Send()函数不同,Send()函数直接触发指定窗口相应的事件,执行事件处理程序后返回到调用应用中。因此,我们说Post()函数采用的是异步方式,Send()函数采用的是同步方式。Post()函数的参数handle指定接收消息的窗口句柄,对PowerBuilder窗口来说,使用Handle()函数可以得到该句柄。对其它应用程序的窗口来说,可以调用系统API函数查找窗口并得到相应窗口的句柄。如果应用程序要邮寄PowerBuilder定义事件(包括预定义事件和用户定义事件),那么使用PostEvent()函数既简单有方便。当应用程序在long参数位置指定一个字符串时,Post()函数复制一个该字符串的副本,然后将副本的地址传送给指定窗口。 -------------------------------------------------------------------------------- ProfileInt() 功能从初始化文件(.ini)中读取整型设置值。 语法ProfileInt ( filename, section, key, default ) 参数filename:string类型,指定初始化文件的名称,可以包括路径,省略路径时,该函数按操作系统的标准路径搜索指定文件section:string类型,指定要得到的值所在的节(Section)key:string类型,指定要得到的值的名称,不用区分大小写default:integer类型,当指定的文件、节名、项目名不存在或不能转换为整数时,函数返回该参数指定的值返回值Integer。函数执行成功时,在指定的文件、节名、项目名不存在任何错误的情况下,函数返回相应项的值;如果指定的文件、节名、项目名不存在或不能转换为整数时,函数返回default参数指定的缺省值。如果发生错误,函数返回-1。如果任何参数的值为NULL,ProfileInt()函数返回NULL。 -------------------------------------------------------------------------------- ProfileString() 功能从初始化文件(.ini)中读取字符串型设置值。 语法ProfileString ( filename, section, key, default ) 参数filename:string类型,指定初始化文件的名称,可以包括路径,省略路径时,该函数按操作系统的标准路径搜索指定文件section:string类型,指定要得到的值所在的节(Section)key:string类型,指定要得到的值的名称,不用区分大小写default:string类型,当指定的文件、节名、项目名不存在时,函数返回该参数指定的值返回值String。函数执行成功时,在指定的文件、节名、项目名不存在任何错误的情况下,函数返回相应项的值;如果指定的文件、节名、项目名不存在,函数返回default参数指定的缺省值。如果发生错误,函数返回空字符串。如果任何参数的值为NULL,ProfileString()函数返回NULL。 -------------------------------------------------------------------------------- Restart() 功能停止所有程序段的执行、关闭所有窗口、提交事务、断开与数据库的连接,然后重新启动应用程序。 语法Restart() 返回值Integer。函数执行成功时返回1,发生错误时返回-1。 -------------------------------------------------------------------------------- Run() 功能运行指定的应用程序。 语法Run ( string {, windowstate } ) 参数string:string类型,指定要运行的应用程序的名称,其中可以包括路径以及相应的参数,就像在命令行中键入的那样windowstate:WindowState枚举类型,可选项,指定程序运行时的窗口状态。有效取值为:Maximized! - 最大化窗口;Minimized! - 最小化窗口;Normal! - 缺省值,正常窗口返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,Run()函数返回NULL。 用法使用Run()函数,应用程序能够启动操作系统中的任何程序。当在Run()参数中指定了要启动应用程序的参数时,参数的意义、格式、个数等由具体的应用程序确定。如果在Run()函数的string参数中指定了文件名但没有给出扩展名时,PowerBuilder认为该文件的扩展名为.EXE。要运行扩展名不是.EXE的应用程序(比如.BAT, .COM, 或.PIF),必须在Run()函数的参数中指定文件的扩展名。 -------------------------------------------------------------------------------- Send() 功能向窗口发送指定的消息并立即执行相应的事件处理程序。 语法Send( handle, messageno, word, long ) 参数handle:long类型,指定窗口的系统句柄,将向该窗口发送消息messageno:UnsignedInteger类型,指定要发送的消息号word:long类型,指定与消息一起发送的word类参数值。如果messageno参数指定的消息不使用该参数,那么将这个参数的值设置为0long:long类型或string,指定与消息一起发送的long型参数值或字符串返回值Long。函数执行成功时返回Windows系统调用SendMessage()的返回值,发生错误时返回-1。如果任何参数的值为NULL,Send()函数返回NULL。 用法Send()函数用于向窗口发送非PowerBuilder预定义事件的消息,这个窗口可以是PowerBuilder应用的窗口,也可以是其它应用的窗口。Send()函数直接触发指定窗口相应的事件,执行事件处理程序后返回到调用应用中,这一点与Post()函数不同,Post()函数把发送的消息放置在指定窗口消息队列的尾部,然后返回到应用程序中,它并不等待相应事件事件处理程序的执行。因此,我们说Post()函数采用的是异步方式,Send()函数采用的是同步方式。Send()函数的参数handle指定接收消息的窗口句柄,对PowerBuilder窗口来说,使用Handle()函数可以得到该句柄。对其它应用程序的窗口来说,可以调用系统API函数查找窗口并得到相应窗口的句柄。实际上,Send()函数把它的各个参数直接传送给Windows的系统调用SendMessage()。在各种C++开发工具的WINDOWS.H文件中可以查到各消息编号。如果应用程序要发送PowerBuilder定义事件(包括预定义事件和用户定义事件),那么使用TriggerEvent()函数既简单有方便。当应用程序在long参数位置指定一个字符串时,Send()函数复制一个该字符串的副本,然后将副本的地址传送给指定窗口。 -------------------------------------------------------------------------------- SetProfileString() 功能设置初始化文件中指定项的值。 语法SetProfileString ( filename, section, key, value ) 参数filename:string类型,指定初始化文件的名称,可以包括路径,省略路径时,该函数按操作系统的标准路径搜索指定文件section:string类型,指定要设置的值所在的节(Section)key:string类型,指定要设置的值的名称,不用区分大小写default:string类型,指定要设置项的值返回值Integer。函数执行成功时返回1,指定的文件未找到或指定的文件不能访问时函数返回-1。如果任何参数的值为NULL,SetProfileString()函数返回NULL。 -------------------------------------------------------------------------------- ShowHelp() 功能显示应用程序帮助,该帮助使用Microsoft Windows帮助系统进行操作。 语法ShowHelp ( helpfile, helpcommand {, typeid } ) 参数helpfile:string类型,指定帮助文件的名称helpcommand:HelpCommand枚举类型,指定显示帮助的格式。有效取值为:Index! - 显示目录主题,使用该值时不要指定typeid参数;Keyword! - 转移到由指定关键字确定的主题;Topic! - 显示指定主题的帮助typeid:可选项,指定帮助主题返回值Integer。函数执行成功时返回1,发生错误时返回-1。如果任何参数的值为NULL,ShowHelp()函数返回NULL。 -------------------------------------------------------------------------------- SignalError() 功能触发应用对象的SystemError事件,通常用于代码调试。 语法SignalError ( { number }, { text } ) 参数number:integer类型,可选项,其值将保存到Error对象的number属性中text:string类型,可选项,其值将保存到Error对象的text属性中返回值Integer。函数执行成功时返回1,发生错误时返回-1。 -------------------------------------------------------------------------------- Yield() 功能将控制权转移给其它图形对象,包括非PowerBuilder对象。该函数检测消息队列,如果有消息,就把消息取出。利用该函数可以在执行耗时较长的操作时把控制权转让给其它应用。 语法Yield() 返回值Boolean。如果在消息队列中提取到了消息,那么函数返回TRUE,否则返回FALSE。用法正常情况下,PowerBuilder应用程序在执行一段代码(比如函数或事件处理程序)的过程中不响应用户的操作。对耗时短暂的代码段来说,这种处理方式没有什么不妥的地方,但是,如果某个代码段的执行耗时较长,应用程序又希望为用户提供更多的控制权,那么需要在这段代码中插入Yield()函数,让用户能够进行其它操作,特别在循环执行的代码中更应该如此。应用程序执行Fill() 功能建立一个由指定字符串填充的指定长度的字符串。 语法Fill ( chars, n ) 参数chars:string类型,指定用于重复填充的字符串n:long类型,指定由该函数返回的字符串的长度返回值String。函数执行成功时返回n个字符的字符串,该字符串以参数chars中的字符串重复填充而成。如果参数chars中的字符个数多于n个,那么使用chars字符串的前n个字符填充函数返回的字符串;如果参数chars中的字符个数少于n个,那么使用chars字符串反复填充,直到返回的字符串长度达到n为止。如果任何参数的值为NULL,Fill()函数返回NULL。 -------------------------------------------------------------------------------- Left() 功能得到字符串左部指定个数的字符。 语法Left ( string, n ) 参数string:string类型,指定要提取子串的字符串n:long类型,指定子串长度返回值String。函数执行成功时返回string字符串左边n个字符,发生错误时返回空字符串("")。如果任何参数的值为NULL,Left()函数返回NULL。如果n的值大于string字符串的长度,那么Left()函数返回整个string字符串,但并不增加其它字符。 -------------------------------------------------------------------------------- LeftTrim() 功能返回指定字符串删除了左部空格后的字符串。 语法LeftTrim ( string ) 参数string:string类型,指定要删除左部空格的字符串返回值String。函数执行成功时返回删除了string字符串左部空格的字符串,发生错误时返回空字符串("")。如果任何参数的值为NULL,LeftTrim()函数返回NULL。 -------------------------------------------------------------------------------- Len() 功能得到字符串的长度。 语法Len (string) 参数string:string类型变量返回值Long。函数执行成功时返回字符串的长度,发生错误时返回-1。如果任何参数的值为NULL,则Len()函数返回NULL。 -------------------------------------------------------------------------------- Lower() 功能将字符串中的大写字母转换为小写字母。 语法Lower ( string ) 参数string:要将其中的大写字母转换为小写字母的字符串返回值String。函数执行成功时返回将大写字母转换为小写字母后的字符串,发生错误时返回空字符串("")。如果string参数的值为NULL,Lower()函数返回NULL。 -------------------------------------------------------------------------------- Match() 功能确定字符串中是否包含指定模式的字符。 语法Match ( string, textpattern ) 参数string:string类型,指定要检查是否匹配指定模式的字符串textpattern:string类型,指定文本匹配模式返回值Boolean:如果字符串string与模式textpattern相匹配,则函数返回TRUE,否则返回FALSE。如果指定的匹配模式无效或上述两个参数中的任何一个未曾赋值,那么Match()函数返回FALSE。如果任何参数的值为NULL,Match()函数返回NULL。 用法textpattern参数的写法与正则表达式十分相似,它由元字符和普通字符组成。每个元字符都有不同的匹配含义,普通字符则与其自身相匹配。下面是匹配模式中使用的元字符及其意义: ^指示字符串的开始,例如,^asd表示以asd开头的字符串,字符串asdfgh与模式^asd匹配,而字符串basdfg与模式^asd不匹配。 $指示字符串的结束,例如,red$表示所有以red结束的字符串均与该模式匹配,而redo与模式red$不匹配。 .匹配任意单个字符,例如,^&&$匹配任何六个字符组成的字符串。 []匹配括号中列出的字符,例如,^[ABC]$匹配由一个字符组成的字符串,其值只能是A或B或C。 -与方括号一起,指定匹配字符的范围,例如,^[A-Z]$只匹配那些由一个大写字母组成的字符串。方括号还可以使用^字符,表示匹配不在指定范围内的任何字符,例如,[^0-9]匹配除数字外的任何字符。 *,+,?这些符号跟在一个字符后面表示该字符可以出现的次数。星号(*)表示可以出现0次或任意次;加号(+)表示可以出现多次,但至少出现一次;问号(?)表示出现0次或一次。例如,A*匹配0个或多个A(没有A、A、AA、AAA、AAAA、**);A+匹配1个或多个A(A、AA、AAA、AAAA、**);A?匹配空串或1个A。 \斜杠(\)是转义字符,它去掉特殊字符的特殊含义,比如,模式\$匹配字符$,模式\\匹配字符\。 -------------------------------------------------------------------------------- Mid() 功能取字符串的子串。 语法Mid ( string, start {, length } ) 参数string:string类型,指定要从中提取子串的字符串start:long类型,指定子串第一个字符在string字符串中的位置,第一个位置为1length:long类型,可选项,指定子串的长度返回值String。函数执行成功时返回string字符串中从start位置开始、长度为length的子串。如果start参数的值大于string中字符个数,那么Mid()函数返回空字符串。如果省略了length参数或length参数的值大于从start开始、string字符串中余下字符的长度,那
CruiseYoung提供的带有详细书签的电子书籍目录 http://blog.csdn.net/fksec/article/details/7888251 该资料是《Android高级编程》的源代码 对应的书籍资料见: Android高级编程 基本信息 原书名: Professional Android Application Development 原出版社: Wrox 作者: (英)Reto Meier 译者: 王鹏杰 霍建同 出版社:清华大学出版社 ISBN:9787302228448 上架时间:2010-7-1 出版日期:2010 年6月 开本:16开 页码:398 版次:1-1 内容简介   android提供一个开放的开发环境,为针对移动设备编写创新应用程序带来了激动人心的新机遇。作为使用androidsdk构建这些应用程序的实用指南书籍,《android高级编程》从始至终穿插了一系列示例项目,每个项目都引入android的新功能和新技术,以助您达到最满的学习效果。书中介绍android的所有基本功能,并通过简明扼要的示例引导您使用高级功能。    《android高级编程》首先简要介绍android软件栈,接着陈述为手机创建稳定可靠、赏心悦目的应用程序的基本原理。通过学习,您可以打下牢固的理论根基,了解使用当前android 1.0 sdk编写定制移动程序所需的知识,还能灵活快捷地运用未来的增强功能构建最前沿的解决方案。    主要内容    ◆android移动开发的最佳实践    ◆简要介绍活动、intent、清单和资源    ◆如何使用布局和定制view创建用户界面    ◆存储和共享应用程序数据的技术    ◆如何创建基于地图的应用程序,如何使用gps和地理编码位置等基于位置的服务    ◆如何创建和使用后台服务及notification    ◆使用加速计、指南针和摄像头硬件    ◆与电话和网络硬件相关的所有内容,如电话api、sms和网络管理等    ◆高级开发主题,包括安全、ipc以及一些高级图形和用户界面技术    读者对象    本书面向希望在android手机平台上创建应用程序的所有人员。不管是经验丰富的移动开发人员,还是初出茅庐的新手,都能从本书提供的宝贵信息中获益。 作译者   Reto Meier出生于澳大利西南的珀斯市,现居伦敦。 Reto是一位经验丰富的软件开发人员,拥有逾10年的GUI程序架构、设计和开发经验。他在涉足IT行业前曾从事过海洋石油和天然气开发以及金融工作。 Reto始终不渝地追求掌握新技术,从2007年Android发布之初Reto就迷恋上了此项技术。他利用业余时间研究包括WPF在内的多种开发平台以及Google的各种开发工具。 详情请访问Reto的个人网站RadioactiveYak,网址是http://blog.radioactiveyak.com。 目录 封面 -14 封底 -13 扉页 -12 版权 -11 作者简介 -10 前言 -9 目录 -4 第1章 Android简介 1 1.1 一些背景信息 2 1.1.1 不远的过去 2 1.1.2 未来的前景 2 1.2 对Android的误解 3 1.3 开放的移动开发平台 3 1.4 自带的Android应用程序 4 1.5 Android SDK功能 5 1.5.1 对包括摄像头、GPS和加速计在内的硬件的访问 5 1.5.2 自带的Google地图、地理编码和基于位置的服务 6 1.5.3 后台服务 6 1.5.4 SQLite 数据存储和检索数据库 6 1.5.5 共享数据和应用程序间通信 7 1.5.6 使用Google Talk的P2P服务 7 1.5.7 扩展的数据支持和2D/3D图形 7 1.5.8 优化的内存和进程管理 8 1.6 开放手机联盟简介 8 1.7 运行Android的环境 8 1.8 从事Android开发的原因 9 1.8.1 推动Android普及的因素 9 1.8.2 Android的独到之处 10 1.8.3 改变移动开发格局 10 1.9 开发框架简介 11 1.9.1 开发包中的资源 11 1.9.2 理解Android软件栈 12 1.9.3 Dalvik虚拟机 13 1.9.4 Android应用程序架构 14 1.9.5 Android库 14 1.9.6 高级Android库 15 1.10 小结 16 第2章 开始入手 17 2.1 Android开发 18 2.1.1

16,471

社区成员

发帖
与我相关
我的任务
社区描述
VC/MFC相关问题讨论
社区管理员
  • 基础类社区
  • Web++
  • encoderlee
加入社区
  • 近7日
  • 近30日
  • 至今
社区公告

        VC/MFC社区版块或许是CSDN最“古老”的版块了,记忆之中,与CSDN的年龄几乎差不多。随着时间的推移,MFC技术渐渐的偏离了开发主流,若干年之后的今天,当我们面对着微软的这个经典之笔,内心充满着敬意,那些曾经的记忆,可以说代表着二十年前曾经的辉煌……
        向经典致敬,或许是老一代程序员内心里面难以释怀的感受。互联网大行其道的今天,我们期待着MFC技术能够恢复其曾经的辉煌,或许这个期待会永远成为一种“梦想”,或许一切皆有可能……
        我们希望这个版块可以很好的适配Web时代,期待更好的互联网技术能够使得MFC技术框架得以重现活力,……

试试用AI创作助手写篇文章吧