EPSON RC+ 7.0 选件 (Ver.7.0) GUI Builder 7.0 Rev.1

EPSON RC+ 7.0 选件 Ver.7.0 GUI Builder 7.0 Rev. 1 C1M13ZS2612R

EPSON RC+ 7.0 选件 (Ver.7.0) GUI Builder 7.0 Rev.1

EPSON RC+ 7.0 选件 (Ver.7.0) GUI Builder 7.0 Rev.1 Copyright 2013 SEIKO EPSON CORPORATION. All rights reserved. GUI Builder 7.0 (Ver.7.0) Rev.1 i

前言 感谢您购买本公司的机器人系统 本手册记载了正确 EPSON RC+ 软件所需的事项 该软件时, 请仔细阅读本手册与其他相关手册 阅读之后, 请妥善保管, 以便随时取阅 保修 本机及其选装部件是经过本公司严格的质量控制 测试和检查, 并在确认性能满足本公司标准之后出厂交付的 在交付产品的保修期内, 本公司仅对正常时发生的故障进行免费修理 ( 有关保修期方面的信息, 请咨询当地的销售办事处 ) 但在以下情况下, 将对客户收取修理费用 ( 即使发生在保修期内 ): 1. 因不同于说明书内容的错误以及不当而导致的故障与损伤 2. 客户擅自改造或拆卸造成的故障 3. 因调整不当 / 擅自修理而导致的损坏 4. 因地震 洪水等自然灾害导致的损坏 警告 小心 : 1. 如果机器人或相关设备的超出本手册所述的条件及产品规格, 将导致保修无效 2. 本公司对因未遵守本手册记载的 警告 与 注意 而导致的任何故障或事故, 甚至是人身伤害或死亡均不承担任何责任, 敬请谅解 3. 本公司不可能完全预见危险与故障发生的所有状况, 此可预见性存在局限性 因此, 本手册不能警告用户所有可能的危险 ii GUI Builder 7.0 (Ver.7.0) Rev.1

商标 本手册中的商标符号 通知 垂询方式 Microsoft Windows Windows 标识为美国 Microsoft Corporation 在美国与其它国家的注册商标或商标 其它品牌与产品名称均为各公司的注册商标或商标 Microsoft Windows XP Operating system Microsoft Windows Vista Operating system Microsoft Windows 7 Operating system 在本手册中,Windows XP,Windows Vista 和 Windows 7 指的是上述各操作系统 在某些情况下,Windows 一般是指 Windows XP,Windows Vista 和 Windows 7 禁止擅自复印或转载本手册的部分或全部内容 本手册记载的内容将来可能会随时变更, 恕不事先通告 如您发现本手册的内容有误或需要改进之处, 请不吝斧正 有关机器人的修理 / 检查 / 调整等事项, 请与服务中心联系 未记载服务中心时, 请与当地销售商联系 联系时, 请事先准备好下述各项 - 控制器型号及其序列号 - 机器人型号及其序列号 - 机器人系统中的软件名称及其版本 - 问题描述 服务中心 GUI Builder 7.0 (Ver.7.0) Rev.1 iii

制造商 Toyoshina Plant Factory Automation Systems Dept. 6925 Toyoshina Tazawa, Azumino-shi, Nagano, 399-8285 JAPAN TEL : +81-(0)263-72-1530 FAX : +81-(0)263-72-1495 供应商 北美与南美欧洲中国台湾 EPSON AMERICA, INC. Factory Automation/Robotics 18300 Central Avenue Carson, CA 90746 USA TEL : +1-562-290-5900 FAX : +1-562-290-5999 E-MAIL : info@robots.epson.com EPSON DEUTSCHLAND GmbH Factory Automation Division Otto-Hahn-Str.4 D-40670 Meerbusch Germany TEL : +49-(0)-2159-538-1391 FAX : +49-(0)-2159-538-3170 E-MAIL : robot.infos@epson.de EPSON China Co., Ltd Factory Automation Division 7F, Jinbao Building No. 89 Jinbao Street Dongcheng District, Beijing, China, 100005 TEL : +86-(0)-10-8522-1199 FAX : +86-(0)-10-8522-1120 EPSON Taiwan Technology & Trading Ltd. Factory Automation Division 14F, No.7, Song Ren Road, Taipei 110 Taiwan, ROC TEL : +886-(0)-2-8786-6688 FAX : +886-(0)-2-8786-6677 iv GUI Builder 7.0 (Ver.7.0) Rev.1

东南亚印度 Epson Singapore Pte Ltd. Factory Automation System 1 HarbourFrontPlace, #03-02 HarbourFront Tower one, Singapore 098633 TEL : +65-(0)-6586-5696 FAX : +65-(0)-6271-3182 韩国 EPSON Korea Co, Ltd. Marketing Team (Robot Business) 11F Milim Tower, 825-22 Yeoksam-dong, Gangnam-gu, Seoul, 135-934 Korea TEL : +82-(0)-2-3420-6692 FAX : +82-(0)-2-558-4271 日本 EPSON SALES JAPAN CORPORATION Factory Automation Systems Department Nishi-Shinjuku Mitsui Bldg.6-24-1 Nishishinjuku.Shinjuku-ku. Tokyo. 160-8324 JAPAN TEL : +81-(0)3-5321-4161 GUI Builder 7.0 (Ver.7.0) Rev.1 v

vi GUI Builder 7.0 (Ver.7.0) Rev.1

目录 1. 简介...1 1.1 功能... 1 2. 安装...1 3. 操作入门...2 3.1 GUI Builder 教程... 2 4. GUI Builder 环境...7 4.1 概述... 7 4.2 了解 GUI Builder 所需的基本概念... 7 4.3 打开 GUI Builder 窗口... 8 4.4 GUI Builder 窗口的组成部分... 8 4.4.1 设计区域... 8 4.4.2 工具栏... 9 4.4.3 窗口资源管理器... 10 4.4.4 属性网格... 10 4.4.5 事件网格... 10 4.5 窗体和控件的... 10 4.5.1 创建窗体... 10 4.5.2 删除窗体... 10 4.5.3 打开和关闭窗体... 11 4.5.4 更改窗体尺寸... 11 4.5.5 编辑多个窗体... 11 4.5.6 创建控件... 11 4.5.7 删除控件... 11 4.5.8 缩放和移动控件... 12 4.5.9 控件的复制 剪切和粘贴... 12 4.5.10 编辑属性... 12 4.5.11 事件处理程序的... 13 4.5.12 更改选项卡顺序... 14 4.5.13 保存工作... 14 4.6 设置 GUI Builder 选项... 15 4.7 导入其他项目的窗体... 16 GUI Builder 7.0 (Ver.7.0) Rev.1 vii

目录 5. GUI Builder 组件... 17 5.1 窗体... 17 5.2 按钮控件... 20 5.3 标签控件... 22 5.4 文本框控件... 24 5.5 单选按钮控件... 26 5.6 复选框控件... 28 5.7 列表框控件... 30 5.8 组合框控件... 32 5.9 图片框控件... 34 5.10 分组框控件... 36 5.11 定时器控件... 38 5.12 视频框控件... 39 5.13 LED 控件... 40 6. 操作... 42 6.1 概述... 42 6.2 编程模式下的 GUI 开发... 42 6.2.1 设计 GUI... 42 6.2.2 调试... 43 6.3 自动模式... 43 6.4. 处理暂停与继续... 44 6.5. 处理紧急停止... 44 6.6 帮助文件... 44 7. GUI Builder 参考... 45 7.1 概述... 45 7.2 GUI Builder 属性和事件格式描述... 45 viii GUI Builder 7.0 (Ver.7.0) Rev.1

1. 简介 1. 简介 注 EPSON RC+ GUI Builder 7.0 选件使您可以为 SPEL+ 应用创建 GUI (Graphical User Interface) GUI Builder 设计用于在 EPSON RC+ 开发环境下为创建 SPEL+ 应用 GUI 创建简单易用的集成工具 其非常适用于需要简单的 GUI 且不愿 Visual Studio 等第三方产品的用户 即便用户之前从未创建过 GUI, GUI Builder 仍可轻松实现 对于高级的 GUI 应用, 您可能会想要考虑同时 EPSON RC+ 7.0 RC+ API 选件和 Visual Studio 或能够与 VB Guide.NET 库连接的其他工具 1.1 功能 GUI Builder 7.0 包支持以下功能 : - GUI 完全集成于 EPSON RC+ 环境, 以实现简单的设计 调试以及运行时的显示 无需任何第三方工具 - 您可以在 EPSON RC+ 项目中创建和调试 GUI 窗体 - 具有多种标准控件, 包括按钮 标签 文本框等 此外, 还提供有显示视频 变量状态和 I/O 状态的控件 - 窗体和控件事件会作为 SPEL+ 任务执行 您可以指定这些任务在 Normal NoPause 或 NoEmgAbort 模式下运行 - 在自动模式下,EPSON RC+ 可在启动时自动显示主窗体, 或者您可以通过 SPEL+ 代码显示窗体 2. 安装 请遵守本章说明, 以助于确保正确安装 GUI Builder 7.0 软件 启动前, 确保已关闭所有 Windows 应用 要安装 GUI Builder: 1. 安装 EPSON RC+ 7.0 GUI Builder 选件会自动安装 2. 确保已在将的控制器中激活 GUI Builder 7.0 的软件密钥 有关激活控制器选件的方式信息, 请参阅 EPSON RC+ 7.0 用户指南 这样便完成了 GUI Builder 7.0 的安装 GUI Builder 7.0 (Ver.7.0) Rev.1 1

3. 操作入门 3. 操作入门 本章介绍了有关 GUI Builder 7.0 操作入门的信息 继续前, 确保已激活 GUI Builder 选件 有关详细信息, 请参阅安装章节 如果您之前从未过 EPSON RC+, 则应阅读 EPSON RC+ 7.0 用户指南, 以熟悉项目和程序的创建 下一节将展示一些简单概念的说明教程 3.1 GUI Builder 教程 在本节中, 我们将创建运行机器人循环的简单 GUI 应用 我们将完成以下任务 : - 创建具有运行机器人循环功能的新 EPSON RC+ 项目 - 创建具有 < 开始 > 和 < 停止 > 按钮的窗体, 以运行机器人循环 这将展示如何创建窗体及添加按钮和事件来开始和停止 SPEL+ 任务 - 在窗体中添加 < 暂停 > 和 < 继续 > 按钮 这将展示 EventTaskType 属性的 - 添加设置窗体 此窗体将标签和文本框控件来允许用户更改机器人速度 - 在主窗体上添加按钮, 以显示设置窗体 这将展示 GShowDialog 语句和 DialogResult 属性的 遵循以下步骤 : 1 创建新的 EPSON RC+ 7.0 项目, 命名为 GUITest 2. 机器人管理器, 示教两个不同位置的两个机器人点 P0 和 P1 3. 在 Main.prg 中的函数 main 中添加代码, 如下所示 : Function main Robot1 Motor On Do Go P0 Wait 0.5 Go P1 Wait 0.5 Loop Fend 4. 选择工具 GUI Builder, 打开 GUI Builder 窗口 5. 点击 GUI Builder 窗口工具栏上的 创建窗格 按钮, 创建窗体并命名为 frmmain 然后点击 < 确定 > 按钮 6. 点击 GUI Builder 窗口工具栏上的 新建按钮 按钮, 然后点击窗体上的鼠标 将创建一个新按钮 2 GUI Builder 7.0 (Ver.7.0) Rev.1

3. 操作入门 7. 在属性网格中, 向下滚动至 Name 属性, 然后将名称改为 btnstart 并按下 ENTER 8. 在属性网格中, 向下滚动至 Text 属性, 然后将 Button1 文本改为 Start 并按下 ENTER 9. 双击窗体上的 < 开始 > 按钮 将打开一个名为 frmmain.prg 的新程序窗口, 内有一个按钮点击事件处理程序的新函数 10. 更改 frmmain_btnstart_click 函数, 以启动 main 任务, 如下所示 这样将在用户点击 < 开始 > 按钮时启动 main 函数 Function frmmain_btnstart_click(sender$ As String) Xqt main Fend 11. 点击 GUI Builder 窗口工具栏上的 新建按钮 按钮, 然后点击 < 开始 > 按钮下方的窗体创建另一按钮 GUI Builder 7.0 (Ver.7.0) Rev.1 3

3. 操作入门 12. 对于新按钮, 将 Name 属性改为 btnstop,text 属性改为 Stop 此时, 窗体应为如下所示 : 13. 双击 <Stop> 按钮以创建按钮点击事件处理程序 然后, 按如下所示更改代码 : Function frmmain_btnstop_click(sender$ As String) Quit main Fend 14. 按 F5 构建项目并显示运行窗口 如果发生任何构建错误, 则修改代码并再按 F5 15. 选择运行窗口上的 < 型号 > 单选按钮 16. 点击运行窗口上的 < 开始 > 按钮 17. 将显示 frmmain 点击 frmmain 上的 <Start> 按钮 此时, 机器人应在 P0 和 P1 之间移动 18. 点击窗体上的 <Stop> 按钮 机器人任务将停止 19. 此时, 点击窗体右上角的 X 按钮 窗体将关闭 现在我们将在 GUI 上添加 < 暂停 > 和 < 继续 > 按钮 20. 点击 GUI Builder 工具栏按钮再次显示 GUI Builder 窗口 21. 点击 GUI Builder 窗口工具栏上的 新建按钮 按钮, 然后点击 < 开始 > 按钮右侧的窗体创建新按钮 22. 对于新按钮, 将 Name 属性改为 btnpause,text 属性改为 Pause 23. 将 < 暂停 > 按钮的 EventTaskType 改为 1 NoPause 这样便允许按钮点击事件处理程序执行 Pause 语句, 而无需暂停任务本身 24. 双击 < 暂停 > 按钮创建事件处理程序函数 然后添加 Pause 语句更改代码, 如下所示 : Function frmmain_btnpause_click(sender$ As String) Pause Fend 25. 点击 GUI Builder 窗口工具栏上的 新建按钮 按钮, 然后点击 < 停止 > 按钮右侧的窗体创建新按钮 26. 对于新按钮, 将 Name 属性改为 btncont,text 属性改为 Continue 4 GUI Builder 7.0 (Ver.7.0) Rev.1

3. 操作入门 27. 将 < 继续 > 按钮的 EventTaskType 改为 1 NoPause 这样便允许按钮点击事件处理程序在正常任务暂停时执行 Cont 语句 28. 双击 < 继续 > 按钮创建事件处理程序函数 然后添加 Cont 语句更改代码, 如下所示 : Function frmmain_btncont_click(sender$ As String) Cont Fend 29. 按 F5 构建项目并打开运行窗口 如果发生任何构建错误, 则修改代码并再按 F5 30. 点击运行窗口上的 < 开始 > 按钮 将显示窗体 31. 点击窗体上的 < 开始 > 按钮 机器人循环将执行 32. 点击窗体上的 < 暂停 > 按钮 机器人循环将暂停 33. 点击窗体上的 < 继续 > 按钮 机器人循环将继续 34. 点击窗体上的 < 停止 > 按钮, 然后点击右上角的 X 按钮关闭窗体 现在我们将在 GUI 上添加设置窗体 35. 点击 GUI Builder 窗体工具栏上的 新建窗体 按钮, 并将新窗体命名为 frmsetup, 然后点击 < 确定 > 将出现显示新窗体的新选项卡页面 36. 点击 新建标签 按钮并点击 frmsetup 创建标签 37. 在属性网格中, 将新标签名称改为 lblspeed 38. 将 Text 属性改为 Speed: 39. 点击 新建文本框 按钮并点击 Speed 标签右侧的 frmsetup 40 将 Name 属性改为 txtspeed,text 属性改为 10 41. 双击 frmsetup 为窗体创建 Load 事件处理程序函数并按如下所示更改代码 : Function frmsetup_load(sender$ As String) GSet frmsetup.txtspeed.text, Str$(Speed(1)) Fend 42. 点击 GUI Builder 窗口工具栏上的 新建按钮 按钮, 然后点击窗体以添加按钮 将此按钮命名为 btnok, 并将 Text 属性设为 OK 43. 点击 GUI Builder 窗口工具栏上的 新建按钮 按钮, 然后点击窗体以添加按钮 将此按钮命名为 btncancel, 并将 Text 属性设为 Cancel 此时, 设置窗体应类似于如下所示窗体 : GUI Builder 7.0 (Ver.7.0) Rev.1 5

3. 操作入门 44. 双击 <OK> 按钮创建事件处理程序函数 然后更改代码以设置窗体的 DialogResult 属性并调用 GClose, 如下所示 : Function frmsetup_btnok_click(sender$ As String) GSet frmsetup.dialogresult, DIALOGRESULT_OK GClose frmsetup Fend 45. 双击 < 取消 > 按钮创建事件处理程序函数 然后更改代码以设置窗体的 DialogResult 属性并调用 GClose, 如下所示 : Function frmsetup_btncancel_click(sender$ As String) GSet frmsetup.dialogresult, DIALOGRESULT_CANCEL GClose frmsetup Fend 46. 点击 frmmain 选项卡, 重新与 frmmain 一起工作 47. 点击 GUI Builder 窗口工具栏上的 新建按钮 按钮, 然后点击窗体以添加按钮 将此按钮命名为 btnsetup, 并将 Text 属性设为 Setup 48. 双击 < 设置 > 按钮创建事件处理程序函数 然后更改代码以显示设置对话框并设置新机器人速度, 如下所示 : Function frmmain_btnsetup_click(sender$ As String) Integer result String value$ result = GShowDialog(frmSetup) If result = DIALOGRESULT_OK Then GGet frmsetup.txtspeed.text, value$ Speed Val(value$) EndIf Fend 49. 按 F5 构建项目并打开运行窗口 50. 点击运行窗口上的 < 开始 > 按钮 将显示主窗体 51. 点击主窗体上的 < 设置 > 按钮 将显示设置对话框以及文本框内的当前机器人速度 52. 输入新速度并点击 < 确定 > 53. 点击主窗体上的 < 开始 > 按钮, 以新速度运行机器人循环 如果点击了 < 停止 > 按钮且机器人停止, 则动作速度将重置为默认速度 54. 至此便完成了教程 6 GUI Builder 7.0 (Ver.7.0) Rev.1

4. GUI Builder 环境 4. GUI Builder 环境 4.1 概述 在本章中, 我们将着重介绍一些概念和定义, 以完全了解 GUI Builder 及其组件 我们将涉及以下主题 : - GUI Builder 应了解的基本概念 - 如何打开 GUI Builder 窗口 - GUI Builder 窗口的组成部分 - 如何窗体和控件 - 设置 GUI Builder 选项 4.2 了解 GUI Builder 所需的基本概念 一些基本概念的简单说明将有助于您更好地理解本章内容 请在继续阅读本章其他内容之前回顾以下概念 什么是 GUI? GUI 即图形用户界面 (Graphical User Interface) GUI 可使您的操作员轻松与 SPEL+ 应用互动, 以运行循环或执行设置功能 GUI 的基本构件即窗体 什么是窗体? 窗体即含有控件的窗口或对话框 它是 GUI 应用的基本组成单元 当运行期间显示窗体时, 窗体上的控件为有效状态并准备接收用户的键盘和鼠标事件 GUI 项目可具有一个窗体或多个窗体 什么是控件? 控件即窗体中包含的对象, 如按钮 复选框 文本框等 每种控件均具有一套各自的属性和事件 什么是事件? 事件即创建的 SPEL+ 功能, 当窗体或控件事件发生时,GUI 会调用此功能 例如, 当用户点击按钮控件时, 按钮点击事件可以在发生点击时调用指定运行的 SPEL+ 功能 GUI Builder 7.0 (Ver.7.0) Rev.1 7

4. GUI Builder 环境 4.3 打开 GUI Builder 窗口 GUI Builder 窗口可在 EPSON RC+ 开发环境中打开 EPSON RC+ 启动后, 可通过两种方式打开 GUI Builder 窗口 : 通过主工具栏 : 在 EPSON RC+ 的主工具栏中, 您应该会看到 GUI Builder 图标 点击 GUI Builder 图标将打开 GUI Builder 窗口 通过工具菜单 : 通过在工具菜单中选择 GUI Builder 将打开 GUI Builder 窗口 一旦 GUI Builder 窗口打开, 您便可以开始 GUI Builder 设计您的 GUI 应用 接下来几页将介绍 GUI Builder 窗口的组成部分 4.4 GUI Builder 窗口的组成部分 GUI Builder 窗口如下所示 后述章节将分别介绍各所示部分 工具栏 窗体资源管理器 设计区域 属性网格 事件网格 4.4.1 设计区域 这里是设计时显示窗体的位置 每个打开的窗体会显示在各自的选项卡上 您可以通过点击相关选项卡或双击窗体资源管理器上的窗体在窗体之间轻松切换 如果窗体大于设计区域, 则会显示滚动条, 您可以滚动条滚动访问窗体的所有区域 8 GUI Builder 7.0 (Ver.7.0) Rev.1

4. GUI Builder 环境 4.4.2 工具栏工具栏包括创建窗体和控件的按钮 GUI Builder 工具栏位于 GUI Builder 窗口顶部的标题栏正下方, 如下所示 : GUI Builder 工具栏 下文所示为每个 GUI Builder 工具栏按钮的一般描述 按钮 描述 新建窗体 : 创建新窗体 将弹出一个对话框并要求用户输入新窗体的名称 删除窗体 : 删除当前项目中的窗体 如果当前项目中没有窗体, 此按钮将会变暗 指针 : 点击此按钮可中止新控件的添加 新建按钮 : 创建新的按钮控件 新建标签 : 创建用于显示静态文本的新标签控件 新建文本框 : 创建允许操作员输入文本的新文本框控件 新建单选按钮 : 创建新的单选按钮控件 新建复选框 : 创建新的复选框控件 新建列表框 : 创建新的列表框控件 新建组合框 : 创建新的组合框控件 新建图片框 : 创建新图片框 新建分组框 : 创建新的分组框控件 新建定时器 : 创建新的定时器控件 新建视频框 : 创建新的视频框控件 此控件可使您 Vision Guide 选件显示视频 新建 LED: 创建新 LED 控件 此控件可使您显示 I/O 状态 您可以视情况允许操作员双击控件更改输出状态 此控件可采用内置图片和各种颜色, 或者您可以个人图像显示关闭和打开状态 GUI Builder 7.0 (Ver.7.0) Rev.1 9

4. GUI Builder 环境 4.4.3 窗口资源管理器 窗体资源管理器是包括当前项目各窗体及其相关控件的树 每当创建新窗体或控件时, 便会添加到此树 双击窗体便会在设计区域打开位于各选项卡的窗体 同时显示此窗体的属性和事件 右击窗体打开菜单, 设置启动窗体 删除窗体或将其关闭 点击树上的控件会激活其相关的窗体并将当前设计集中到此控件 之后会显示此控件的属性和事件 4.4.4 属性网格 属性网格用于显示和编辑窗体和控件属性 当您选择一个窗体或控件时, 网格中会显示相关属性 共有两栏 :Property 和 Value Property 为属性名称 Value 为可编辑的当前值 4.4.5 事件网格 事件网格用于显示和更改相关窗体或控件的事件 每个事件均具有一个在发生事件时会调用的用户函数 4.5 窗体和控件的 4.5.1 创建窗体 要创建窗体 : 1. 打开 GUI Builder 窗口 2. 点击工具栏上的 创建窗格 按钮 3. 输入窗体名称 您可能想要以 frm 为前缀的名称 出现 创建窗格 对话框, 您可以从 从现有窗格中复制 选择其他窗体随意复制 4.5.2 删除窗体 若要删除窗体, 右击窗体资源管理器中的窗体, 然后选择 < 删除 > 此时将显示确认消息 点击 < 是 > 删除窗体 此外, 还可以下方法 - 点击工具栏上的 < 删除窗体 > 按钮 - 右击窗体选项卡, 然后选择 < 删除 > 10 GUI Builder 7.0 (Ver.7.0) Rev.1

4. GUI Builder 环境 4.5.3 打开和关闭窗体 若要打开窗体, 双击窗体资源管理器中的窗体 若要关闭窗体, 右击窗体资源管理器中的窗体并选择 < 关闭 >, 或者右击窗体选项卡并选择 < 关闭 > 4.5.4 更改窗体尺寸 可采用两种方式更改窗体尺寸 : - 鼠标拖拽 GUI Builder 窗口设计区域内的一个窗体尺寸句柄 - 设计时在属性网格中更改 Height 和 Width 属性或在运行时 GSet 4.5.5 编辑多个窗体 GUI Builder 窗口允许通过选项卡界面多个窗体 您可以通过点击相应的选项卡在当前打开的窗体之间切换 您可以在一个窗体中复制控件并将其粘贴到另一窗体 4.5.6 创建控件 要创建控件 1. 打开想要添加控件的窗体 2. 点击 GUI Builder 窗口工具栏上的控件按钮 将显示十字光标 3. 您可以在想要的控件位置旁单击窗体, 将会以默认尺寸创建此控件 或者您可以用鼠标在窗体上拖拽控件尺寸的轮廓, 然后释放鼠标以轮廓尺寸创建控件 4.5.7 删除控件 要删除控件 1. 打开想要删除一个或多个控件的窗体 2. 点击您想删除的控件 若要选择更多控件, 按住 Ctrl 或 Shift 键并点击各附加控件 3. 按下键盘上的 Del 键 将删除所选控件 GUI Builder 7.0 (Ver.7.0) Rev.1 11

4. GUI Builder 环境 4.5.8 缩放和移动控件 要更改控件尺寸 - 鼠标拖拽 GUI Builder 窗口设计区域内一个控件的尺寸句柄 - 设计时在属性网格中更改 Height 和 Width 属性或在运行时 GSet 要移动控件 - 点击控件将其激活, 然后释放鼠标 鼠标位于控件上方时, 将显示移动光标 点击并拖拽控件至新位置 - 设计时更改属性网格中的 Left 和 Top 属性, 或者在运行时 GSet 更改 Left 和 Top 属性 4.5.9 控件的复制 剪切和粘贴 选择复制或剪切的控件 首先, 点击一个控件 若要选择更多控件, 按住 Ctrl 或 Shift 键并点击各附加控件 选定控件将以白色 ( 第一个控件 ) 和黑色尺寸句柄指示 复制选定控件 若要复制选定控件, 按下 Ctrl+C, 或点击主工具栏上的复制按钮, 或从编辑菜单中选择复制 剪切选定控件 若要剪切选定控件, 按下 Ctrl+X, 或点击主工具栏上的剪切按钮, 或从编辑菜单中选择剪切 粘贴控件 若要粘贴已复制或剪切的控件, 按下 Ctrl+V, 或点击主工具栏上的粘贴按钮, 或从编辑菜单中选择粘贴 4.5.10 编辑属性 若要编辑属性, 首先点击窗体或控件, 以在属性网格中显示相关属性 对于需要文本输入的属性 点击属性在属性网格中更改 然后输入新值并按下 Enter, 或选择其他属性行应用更改 对于具有下拉列表值的属性 点击属性在属性网格中更改 点击值右侧的下箭头按钮 从下拉列表中选择新值 选择之后便会应用更改 对于具有数值选择按钮的属性 点击属性在属性网格中更改 点击值右侧的椭圆按钮 从对话框中选择新值 选择之后或在对话框中点击 < 确定 > 之后便会应用更改 12 GUI Builder 7.0 (Ver.7.0) Rev.1

4. GUI Builder 环境 4.5.11 事件处理程序的 事件处理程序为具有指定事件的正确参数的 SPEL+ 函数 事件处理程序函数可位于当前项目中的任一 SPEL+ 程序文件内 默认情况下, 将在为窗体创建的程序文件内创建事件处理程序 例如, 在为按钮控件点击事件创建事件处理程序时, 如果没有窗体程序文件, 则会首先创建文件, 然后再将函数添加至此文件 要创建事件处理程序 共有三种创建事件处理程序的方式 : - 双击窗体或控件创建默认事件处理程序 例如, 如果双击按钮控件, 则会创建点击事件处理程序函数 - 在事件网格中双击事件名称 - 在事件网格中选择事件值下拉列表的项目中已存在的函数 列表中仅显示具有正确参数的函数 要更改事件处理程序 您可以通过在事件值下拉列表中选择另一函数来更改事件处理程序函数 要禁用事件处理程序 有时在创建事件处理程序之后, 您可能会决定不再需要此程序 若要禁用事件处理程序, 在事件值下拉列表中选择 (None) 这并不会删除相关函数 但在事件发生时不会再调用相关函数 EventTaskType 事件发生时, 事件处理程序函数会作为 SPEL+ 任务启动 EventTaskType 属性可使您指定将执行的任务类型 这对于需要在暂停情况或紧急停止情况下执行的事件非常重要 例如, 如果按钮点击事件处理程序将执行 Pause 或 Cont, 则 EventTaskType 必须设为 1 NoPause 或者如果事件处理程序在紧急停止情况下必须执行 Reset, 则 EventTaskType 必须设为 2 NoEmgAbort GUI Builder 7.0 (Ver.7.0) Rev.1 13

4. GUI Builder 环境 4.5.12 更改选项卡顺序 在窗体中添加控件之后, 您可能会想更改选项卡顺序 即用户在运行时输入选项卡时设置的焦点顺序 另外重要的是, 在标识控件之前热键将标签的选项卡顺序设为一个选项卡索引 要更改选项卡顺序 1. 打开想要更改选项卡顺序的窗体 2. 按下 Tab 键 将显示如下所示的选项卡顺序 : 3. 以您想要的顺序点击每个选项卡顺序值 4. 再按下 Tab 键隐藏选项卡顺序 4.5.13 保存工作在 GUI Builder 窗口中进行更改之后, 您可以通过两种方式保存工作 : - 从文件菜单中选择保存或按下 Ctrl+S - 点击 EPSON RC+ 主工具栏上的项目保存工具栏按钮 14 GUI Builder 7.0 (Ver.7.0) Rev.1

4. GUI Builder 环境 4.6 设置 GUI Builder 选项 您可以通过设置 GUI Builder 选项改变 GUI Builder 窗口设计区域中窗体上的控件管理方式 选择设置菜单 选项 GUI 创建器 如果布局模式设为捕捉线, 当您在窗体中移动控件时,GUI Builder 会在控件周围显示线段 捕捉线 如果布局模式设为对齐网格, 各窗体上会显示网格, 当您移动窗体上的控件时, 控件会对齐到各网格位置 若要更改网格尺寸, 可更改 < 网格宽度 > 和 < 网格高度 > 值并点击 < 应用 > 当您更改 GUI Builder 选项并点击 < 应用 > 时, 如果 GUI Builder 窗口打开, 则会保存当前更改并重新打开窗口以新选项 GUI Builder 7.0 (Ver.7.0) Rev.1 15

4. GUI Builder 环境 4.7 导入其他项目的窗体 您可以文件 导入菜单导入其他项目的 GUI Builder 窗体 1. 选择文件 导入 2. 导航到所需项目文件夹导入并选择 GUI Builder 文件类型 3. 选择 GUI 文件名称并点击 < 打开 > 4. 将出现一个具有导入项目中窗体列表的对话框 5. 选择您想要导入的一个或多个窗体, 然后点击 < 确定 > 6. 选定窗体将添加至当前项目 如果窗体已存在, 将提示是否覆盖现有窗体 16 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 5. GUI Builder 组件 5.1 窗体 本章将介绍窗体以及窗体上可用的所有控件 每个组件章节将提供与组件相关的所有属性和事件的信息 有关属性 事件和语句的更多详细信息, 请参阅 GUI Builder 参考章节 5.1.1 描述 窗体是 GUI 应用的基本构件 它可使您显示具有控件的窗口或对话框, 以实现用户交互 GUI 应用可具有一个窗体或多个窗体 5.1.2 显示窗体 窗体可通过三种方式显示 : 1. 如果窗体设为启动窗体, 则在自动模式下, 如果系统启动, 将自动显示窗体 若要设置启动窗体, 在窗体资源管理器中右击窗体, 然后选择 启动窗格, 如下所示 : 窗体将以黑体显示, 表示其为启动窗体 您还可以在项目 属性 GUI Builder 中为项目设置启动窗体 2. GShowDialog 函数 这样会将窗体显示为对话框并返回 DialogResult 值 result = GShowDialog(frmSetSpeed) 通常情况下,DialogResult 值采用窗体上的按钮设置, 如 < 确定 > 按钮和 < 取消 > 按钮 3. GShow 语句 这样会将窗体显示为窗口 GShow frmiodiags GUI Builder 7.0 (Ver.7.0) Rev.1 17

5. GUI Builder 组件 设置窗体外观 设置 FormBorderStyle 属性 对于用作对话框的窗体, 应 3 FixedDialog 设置 ControlBox MaximizeBox MinimizeBox, 以配置窗体的标题栏 设置 WindowState, 以便在显示窗体时以 Normal size Maximized 或 Minimized 形式显示 帮助 您可以在帮助文件中将 HelpButton 属性设为 True 并将 HelpID 属性设为主题 ID, 进而显示帮助文件中的帮助主题 有关详细信息, 请参阅 6.6 帮助文件 18 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 5.1.3 窗体属性 属性 AcceptButton BackColor CancelButton ControlBox 描述 设置用户键入 Enter 时执行点击事件的按钮控件 默认 :None 设置窗体的背景颜色 默认 :Control 设置用户键入 Esc 时执行点击事件的按钮控件 执行后, 窗体关闭 默认 :None 设置是否显示标题栏控件框项目 默认 :1 True 窗体上的控件数组 获取控件数组中的控件数量 Controls Count Dialog Result 设置窗体关闭时的返回值 ( 仅运行时 ) EventTaskType 设置用于事件的任务类型 默认 :0 Normal FormBorderStyle 设置用于窗体的边框类型 默认 :3 FixedDialog Height 设置控件高度, 单位为像素 HelpButton 设置是否显示标题栏帮助按钮 默认 :0 False HelpID 设置用户点击标题栏帮助按钮时显示的帮助主题 ID 默认 :0 Left 设置窗体的左坐标, 单位为像素 MaximizeBox 设置是否显示标题栏最大化按钮 默认 :0 False MinimizeBox 设置是否显示标题栏最小化按钮 默认 :0 False Name 设置控件名称 StartPosition 设置窗体的启动位置 默认 :1 - CenterScreen Text 用于设置控件文本 默认 : 窗体名称 Top 获取或设置窗体的顶坐标, 单位为像素 Type 获取控件的类型名称 Width 设置窗体宽度, 单位为像素 WindowState 设置窗体的默认窗口状态 默认 :0 - Normal GUI Builder 7.0 (Ver.7.0) Rev.1 19

5. GUI Builder 组件 5.1.4 窗体事件 事件 Closed Load Resize 描述窗体关闭后执行 窗体加载时执行 重新调整窗体尺寸时执行 5.2 按钮控件 5.2.1 描述 按钮控件可通过用户点击按钮来执行动作 按钮控件可显示文本和图像 点击按钮时, 看上去就像按下按钮, 然后释放 5.2.2 按钮控件可使操作员通过点击鼠标执行某些动作 您可以多个属性改变按钮外观, 如 ForeColor( 用于按钮文本 ) BackColor Font TextAlign Image 和 ImageAlign 您必须提供点击事件函数来确定是否在操作员点击按钮后会在事件处理程序中执行某些动作 5.2.3 按钮控件属性 属性 BackColor BackColorMode Enabled EventTaskType 描述 控件的背景颜色 默认 :Control 控件的背景颜色模式 默认 :0 Visual Style 设置是否在运行时启用控件 默认 :1 True 用于事件的任务类型 默认 :0 Normal Font 控件文本的字体 ( 仅设计时 ) 默认 :Microsoft Sans Serif 8.25 pt FontBold 当前字体的粗体属性 ( 仅运行时 ) 默认 :0 - False FontItalic 当前字体的斜体属性 ( 仅运行时 ) 默认 :0 - False FontName 当前字体的名称 ( 仅运行时 ) 默认 :Microsoft Sans Serif FontSize 点中当前字体的大小 ( 仅运行时 ) 默认 :8.25 ForeColor 控件文本的前景颜色 默认 :ControlText 20 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 Height 控件高度, 单位为像素 Image 控件图片 若要删除, 可按下 < 删除 > 键 默认 : 空 ImageAlign 控件的图片对齐 默认 :5 MiddleCenter Left 控件的左坐标, 单位为像素 Name 控件名称 默认 :ButtonXX TabIndex 控件的选项卡索引 Text 控件文本 默认 : 控件名称 TextAlign 选择文本对齐 默认 :5 MiddleCenter ToolTipText 控件提示信息中的文本 默认 : 空 Top 控件的顶坐标, 单位为像素 Visible 控件在运行时是否可见 默认 :1 True Width 控件宽度, 单位为像素 5.2.4 按钮控件事件 事件 Click 描述 用户鼠标单击控件时执行 GUI Builder 7.0 (Ver.7.0) Rev.1 21

5. GUI Builder 组件 5.3 标签控件 5.3.1 描述 标签控件用于显示用户无法编辑的文本或图像 还用于识别窗体上的对象, 以描述点击某个控件会执行的动作, 例如, 根据运行时间事件或应用中的过程显示信息 由于标签控件无法接收焦点, 还可用于创建其他控件的快捷键 5.3.2 标签控件可在窗体上显示静态文本 通常情况下, 标签控件用于为另一控件提供文本标签 例如, 如果窗体上有一个 List Box 控件, 您可以将标签控件放在具有列表名称的列表框上方 在下例中, 具有 Text 属性的标签设为 Part Numbers:, 用以标识列表框 设置标签外观 BorderStyle ForeColor BackColor Font Image ImageAlign 和 TextAlign 属性可更改标签外观 热键 ( 助记符 ) 您可以将标签 Text 属性中的一个字符指定为热键 在此标签的 Text 属性中, 在热键前字符 (&) 例如, 在上例中标签的 Text 属性为 Part &Numbers: 运行时, 如果用户键入 Alt+N, 则焦点将进入列表框 热键时, 务必设置选项卡顺序, 使标签的选项卡索引位于标识的控件选项卡索引之前 请参阅章节更改选项卡顺序 5.3.3 标签控件属性 属性描述 BackColor 控件的背景颜色 默认 :Control BorderStyle 用于控件的边框 默认 :0 None Enabled 设置是否在运行时启用控件 默认 :1 True EventTaskType 用于事件的任务类型 默认 :0 Normal Font 控件文本的字体 ( 仅设计时 ) 默认 :Microsoft Sans Serif 8.25 pt 22 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 FontBold 当前字体的粗体属性 ( 仅运行时 ) 默认 :0 False FontItalic 当前字体的斜体属性 ( 仅运行时 ) 默认 :0 False FontName 当前字体的名称 ( 仅运行时 ) 默认 :Microsoft Sans Serif FontSize 点中当前字体的大小 ( 仅运行时 ) 默认 :8.25 ForeColor 控件文本的前景颜色 默认 :ControlText Height 控件高度, 单位为像素 Image 控件图片 若要删除, 可按下 < 删除 > 键 默认 : 空 ImageAlign 控件的图片对齐 默认 :5 MiddleCenter Left 控件的左坐标, 单位为像素 Name 控件名称 默认 :LabelXX TabIndex 控件的选项卡索引 Text 控件文本 默认 : 控件名称 TextAlign 选择文本对齐 默认 :1 TopLeft ToolTipText 控件提示信息中的文本 默认 : 空 Top 控件的顶坐标, 单位为像素 Visible 控件在运行时是否可见 默认 :1 True Width 控件宽度, 单位为像素 5.3.4 标签控件事件 事件 Click DblClick 描述 用户鼠标单击控件时执行 用户鼠标双击控件时执行 GUI Builder 7.0 (Ver.7.0) Rev.1 23

5. GUI Builder 组件 5.4 文本框控件 5.4.1 描述 文本框用于获取操作员的输入或显示文本 文本框控件通常用于可编辑文本, 尽管也可设为只读 文本框可显示多行, 并根据控件尺寸进行文本换行 文本框控件允许在控件中显示或输入单一格式的文本 5.4.2 文本框可用于单行模式或多行模式 单行文本框 默认情况下, 创建文本框时, 文本框为单行模式 您仅可更改控件宽度 用户仅可键入一行字符 多行文本框 若要多行模式, 将 Multiline 属性设为 True 在此模式下, 您可以更改控件的高度和宽度 通过设置 Scrollbars 属性还可以显示滚动条 设置文本框外观 BorderStyle ForeColor BackColor Font 和 TextAlign 属性可更改文本框的外观 显示 SPEL+ 全局变量状态 您可以通过设置 Variable 属性自动显示 SPEL+ 全局变量的值 5.4.3 文本框控件属性 属性描述 AppendText 运行时附加文本 BackColor 控件的背景颜色 默认 :Window BorderStyle 用于控件的边框 默认 :2 Fixed3D Enabled 设置是否在运行时启用控件 默认 :1 True EventTaskType 用于事件的任务类型 默认 :0 Normal Font 控件文本的字体 ( 仅设计时 ) 默认 :Microsoft Sans Serif 8.25 pt FontBold 当前字体的粗体属性 ( 仅运行时 ) 默认 :0 False FontItalic 当前字体的斜体属性 ( 仅运行时 ) 默认 :0 False 24 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 FontName 当前字体的名称 ( 仅运行时 ) 默认 :Microsoft Sans Serif FontSize 当前字体的大小, 单位为点 ( 仅运行时 ) 默认 :8.25 ForeColor 控件文本的前景颜色 默认 :WindowText Height 控件高度, 单位为像素 Left 控件的左坐标, 单位为像素 Multiline 设置是否显示一行或多行 默认 :0 False Name 控件名称 默认 :TextBoxXX PasswordChar 设置用于隐藏输入的各字符的字符 默认 : 空 ReadOnly 设置用户是否可以编辑文本 默认 :0 False ScrollBars 设置如何显示控件的滚动条 默认 :0 None TabIndex 控件的选项卡索引 Text 控件文本 默认 : 空 TextAlign 选择文本对齐 默认 :1 Left ToolTipText 控件提示信息中的文本 默认 : 空 Top 控件的顶坐标, 单位为像素 Update 更新文本控件的显示 ( 仅运行时 ) Variable 这是一个可选的 SPEL + 全局变量 默认 :None Visible 控件在运行时是否可见 默认 :1 True Width 控件宽度, 单位为像素 WordWrap 设置文字是否换行 默认 :1 True 5.4.4 文本框控件事件 事件 KeyPress 描述 当控件存在焦点并按下按键时, 会发生此事件 GUI Builder 7.0 (Ver.7.0) Rev.1 25

5. GUI Builder 组件 5.5 单选按钮控件 5.5.1 描述 单选按钮控件会为操作员提供一系列两个或多个互斥的选项 尽管单选按钮和复选框的功能类似, 但仍存在重要差异 : 当用户选择一个单选按钮时, 便无法同时选择同一组的其他单选按钮 5.5.2 单选按钮控件应在分组框控件内分组 每次操作员点击一组中的一个单选按钮时, 便取消选定其他按钮 Click 事件确定操作员是否点击了单选按钮 Checked 属性确定用户是否选中了复选框 在某些情况下, 对一组内的所有单选按钮一个点击事件处理程序可能会很方便 您可以 Sender$ 参数确定是否点击了单选按钮 Sender$ 是发送事件的控件名称 Function frmsetup_optionsclick(sender$ As String) Boolean checked GGet frmsetup.sender$.checked, checked If checked Then Select Sender$ Case RadioButton1 : g_option1 = True Case RadioButton2 : g_option2 = True Send EndIf Fend 设置单选按钮外观 BorderStyle ForeColor BackColor Font Image ImageAlign 和 TextAlign 属性可更改单选按钮的外观 26 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 5.5.3 单选按钮控件属性 属性 BackColor Checked Enabled EventTaskType 描述 控件的背景颜色 默认 :Control 设置是否在运行时选择控件 默认 :0 False 设置是否在运行时启用控件 默认 :1 True 用于事件的任务类型 默认 :0 Normal Font 控件文本的字体 ( 仅设计时 ) 默认 :Microsoft Sans Serif 8.25 pt FontBold 当前字体的粗体属性 ( 仅运行时 ) 默认 :0 False FontItalic 当前字体的斜体属性 ( 仅运行时 ) 默认 :0 False FontName 当前字体的名称 ( 仅运行时 ) 默认 :Microsoft Sans Serif FontSize 点中当前字体的大小 ( 仅运行时 ) 默认 :8.25 ForeColor 控件文本的前景颜色 默认 :ControlText Height 控件高度, 单位为像素 Image 控件图片 若要删除, 可按下 < 删除 > 键 默认 : 空 ImageAlign 控件的图片对齐 默认 :5 MiddleCenter Left 控件的左坐标, 单位为像素 Name 控件名称 默认 :RadioButtonXX TabIndex 控件的选项卡索引 Text 控件文本 默认 : 控件名称 TextAlign 选择文本对齐 默认 :4 Middle Left ToolTipText 控件提示信息中的文本 默认 : 空 Top 控件的顶坐标, 单位为像素 Visible 控件在运行时是否可见 默认 :1 True Width 控件宽度, 单位为像素 GUI Builder 7.0 (Ver.7.0) Rev.1 27

5. GUI Builder 组件 5.5.4 单选按钮控件事件 事件 Click 描述 用户鼠标单击控件时执行 5.6 复选框控件 5.6.1 描述 复选框控件表示是否打开或关闭某一特定条件 通常用于为用户提供是 / 否或 True/False 的选择 您可以成组复选框显示用户可从中选择一个或多个选项的诸多选项 复选框类似于单选按钮, 但可选择任意数量的分组复选框控件 5.6.2 复选框可使操作员打开或关闭应用选项 通常情况下, 您将在分组框控件中添加复选框 Checked 属性确定用户是否选中了复选框 设置复选框外观 BorderStyle ForeColor BackColor Font Image ImageAlign 和 TextAlign 属性可更改复选框的外观 5.6.3 复选框控件属性 属性 BackColor Checked Enabled EventTaskType 描述 控件的背景颜色 默认 :Control 设置是否在运行时选中控件 默认 :0 False 设置是否在运行时启用控件 默认 :1 True 用于事件的任务类型 默认 :0 Normal Font 控件文本的字体 ( 仅设计时 ) 默认 :Microsoft Sans Serif 8.25 pt FontBold 当前字体的粗体属性 ( 仅运行时 ) 默认 :0 False FontItalic 当前字体的斜体属性 ( 仅运行时 ) 默认 :0 False 28 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 FontName 当前字体的名称 ( 仅运行时 ) 默认 :Microsoft Sans Serif FontSize 点中当前字体的大小 ( 仅运行时 ) 默认 :8.25 ForeColor 控件文本的前景颜色 默认 :ControlText Height 控件高度, 单位为像素 Image 控件图片 若要删除, 可按下 < 删除 > 键 默认 : 空 ImageAlign 控件的图片对齐 默认 :5 MiddleCenter Left 控件的左坐标, 单位为像素 Name 控件名称 默认 :CheckBoxXX TabIndex 控件的选项卡索引 Text 控件文本 默认 : 控件名称 TextAlign 选择文本对齐 默认 :4 MiddleLeft ToolTipText 控件提示信息中的文本 默认 : 空 Top 控件的顶坐标, 单位为像素 Visible 控件在运行时是否可见 默认 :1 True Width 控件宽度, 单位为像素 5.6.4 复选框控件事件 事件 Click 描述 用户鼠标单击控件时执行 GUI Builder 7.0 (Ver.7.0) Rev.1 29

5. GUI Builder 组件 5.7 列表框控件 5.7.1 描述 列表框控件会显示操作员可从中选择一个或多个项目的项目列表 5.7.2 列表框控件显示操作员可从中选择的项目静态列表 要在列表框中添加项目运行时 AddItem 属性在列表框中添加项目 通常会在窗体加载事件中完成 GSet frmsetup.lstmodels.additem, Model1 GSet frmsetup.lstmodels.additem, Model2 GSet frmsetup.lstmodels.additem, Model3 此外, 您可以通过将 Sorted 属性设为 True 对列表进行分类 要确定选定的项目 SelectedIndex 属性确定用户选择 如果未选定任何项目, 则 SelectedIndex 为 -1 Integer index GGet frmsetup.lstmodels.selectedindex, index 列表数组您可以 List array 属性访问列表中的所有项目 Integer I, count String item$ GGet frmsetup.lstmodels.listcount, count For I = 0 To count 1 GGet frmsetup.lstmodels.list(i), item$ Next i 您可以通过将 List 属性设为空字符串来删除项目 GSet frmsetup.lstmodels.list(0), 设置列表框外观 BorderStyle ForeColor BackColor Font 属性可更改列表框的外观 30 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 5.7.3 列表框控件属性 属性 AddItem BackColor BorderStyle Enabled EventTaskType 描述 运行时在列表中添加项目 控件的背景颜色 默认 :Window 用于控件的边框 默认 :2 Fixed3D 设置是否在运行时启用控件 默认 :1 True 用于事件的任务类型 默认 :0 Normal Font 控件文本的字体 ( 仅设计时 ) 默认 :Microsoft Sans Serif 8.25 pt FontBold 当前字体的粗体属性 ( 仅运行时 ) 默认 :0 False FontItalic 当前字体的斜体属性 ( 仅运行时 ) 默认 :0 False FontName 当前字体的名称 ( 仅运行时 ) 默认 :Microsoft Sans Serif FontSize 点中当前字体的大小 ( 仅运行时 ) 默认 :8.25 ForeColor 控件文本的前景颜色 默认 :WindowText Height 控件高度, 单位为像素 Left 控件的左坐标, 单位为像素 List 用于在运行时访问列表中的项目 ListCount 用于在运行时获取列表中的项目数量 Name 控件名称 默认 :ListBoxXX SelectedIndex 用于在运行时确定操作员选择的项目 Sorted 设置是否对列表中的项目分类 默认 :0 False TabIndex 控件的选项卡索引 ToolTipText 控件提示信息中的文本 默认 : 空 Top 控件的顶坐标, 单位为像素 Visible 控件在运行时是否可见 默认 :1 True Width 控件宽度, 单位为像素 GUI Builder 7.0 (Ver.7.0) Rev.1 31

5. GUI Builder 组件 5.7.4 列表框控件事件 事件 Click DblClick 描述 用户鼠标单击控件时执行 用户鼠标双击控件时执行 5.8 组合框控件 5.8.1 描述 组合框控件用于显示下拉组合框内的数据 默认情况下, 组合框控件包括两部分 : 上面部分是允许用户键入列表项目的文本框 第二部分是显示用户可从中选择一个项目的项目列表的列表框 5.8.2 根据 DropDownStyle 属性的值, 组合框控件具有三种不同的方法 DropDownStyle = Simple 在 Simple 模式下, 列表框上方会有一个文本框 操作员可通过在文本框区域键入信息来编辑或添加选择 DropDownStyle = DropDown 在此模式下, 操作员点击文本区域右侧的下箭头按钮之前, 不会显示列表框部分 操作员可在文本框区域编辑选定的文本 DropDownStyle = DropDownList 指定 DropDownList 时, 操作员不可在文本框区域键入文本 仅可选择列表中的项目 有关如何在组合框控件的列表框部分添加项目的信息, 请参阅列表框控件的信息, 了解 AddItem List ListCount 和 SelectedIndex 的相关信息 设置组合框外观 ForeColor BackColor 和 Font 属性可更改组合框的外观 32 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 5.8.3 组合框控制属性 属性 AddItem BackColor DropDownStyle Enabled EventTaskType 描述 运行时在列表中添加项目 控件的背景颜色 默认 :Window 指定组合框的类型 默认 :1 DropDown 设置是否在运行时启用控件 默认 :1 True 用于事件的任务类型 默认 :0 Normal Font 控件文本的字体 ( 仅设计时 ) 默认 :Microsoft Sans Serif 8.25 pt FontBold 当前字体的粗体属性 ( 仅运行时 ) 默认 :0 False FontItalic 当前字体的斜体属性 ( 仅运行时 ) 默认 :0 False FontName 当前字体的名称 ( 仅运行时 ) 默认 :Microsoft Sans Serif FontSize 点中当前字体的大小 ( 仅运行时 ) 默认 :8.25 ForeColor 控件文本的前景颜色 默认 :WindowText Height 控件高度, 单位为像素 Left 控件的左坐标, 单位为像素 List 用于在运行时访问列表中的项目 ListCount 用于在运行时获取列表中的项目数量 Name 控件名称 默认 :ComboBoxXX SelectedIndex 用于在运行时确定操作员选择的项目 Sorted 设置是否对列表中的项目分类 默认 :0 False TabIndex 控件的选项卡索引 Text 控件文本 默认 : 空 ToolTipText 控件提示信息中的文本 默认 : 空 Top 控件的顶坐标, 单位为像素 Visible 控件在运行时是否可见 默认 :1 True Width 控件宽度, 单位为像素 GUI Builder 7.0 (Ver.7.0) Rev.1 33

5. GUI Builder 组件 5.8.4 组合框控件事件 事件 Click 描述 用户鼠标单击控件时执行 5.9 图片框控件 5.9.1 描述 图片框控件用于显示位图 GIF JPEG PNG WMF 图元文件或图标格式的图形 5.9.2 图片框控件可显示文件中的图像 您可以在设计或运行时设置图片框控件的图像 设置图像 设计时, 可 Image 属性浏览图像文件 运行时, 可 Image 属性指定图像文件的完整路径 更改图像尺寸 您可以 SizeMode 属性指定图像尺寸 设置图片框外观 BackColor BorderStyle 和 SizeMode 属性可更改图片框的外观 5.9.3 图片框控件属性 属性 BackColor BorderStyle Enabled EventTaskType 描述 控件的背景颜色 默认 :Control 用于控件的边框 默认 :0 None 设置是否在运行时启用控件 默认 :1 True 用于事件的任务类型 默认 :0 Normal 控件高度, 单位为像素 Height Image 指定待显示的图像 若要删除, 可按下 < 删除 > 键 Left 控件的左坐标, 单位为像素 Name 控件名称 默认 :PictureBoxXX SizeMode TabIndex ToolTipText 指定图像尺寸 默认 :0 Normal 控件的选项卡索引 控件提示信息中的文本 默认 : 空 34 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 Top Visible Width 控件的顶坐标, 单位为像素 控件在运行时是否可见 默认 :1 True 控件宽度, 单位为像素 5.9.4 图片框控件事件 事件 Click DblClick 描述 用户鼠标单击控件时执行 用户鼠标双击控件时执行 GUI Builder 7.0 (Ver.7.0) Rev.1 35

5. GUI Builder 组件 5.10 分组框控件 5.10.1 描述 分组框控件用于为其他控件提供识别分组 通常情况下, 您可以分组框按功能划分窗体 例如, 您可能设有指定机器人速度选项的设置窗体 在分组框中对所有选项分组可为用户提供合乎逻辑的视觉提示 5.10.2 分组框控件可为选择选项 ( RadioButtons) 或设置选项 ( CheckBoxes) 的控件进行分组 您也可以对其他控件分组 首先, 将分组框控件添加到窗体中 然后, 在分组框上创建新控件, 或将现有控件拖至分组框 将分组框的 Text 属性设为组名 设置分组框外观 BackColor ForeColor 和 Font 属性可更改分组框的外观 5.10.3 分组框控件属性 属性描述 BackColor 控件的背景颜色 默认 :Control Enabled 设置是否在运行时启用控件 默认 :1 True EventTaskType 用于事件的任务类型 默认 :0 Normal Font 控件文本的字体 ( 仅设计时 ) 默认 :Microsoft Sans Serif 8.25 pt ForeColor 控件文本的前景颜色 默认 :ControlText FontBold 当前字体的粗体属性 ( 仅运行时 ) 默认 :0 False FontItalic 当前字体的斜体属性 ( 仅运行时 ) 默认 :0 False FontName 当前字体的名称 ( 仅运行时 ) 默认 :Microsoft Sans Serif FontSize 点中当前字体的大小 ( 仅运行时 ) 默认 :8.25 36 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 ForeColor Height Left Name TabIndex Text ToolTipText Top Visible Width 控件文本的前景颜色 默认 :ControlText 控件高度, 单位为像素 控件的左坐标, 单位为像素 控件名称 默认 :GroupBoxXX 控件的选项卡索引 默认 : 控件文本 默认 : 控件名称控件提示信息中的文本 默认 : 空控件的顶坐标, 单位为像素 控件在运行时是否可见 默认 :1 True 控件宽度, 单位为像素 5.10.4 分组框控件事件 事件 Click 描述 用户鼠标单击控件时执行 GUI Builder 7.0 (Ver.7.0) Rev.1 37

5. GUI Builder 组件 5.11 定时器控件 5.11.1 描述 定时器是定期发出事件的控件 即使发生紧急停止或其他正常任务暂停时, 定时器控件仍可执行 5.11.2 定时器控件可定时执行代码 例如, 定时器控件可用于每两秒更新一次状态标签 要定时器 1. 在窗体中添加定时器控件 由于此控件在运行时不可见, 因此会显示在设计区域内的窗体下方 2. 将 Interval 属性设为所需时间, 单位为毫秒 3. 如果定时器应始终运行, 则在设计时将 Enabled 属性设为 True 否则, 可在运行时在代码中将 Enabled 属性设为 True 4. 添加 Tick 事件的事件处理程序, 以执行代码 注 当定时器正在执行 Tick 事件处理程序时, 将忽略同一定时器的其他 Tick 事件 5.11.3 定时器控件属性 属性 Enabled Interval Name 描述 设置是否启用控件 默认 :0 False 设置时间间隔, 单位为毫秒 默认 :100 控件名称 默认 :TimerXX 5.11.4 定时器控件事件 事件 Tick 描述 定时器启用且达到间隔时发生 38 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 5.12 视频框控件 5.12.1 描述 视频框控件可实现在窗体内显示 Vision Guide 选件的视频 5.12.2 通过视频框控件可轻松在应用中的窗体上显示视觉窗口 运行视觉顺序时, 还可在窗口上显示图形 执行以下步骤创建视觉窗口 : 1. 将视频框控件放在想要显示视频的窗体上 控件尺寸可更改为全尺寸 2. 将 VideoEnabled 属性设为 True 3. 如果您想要显示视觉图形, 则将 GraphicsEnabled 属性设为 True 4. 默认情况下,Camera 属性值为 0 即允许视频框在序列运行时显示任一相机的视频 将 Camera 属性设为项目中的任一相机编号, 以显示此相机的视频和序列图形 视频会自动缩放至适合视频框的尺寸 当您更改视频框的高度或宽度时, 屏幕比例将保持不变 设置视频框外观 BorderStyle 属性可更改视频框的外观 5.12.3 视频框控件属性 属性 BorderStyle Camera Enabled EventTaskType GraphicsEnabled Height Left Name TabIndex ToolTipText Top VideoEnabled 描述 用于控件的边框 默认 :0 None 选择将显示视频的相机 默认 :0 设置是否在运行时启用控件 默认 :1 True 用于事件的任务类型 默认 :0 Normal 设置是否显示视觉图形 默认 :0 False 控件高度, 单位为像素 控件的左坐标, 单位为像素 控件名称 默认 :VideoBoxXX 控件的选项卡索引 控件提示信息中的文本 默认 : 空控件的顶坐标, 单位为像素 设置是否显示视频 默认 :0 - False GUI Builder 7.0 (Ver.7.0) Rev.1 39

5. GUI Builder 组件 Visible Width 控件在运行时是否可见 默认 :1 True 控件宽度, 单位为像素 5.12.4 视频框控件事件 事件 Click DblClick 描述 用户鼠标单击控件时执行 用户鼠标双击控件时执行 5.13 LED 控件 5.13.1 描述 LED 控件用于显示 I/O 状态 5.13.2 要 LED 控件 1. 将 Text 属性设为状态名称 2. 设置 IOType 属性 可以选择 input,output, 或 memory I/O 3. 设置 IOBit 属性 即想要显示状态的位 对于输出, 您可以视情况允许操作员双击 LED 控件切换输出状态 为此, 需将 AllowStateChange 属性设为 True 设置 LED 外观 BackColor BorderStyle ForeColor Font ImageAlign 和 TextAlign 属性可更改 LED 的外观 您还可以更改 ImageOn 和 ImageOff 属性, 以内置彩色图像, 或者可以提供自己的图像 5.13.3 LED 控件属性 属性描述 AllowStateChange 允许操作员切换输出状态 默认 :0 False BackColor 控件的背景颜色 默认 :Control BorderStyle 用于控件的边框 默认 :0 None Enabled 设置是否在运行时启用控件 默认 :1 True EventTaskType 用于事件的任务类型 默认 :0 Normal Font 控件文本的字体 ( 仅设计时 ) 默认 :Microsoft Sans Serif 8.25 pt 40 GUI Builder 7.0 (Ver.7.0) Rev.1

5. GUI Builder 组件 FontBold 当前字体的粗体属性 ( 仅运行时 ) 默认 :0 False FontItalic 当前字体的斜体属性 ( 仅运行时 ) 默认 :0 False FontName 当前字体的名称 ( 仅运行时 ) 默认 :Microsoft Sans Serif FontSize 点中当前字体的大小 ( 仅运行时 ) 默认 :8.25 ForeColor 控件文本的前景颜色 默认 :ControlText Height 控件高度, 单位为像素 ImageAlign 控件的图片对齐 默认 :4 - MiddleLeft ImageOff 设置 I/O 状态关闭时显示的图像 默认 : LedOff.ico ImageOn 设置 I/O 状态打开时显示的图像 默认 :LedRed.ico IOBit 范围 :0 至 9999 默认 :0 IOType 设置待监测 I/O 的类型 默认 :0 Input Left 控件的左坐标, 单位为像素 Name 控件名称 默认 :LedXX TabIndex 控件的选项卡索引 Text 控件文本 默认 : 控件名称 TextAlign 选择文本对齐 默认 :6 MiddleRight ToolTipText 控件提示信息中的文本 默认 : 空 Top 控件的顶坐标, 单位为像素 Visible 控件在运行时是否可见 默认 :1 True Width 控件宽度, 单位为像素 5.13.4 LED 控件事件 事件 DblClick 描述 用户鼠标双击控件时执行 GUI Builder 7.0 (Ver.7.0) Rev.1 41

6. 操作 6. 操作 6.1 概述 本章包括以下主题 : - 编程模式下的 GUI 开发 - 自动模式下的 GUI 启动配置 - 处理暂停和继续 - 处理紧急停止 - 帮助文件 6.2 编程模式下的 GUI 开发 您可以在编程模式下设计和调试 GUI 应用 开始前, 需在编程模式下启动 EPSON RC+ 7.0 6.2.1 设计 GUI 若要为应用设计 GUI, 需遵循以下步骤作为简单指南 1. 为应用创建一个或多个窗体 通常需指定其中一个窗体为主窗体 2. 确定想要启动 GUI 的方式 您可以将其中一个窗体设为启动窗体 当 RC+ 在自动模式下启动时, 将自动显示此窗体 如果您不想在启动时显示窗体, 则会显示操作员窗口, 并且您可以 GShow 或 GShowDialog 显示 SPEL+ 代码中的任一窗体 3. 为窗体添加控件 4. 为控件添加所需事件 有关窗体和控件的详细信息, 请参阅章节窗体和控件的 42 GUI Builder 7.0 (Ver.7.0) Rev.1

6. 操作 6.2.2 调试 您可以通过运行窗口运行项目中的任一窗体 1. 打开运行窗口 2. 从下拉列表中选择想要运行的窗体 3. 点击 < 开始 > 将显示选定窗体, 并且您可以窗体上的控件 4. 若要停止, 可关闭所有窗体, 或点击运行窗口上的 < 停止 > 按钮 GUI 事件处理程序会作为 SPEL + 任务运行, 因此您可以在任一事件处理程序中设置断点, 单步调试代码并查看变量值 6.3 自动模式 在开发应用之后, 您将需要设置 EPSON RC+ 在自动模式下运行 启动时, 您可以选择显示其中一个 GUI 窗体, 或者您可以显示操作员窗口, 然后显示程序中的其中一个窗体 要设置 EPSON RC+ 在自动模式下启动 1. 打开设置 系统配置 2. 在启动模式页面, 选中 < 自动 > 并点击 < 应用 >, 然后点击 < 关闭 > 要配置启动时显示的窗体 1. 打开 GUI Builder 窗口 2. 在窗体资源管理器中, 右击想要在启动时显示的窗体, 并选择 启动窗体 3. 点击主工具栏上的 < 项目保存 > 按钮 GUI Builder 7.0 (Ver.7.0) Rev.1 43

6. 操作 6.4. 处理暂停与继续 您可能会想要在 GUI 中控制器的暂停和继续功能 通常, 会有一个具有暂停按钮和继续按钮的对话框 若要使这些按钮正常工作, 需要将各按钮的 EventTaskType 属性设为 1 NoPause 这是因为按钮点击事件执行时, 事件任务必须忽略控制器的暂停状态 Function frmmain_btnpause_click(sender$ As String) Pause Fend Function frmmain_btncont_click(sender$ As String) Cont Fend 6.5. 处理紧急停止 6.6 帮助文件 紧急停止后, 您必须在可以重新运行机器人之前重置紧急停止条件 为此, 需提供重置按钮, 并将其 EventTaskType 设为 2 NoEmgAbort Function frmmain_btnreset_click(sender$ As String) Reset If EstopOn Then MsgBox "EStop could not be reset" EndIf Fend GUI Builder 支持简单的帮助系统, 即允许您为项目指定帮助文件, 以在操作员点击窗体帮助按钮时显示主题 帮助文件必须采用 Microsoft HTML 帮助格式 要帮助文件 : 1. 打开项目 属性 GUI 创建器 2. 浏览到帮助文件并点击打开以设置帮助文件 3. 对于将显示帮助的每个窗体, 将 HelpButton 属性设为 True 并为想要显示的主题设置 HelpID 属性 44 GUI Builder 7.0 (Ver.7.0) Rev.1

7. GUI Builder 参考 7. GUI Builder 参考 7.1 概述本章将介绍所有 GUI Builder 窗体和控件属性和事件以及所有 GUI Builder SPEL+ 命令 有关如何 GUI Builder 的更多信息, 请参阅 GUI Builder 手册 7.2 GUI Builder 属性和事件格式描述所有 GUI Builder 属性和事件将在后文列出 属性标题以及结果参考页码的说明如下所示 : 范围 描述 如果属性或事件用于 GUI Builder 对象, 则本节将简单列出此属性适用的对象 ( 不包括 Button, Label, Checkbox) 如果属性或事件用于窗体, 则本节将介绍 Forms 一词 将为每个属性或事件提供简单描述 为简单起见, 本节内容通常很短 章节将介绍如果通过 SPEL + 语言访问属性或事件 数值 备注 仅运行时 描述属性可设至或结果将返回的可接受数值范围 对于具有默认值的属性, 还会显示默认值 介绍描述章节未涉及的更多详细信息 本节通常用于描述可能适用于特定属性或事件的所有警告或特殊信息 ( 强烈建议在各属性之前阅读相关的备注章节 ) 提供一系列可能有助于回顾的相关属性 结果 对象和其他主题 在适用时显示在属性或结果名称下方 通过 GUI Builder 无法访问仅运行时的属性和结果 只能通过 SPEL + 语言访问 GUI Builder 7.0 (Ver.7.0) Rev.1 45

AcceptButton 属性 AcceptButton 属性 Form 描述获取或设置用户按下 ENTER 键时点击的窗体按钮 GGet Form.AcceptButton, var GSet Form.AcceptButton, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的字符串变量 新属性值的字符串表达式 数值 窗体上任一按钮的名称 默认 :None 备注该属性允许您指定用户在应用中按下 ENTER 键时发生的默认动作 分配至该属性的按钮必须是位于当前窗体或位于当前窗体上的容器内的按钮 您可以该属性允许用户在完成时仅按下 ENTER 键而无需用鼠标手动点击接受按钮, 从而允许用户快速导航简单窗体 如果窗体上当前选定的控件拦截 ENTER 键并对其进行处理, 则接受按钮可能未激活 例如, 多行文本框控件允许在控件中插入新一行字符时按下 ENTER 键 Form Button CancelButton GSet frmmain.acceptbutton, "btnok" 46 GUI Builder 7.0 (Ver.7.0) Rev.1

AddItem 属性 AddItem 属性 ListBox ComboBox 描述用于在列表框或组合框控件中添加项目 GSet Form.Control.AddItem, value Form 窗体名称或含有窗体名称的字符串变量 Control value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 新属性值的字符串表达式 数值待添加至列表的字符串值 ComboBox ListBox List ListCount Sorted GSet frmmain.lstmodels.additem, "Model1" GUI Builder 7.0 (Ver.7.0) Rev.1 47

AppendText 属性 AppendText 属性 TextBox 描述在文本框控件上附加文本 GSet Form.Control.AppendText, value Form 窗体名称或含有窗体名称的字符串变量 Control value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 新属性值的字符串表达式 数值 将添加至控件中文本结尾处的字符串 TextBox GSet frmmain.txtstatus.appendtext, "Cycle Complete" 48 GUI Builder 7.0 (Ver.7.0) Rev.1

AllowStateChange 属性 AllowStateChange 属性 LED 描述获取或设置双击时 LED 控件的反转驱动 GGet Form.Control.AllowStateChange, var GSet Form.Control.AllowStateChange, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False 备注若要转换输出, 需将 IOType 属性设为 1 Output 或 2 Memory LED IOType GSet frmmain.led1.allowstatechange, True GUI Builder 7.0 (Ver.7.0) Rev.1 49

BackColor 属性 BackColor 属性 Form Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox LED 描述获取或设置窗体或控件的背景颜色 GGet Form.Control.BackColor, var GSet Form.Control.BackColor, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的字符串变量 新属性值的字符串表达式 数值用于窗体或控件背景颜色的颜色名称 默认 : Control (Form Button Label RadioButton CheckBox PictureBox GroupBox LED) Window (TextBox ListBox ComboBox) BackColorMode Form Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox LED GSet frmmain.lblstatus.backcolor, "Red" 50 GUI Builder 7.0 (Ver.7.0) Rev.1

BackColorMode 属性 BackColorMode 属性 Button 描述获取或设置用于按钮控件的 BackColorMode GGet Form.Control.BackColorMode, var GSet Form.Control.BackColorMode, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值 0 VisualStyle. 系统指定的 BackColor 1 User. 指定的 BackColor 备注当 BackColorMode 为 0 时, 会根据当前方案由 Windows 设置控件的背景颜色 当 BackColorMode 为 1 时, 会由 BackColor 属性值设置背景颜色 默认 :0 Visual Style BackColor Button GSet frmmain.btnok.backcolormode, BACKCOLORMODE_USER GUI Builder 7.0 (Ver.7.0) Rev.1 51

BorderStyle 属性 BorderStyle 属性 Label TextBox ListBox PictureBox VideoBox LED 描述获取或设置控件的边框样式 GGet Form.Control.BorderStyle, var GSet Form.Control.BorderStyle, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值 0 - None 1 - FixedSingle 2 - Fixed3D 默认 : 0 None(Label PictureBox VideoBox LED) 2 Fixed3D(TextBox ListBox) 备注您可以该属性为控件添加边框 例如, 该属性可用于区分标识其他控件的标签和显示应用中过程状态的标签 Label TextBox ListBox PictureBox VideoBox LED GSet frmmain.lblstatus.borderstyle, BORDERSTYLE_NONE 52 GUI Builder 7.0 (Ver.7.0) Rev.1

Camera 属性 Camera 属性 VideoBox 描述获取或设置视频框控件的相机编号 GGet Form.Control.Camera, var GSet Form.Control.Camera, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值用于视频显示的相机编号 如果数值为 0, 则会在 VRun 执行时显示任一相机的视频 若要显示视频, 需将 VideoEnabled 属性设为 1 True VideoBox VideoEnabled GSet frmmain.videobox1.camera, 1 GUI Builder 7.0 (Ver.7.0) Rev.1 53

CancelButton 属性 CancelButton 属性 Form 描述获取或设置用户按下 ESC 键时点击的窗体按钮 GGet Form.CancelButton, var GSet Form.CancelButton, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的字符串变量 新属性值的字符串表达式 数值 窗体上任一按钮的名称 默认 :None 备注窗体的取消按钮是无论何时用户按下 ESC 键均会点击的按钮控件 分配至该属性的按钮必须是位于当前窗体或位于当前窗体上的容器内的按钮 该属性允许您指定用户在应用中按下 ESC 键时发生的默认动作 您可以该属性允许用户仅通过按下 ESC 键来关闭窗口, 而无需用鼠标手动点击取消按钮来提交更改, 从而允许用户快速导航简单窗体 CancelButton 在窗体上的其他控件拦截 ESC 键时可能会无效 例如, 如果您的窗体上打开了一个组合框, 则 ESC 将关闭组合框, 而不会关闭窗体 分配至 CancelButton 的按钮控件必须在窗体上可见, 否则按下 ESC 键将无效 Form Button AcceptButton GSet frmmain.cancelbutton, "btncancel" 54 GUI Builder 7.0 (Ver.7.0) Rev.1

Checked 属性 Checked 属性 RadioButton Checkbox 描述获取或设置表示是否选中复选框或单选按钮控件的值 GGet Form.Control.Checked, var GSet Form.Control.Checked, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 - False 1 True 默认 :0 False 备注该属性可确定是否选中了复选框或单选按钮控件 该属性还可用于以编程方式设置复选框或单选按钮控件的状态 RadioButton CheckBox GSet frmmain.chkhipower.checked, False GUI Builder 7.0 (Ver.7.0) Rev.1 55

Click 事件 Click 事件 Button Label RadioButton Checkbox ListBox ComboBox PictureBox GroupBox VideoBox 描述单击控件时发生 Form_Control_Click (sernder$ As String) Sender$ 发送事件的控件的名称 备注 Click 事件用于响应用户对控件的单击 您可以 Sender$ 参数确定发送事件的控件 这对于想要一个函数处理多个控件的情况非常有用, 如, 对于单选按钮和复选框 Button Label RadioButton Checkbox ListBox ComboBox PictureBox GroupBox VideoBox Function frmmain_btnstart_click(sender$ As String) Xqt main Fend 56 GUI Builder 7.0 (Ver.7.0) Rev.1

Closed 事件 Closed 事件 Form 描述窗体关闭时发生 Form_Closed (Sernder$ As String) Sender$ 发送事件的窗体的名称 备注您可以该事件在窗体关闭之后执行任务 Form Load Resize Function frmmain_closed(sender$ As String) Print "frmmain was closed" Fend GUI Builder 7.0 (Ver.7.0) Rev.1 57

ControlBox 属性 ControlBox 属性 Form 描述获取或设置表示是否在窗体标题栏显示控件框的值 GGet Form.ControlBox, var GSet Form.ControlBox, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 - False 1 True 默认 :True 备注如果 ControlBox 属性设为 true, 则会在窗体的标题栏左上角显示控件框 控件框可用于关闭窗体 Form MaximizeBox MinimizeBox GSet frmmain.controlbox, False 58 GUI Builder 7.0 (Ver.7.0) Rev.1

Controls 属性 Controls 属性 Form 描述窗体上的控件数组 用于通过索引访问控件属性 GGet Form.Controls(Index As Integer).Property, var GSet Form.Controls(Index As Integer).Property, value Form 窗体名称或含有窗体名称的字符串变量 Index Property var value 含有窗体上控件索引的整数表达式 待访问的控件属性名称 将含有属性值的变量 数据类型取决于指定的属性 新属性值的表达式 数据类型取决于指定的属性 备注 Controls 属性可通过索引访问窗体上的控件 这样便允许您循环访问控件集合并获取或设置一般属性 Count Type Integer i, count String type$ GGet frmmain.controls.count, count For i = 1 To count GGet frmmain.controls(i).type, type$ If type$ = "Button" Then GSet frmmain.controls(i).enabled, False EndIf Next i GUI Builder 7.0 (Ver.7.0) Rev.1 59

Count 属性 Count 属性 Form.Controls 描述获取窗体上的控件数量 GGet Form.Controls.Count, var Form 窗体名称或含有窗体名称的字符串变量 var 将含有属性值的整数变量 数值返回窗体上的控件数量 备注 Count 属性可确定窗体上的控件数量 然后可以 Controls 属性循环访问所有控件 Controls Type Integer count GSet frmmain.controls.count, count For i = 1 To count GGet frmmain.controls(i).type, type$ If type$ = "Button" Then GSet frmmain.controls(i).enabled, False EndIf Next i 60 GUI Builder 7.0 (Ver.7.0) Rev.1

DblClick 事件 DblClick 事件 Label ListBox Led PictureBox VideoBox LED 描述双击控件时发生 Form_Control_DblClick (Sernder$ As String) Sender$ 发送事件的控件的名称 备注 DblClick 事件用于响应用户对控件的双击 您可以 Sender$ 参数确定发送事件的控件 Label ListBox PictureBox VideoBox LED Function frmmain_lstmodels_dblclick(sender$ As String) Integer index GGet frmmain.lstmodels.selectedindex, index GGet frmmain.lstmodels.list(index), g_currmodel$ Fend GUI Builder 7.0 (Ver.7.0) Rev.1 61

DialogResult 属性 DialogResult 属性 Form 描述获取或设置窗体的对话框结果 GGet Form.DialogResult, var GSet Form.DialogResult, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的整数变量 新属性值的整数表达式 数值 0 None 1 OK 2 Cancel 默认 :2 Cancel 备注 DialogResult 用于表示用户是否接受窗体或取消窗体 通常, 一个对话框具有一个 < 确定 > 按钮和一个 < 取消 > 按钮 当用户单击 < 确定 > 按钮时,DialogResult 属性会在按钮单击事件中设为 1-OK 如果单击 < 取消 > 按钮, 则 DialogResult 属性会设为 2 Cancel Form Function frmsetspeed_btnok_click(sender$ As String) GSet frmsetspeed.dialogresult, DIALOGRESULT_OK GClose frmsetspeed GClose frmsetspeed Fend Function frmmain_btnsetspeed_click(sender$ As String) Integer result String speed$ result = GShowDialog(frmSetSpeed) If result = DIALOGRESULT_OK Then GGet frmsetspeed.txtspeed.text, speed$ g_robotspeed = Val(speed$) Fend 62 GUI Builder 7.0 (Ver.7.0) Rev.1

DropDownStyle 属性 DropDownStyle 属性 ComboBox 描述获取或设置指定组合框类型的值 GGet Form.Control.DropDownStyle, var GSet Form.Control.DropDownStyle, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值 0 Simple 1 DropDown 2 DropDownList 默认 :1 DropDown 备注 DropDownStyle 属性可控制为用户展示的界面 您可以输入数值提供始终显示列表的简单下拉列表框 文本部分不可编辑且必须选择箭头查看下拉列表的下拉列表框, 或文本部分可编辑且用户必须按下箭头键查看列表的默认下拉列表框 若要始终显示用户不可编辑的列表, ListBox 控件 ComboBox GSet frmmain.cmbpartnames.dropdownstyle, DROPDOWNSTYLE_SIMPLE GUI Builder 7.0 (Ver.7.0) Rev.1 63

Enabled 属性 Enabled 属性 Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox Timer VideoBox LED 描述获取或设置是否在运行时启用控件 GGet Form.Control.Enabled, var GSet Form.Control.Enabled, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 : 1 True( 适用于 Timer 以外 ) 0 False( 适用于 Timer) 备注在某些情况下, 需要防止操作员单击控件, 如按钮 例如,SPEL + 任务未运行时, 可将 Enabled 设为 0 False, 使 < 暂停 > 按钮变暗 Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox Timer VideoBox LED GSet frmmain.btnpause.enabled, False 64 GUI Builder 7.0 (Ver.7.0) Rev.1

EventTaskType 属性 EventTaskType 属性 Form Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox VideoBox LED 描述获取以事件开始的函数的任务类型 GGet Form.[Control].EventTaskType, var Form 窗体名称或含有窗体名称的字符串变量 Control var 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 数值 0 Normal 1 NoPause 2 NoEmgAbort 默认 :0 Normal 备注当该属性设为 1 NoPause 时, 事件处理程序函数在其他任务暂停时仍可运行 当该属性设为 2 NoEmgAbort 时, 事件处理程序函数在紧急停止状态下仍可运行 Form Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox VideoBox LED Integer Ttype GGet frmmain.btnpause.eventtasktype, Ttype GUI Builder 7.0 (Ver.7.0) Rev.1 65

Font 属性 Font 属性 仅来自 GUI Button Label TextBox RadioButton CheckBox ListBox ComboBox GroupBox LED 描述 Font 属性允许在设计时更改控件的字体参数 ( 字体名称 类型 大小 ) 在 GUI Builder 窗口属性网格中, 选择窗体上的控件并单击 Font 属性值内的按钮 将显示以下对话框 更改设置并单击 < 确定 > 保存 Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox 66 GUI Builder 7.0 (Ver.7.0) Rev.1

FontBold 属性 FontBold 属性 Button Label TextBox RadioButton CheckBox ListBox ComboBox GroupBox LED 描述获取或设置控件上的文本字体在运行时是否采用粗体 GGet Form.Control.FontBold, var GSet Form.Control.FontBold, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False Button Label TextBox RadioButton Checkbox ListBox ComboBox GroupBox LED FontName FontItalic FontSize GSet frmmain.btnok.fontbold, True GUI Builder 7.0 (Ver.7.0) Rev.1 67

FontItalic 属性 FontItalic 属性 Button Label TextBox RadioButton CheckBox ListBox ComboBox GroupBox LED 描述获取或设置控件字体在运行时是否采用斜体 GGet Form.Control.FontItalic, var GSet Form.Control.FontItalic, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False Button Label TextBox RadioButton Checkbox ListBox ComboBox GroupBox LED FontName FontBold FontSize GSet frmmain.btnok.fontitalic, True 68 GUI Builder 7.0 (Ver.7.0) Rev.1

FontName 属性 FontName 属性 Button Label TextBox RadioButton CheckBox ListBox ComboBox GroupBox LED 描述获取或设置控件所文本的字体名称 GGet Form.Control.FontName, var GSet Form.Control.FontName, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的字符串变量 新属性值的字符串表达式 数值含有字体名称的字符串 默认 :Microsoft Sans Serif Button Label TextBox RadioButton Checkbox ListBox ComboBox GroupBox LED FontSize FontItalic FontBold GSet frmmain.txtstatus.fontname, "Courier New" GUI Builder 7.0 (Ver.7.0) Rev.1 69

FontSize 属性 FontSize 属性 Button Label TextBox RadioButton CheckBox ListBox ComboBox GroupBox LED 描述获取或设置控件所文本的字体大小 GGet Form.Control.FontSize, var GSet Form.Control.FontSize, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的实际变量 新属性值的实际表达式 数值字体大小值, 单位为点 默认 :8.25 Button Label TextBox RadioButton Checkbox ListBox ComboBox GroupBox FontName FontItalic FontBold GSet frmmain.btnok.fontsize, 16 70 GUI Builder 7.0 (Ver.7.0) Rev.1

ForeColor 属性 ForeColor 属性 Button Label TextBox RadioButton CheckBox ListBox ComboBox GroupBox LED 描述获取或设置控件的前景颜色 GGet Form.Control.ForeColor, var GSet Form.Control.ForeColor, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的字符串变量 新属性值的字符串表达式 数值表示控件前景颜色的字符串 默认 : Control Text(Button Label RadioButton CheckBox GroupBox LED) Window Text(TextBox ListBox ComboBox) Button Label TextBox RadioButton Checkbox ListBox ComboBox GroupBox LED GSet frmmain.btnok.forecolor, "Blue" GUI Builder 7.0 (Ver.7.0) Rev.1 71

FormBorderStyle 属性 FormBorderStyle 属性 Form 描述获取或设置窗体的边框样式 GGet Form.FormBorderStyle, var GSet Form.FormBorderStyle, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的整数变量 新属性值的整数表达式 数值 0 None 1 Fixed Single 2 Fixed3D 3 FixedDialog 4 Sizeable 默认 :3 FixedDialog Form GSet frmmain.formborderstyle, FORMBORDERSYTLE_NONE 72 GUI Builder 7.0 (Ver.7.0) Rev.1

GClose 语句 GClose 语句 Form 描述关闭窗体 GClose Form Form 窗体名称或含有窗体名称的字符串变量 还可以提供系统窗体 ID 关闭任一以下系统窗口 : WIN_IOMON WIN_TASKMGR WIN_FORCEMON WIN_SIMULATOR 关闭 I/O 监视器窗口 关闭任务管理器窗口 关闭力监视器窗口 关闭仿真器窗口 GShow GShowDialog GClose frmsetup GClose WIN_TASKMGR GUI Builder 7.0 (Ver.7.0) Rev.1 73

GGet 语句 GGet 语句 描述 GGet 用于获取当前项目中窗体和控件的属性值 GGet Form.Property, var GGet Form.Control.Property, var Form 窗体名称或含有窗体名称的字符串变量 Control Property var 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 待设置或返回数值的属性名称 将含有返回数值的变量 备注 GGet 用于在运行时检索属性值 GSet 74 GUI Builder 7.0 (Ver.7.0) Rev.1

GraphicsEnabled 属性 GraphicsEnabled 属性 VideoBox 描述获取或设置 VideoBox 是否显示视觉图形 GGet Form.Control.GraphicsEnabled, var GSet Form.Control.GraphicsEnabled, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False VideoBox VideoEnabled GSet frmmain.videobox1.graphicsenabled, True GUI Builder 7.0 (Ver.7.0) Rev.1 75

GSet 语句 GSet 语句 描述 GSet 用于设置 GUI Builder 中的属性值 GSet Form.Property, value GSet Form.Control.Property, value Form 窗体名称或含有窗体名称的字符串变量 Control Property value 控件名称或含有对象名称的字符串变量 控件必须位于指定窗体内 待设置数值的属性名称 含有待设置数据的表达式 备注 GSet 用于在运行时设置窗体或控件属性的值 GGet 76 GUI Builder 7.0 (Ver.7.0) Rev.1

GShow 语句 GShow 语句 Form 描述 GShow 以非模态窗口的形式显示窗体 GShow Form Form 窗体名称或含有窗体名称的字符串变量 还可以提供系统窗体 ID 显示任一以下系统窗口 : WIN_IOMON WIN_TASKMGR WIN_FORCEMON WIN_SIMULATOR 打开 I/O 监视器窗口 打开任务管理器窗口 打开力监视器窗口 打开仿真器窗口 GClose GShowDialog GShow frmiodiags GShow WIN_TASKMGR GUI Builder 7.0 (Ver.7.0) Rev.1 77

GShowDialog 函数 GShowDialog 函数 Form 描述 GShow 以模态对话框的形式显示窗体 GShowDialog(Form) Form 窗体名称或含有窗体名称的字符串变量 返回值返回窗体的 DialogResult 属性值 GShow result = GShowDialog(frmSetup) If result = DIALOGRESULT_OK Then Call SaveSettings EndIf 78 GUI Builder 7.0 (Ver.7.0) Rev.1

Height 属性 Height 属性 Form Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox VideoBox LED 描述获取或设置窗体或控件的高度, 单位为像素 GGet Form.[Control].Height, var GSet Form.[Control].Height, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值 表示高度的整数, 单位为像素 Form Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox VideoBox LED Left Top Width GSet frmmain.btnok.height, 48 GUI Builder 7.0 (Ver.7.0) Rev.1 79

HelpButton 属性 HelpButton 属性 Form 描述获取或设置表示是否应在窗体标题框显示 Help 按钮的值 GGet Form.HelpButton, var GSet Form.HelpButton, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False 备注该属性设为 1 True 时,< 关闭 > 按钮左侧的标题栏中将出现一个带问号的小按钮 (MaximizeBox MinimizeBox 属性设为 False 时 ) 可此按钮显示应用的帮助信息 Form HelpID GSet frmmain.helpbutton, True 80 GUI Builder 7.0 (Ver.7.0) Rev.1

HelpID 属性 HelpID 属性 Form 描述返回或设置包含帮助文件内主题 HelpID 的整数 GGet Form.HelpID, var GSet Form.HelpID, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的整数变量 新属性值的整数表达式 数值表示帮助文件中主题 ID 的整数值 (0~999999) 默认 :0 备注 HelpID 属性用于显示应用上下文相关的帮助 帮助文件在 EPSON RC+ 项目 属性 GUI Builder 页面指定 当 HelpID 非 0 且用户按下 F1 或单击窗体帮助按钮时 ( 如果 HelpButton 属性为 True), 将显示帮助主题 Form HelpButton GSet frmmain.helpid, 50 GUI Builder 7.0 (Ver.7.0) Rev.1 81

Image 属性 Image 属性 Button Label RadioButton CheckBox PictureBox 描述获取或设置控件上显示的图像 GGet Form.Control.Image, var GSet Form.Control.Image, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的字符串变量 新属性值的字符串表达式 数值含有图像文件完整路径的字符串 默认 : 空白 注 删除键可删除已设置的图像文件 Button Label RadioButton Checkbox PictureBox ImageAlign GSet frmmain.btntools.image, "c:\images\tools.bmp" 82 GUI Builder 7.0 (Ver.7.0) Rev.1

ImageAlign 属性 ImageAlign 属性 Button Label RadioButton CheckBox LED 描述获取或设置控件上显示的图像的图像对齐 GGet Form.Control.ImageAlign, var GSet Form.Control.ImageAlign, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值 1 TopLeft 2 TopCenter 3 TopRight 4 MiddleLeft 5 MiddleCenter 6 MiddleRight 7 BottomLeft 8 BottomCenter 9 BottomRight 默认 : 5 MiddleCenter(Button Label RadioButton CheckBox) 4 MiddleLeft(LED) Button Label RadioButton Checkbox LED Image GSet frmmain.btntools.imagealign, IMAGEALIGN_MIDDLECENTER GUI Builder 7.0 (Ver.7.0) Rev.1 83

ImageOff 属性 ImageOff 属性 LED 描述获取或设置 LED 控件关闭时显示的图像 GGet Form.Control.ImageOff, var GSet Form.Control.ImageOff, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的字符串变量 新属性值的字符串表达式 数值含有图像文件完整路径的字符串 文件扩展名应为 bmp ico jpeg gif wmf 或 png 默认 :LedOff.ico LED ImageOn GSet frmmain.led1.imageoff, "c:\epsonrc70\gui\icons\ledoff.ico" 84 GUI Builder 7.0 (Ver.7.0) Rev.1

ImageOn 属性 ImageOn 属性 LED 描述获取或设置 LED 控件打开时显示的图像 GGet Form.Control.ImageOn, var GSet Form.Control.ImageOn, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的字符串变量 新属性值的字符串表达式 数值含有图像文件完整路径的字符串 文件扩展名应为 bmp ico jpeg gif wmf 或 png 默认 :LedRed.ico LED ImageOff GSet frmmain.led1.imageon, "c:\epsonrc70\gui\icons\ledred.ico" GUI Builder 7.0 (Ver.7.0) Rev.1 85

Interval 属性 Interval 属性 Timer 描述获取或设置定时器滴答之间的时间, 单位为毫秒 GGet Form.Control.Interval, var GSet Form.Control.Interval, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值每次定时器滴答之间的毫秒数 整数值范围为 1 9999 默认 :100 备注若要获取间隔的秒数, 需将此数值除以 1,000 Timer Enabled GSet frmmain.tmrmain.interval, 500 86 GUI Builder 7.0 (Ver.7.0) Rev.1

IOBit 属性 IOBit 属性 LED 描述获取或设置在 LED 控件上显示的 I/O 位数 GGet Form.Control.IOBit, var GSet Form.Control.IOBit, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值整数值范围为 0 9999 默认 :0 LED IOType GSet frmmain.led1.iobit, 10 GUI Builder 7.0 (Ver.7.0) Rev.1 87

IOType 属性 IOType 属性 LED 描述获取或设置在 LED 控件上显示的 I/O 类型 GGet Form.Control.IOType, var GSet Form.Control.IOType, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值 0 Input 1 Output 2 Memory 默认 :0 Input LED IOBit GSet frmmain.led1.iotype, IOTYPE_OUTPUT 88 GUI Builder 7.0 (Ver.7.0) Rev.1

KeyPress 事件 KeyPress 事件 TextBox 描述按下按键时发生 Form_Control_KeyPress (Sernder$ As String, ByRef Key$ As String) Sender$ 发送事件的控件的名称 Key$ 操作员按下的按键 备注 Keypress 事件可用于检测操作员输入的按键 此事件可用作过滤器 通过将 Key$ 设置为其他字符可更改按下的按键 通过将 Key$ 设为空字符串可取消 keypress 响应 TextBox Function frmmain_txtspeed_keypress(sender$ As String, ByRef Key$ As String) ' 仅允许输入数字 If Instr("0123456789" Key$) < 0 Then Key$ = "" EndIf Fend GUI Builder 7.0 (Ver.7.0) Rev.1 89

Left 属性 Left 属性 Form Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox VideoBox LED 描述获取或设置窗体或控件的左坐标, 单位为像素 GGet Form.[Control].Left, var GSet Form.[Control].Left, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值表示左坐标的整数, 单位为像素 Form Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox VideoBox LED Top Height Width GSet frmmain.btnok.left, 200 90 GUI Builder 7.0 (Ver.7.0) Rev.1

List 属性 List 属性 ListBox ComboBox 描述获取或设置控件项目列表中指定元素的字符串值 GGet Form.Control.List(index), var GSet Form.Control.List(index), value Form 窗体名称或含有窗体名称的字符串变量 Control index var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 以 0 开始的列表数组索引的整数表达式 将含有属性值的整数变量 新属性值的字符串表达式 数值含有指定列表项目的字符串 备注 AddItem 为列表框或组合框列表添加项目之后, 可以 List 属性获取或编辑任一项目的值 设置空字符串可删除项目 ComboBox ListBox ListCount AddItem String part$ GGet frmmain.lstpartnames.list(0), part$ GUI Builder 7.0 (Ver.7.0) Rev.1 91

ListCount 属性 ListCount 属性 ListBox ComboBox 描述获取列表框或组合框中的项目计数 GGet Form.Control.ListCount, var Form 窗体名称或含有窗体名称的字符串变量 Control var 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的整数变量 数值 返回列表中的项目数量 ComboBox ListBox AddItem List Integer count GGet frmmain.lstpartnames.listcount, count 92 GUI Builder 7.0 (Ver.7.0) Rev.1

Load 事件 Load 事件 Form 描述首次显示窗体之前发生 Form_Load (Sernder$ As String) Sender$ 发送事件的窗体的名称 备注您可以此事件在为用户显示窗体之前执行任务 Form Resize Closed Function frmmain_load(sender$ As String) GSet frmmain.txtspeed.text, Str$(g_RobotSpeed) Fend GUI Builder 7.0 (Ver.7.0) Rev.1 93

MaximizeBox 属性 MaximizeBox 属性 Form 描述获取或设置表示是否在窗体标题栏显示最大化按钮的值 GGet Form.MaximizeBox, var GSet Form.MaximizeBox, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False 备注最大化按钮可户将窗体最大化为全屏 Form MinimizeBox GSet frmmain.maximizebox, True 94 GUI Builder 7.0 (Ver.7.0) Rev.1

MinimizeBox 属性 MinimizeBox 属性 Form 描述获取或设置表示是否在窗体标题栏显示最小化按钮的值 GGet Form.MinimizeBox, var GSet Form.MinimizeBox, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False 备注最小化按钮可户将窗体最小化为图标 Form MaximizeBox GSet frmmain.minimizebox, True GUI Builder 7.0 (Ver.7.0) Rev.1 95

MultiLine 属性 MultiLine 属性 TextBox 描述获取或设置表示是否为多行文本框控件的值 GGet Form.Control.MultiLine, var GSet Form.Control.MultiLine, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False 备注如果想要在文本框控件中显示多行, 则必须将 MultiLine 设为 1 True TextBox ScrollBars GSet frmmain.txtstatus.multiline, True 96 GUI Builder 7.0 (Ver.7.0) Rev.1

Name 属性 Name 属性 Form Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox Timer VideoBox LED 描述在运行时获取窗体或控件的名称 用于在设计时设置窗体或控件的名称 GGet Form.[Control].Name, var Form 窗体名称或含有窗体名称的字符串变量 Control var 控件名称或含有控件名称的字符串变量 将含有属性值的字符串变量 数值 含有窗体或控件名称的字符串 Form Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox Timer VideoBox LED String name$ GGet frmmain.btnok.name, name$ GUI Builder 7.0 (Ver.7.0) Rev.1 97

PasswordChar 属性 PasswordChar 属性 TextBox 描述获取或设置用于单行文本框控件中密码的掩码字符的字符 GGet Form.Control.PasswordChar, var GSet Form.Control.PasswordChar, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的字符串变量 新属性值的字符串表达式 数值 含有用于掩码字符的字符串 备注 PasswordChar 可隐藏密码的字符 用户输入字符时, 将显示 PasswordChar 注意 TextBox 控件的 Multiline 属性必须设为 0 False TextBox GSet frmmain.txtpassword.passwordchar, "*" 98 GUI Builder 7.0 (Ver.7.0) Rev.1

ReadOnly 属性 ReadOnly 属性 TextBox 描述获取或设置文本框控件是否为只读 GGet Form.Control.ReadOnly, var GSet Form.Control.ReadOnly, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False 备注该属性设为 1 True 时, 操作员将无法编辑文本框 TextBox GSet frmmain.txtspeed.readonly, True GUI Builder 7.0 (Ver.7.0) Rev.1 99

Resize 事件 Resize 事件 Form 描述重新调整窗体尺寸时发生 Form_Resize (Sernder$ As String) Sender$ 发送事件的窗体的名称 Form Load Closed Function frmmain_resize(sender$ As String) Integer width GGet frmmain.width, width GSet frmmain.btnok.left, width / 2-100 GSet frmmain.btncancel.left, width / 2 + 10 Fend 100 GUI Builder 7.0 (Ver.7.0) Rev.1

ScrollBars 属性 ScrollBars 属性 TextBox 描述获取或设置应出现在多行文本框控件上的滚动条 GGet Form.Control.ScrollBars, var GSet Form.Control.ScrollBars, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的整数变量 新属性值的整数表达式 数值 0 None 1 Horizontal 2 Vertical 3 Both 默认 :0 None 备注若要 ScrollBars, 文本框控件的 Multiline 属性必须设为 1 True 若要显示水平滚动条, 需将 WordWrap 属性设为 0 False TextBox Multiline WordWrap GSet frmmain.txtstatus.scrollbars, SCROLLBARS_VERT GUI Builder 7.0 (Ver.7.0) Rev.1 101

SelectedIndex 属性 SelectedIndex 属性 ListBox ComboBox 描述获取或设置 SelectedIndex 属性返回当前选定项目的索引 GGet Form.Control.SelectedIndex, var GSet Form.Control.SelectedIndex, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的整数变量 新属性值的整数表达式 数值 返回以 0 开始的选定项目索引 如果未选定项目, 则会返回 -1 备注 SelectedIndex 可确定用户在列表框或组合框中选定的项目 通常, 会在控件的 Click 事件中完成 AddItem ComboBox List ListBox Integer index GGet frmmain.lstparts.selectedindex, index 102 GUI Builder 7.0 (Ver.7.0) Rev.1

SizeMode 属性 SizeMode 属性 PictureBox 描述表示图像显示的方式 GGet Form.Control.SizeMode, var GSet Form.Control.SizeMode, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的整数变量 新属性值的整数表达式 数值 0 Normal 1 StretchImage 2 AutoSize 3 CenterImage 4 Zoom 默认 :0 Normal 备注默认情况下为 Normal 模式, 图像置于图片框的左上角, 并会剪掉图像对于图片框过大的所有部分 StretchImage 值可拉伸图像, 以适合图片框 AutoSize 值可调整控件尺寸, 使其始终适合图像 CenterImage 值可使图像居中于图片框 Zoom 值可拉伸图像, 使其适合保持相同屏幕比例的图片框 PictureBox Image ImageAlign GSet frmmain.piclogo.sizemode, SIZEMODE_AUTOSIZE GUI Builder 7.0 (Ver.7.0) Rev.1 103

Sorted 属性 Sorted 属性 ComboBox ListBox 描述获取或设置表示是否按字母顺序对组合框或列表框中的项目排序的值 排序顺序 : 数字字符 ( 不论是单字节或双字节 ) 字母符号 片假名 平假名 日语字符 GGet Form.Control.Sorted, var GSet Form.Control.Sorted, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False ComboBox ListBox GSet frmmain.lstparts.sorted, True 104 GUI Builder 7.0 (Ver.7.0) Rev.1

StartPosition 属性 StartPosition 属性 Form 描述获取或设置窗体运行时的启动位置 GGet Form.StartPosition, var GSet Form.StartPosition, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的整数变量 新属性值的整数表达式 数值 0 Manual 1 CenterScreen 2 CenterParent 默认 :1 CenterScreen Form WindowState GSet frmmain.startposition, STARTPOSITION_CENTERSCREEN GUI Builder 7.0 (Ver.7.0) Rev.1 105

TabIndex 属性 TabIndex 属性 Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox VideoBox LED 描述获取或设置容器内控件的选项卡顺序 GGet Form.Control.TabIndex, var GSet Form.Control.TabIndex, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值 控件选项卡顺序的索引 Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox VideoBox LED GSet frmmain.txtstatus.tabindex, 3 106 GUI Builder 7.0 (Ver.7.0) Rev.1

Text 属性 Text 属性 Form Button Label TextBox RadioButton CheckBox ComboBox GroupBox LED 描述获取或设置与控件相关的文本 GGet Form.[Control].Text, var GSet Form.[Control].Text, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的字符串变量 新属性值的字符串表达式 数值 含有窗体或控件文本的字符串 Form Button Label TextBox RadioButton Checkbox ComboBox GroupBox LED TextAlign GSet frmmain.lblname.text, "Name: " GUI Builder 7.0 (Ver.7.0) Rev.1 107

TextAlign 属性 TextAlign 属性 Button Label TextBox RadioButton CheckBox LED 描述获取或设置控件中的文本对齐 GGet Form.Control.TextAlign, var GSet Form.Control.TextAlign, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值对于按钮 标签 单选按钮 复选框控件 1 TopLeft 2 TopCenter 3 TopRight 4 MiddleLeft 5 MiddleCenter 6 MiddleRight 7 BottomLeft 8 BottomCenter 9 BottomRight 默认 : 1 TopLeft (Label 1) 4 MiddleLeft (RadioButton, CheckBox) 5 MiddleCenter (Button) 6 MiddleRight(LED) 对于文本框 1 Left 2 Center 3 Right 默认 :1 Left Button Label TextBox RadioButton Checkbox LED Text GSet frmmain.lblname.textalign, TEXTALIGN_LEFT 108 GUI Builder 7.0 (Ver.7.0) Rev.1

Tick 事件 Tick 事件 Timer 描述定时器控件达到间隔值时发生 Form_Control_Tick (Sernder$ As String) Sender$ 发送事件的控件的名称 Timer Interval Enabled Function frmmain_timer1_tick(sender$ As String) GSet frmmain.lbldatetime.text, Date$ + " " + Time$ Fend GUI Builder 7.0 (Ver.7.0) Rev.1 109

ToolTipText 属性 ToolTipText 属性 Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox VideoBox LED 描述用于在用户将鼠标指针放在控件上方时显示具有控件用途简介的小方形弹出窗口 GGet Form.Control.ToolTipText, var GSet Form.Control.ToolTipText, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的字符串变量 新属性值的字符串表达式 数值 含有控件工具提示文本的字符串 默认 : 空字符串 Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox VideoBox LED GSet frmmain.btnstart.tooltiptext, "Click Here to Start" 110 GUI Builder 7.0 (Ver.7.0) Rev.1

Top 属性 Top 属性 Form Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox VideoBox LED 描述获取或设置窗体或控件的顶坐标, 单位为像素 GGet Form.[Control].Top, var GSet Form.[Control].Top, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值 表示顶坐标的整数, 单位为像素 Form Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox VideoBox LED Left Height Width GSet frmmain.txtstatus.top, 200 GUI Builder 7.0 (Ver.7.0) Rev.1 111

Type 属性 Type 属性 All Controls 描述获取控件的类型名称 GGet Form.Control.Type, var Form 窗体名称或含有窗体名称的字符串变量 Control var 控件名称或含有控件名称的字符串变量 将含有属性值的字符串变量 数值 含有控件类型名称的字符串 Controls GGet frmmain.controls(index).type, typename$ 112 GUI Builder 7.0 (Ver.7.0) Rev.1

Update 属性 Update 属性 TextBox 描述获取或设置当文本框设为显示全局变量时是否自动更新文本框的值 GGet Form.Control.Update, var GSet Form.Control.Update, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :1 True 备注若要在文本框上显示 SPEL + 全局变量, 设置 Variable 属性中的全局变量名称 如果 Update 属性设为 0 False, 则不会更新全局变量值 TextBox Variable GSet frmmain.txtstatus.update, False GUI Builder 7.0 (Ver.7.0) Rev.1 113

Variable 属性 Variable 属性 TextBox 描述获取或设置用于文本框显示的 SPEL + 全局变量名称 GGet Form.Control.Variable, var GSet Form.Control.Variable, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的字符串变量 新属性值的字符串表达式 数值当前项目中 SPEL + 全局变量的名称 默认 :None 备注当 Variable 属性设为 SPEL + 全局变量时, 将在运行时自动更新 Text 值, 以显示变量值 TextBox GSet frmmain.txtstatus.variable, "g_status$" 114 GUI Builder 7.0 (Ver.7.0) Rev.1

VideoEnabled 属性 VideoEnabled 属性 VideoBox 描述获取或设置 VideoBox 是否显示视频 GGet Form.Control.VideoEnabled, var GSet Form.Control.VideoEnabled, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 0 False 1 True 默认 :0 False VideoBox GraphicsEnabled GSet frmmain.videobox1.videoenabled, True GUI Builder 7.0 (Ver.7.0) Rev.1 115

Visible 属性 Visible 属性 Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox VideoBox LED 描述获取或设置表示是否在运行时显示控件的值 GGet Form.Control.Visible, var GSet Form.Control.Visible, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 1 True 显示控件 0 False 不显示控件默认 :1 True Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox VideoBox LED Enabled GSet frmmain.txtstatus.visible, True 116 GUI Builder 7.0 (Ver.7.0) Rev.1

Width 属性 Width 属性 Form Button Label TextBox RadioButton CheckBox ListBox ComboBox PictureBox GroupBox1 VideoBox LED 描述获取或设置窗体或控件的宽度, 单位为像素 GGet Form.[Control].Width, var GSet Form.[Control].Width, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 将含有属性值的整数变量 新属性值的整数表达式 数值 表示宽度的整数, 单位为像素 Form Button Label TextBox RadioButton Checkbox ListBox ComboBox PictureBox GroupBox VideoBox LED Left Top Height GSet frmmain.txtstatus.width, 300 GUI Builder 7.0 (Ver.7.0) Rev.1 117

WindowState 属性 WindowState 属性 Form 描述获取或设置窗体的窗口状态 GGet Form.WindowState, var GSet Form.WindowState, value Form 窗体名称或含有窗体名称的字符串变量 var value 将含有属性值的整数变量 新属性值的整数表达式 数值 0 Normal 1 Minimized 2 Maximized 默认 :0 Normal Form GSet frmmain.windowstate, WINDOWSTATE_MAXIMIZED 118 GUI Builder 7.0 (Ver.7.0) Rev.1

WordWrap 属性 WordWrap 属性 TextBox 描述表示多行文本框控件是否在必要时自动换行至下一行的开始 GGet Form.Control.WordWrap, var GSet Form.Control.WordWrap, value Form 窗体名称或含有窗体名称的字符串变量 Control var value 控件名称或含有控件名称的字符串变量 控件必须位于指定窗体内 将含有属性值的 Boolean 变量 新属性值的 Boolean 表达式 数值 1 True : 多行文本框控件换行 0 False : 当用户的输入超过控件右侧边缘时, 文本框控件自动水平滚动 默认 :1 True TextBox Multiline ScrollBars GSet frmmain.txtstatus.wordwrap, True GUI Builder 7.0 (Ver.7.0) Rev.1 119

WordWrap 属性 120 GUI Builder 7.0 (Ver.7.0) Rev.1