EPSON RC+ 7.

0 Option

GUI Builder 7.0

Rev.6 EM221S5125F
EPSON RC+ 7.0 Option GUI Builder 7.0 Rev.6
EPSON RC+ 7.0 Option

GUI Builder 7.0

Rev.6

Copyright  2012-2022 SEIKO EPSON CORPORATION. All rights reserved.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 i

FOREWORD
Thank you for purchasing our robot products. This manual contains the information
necessary for the correct use of the EPSON RC+ software.
Please carefully read this manual and other related manuals when using this software.
Keep this manual in a handy location for easy access at all times.

The robot system and its optional parts are shipped to our customers only after being
subjected to the strictest quality controls, tests, and inspections to certify its compliance with
our high performance standards. Please note that the basic performance of the product will
not be exhibited if our robot system is used outside of the usage conditions and product
specifications described in the manuals.

This manual describes possible dangers and consequences that we can foresee. Be sure to
comply with safety precautions on this manual to use our robot system safety and correctly.

TRADEMARKS
Microsoft, Windows, and Windows logo are either registered trademarks or trademarks of
Microsoft Corporation in the United States and/or other countries. Other brand and product
names are trademarks or registered trademarks of the respective holders.

TRADEMARK NOTATION IN THIS MANUAL

Microsoft® Windows® 8 Operating system
Microsoft® Windows® 10 Operating system
Throughout this manual, Windows 8 and Windows 10 refer to above respective operating
systems. In some cases, Windows refers generically to Windows 8 and Windows 10.
NOTICE
No part of this manual may be copied or reproduced without authorization.
The contents of this manual are subject to change without notice.
Please notify us if you should find any errors in this manual or if you have any comments
regarding its contents.

MANUFACTURER

CONTACT INFORMATION
Contact information is described in “SUPPLIERS” in the first pages of the following
manual:
Robot System Safety Manual Read this manual first

ii EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Table of Contents

1. Introduction ......................................................................... 1
1.1 Features........................................................................................1

2. Installation ........................................................................... 1

3. Getting Started ....................................................................... 2

3.1 GUI Builder Tutorial ......................................................................2

4. The GUI Builder Environment ............................................... 7

4.1 Overview .......................................................................................7
4.2 Basic Concepts Required to Understand GUI Builder .................7
4.3 Open the GUI Builder Window .....................................................8
4.4 Parts of the GUI Builder Window..................................................8
4.4.1 Design Area ..........................................................................8
4.4.2 Toolbar .................................................................................9
4.4.3 Forms Explorer ...................................................................10
4.4.4 Property Grid ......................................................................10
4.4.5 Events Grid .........................................................................10
4.5 Working with Forms and Controls ..............................................10
4.5.1 Creating a Form .................................................................10
4.5.2 Deleting a Form ..................................................................10
4.5.3 Opening and Closing Forms ..............................................11
4.5.4 Changing the Size of a Form .............................................11
4.5.5 Editing Multiple Forms ........................................................11
4.5.6 Creating Controls ...............................................................11
4.5.7 Deleting Controls ................................................................11
4.5.8 Sizing and Moving Controls ...............................................12
4.5.9 Copy, Cut, Paste for Controls ............................................12
4.5.10 Editing Properties .............................................................12
4.5.11 Working with Event Handlers ...........................................13
4.5.12 Changing Tab Order ........................................................14
4.5.13 Saving Your Work ............................................................14
4.6 Setting GUI Builder Preferences ................................................15
4.7 Importing forms from other projects ...........................................16

5. GUI Builder Components ..................................................... 17

5.1 Form............................................................................................17
5.1.1 Description..........................................................................17
5.1.2 Usage .................................................................................17
5.1.3 Form Properties..................................................................18
5.1.4 Form Events .......................................................................19
EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 iii
Table of Contents

5.2 Button Control ............................................................................ 19

5.2.1 Description ......................................................................... 19
5.2.2 Usage ................................................................................. 19
5.2.3 Button Control Properties................................................... 19
5.2.4 Button Control Events ........................................................ 20
5.3 Label Control .............................................................................. 21
5.3.1 Description ......................................................................... 21
5.3.2 Usage ................................................................................. 21
5.3.3 Label Control Properties .................................................... 21
5.3.4 Label Control Events .......................................................... 22
5.4 TextBox Control.......................................................................... 23
5.4.1 Description ......................................................................... 23
5.4.2 Usage ................................................................................. 23
5.4.3 TextBox Control Properties ................................................ 23
5.4.4 TextBox Control Events ..................................................... 24
5.5 RadioButton Control ................................................................... 25
5.5.1 Description ......................................................................... 25
5.5.2 Usage ................................................................................. 25
5.5.3 RadioButton Control Properties ......................................... 26
5.5.4 RadioButton Control Events............................................... 27
5.6 CheckBox Control ...................................................................... 27
5.6.1 Description ......................................................................... 27
5.6.2 Usage ................................................................................. 27
5.6.3 CheckBox Control Properties............................................. 27
5.6.4 CheckBox Control Events .................................................. 28
5.7 ListBox Control ........................................................................... 29
5.7.1 Description ......................................................................... 29
5.7.2 Usage ................................................................................. 29
5.7.3 ListBox Control Properties ................................................. 30
5.7.4 ListBox Control Events ....................................................... 30
5.8 ComboBox Control ..................................................................... 31
5.8.1 Description ......................................................................... 31
5.8.2 Usage ................................................................................. 31
5.8.3 ComboBox Control Properties ........................................... 32
5.8.4 ComboBox Control Events................................................. 33
5.9 PictureBox Control ..................................................................... 33
5.9.1 Description ......................................................................... 33
5.9.2 Usage ................................................................................. 33
5.9.3 PictureBox Control Properties ........................................... 33
5.9.4 PictureBox Control Events ................................................. 34
iv EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6
 Table of Contents

5.10 GroupBox Control .....................................................................35

5.10.1 Description........................................................................35
5.10.2 Usage ...............................................................................35
5.10.3 GroupBox Control Properties ...........................................35
5.10.4 GroupBox Control Events ................................................36
5.11 Timer Control ............................................................................37
5.11.1 Description........................................................................37
5.11.2 Usage ...............................................................................37
5.11.3 Timer Control Properties ..................................................37
5.11.4 Timer Control Events........................................................37
5.12 VideoBox Control......................................................................38
5.12.1 Description........................................................................38
5.12.2 Usage ...............................................................................38
5.12.3 VideoBox Control Properties ............................................38
5.12.4 VideoBox Control Events .................................................39
5.13 LED Control ..............................................................................40
5.13.1 Description........................................................................40
5.13.2 Usage ...............................................................................40
5.13.3 LED Control Properties ....................................................40
5.13.4 LED Control Events ..........................................................41
5.14 StatusBar Control .....................................................................42
5.14.1 Description ......................................................................42
5.14.2 Usage ..............................................................................42
5.14.3 StatusBar Control Properties ..........................................42
5.14.4 StatusBar Control Events ................................................43
5.15 ProgressBar Control .................................................................44
5.15.1 Description ......................................................................44
5.15.2 Usage ..............................................................................44
5.15.3 ProgressBar Control Properties ......................................44
5.15.4 ProgressBar Control Events............................................45
5.16 TrackBar Control ......................................................................46
5.16.1 Description ......................................................................46
5.16.2 Usage ..............................................................................46
5.16.3 TrackBar Control Properties............................................46
5.16.4 TrackBar Control Events .................................................47
5.17 Grid Control .........................................................................48
5.17.1 Description ......................................................................48
5.17.2 Usage ..............................................................................48
5.17.3 Grid Control Properties ...................................................48
5.17.4 Grid Control Events .........................................................49
EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 v
Table of Contents

5.17.5 GridEditor ........................................................................ 49

6. Operation ............................................................................. 50
6.1 Overview..................................................................................... 50
6.2 GUI Development in Program Mode .......................................... 50
6.2.1 Design the GUI................................................................... 50
6.2.2 Debugging .......................................................................... 51
6.3 Auto Mode .................................................................................. 51
6.4 Handling Pause and Continue ................................................... 52
6.5 Handling Emergency Stop ......................................................... 52
6.6 Using a Help File ........................................................................ 52

7. GUI Builder Reference ........................................................ 53

7.1 Overview..................................................................................... 53
7.2 GUI Builder Properties and Events Format Description ............ 53
AcceptButton Property ................................................................ 54
AddItem Property ........................................................................ 55
AddRow Property ........................................................................ 56
AppendText Property .................................................................. 57
AllowStateChange Property ........................................................ 58
BackColor Property ..................................................................... 59
BackColorMode Property ............................................................ 60
BorderStyle Property ................................................................... 61
Camera Property ......................................................................... 62
CancelButton Property ................................................................ 63
CellBackColor Property ............................................................... 64
CellChanged Event ..................................................................... 65
CellForeColor Property ............................................................... 66
CellText Property ........................................................................ 67
Checked Property ....................................................................... 68
Click Event .................................................................................. 69
Closed Event ............................................................................... 70
ControlBox Property .................................................................... 71
Controls Property ........................................................................ 72
Count Property ............................................................................ 73
DblClick Event ............................................................................. 74
DialogResult Property ................................................................. 75
Dock Property.............................................................................. 76
DropDownStyle Property............................................................. 77
Enabled Property ........................................................................ 78

vi EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Table of Contents

EventTaskType Property .............................................................79

Font Property ...............................................................................80
FontBold Property........................................................................81
FontItalic Property .......................................................................82
FontName Property .....................................................................83
FontSize Property ........................................................................84
ForeColor Property ......................................................................85
FormBorderStyle Property...........................................................86
GClose Statement .......................................................................87
GGet Statement...........................................................................88
GraphicsEnabled Property ..........................................................89
GridEditor Property ......................................................................90
GSet Statement ...........................................................................92
GShow Statement .......................................................................93
GShowDialog Function................................................................94
GShowDialog Statement .............................................................95
Height Property............................................................................96
HelpButton Property ....................................................................97
HelpID Property ...........................................................................98
Image Property ............................................................................99
ImageAlign Property ................................................................. 100
ImageOff Property .................................................................... 101
ImageOn Property .................................................................... 102
Interval Property ....................................................................... 103
IOBit Property ........................................................................... 104
IOType Property ....................................................................... 105
KeyPress Event ........................................................................ 106
LargeChange Property ............................................................. 107
Left Property ............................................................................. 108
List Property ............................................................................. 109
ListCount Property .................................................................... 110
Load Event ............................................................................... 111
MaximizeBox Property ............................................................. 112
Maximum Property ................................................................... 113
MinimizeBox Property .............................................................. 114
Minimum Property .................................................................... 115
MultiLine Property..................................................................... 116
Name Property ......................................................................... 117
Orientation Property ................................................................. 118
PasswordChar Property ........................................................... 119
EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 vii
Table of Contents

ProgressBarStyle Property ....................................................... 120

ReadOnly Property................................................................... 121
RemoveRow Property ............................................................... 122
Resize Event ............................................................................. 123
RobotNumber Property ............................................................. 124
RowCount Property ................................................................... 125
Scroll Event ............................................................................... 126
ScrollBars Property ................................................................... 127
SelectedIndex Property ............................................................. 128
ShowDateTime Property ........................................................... 129
ShowEStop Property ................................................................. 130
ShowPrint Property ................................................................... 131
ShowRobot Property ................................................................. 132
ShowSafeguard Property .......................................................... 133
SizeMode Property.................................................................... 134
SmallChange Property .............................................................. 135
Sorted Property ......................................................................... 136
StartPosition Property ............................................................... 137
Step Property ............................................................................ 138
TabIndex Property..................................................................... 139
Text Property ............................................................................. 140
TextAlign Property..................................................................... 141
Tick Event..................................................................................142
TickFrequency Property ............................................................ 143
TickStyle Property ..................................................................... 144
ToolTipText Property................................................................. 145
Top Property.............................................................................. 146
Type Property ............................................................................ 147
Update Property ........................................................................ 148
Value Property........................................................................... 149
Variable Property ...................................................................... 150
VideoEnabled Property ............................................................. 151
Visible Property ......................................................................... 152
Width Property........................................................................... 153
WindowState Property .............................................................. 154
WordWrap Property .................................................................. 155

viii EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 1. Introduction

1. Introduction
The EPSON RC+ GUI Builder 7.0 Option enables you create a GUI (Graphical User
Interface) for your SPEL+ application. The design goal for GUI Builder was to create an
easy to use integrated tool for creating a SPEL+ application GUI in the EPSON RC+
development environment. It is ideal for users that need a simple GUI and do not want to
use a third party product such as Visual Studio. Even users that never created a GUI
before can easily make one with GUI Builder.
NOTE For advanced GUI applications, you may want to consider using the EPSON RC+ 7.0
 RC+ API option along with Visual Studio or another tool that can interface with the VB
Guide .NET libraries.

1.1 Features
The following features are supported in the GUI Builder 7.0 package:
Your GUI is integrated completely within the EPSON RC+ environment for easy design,
debugging, and display at runtime. No third party tools are required.
You can create and debug GUI forms in your EPSON RC+ project.
Several standard controls are provided, including button, label, textbox, etc. In addition,
controls are provided for displaying video, variable status, and I/O status.
Form and control events are executed as SPEL+ tasks. You can specify whether these
task run in Normal, NoPause, or NoEmgAbort modes.
In Auto mode, EPSON RC+ can automatically display your main form at startup, or you
can show forms from your SPEL+ code.

2. Installation
Please follow the instructions in this chapter to help ensure proper installation of the GUI
Builder 7.0 software.
Before starting, ensure that all Windows applications have been closed.

To install GUI Builder:

1. Install EPSON RC+ 7.0. The GUI Builder option is automatically installed.
2. Ensure that the software key has been enabled for GUI Builder 7.0 in the controller
you will be using. Refer to the EPSON RC+ 7.0 User’s Guide for information on how
to enable options in the controller.
This completes the GUI Builder 7.0 installation.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 1

3. Getting Started

3. Getting Started
This chapter contains information for getting started with GUI Builder 7.0.
Before continuing, ensure that the GUI Builder option is enabled. See the Installation
chapter for details.
If you have never used EPSON RC+ before, you should read the EPSON RC+ 7.0 User's
Guide to get familiar with creating projects and programs.
The following section presents a tutorial illustrating some simple concepts.

3.1 GUI Builder Tutorial

In this section we will create a simple GUI application that runs a robot cycle.
We will walk through the following tasks:
- Create a new EPSON RC+ project with a function to run the robot cycle.
- Create a form with Start and Stop buttons to run the robot cycle. This shows how
to create a form and add buttons with events to start and stop a SPEL+ task.
- Add Pause and Continue buttons to the form. This shows the use of the
EventTaskType property.
- Add a setup form. This form will use the Label and TextBox controls to allow the
user to change robot speeds.
- Add a button on the main form to display the setup form. This shows the use of
the GShowDialog statement and the DialogResult property.
Follow these steps:
1 Create a new EPSON RC+ 7.0 project called GUITest.
2. Using the Robot Manager, teach two robot points P0 and P1 in two different
positions.
3. Add code to function main in Main.prg as shown below:

Function main
Robot1
Motor On
Do
Go P0
Wait 0.5
Go P1
Wait 0.5
Loop
Fend
4. Select Tools | GUI Builder to open the GUI Builder window.
5. Click the New Form button on the GUI Builder window toolbar to create a form and
name it frmMain. Click the OK button.

6. Click the New Button button on the GUI Builder window toolbar click the mouse on
the form. A new button will be created.

2 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 3. Getting Started

7. In the Property Grid, scroll down to the Name property, then change the name to
btnStart and press ENTER.

8. In the Property Grid, scroll down to the Text property, then change the text from
Button1 to Start and press ENTER.

9. Double click on the Start button on your form. A new program window named
frmMain.prg will be opened with a new function for the button click event handler.

10. Change the frmMain_btnStart_Click function to start the main task as shown below.
This will cause the main function to start when the user clicks the Start button.

Function frmMain_btnStart_Click(Sender$ As String)

Xqt main
Fend
11. Click the New Button button on the GUI Builder window toolbar, then click on the
form under the Start button to create another button.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 3

3. Getting Started

12. For the new button, change the Name property to btnStop, and change the Text
property to Stop. At this point, your form should look as shown below:

13. Double click the Stop button to create the button click event handler. Then change
the code as shown below:

Function frmMain_btnStop_Click(Sender$ As String)

Quit main
Fend
14. Press F5 to build the project and display the Run Window. If any build errors occur,
correct your code and press F5 again.
15. Select the Form radio button on the Run Window.
16. Click the Start button on the Run Window.
17. frmMain will be displayed. Click the Start button on frmMain. The robot should
now be moving between P0 and P1.
18. Click the Stop button on your form. The robot task will stop.
19. Now click the X button in the upper right of your form. The form will close.

We will now add Pause and Continue buttons to our GUI.

20. Show the GUI Builder window again by clicking on the GUI Builder toobar button.
21. Click the New Button button on the GUI Builder window toolbar and click the form
to the right of the Start button to create a new button.
22. For the new button, change the Name property to btnPause, and change the Text
property to Pause.
23. Change the EventTaskType for the Pause button to 1 – NoPause. This allows the
button click event handler to execute the Pause statement without pausing the task
itself.
24. Double click the Pause button to create an event handler function. Then change the
code by adding the Pause statement as shown below:

Function frmMain_btnPause_Click(Sender$ As String)

Pause
Fend
25. Click the New Button button on the GUI Builder window toolbar and click the form
to the right of the Stop button to create a new button.
26. For the new button, change the Name property to "btnCont", and change the Text
property to "Continue".

4 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 3. Getting Started

27. Change the EventTaskType for the Continue button to 1 – NoPause. This allows the
button click event handler to execute the Cont statement when normal tasks are
paused.
28. Double click the Continue button to create an event handler function. Then change
the code by adding the Cont statement as shown below:

Function frmMain_btnCont_Click(Sender$ As String)

Cont
Fend
29. Press F5 to build the project and open the Run Window. If any build errors occur,
correct your code and press F5 again.
30. Click the Start button on the Run Window. Your form will be displayed.
31. Click the Start button on your form. The robot cycle will execute.
32. Click the Pause button on your form. The robot cycle will pause.
33. Click the Continue button on your form. The robot cycle will continue.
34. Click the Stop button on your form, then close the form by clicking the X button in
the upper right corner.

We will now add a setup form to our GUI.

35. Click the New Form button the GUI Builder window toolbar and name the new form
frmSetup, then click OK. A new tab page will be opened showing the new form.
36. Click the New Label button and click on frmSetup to create a label.
37. In the Property Grid, change the name of the new label to "lblSpeed".
38. Change the Text property to "Speed:".
39. Click the New TextBox button and click on frmSetup to the right of the Speed label.
40 Change the Name property to "txtSpeed" and change the Text property to "10".
41. Double click on frmSetup to create the Load event handler function for the form and
change the code as shown below:

Function frmSetup_Load(Sender$ As String)

GSet frmSetup.txtSpeed.Text, Str$(Speed(1))
Fend
42. Click the New Button button on the GUI Builder window toolbar and click the form
to add the button. Name this button "btnOK" and set the Text property to "OK".
43. Click the New Button button on the GUI Builder window toolbar and click the form
to add the button. Name this button "btnCancel" and set the Text property to
"Cancel". At this point, you setup form should look similar to the one shown below:

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 5

3. Getting Started

44. Double click the OK button to create an event handler function. Then change the
code to set the form's DialogResult property and call GClose as shown below:

Function frmSetup_btnOK_Click(Sender$ As String)

GSet frmSetup.DialogResult, DIALOGRESULT_OK
GClose frmSetup
Fend
45. Double click the Cancel button to create an event handler function. Then change the
code to set the form's DialogResult property and call GClose as shown below:

Function frmSetup_btnCancel_Click(Sender$ As String)

GSet frmSetup.DialogResult, DIALOGRESULT_CANCEL
GClose frmSetup
Fend
46. Click the frmMain tab to work with frmMain again.
47. Click the New Button button on the GUI Builder window toolbar and click the form
to add the button. Name this button "btnSetup" and set the Text property to "Setup".
48. Double click the Setup button to create an event handler function. Then change the
code to show the setup dialog and set the new robot speed as shown below:

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. Press F5 to build the project and open the Run Window.
50. Click the Start button on the Run Window. The main form will be displayed.
51. Click the Setup button on the main form. The setup dialog will be displayed with the
current robot speed in the textbox.
52. Enter a new speed and click OK.
53. Click the Start button on the main form to run the robot cycle at the new speed.
If the Stop button is clicked and the robot stops, the motion speed will be reset to the
default.
54. This completes the tutorial.

6 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 4. The GUI Builder Environment

4. The GUI Builder Environment

4.1 Overview
In this chapter we will focus on some concepts and definitions so you can gain a complete
understanding of GUI Builder and its components. We will cover the following topics:
- Basic concepts which you should understand to use GUI Builder
- How to open the GUI Builder window
- Parts of the GUI Builder window
- How to work with forms and controls
- Setting GUI Builder preferences

4.2 Basic Concepts Required to Understand GUI Builder

A quick explanation of some of the basic concepts will help you understand this chapter
much better. Please review the concepts described below before proceeding through the
rest of this chapter.
What is a GUI?
GUI stands for Graphical User Interface. A GUI allows your operators to easily interact
with your SPEL+ application to run cycles or perform setup functions. The basic building
block for your GUI is the Form.

What is a Form?
A form is a window or dialog box that contains controls. It is the basic unit of your GUI
application. When a form is displayed at runtime, the controls on the form are active and
ready to receive keyboard and mouse events from the user. Your GUI project can have
just one form or several forms.

What is a Control?
Controls are objects that are contained within a form, such as buttons, checkboxes,
textboxes, etc. Each type of control has its own set of properties and events.

What is an Event?
An event is a SPEL+ function created by you that is called by the GUI when a form or
control event occurs. For example, when the user clicks a button control, the button click
event can call the SPEL+ function that you designated to run when the click occurs.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 7

4. The GUI Builder Environment

4.3 Open the GUI Builder Window

The GUI Builder window is opened from within the EPSON RC+ development
environment. After EPSON RC+ has been started, the GUI Builder window can be
opened in 2 different ways:
From the main Toolbar: From the main toolbar in EPSON RC+ you should see the GUI
Builder icon . Clicking on the GUI Builder icon will open
the GUI Builder window.
From the Tools menu: Selecting GUI Builder from the Tools menu will open the GUI
Builder window.
Once the GUI Builder window is open you can now begin using GUI Builder to design
your GUI application. The next few pages describe the basic parts of the GUI Builder
window.

4.4 Parts of the GUI Builder Window

The GUI Builder window is shown below. Each of the indicated parts are described in the
following sections.

Tool Bar

Forms Explorer

Property Grid
Design Area

Events Grid

4.4.1 Design Area

This is where your forms are displayed at design time. Each opened form is displayed on
its own tab. You can easily switch between forms by clicking on the associated tab or by
double clicking the form in the Forms Explorer. If a form is larger than the design area,
then scroll bars will be displayed and you can scroll to access all areas of the form.

8 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 4. The GUI Builder Environment

4.4.2 Toolbar
The toolbar contains buttons for creating forms and controls. The GUI Builder toolbar is
located at the top of the GUI Builder window just below the title bar and appears as
follows:

TheGUI Builder Toolbar

Shown below are general descriptions for each of the GUI Builder toolbar buttons.

Button Description
New form: Creates a new form. A dialog pops up and the user is asked to
enter the name for the new form.
Delete Form: Deletes a form in the current project. This button is dimmed if
there are no forms for the current project.
Pointer: Click this button to abort the addition of a new control.

New Button: Creates a new button control.

New Label: Creates a new label control used to display static text.

New TextBox: Creates a new textbox control that allows operators to input
text.
New RadioButton: Creates a new radio button control.

New CheckBox: Creates a new checkbox control

New ListBox: Creates a new listbox control.

New ComboBox: Creates a new combobox control.

New Grid: Creates a new grid control.

New PictureBox: Creates a new picturebox.

New GroupBox: Creates a new groupbox control.

New StatusBar: Creates a new status bar control.

New ProgressBar: Creates a new progress bar control.

New TrackBar: Creates a new track bar control.

New Timer: Creates a new timer control.

New VideoBox: Creates a new videobox control. This control allows you to
display video for Vision Guide operations.
New LED: Creates a new LED control. This control allows you to display I/O
status. You can optionally allow the operator to double click on the control to
change output status. The control can use built-in pictures with various colors,
or you can use your own images for off and on status.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 9

4. The GUI Builder Environment

4.4.3 Forms Explorer

The Forms Explorer is a tree that contains each form for the current project and its associated
controls. When a new form or control is created, it is added to the tree.
Double-clicking on a form opens the form in its own tab in the design area. The properties
and events for the form are displayed. Right click on a form to open a menu to set the start
form, delete the form, or close it.
Clicking on a control in the tree activates its associated form and sets the current design
focus on the control. The properties and events for the control are then displayed

4.4.4 Property Grid

The Property Grid is used to display and edit form and control properties. When you select
a form or control, the associated properties are displayed in the grid. There are two columns:
Property and Value. Property is the name of the property. Value is the current value that
you can edit.

4.4.5 Events Grid

The Events Grid is used to display and change the events for the associated form or control.
Each event has a user function that is called when the event occurs.

4.5 Working with Forms and Controls

4.5.1 Creating a Form
To create a form:
1. Open the GUI Builder window.
2. Click on the New Form button on the toolbar.

3. Type a name for the form. You may want to use a name starting with "frm" as the
prefix. Form the New Form dialog, you can optionally copy another form by selecting it
from the Copy from existing form list.

4.5.2 Deleting a Form

To delete a form, right click on the form in the Forms Explorer, then select Delete. A
confirmation message will be displayed. Click Yes to delete the form. Also, you can use
the following methods.
- Click on the <Delete Form> button on the tool bar
- Right click on the form tab, then select Delete.

10 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 4. The GUI Builder Environment

4.5.3 Opening and Closing Forms

To open a form, double click on the form in the Forms Explorer.
To close a form, right click on the form in Forms Explorer and select Close, or right click
on the form tab and select Close.

4.5.4 Changing the Size of a Form

You can change the size of a form using two methods:
- Use the mouse to drag one of the form size handles in the GUI Builder window
design area.
- Change the Height and Width properties in the Property Grid at design time or using
GSet at runtime.

4.5.5 Editing Multiple Forms

The GUI Builder window allows you to work with multiple forms using a tab interface.
You can switch between currently open forms by click on the corresponding tab.

You can copy controls from one form and paste them in another form.

4.5.6 Creating Controls

To create a control
1. Open the form to which you want to add a control.
2. Click on the control button on the GUI Builder window toolbar. A cross cursor will
be displayed.
3. You can simple click on the form near the location where you want the control and
the control will be created with the default size. Or, you can use the mouse to draw
an outline of the control size on the form and release the mouse to create the control
using the size of the outline.

4.5.7 Deleting Controls

To delete a control
1. Open the form from which you want to delete one or more controls.
2. Click on the control you want to delete. To select more controls, hold down the Ctrl
or Shift key and click on each additional control.
3. Press the Del key on the keyboard. The controls will be deleted.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 11

4. The GUI Builder Environment

4.5.8 Sizing and Moving Controls

To change the size of a control
- Use the mouse to drag one of the control's size handles in the GUI Builder window
design area.
- Change the Height and Width properties in the Property Grid at design time or using
GSet at runtime.
To move a control

- Click the control to activate it, then release the mouse. A move cursor is now
displayed when the mouse is over the control. Click and drag the control to its new
position.
- Change the Left and Top properties in the Property Grid at design time, or use GSet
at runtime to change the Left and Top properties.

4.5.9 Copy, Cut, Paste for Controls

Selecting controls for copy or cut
First, click on one control. To select more controls, hold down the Ctrl or Shift key and
click on each additional control. The selected controls are indicated by white (first
control) and black size handles.
Copy selected controls
To copy the selected controls, type Ctrl+C, or click the Copy button on the main toolbar,
or select Copy from the Edit menu.
Cut selected controls
To cut the selected controls, type Ctrl+X, or click the Cut button on the main toolbar, or
select Cut from the Edit menu.
Pasting controls
To paste controls that have been copied or cut, type Ctrl+V, or click the Paste button on
the main toolbar, or select Paste from the Edit menu.

4.5.10 Editing Properties

To edit properties, first click on the form or control to display the associated properties in
the Property Grid.
For properties that require text input
Click on the property to change in the Property Grid. Then type in the new value and
press Enter or select another property row to apply the change.
For properties that provide a dropdown list of values
Click on the property to change in the Property Grid. Click the down arrow button on the
right side of the value. Select the new value from the dropdown list. The change is
applied after you make the selection.
For properties that provide a button for selecting values
Click on the property to change in the Property Grid. Click the ellipses button on the right
side of the value. Select the new value(s) from the dialog. The change is applied after you
make the selection or click OK on the dialog.

12 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 4. The GUI Builder Environment

4.5.11 Working with Event Handlers

Event handlers are SPEL+ functions with the correct parameters for the specified event.
Event handler functions can be in any SPEL+ program file in the current project. By
default, event handlers are created in a program file that is created for a form. For
example, when you create an event handler for a Button control Click event, a form
program file is created first if it does not already exist, then the function is added to the
file.
To create an event handler
There are three ways to create an event handler
- Double click on the form or control to create the default event handler. For example, if
you double click on a Button control, the Click event handler function is created.
- In the Events grid, double click on the event name.
- In the Events grid, select a function that already exists in the project in the value
dropdown list for the event. Only functions with the correct parameters are shown in the
list.
To change an event handler
You can change the event handler function by selecting another function in the event value
dropdown list.

To disable an event handler

Sometimes after creating an event handler, you may decide that it is no longer needed. To
disable the event handler, select (None) in the event value dropdown list. The associated
function is not deleted. But it will not be called when the event occurs.

Using EventTaskType
When an event occurs, the event handler function is started as a SPEL+ task.
The EventTaskType property lets you specify which type of task will be executed. This is
important for events that need to execute in a pause condition or emergency stop
condition.
For example, if a button click event handler will execute Pause or Cont, the
EventTaskType must be set to 1 – NoPause. Or if an event handler must execute Reset
during an emergency stop condition, then the EventTaskType must be set to 2 –
NoEmgAbort.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 13

4. The GUI Builder Environment

4.5.12 Changing Tab Order

After adding controls to a form, you may want to change the tab order. This is the order
that focus is set when the user types Tab at runtime. It is also important to set the tab
order of labels using hotkeys to be one tab index before the control that is being labeled.
To change tab order
1. Open the form for which you want to change the tab order.
2. Type the Tab key. The tab order will be displayed as shown below:

3. Click on each tab order value in the order you want.

4. Type the Tab key again to hide the tab order.

4.5.13 Saving Your Work

After making changes in the GUI Builder window, you can save your work using two
methods:
- From the File menu, select Save, or type Ctrl+S.
- Click the Project Save toolbar button on the EPSON RC+ main toolbar.

14 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 4. The GUI Builder Environment

4.6 Setting GUI Builder Preferences

You can change how controls are managed on the forms in the GUI Builder window
design area by setting the GUI Builder preferences.
Select the Setup menu | Preferences | GUI Builder.

When the Layout Mode is set to Snap Lines, GUI Builder shows line segments around the
controls as you move them around the form.

Snap Lines

When Layout Mode is set to Snap To Grid, a grid is displayed on each form, and when
you move a control on the form, it snaps to each grid location.

To change the size of the grid, change the Grid Width and Grid Height values and click
Apply.
When you change GUI Builder preferences and click Apply, if the GUI Builder window
is open, the current changes will be saved and the window will be re-opened to use the
new preferences.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 15

4. The GUI Builder Environment

4.7 Importing forms from other projects

You can import GUI Builder forms from other projects using the File | Import menu.
1. Select File | Import.
2. Navigate to the desired project folder to import from and select the GUI Builder file
type.

3. Select the GUI file name and click Open.

4. A dialog will appear that has a list of forms in the project you are importing from.

5. Select one or more forms you want to import, then click OK.
6. The selected forms will be added to the current project. If a form already existed, you
will be prompted whether to overwrite it or not.

16 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

5. GUI Builder Components

This chapter describes the Form and all of the controls that can be used on a Form. Each
component section has information on usage and all properties and events associated with
the component.
For more details on properties, events, and statements, refer to the GUI Builder Reference
chapter.

5.1 Form
5.1.1 Description
The Form is the basic building block of your GUI application. It allows you to display a
window or dialog box with controls for user interaction. Your GUI application can have
one form or many forms.

5.1.2 Usage
Displaying a form
A Form can be displayed in three ways:
1. If the Form is set as the startup form, then in auto mode when the system starts, it is
displayed automatically. To set the startup form, right click on the form in the Forms
Explorer, then select Startup Form, as shown below:

A form is shown in bold to indicate it is the startup form. You can also set the
startup form for your project from Project | Properties | GUI Builder.
2. Using the GShowDialog function. This displays the form as a dialog box and returns
the DialogResult value.

result = GShowDialog(frmSetSpeed)

Typically, the DialogResult value is set by buttons on the form, such as an OK button
and a Cancel button.
3. Using the GShow statement. This displays the form as a window.

GShow frmIODiags

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 17

5. GUI Builder Components

Setting Form Appearance

Set the FormBorderStyle property. For forms used as dialogs, you should use 3 –
FixedDialog.
Set ControlBox, MaximizeBox, MinimizeBox to configure the form's title bar.
Set the WindowState to show the form as Normal size, Maximized, or Minimized when it
is displayed.
Using Help
You can display help topics from your own help file by setting the HelpButton property to
True and the HelpID property to a topic ID in the help file.
For the details, refer to 6.6 Using a Help File.

5.1.3 Form Properties

Property Description
AcceptButton Sets the button control whose click event executes when the user
types Enter.
Default: None
BackColor Sets the background color for the form.
Default: Control
CancelButton Sets the button control shoes click event executes when the user
types Esc. After executed, the form closes.
Default: None
ControlBox Sets whether the title bar control box items are displayed.
Default: 1 – True
Controls Array of controls on the form.
Count Gets the number of controls in the Controls array.
Dialog Result Sets the return value when the form is closed (runtime only).
EventTaskType Sets the type of task used for events.
Default: 0 – Normal
FormBorderStyle Sets the style of the border used for the form.
Default: 3 – FixedDialog
Height Sets the height of the control in pixels.
HelpButton Sets whether the title bar help button is displayed.
Default: 0 – False
HelpID Sets the ID for the help topic that is displayed when the user clicks
the title bar help button
Default: 0
Left Sets the left coordinate of the form in pixels.
MaximizeBox Sets whether the title bar maximize button is displayed.
Default: 0 – False
MinimizeBox Sets whether the title bar minimize button is displayed.
Default: 0 – False
Name Sets the name of the control.
StartPosition Sets the start position of the form.
Default: 1 - CenterScreen

18 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

Property Description
Text Used to set the text of the control.
Default: Name of form
Top Gets or sets the top coordinate of the form in pixels.
Type Gets the type name of the control.
Width Sets the width of the form in pixels.
WindowState Sets the default window state for the form.
Default: 0 - Normal

5.1.4 Form Events

Event Description
Closed Executes after the form is closed.
Load Executes when the form loads.
Resize Executes when the form is resized.

5.2 Button Control

5.2.1 Description
The Button control allows the user to click it to perform an action. The Button control can
display both text and images. When the button is clicked, it looks as if it is being pushed in
and released.

5.2.2 Usage
Button controls allow the operator to initiate some action by clicking with the mouse.
You can change the look of a button using several properties, such as ForeColor (used for
the button text), BackColor, Font, TextAlign, Image, and ImageAlign.
You must provide a click event function to determine whether the operator clicked the
button, and then take some action in the event handler.

5.2.3 Button Control Properties

Property Description
BackColor The background color for the control.
Default: Control
BackColorMode The background color mode for the control.
Default: 0 – Visual Style
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
Font The font for the control text (design time only).
Default: Microsoft Sans Serif 8.25 pt
FontBold The bold attribute for the current font (runtime only).
Default: 0 - False

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 19

5. GUI Builder Components

Property Description
FontItalic The italic attribute for the current font (runtime only).
Default: 0 - False
FontName The name for the current font (runtime only).
Default: Microsoft Sans Serif
FontSize The size for the current font in points (runtime only).
Default: 8.25
ForeColor The foreground color for the control text.
Default: ControlText
Height The height of the control in pixels.
Image The picture for the control. To delete, press the <Delete> key.
Default: Empty
ImageAlign The picture alignment for the control.
Default: 5 – MiddleCenter
Left The left coordinate of the control in pixels.
Name The name of the control.
Default: ButtonXX
TabIndex The tab index of the control.
Text The text of the control.
Default: Name of control
TextAlign Selects the text alignment.
Default: 5 – MiddleCenter
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

5.2.4 Button Control Events

Event Description
Click Executes when the user clicks the control with the mouse.

20 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

5.3 Label Control

5.3.1 Description
Label controls are used to display text or images that cannot be edited by the user. They
are used to identify objects on a form to provide a description of what a certain control
will do if clicked, for example, or to display information in response to a run-time event or
process in your application. Because the Label control cannot receive focus, it can also be
used to create access keys for other controls.

5.3.2 Usage
Use the Label control to display static text on your form.
Typically, label controls are used to provide a text label for another control. For example,
if you have a ListBox control on a form, you can put a Label control above the listbox
with the name of the list. In the example below, a label with the Text property set to "Part
Numbers:" is used to label a list box.

Setting Label Appearance

Use the BorderStyle, ForeColor, BackColor, Font, Image, ImageAlign, and TextAlign
properties to change the appearance of the label.
Using hotkeys (mnemonics)
You can designate a character in the label's Text property to be a hotkey. In the Text
property of the label, use the ampersand character (&) before the hotkey. For example, in
the example shown above, the Text property for the label is "Part &Numbers:".
At runtime, when the user types Alt+N, the focus will go to the listbox.
When using hotkeys, be sure that the tab order is set so that the label's TabIndex is one
before the control's TabIndex that is labeled. See the section Changing Tab Order.

5.3.3 Label Control Properties

Property Description
BackColor The background color for the control.
Default: Control
BorderStyle The border used for the control.
Default: 0 – None
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
Font The font for the control text (design time only).
Default: Microsoft Sans Serif 8.25 pt

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 21

5. GUI Builder Components

Property Description
FontBold The bold attribute for the current font (runtime only).
Default: 0 – False
FontItalic The italic attribute for the current font (runtime only).
Default: 0 – False
FontName The name for the current font (runtime only).
Default: Microsoft Sans Serif
FontSize The size for the current font in points (runtime only).
Default: 8.25
ForeColor The foreground color for the control text.
Default: ControlText
Height The height of the control in pixels.
Image The picture for the control. To delete, press the <Delete> key.
Default: Empty
ImageAlign The picture alignment for the control.
Default: 5 – MiddleCenter
Left The left coordinate of the control in pixels.
Name The name of the control.
Default: LabelXX
TabIndex The tab index of the control.
Text The text of the control.
Default: Name of control
TextAlign Selects the text alignment.
Default: 1 – TopLeft
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

5.3.4 Label Control Events

Event Description
Click Executes when the user clicks the control with the mouse.
DblClick Executes when the user double clicks the control with the mouse.

22 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

5.4 TextBox Control

5.4.1 Description
Text boxes are used to get input from the operator or to display text. The TextBox control
is generally used for editable text, although it can also be made read-only. Text boxes can
display multiple lines, and wrap text to the size of the control. The TextBox control allows
a single format for text displayed or entered in the control.

5.4.2 Usage
A TextBox can be used in single line mode or multiline mode.
Single line textbox
By default, when a TextBox is created, it is in single line mode. You can only change the
width of the control. The user can only type in one line of characters.
Multiline textbox
To use multiline mode, set the Multiline property to True. In this mode, you can change
the height and width of the control. You can display scrollbars by setting the Scrollbars
property.
Setting TextBox Appearance
Use the BorderStyle, ForeColor, BackColor, Font, and TextAlign properties to change the
appearance of the textbox.
Displaying SPEL+ Global Variable Status
You can display the value of a SPEL+ global variable automatically by setting the
Variable property.
NOTE
If the SPEL+ global variable is not displayed by the setting of Variable property, rebuild
the project.

5.4.3 TextBox Control Properties

Property Description
AppendText Append text at runtime.
BackColor The background color for the control.
Default: Window
BorderStyle The border used for the control.
Default: 2 – Fixed3D
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
Font The font for the control text (design time only).
Default: Microsoft Sans Serif 8.25 pt
FontBold The bold attribute for the current font (runtime only).
Default: 0 – False
FontItalic The italic attribute for the current font (runtime only).
Default: 0 – False

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 23

5. GUI Builder Components

Property Description
FontName The name for the current font (runtime only).
Default: Microsoft Sans Serif
FontSize The size for the current font in points (runtime only).
Default: 8.25
ForeColor The foreground color for the control text.
Default: WindowText
Height The height of the control in pixels.
Left The left coordinate of the control in pixels.
Multiline Sets whether to display one line or multiple lines.
Default: 0 - False
Name The name of the control.
Default: TextBoxXX
PasswordChar Sets the character used to hide each character that is entered.
Default: Empty
ReadOnly Sets whether the user can edit text or not.
Default: 0 - False
ScrollBars Sets how to display the scrollbars for the control.
Default: 0 - None
ShowPrint Sets whether to display output from Print statements or not.
Default: 0 - False
TabIndex The tab index of the control.
Text The text of the control.
Default: Empty
TextAlign Selects the text alignment.
Default: 1 – Left
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Update Updates the display of textbox control (runtime only).
Variable This is an optional SPEL+ global variable.
Default: None
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.
WordWrap Sets whether to wrap words or not.
Default: 1 – True

5.4.4 TextBox Control Events

Event Description
KeyPress This event occurs when the control has focus and a key is pressed.

24 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

5.5 RadioButton Control

5.5.1 Description
RadioButton controls present a set of two or more mutually exclusive choices to the
operator. While radio buttons and check boxes may appear to function similarly, there is
an important difference: when a user selects a radio button, the other radio buttons in the
same group cannot be selected as well.

5.5.2 Usage
RadioButton controls should be grouped together in a GroupBox control. Each time the
operator clicks on one of the radiobuttons in a group, the other buttons are deselected.

Use the Click event to determine if the operator clicked the radiobutton. Use the Checked
property to determine if the user checked the box.
In some cases, it may be convenient to use one click event handler for all radiobuttons in a
group. You can use the Sender$ parameter to determine which radiobutton was clicked.
Sender$ is the name of the control that sent the event.
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
Setting RadioButton Appearance
Use the BorderStyle, ForeColor, BackColor, Font, Image, ImageAlign, and TextAlign
properties to change the appearance of the radiobutton.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 25

5. GUI Builder Components

5.5.3 RadioButton Control Properties

Property Description
BackColor The background color for the control.
Default: Control
Checked Sets whether the control is selected at runtime.
Default: 0 – False
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
Font The font for the control text (design time only).
Default: Microsoft Sans Serif 8.25 pt
FontBold The bold attribute for the current font (runtime only).
Default: 0 – False
FontItalic The italic attribute for the current font (runtime only).
Default: 0 – False
FontName The name for the current font (runtime only).
Default: Microsoft Sans Serif
FontSize The size for the current font in points (runtime only).
Default: 8.25
ForeColor The foreground color for the control text.
Default: ControlText
Height The height of the control in pixels.
Image The picture for the control. To delete, press the <Delete> key.
Default: Empty
ImageAlign The picture alignment for the control.
Default: 5 – MiddleCenter
Left The left coordinate of the control in pixels.
Name The name of the control.
Default: RadioButtonXX
TabIndex The tab index of the control.
Text The text of the control.
Default: Name of control
TextAlign Selects the text alignment.
Default: 4 – Middle Left
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

26 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

5.5.4 RadioButton Control Events

Event Description
Click Executes when the user clicks the control with the mouse.

5.6 CheckBox Control

5.6.1 Description
The CheckBox control indicates whether a particular condition is on or off. It is
commonly used to present a Yes/No or True/False selection to the user. You can use
check box controls in groups to display multiple choices from which the user can select
one or more. It is similar to the RadioButton control, but any number of grouped
CheckBox controls may be selected.

5.6.2 Usage
Use checkboxes to allow the operator to turn application preferences on or off.
Typically, you would add the checkboxes to a GroupBox control. Use the Checked
property to determine if the user checked the box.

Setting CheckBox Appearance

Use the BorderStyle, ForeColor, BackColor, Font, Image, ImageAlign, and TextAlign
properties to change the appearance of the checkbox.

5.6.3 CheckBox Control Properties

Property Description
BackColor The background color for the control.
Default: Control
Checked Sets whether the control is checked at runtime.
Default: 0 – False
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
Font The font for the control text (design time only).
Default: Microsoft Sans Serif 8.25 pt
FontBold The bold attribute for the current font (runtime only).
Default: 0 – False
FontItalic The italic attribute for the current font (runtime only).
Default: 0 – False

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 27

5. GUI Builder Components

Property Description
FontName The name for the current font (runtime only).
Default: Microsoft Sans Serif
FontSize The size for the current font in points (runtime only).
Default: 8.25
ForeColor The foreground color for the control text.
Default: ControlText
Height The height of the control in pixels.
Image The picture for the control. To delete, press the <Delete> key.
Default: Empty
ImageAlign The picture alignment for the control.
Default: 5 – MiddleCenter
Left The left coordinate of the control in pixels.
Name The name of the control.
Default: CheckBoxXX
TabIndex The tab index of the control.
Text The text of the control.
Default: Name of control
TextAlign Selects the text alignment.
Default: :4 – MiddleLeft
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

5.6.4 CheckBox Control Events

Event Description
Click Executes when the user clicks the control with the mouse.

28 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

5.7 ListBox Control

5.7.1 Description
A ListBox control displays a list of items from which the operator can select one or more.

5.7.2 Usage
Use the ListBox control to display a static list of items from which the operator can
choose.
To add items to a list box
Use the AddItem property at runtime to add items to a listbox. This is normally done in
the form load event.
GSet frmSetup.lstModels.AddItem, "Model1"
GSet frmSetup.lstModels.AddItem, "Model2"
GSet frmSetup.lstModels.AddItem, "Model3"
Optionally, you can have the list sorted by set the Sorted property to True.
To determine which item was selected
Use the SelectedIndex property to determine the user selection. If no item has been
selected, then SelectedIndex is -1.
Integer index
GGet frmSetup.lstModels.SelectedIndex, index
The List array
You can access all of the items in a list using the List array property.
Integer i, count
String item$
GGet frmSetup.lstModels.ListCount, count
For i = 0 To count - 1
GGet frmSetup.lstModels.List(i), item$
Next i
You can delete an item by setting the List property to an empty string.
GSet frmSetup.lstModels.List(0), ""
Setting ListBox Appearance
Use the BorderStyle, ForeColor, BackColor, Font, properties to change the appearance of
the listbox.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 29

5. GUI Builder Components

5.7.3 ListBox Control Properties

Property Description
AddItem Adds an item to the list at runtime.
BackColor The background color for the control.
Default: Window
BorderStyle The border used for the control.
Default: 2 – Fixed3D
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
Font The font for the control text (design time only).
Default: Microsoft Sans Serif 8.25 pt
FontBold The bold attribute for the current font (runtime only).
Default: 0 – False
FontItalic The italic attribute for the current font (runtime only).
Default: 0 – False
FontName The name for the current font (runtime only).
Default: Microsoft Sans Serif
FontSize The size for the current font in points (runtime only).
Default: 8.25
ForeColor The foreground color for the control text.
Default: WindowText
Height The height of the control in pixels.
Left The left coordinate of the control in pixels.
List Use to access the items in the list at runtime.
ListCount Use to get the number of items in the list at runtime.
Name The name of the control.
Default: ListBoxXX
SelectedIndex Use to determine which item has been selected by the operator at
runtime.
Sorted Sets whether to sort the items in the list or not.
Default: 0 – False
TabIndex The tab index of the control.
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

5.7.4 ListBox Control Events

Event Description
Click Executes when the user clicks the control with the mouse.
DblClick Executes when the user double clicks the control with the mouse.

30 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

5.8 ComboBox Control

5.8.1 Description
The ComboBox control is used to display data in a dropdown combo box. By default, the
ComboBox control appears in two parts: the top part is a text box that allows the user to
type a list item. The second part is a list box that displays a list of items from which the
user can select one.

5.8.2 Usage
The ComboBox control can behave in three different ways, depending on the value of the
DropDownStyle property.
DropDownStyle = Simple

In simple mode, there is a textbox above a list box. The operator can edit or add selections
by typing in the textbox area.
DropDownStyle = DropDown

In this mode, the listbox portion is not displayed until the operator clicks the down arrow
button located on the right side of the text area. The operator can edit the selected text in
the textbox area.
DropDownStyle = DropDownList

When DropDownList is specified, the operator cannot type text in the textbox area. Only
items in the list can be selected.
For information on how to add items to the listbox portion of the ComboBox control, see
the Usage information for the ListBox control for information on AddItem, List,
ListCount, and SelectedIndex.
Setting ComboBox Appearance
Use the ForeColor, BackColor, and Font properties to change the appearance of the
combobox.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 31

5. GUI Builder Components

5.8.3 ComboBox Control Properties

Property Description
AddItem Adds an item to the list at runtime.
BackColor The background color for the control.
Default: Window
DropDownStyle Specifies the style of the combo box.
Default: 1 – DropDown
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
Font The font for the control text (design time only).
Default: Microsoft Sans Serif 8.25 pt
FontBold The bold attribute for the current font (runtime only).
Default: 0 – False
FontItalic The italic attribute for the current font (runtime only).
Default: 0 – False
FontName The name for the current font (runtime only).
Default: Microsoft Sans Serif
FontSize The size for the current font in points (runtime only).
Default: 8.25
ForeColor The foreground color for the control text.
Default: WindowText
Height The height of the control in pixels.
Left The left coordinate of the control in pixels.
List Use to access the items in the list at runtime.
ListCount Use to get the number of items in the list at runtime.
Name The name of the control.
Default: ComboBoxXX
SelectedIndex Use to determine which item has been selected by the operator at
runtime.
Sorted Sets whether to sort the items in the list or not.
Default: 0 – False
TabIndex The tab index of the control.
Text The text of the control.
Default: Empty
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

32 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

5.8.4 ComboBox Control Events

Event Description
Click Executes when the user clicks the control with the mouse.

5.9 PictureBox Control

5.9.1 Description
The PictureBox control is used to display graphics in bitmap, GIF, JPEG, PNG, WMF,
metafile, or icon format.

5.9.2 Usage
Use a PictureBox control to display an image from a file. You can set the image for a
picturebox control at design time or runtime.
Setting the Image
At design time, use the Image property to browse for an image file.
At runtime, use the Image property to specify the full path for the image file.
Changing image size
You can specify how the image is sized by using the SizeMode property.
Setting PictureBox Appearance
Use the BackColor, BorderStyle, and SizeMode properties to change the appearance of the
picturebox.

5.9.3 PictureBox Control Properties

Property Description
BackColor The background color for the control.
Default: Control
BorderStyle The border used for the control.
Default: 0 – None
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
Height The height of the control in pixels.
Image Specifies the image to be displayed. To delete, press the <Delete>
key.
Left The left coordinate of the control in pixels.
Name The name of the control.
Default: PictureBoxXX
SizeMode Specifies how the image is sized.
Default: 0 – Normal
TabIndex The tab index of the control.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 33

5. GUI Builder Components

Property Description
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

5.9.4 PictureBox Control Events

Event Description
Click Executes when the user clicks the control with the mouse.
DblClick Executes when the user double clicks the control with the mouse.

34 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

5.10 GroupBox Control

5.10.1 Description
GroupBox controls are used to provide an identifiable grouping for other controls.
Typically, you use group boxes to subdivide a form by function. For example, you may
have a setup form that specifies robot speed options.. Grouping all options in a group box
gives the user a logical visual cue.

5.10.2 Usage
Use the GroupBox control to group together controls for selecting options (using
RadioButtons) or setting preferences (using CheckBoxes). You can also group together
other controls as well.
First, add a GroupBox control to your form.
Next, either create new controls on the groupbox, or drag existing controls to the
groupbox.
Set the Text property of the groupbox to the name of the group.
Setting GroupBox Appearance
Use the BackColor, ForeColor, and Font properties to change the appearance of the
picturebox.

5.10.3 GroupBox Control Properties

Property Description
BackColor The background color for the control.
Default: Control
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
Font The font for the control text (design time only).
Default: Microsoft Sans Serif 8.25 pt
ForeColor The foreground color for the control text.
Default: ControlText
FontBold The bold attribute for the current font (runtime only).
Default: 0 – False
FontItalic The italic attribute for the current font (runtime only).
Default: 0 – False
FontName The name for the current font (runtime only).
Default: Microsoft Sans Serif
FontSize The size for the current font in points (runtime only).
Default: 8.25

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 35

5. GUI Builder Components

Property Description
ForeColor The foreground color for the control text.
Default: ControlText
Height The height of the control in pixels.
Left The left coordinate of the control in pixels.
Name The name of the control.
Default: GroupBoxXX
TabIndex The tab index of the control.
Default:
Text The text of the control.
Default: Name of the Control
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

5.10.4 GroupBox Control Events

Event Description
Click Executes when the user clicks the control with the mouse.

36 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

5.11 Timer Control

5.11.1 Description
The Timer is a control that raises an event at regular intervals. It is executable even when
the emergency stop occurs or other normal tasks are paused.

5.11.2 Usage
Use the Timer control to periodically execute code. For example, a Timer control could
be used to update a status label every two seconds.
To use a Timer
1. Add a Timer control to a form. The control is displayed below the form in the design
area, since this control is invisible at runtime.
2. Set the Interval property to the desired time period in milliseconds.
3. Set the Enabled property to True at design time if the timer should always run.
Otherwise, set the Enabled property to True at runtime in your code.
4. Add an event handler for the Tick event to execute your code.
NOTE When a timer is executing the Tick event handler, other tick events from the same timer
 are ignored.

5.11.3 Timer Control Properties

Property Description
Enabled Sets whether the control is enabled.
Default: 0 – False
Interval Sets the time interval in milliseconds
Default: 100
Name The name of the control.
Default: TimerXX

5.11.4 Timer Control Events

Event Description
Tick Occurs when the time is enabled and the interval has been reached.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 37

5. GUI Builder Components

5.12 VideoBox Control

5.12.1 Description
The VideoBox control allows you to display video for the Vision Guide option in your
forms.

5.12.2 Usage
You can easily display a video window on a form in your application by using the
VideoBox control. When you run a vision sequence, the graphics can also be displayed on
the window.
Perform the following steps to create a vision window:
1. Place a VideoBox control on the form you want the video to be displayed. The
control size can be changed up to the full size.
2. Set the VideoEnabled property to True.
3. Set the GraphicsEnabled property to True if you want to display vision graphics.
4. By default, the Camera property value is 0. This allows the videobox to display
video from any camera when a sequence is run. Set the Camera property to any
camera number in the project to show the video and sequence graphics for that
camera.
The video is automatically scaled to fit the size of the VideoBox. When you change the
height or width of the videobox, the aspect ratio is maintained.
Setting VideoBox Appearance
Use the BorderStyle property to change the appearance of the videobox.

5.12.3 VideoBox Control Properties

Property Description
BorderStyle The border used for the control.
Default: 0 – None
Camera Selects which camera to display video for.
Default: 0
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
GraphicsEnabled Sets whether vision graphics are displayed or not.
Default: 0 – False
Height The height of the control in pixels.
Left The left coordinate of the control in pixels.
Name The name of the control.
Default: VideoBoxXX
TabIndex The tab index of the control.
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
VideoEnabled Sets whether video is displayed on not.
Default: 0 - False

38 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

Property Description
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

5.12.4 VideoBox Control Events

Event Description
Click Executes when the user clicks the control with the mouse.
DblClick Executes when the user double clicks the control with the mouse.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 39

5. GUI Builder Components

5.13 LED Control

5.13.1 Description
The LED control is used to display I/O status.

5.13.2 Usage
To use the LED control
1. Set the Text property to the name of the status.
2. Set the IOType property. You can choose from input, output, or memory I/O.
3. Set the IOBit property. This is the bit you want to display the status for.
For outputs, you can optionally allow the operator to double click on the LED control to
toggle the output status. To do this, set the AllowStateChange property to True.
Setting LED Appearance
Use the BackColor, BorderStyle, ForeColor, Font, ImageAlign, and TextAlign properties
to change the appearance of the LED.
You can also change the ImageOn and ImageOff properties to use the built-in color
images, or you can provide your own images.

5.13.3 LED Control Properties

Property Description
AllowStateChange Allows the operator to toggle output status
Default: 0 – False
BackColor The background color for the control.
Default: Control
BorderStyle The border used for the control.
Default: 0 – None
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType The type of task used for events.
Default: 0 – Normal
Font The font for the control text (design time only).
Default: Microsoft Sans Serif 8.25 pt
FontBold The bold attribute for the current font (runtime only).
Default: 0 – False
FontItalic The italic attribute for the current font (runtime only).
Default: 0 – False
FontName The name for the current font (runtime only).
Default: Microsoft Sans Serif
FontSize The size for the current font in points (runtime only).
Default: 8.25
ForeColor The foreground color for the control text.
Default: ControlText
Height The height of the control in pixels.

40 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

Property Description
ImageAlign The picture alignment for the control.
Default: 4 - MiddleLeft
ImageOff This sets the image displayed when the I/O status is off.
Default: LedOff.ico
ImageOn This sets the image displayed when the I/O status is on.
Default: LedRed.ico
IOBit Range: 0 to 9999
Default: 0
IOType This sets the type of I/O to monitor.
Default: 0 – Input
Left The left coordinate of the control in pixels.
Name The name of the control.
Default: LedXX
TabIndex The tab index of the control.
Text The text of the control.
Default: Name of control
TextAlign Selects the text alignment.
Default: 6 – MiddleRight
ToolTipText The text used in the control's tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

5.13.4 LED Control Events

Event Description
DblClick Executes when the user double clicks the control with the mouse.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 41

5. GUI Builder Components

5.14 StatusBar Control

5.14.1 Description
The StatusBar control displays status text and optional panels for date/time, Estop status,
Safeguard status, and robot information.

5.14.2 Usage
Use a StatusBar control to display status text and other built-in status. The text panel is
always visible. Use the Text property to set the text in the text panel. There are other
status panels that by default are not visible: DateTime, Estop, Robot, Safeguard. Use
ShowDateTime, ShowEStop, ShowRobot, and ShowSafeguard properties to make these
panels visible or not. These panels are automatically updated by the system.

5.14.3 StatusBar Control Properties

Property Description
BackColor The background color for the control.
Default: Control
BorderStyle The border used for the control.
Default: 0 – None
Dock Sets docking position on the form for a control.
Default:2 –Bottom
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType Sets the type of task used for events.
Default: 0 – Normal
Font The font for the control text (design time only).
Default: Microsoft Sans Serif 8.25 pt
ForeColor The foreground color for the control text.
Default: ControlText
Height The height of the control in pixels.
Left The left coordinate of the control in pixels.
Name The name of the control.
Default: StatusBarXX
RobotNumber Specified the robot number used for ShowRobot.
ShowDateTime Sets whether to display the current date and time.
Default: 0 - False
ShowEStop Sets whether to display Estop status.
Default: 0 - False
ShowRobot Sets whether to display the robot that is selected by the
RobotNumber property.
Default: 0 - False
ShowSafeguard Sets whether to display the Safeguard status.
Default: 0 - False
TabIndex The tab index of the control.

42 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

Property Description
Text The text displayed in the StatusBar text panel.
Default: Name of control
ToolTipText The text used in the control’s tooltip.
Default: Empty
Top The top coordinate of the control in pixels.
Visible Whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

5.14.4 StatusBar Control Events

Event Description
Click Executes when the user clicks the control with the mouse.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 43

5. GUI Builder Components

5.15 ProgressBar Control

5.15.1 Description
A ProgressBar control is used to graphically display the status of processing or a value.

5.15.2 Usage
Use the ProgressBar control to show the status of a long running operation or the value of
a variable.

Displaying SPEL+ Global Variable Status

You can display the value of a SPEL+ global variable automatically by setting the
Variable property.
NOTE
If the SPEL+ global variable is not displayed by the setting of Variable property, rebuild
the project.

5.15.3 ProgressBar Control Properties

Property Description
BackColor The background color for the control.
Default: Control
BorderStyle The border used for the control.
Default: 0 – None
Dock Sets docking operation for the control.
Default:0 –None
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType Sets the type of task used for events.
Default: 0 – Normal
ForeColor The foreground color for the control text.
Default: ControlText
Height The height of the control in pixels.
Left The left coordinate of the control in pixels.
Maximum Sets the maximum of the range that the control is processing.
Default: 100
Minimum Sets the minimum of the range that the control is processing.
Default: 0
Name The name of the control.
Default: ProgressBarXX
Orientation Sets the orientation of the control.
Default: 0 – Horizontal
ProgressBarStyle Sets the style of the ProgressBar control.
Default:0 – Blocks
Step Sets the amount to increment the current value of the control.
Default:10
TabIndex The tab index of the control.
ToolTipText The text used in the control's tooltip.
Default: Empty

44 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

Property Description
Top The top coordinate of the control in pixels.
Value Sets the value that specifies the progress bar position.
Default: 50
Variable This is an optional SPEL+ global integer variable. When specified,
the Value property is automatically set to the variable value at
runtime.
Default: None
Visible Sets whether the control is visible or not at runtime.
Default: 1 - True
Width The width of the control in pixels.

5.15.4 ProgressBar Control Events

Event Description
Click Executes when the user clicks the control with the mouse.
DblClick Executes when the user double clicks the control with the mouse.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 45

5. GUI Builder Components

5.16 TrackBar Control

5.16.1 Description
A TrackBar control is used to allow the operator to set a value by dragging a slider.

5.16.2 Usage
Use the TrackBar control when you want to support changing a value graphically.

Displaying SPEL+ Global Variable Status

You can set the value of a SPEL+ global variable automatically according to the trackbar
value by using the Variable property.
NOTE
If the SPEL+ global variable is not updated by the setting of Variable property, rebuild the
project.

5.16.3 TrackBar Control Properties

Property Description
BackColor The background color for the control.
Default: Control
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType Sets the type of task used for events.
Default: 0 – Normal
Height The height of the control in pixels.
LargeChange Sets the number of positions that the slider moves when clicking the
mouse on either side of the bar or by pressing Page Up and Page
Down keys.
Default: 5
Left The left coordinate of the control in pixels.
Maximum Sets the maximum of the range that the control is processing.
Default: 10
Minimum Sets the minimum of the range that the control is processing.
Default: 0
Name The name of the control.
Default: TrackBarXX
Orientation Sets the orientation of the control.
Default: 0 – Horizontal
SmallChange Sets the number of positions that the slider moves for keyboard
inputs (arrow orientation keys).
Default: 1
TabIndex The tab index of the control.
TickFrequency Sets the interval of the tick marks.
Default: 1
TickStyle Sets where to display the tick marks on the track bar.
Default: 2 - BottomRight
ToolTipText The text used in the control's tooltip.
Default: Empty

46 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

Property Description
Top The top coordinate of the control in pixels.
Value Sets the value that represents the control’s current position.
Default: 0
Variable This is an optional SPEL+ global integer variable. When specified,
the variable is automatically set according to the slider position.
Default: None
Visible Sets whether the control is visible or not at runtime.
Default: 1 - True
Width The width of the control in pixels.

5.16.4 TrackBar Control Events

Event Description
Scroll Executes after the slider on the track bar has been moved.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 47

5. GUI Builder Components

5.17 Grid Control

5.17.1 Description
The Grid control is used to display and allow editing of data in a spreadsheet format.

5.17.2 Usage
The Grid control has cells that contain data in rows and columns. The operator can select
rows and cells. The operator can optionally edit the cells in the specified columns.

At design time you can configure the Grid control:

1. Click the GridEditor property to open the designer of the grid control.
2. Design the grid by setting properties to the desired values.
3. Close the designer.
At runtime:
- You can read and write cell text using the CellText property.
- You can add or remove rows using AddRow and RemoveRow properties.
- You can change a cell forecolor and backcolor using the CellForeColor and
CellBackColor properties.

5.17.3 Grid Control Properties

Property Description
AddRow Adds a row at runtime.
BorderStyle
The background color for the control.
Default: Control
CellBackColor Sets or gets the back color of a cell at runtime.
CellForeColor Sets or gets the fore color of a cell at runtime.
CellText Sets or gets the text in the cell at runtime.
Enabled Sets whether the control is enabled at runtime.
Default: 1 – True
EventTaskType Sets the type of task used for events.
Default: 0 – Normal
GridEditor Opens the designer to setup the Grid control.
Height The height of the control in pixels.
Left The left coordinate of the control in pixels.
Name The name of the control.
Default: GridXX
RemoveRow Removes a row at runtime.
RowCount Sets or gets the number of rows at runtime.
ScrollBars Sets how to display the scrollbars for the control.
Default: 0 - None

48 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 5. GUI Builder Components

SelectedIndex Sets or gets the selected row at runtime.

Top The top coordinate of the control in pixels.
Visible Sets whether the control is visible or not at runtime.
Default: 1 – True
Width The width of the control in pixels.

5.17.4 Grid Control Events

Event Description
CellChanged Executes when the user leaves a cell that was changed.
Click Executes when the user clicks the control with the mouse.
DblClick Executes when the user double clicks the control with the mouse.

5.17.5 GridEditor
The grid editor is a dialog where the user can modify and set up the grid control. It is only
available at design time. It has many properties to set in order to best suit the user’s needs.
To get more information on the Grid Editor, refer to the Grid Editor property.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 49

6. Operation

6. Operation

6.1 Overview
This chapter contains the following topics:
- Developing your GUI in Program Mode
- Configuring your GUI startup in Auto Mode
- Handling pause and continue
- Handling emergency stop
- Using a help file

6.2 GUI Development in Program Mode

You design and debug your GUI application in program mode.
To begin, start EPSON RC+ 7.0 in program mode.

6.2.1 Design the GUI

To design the GUI for your application, follow these steps as a simple guideline.
1. Create one or more forms for the application. Typically you will designate one of
the forms to be your main form.
2. Decide on how you want to start the GUI. You can set one of the forms as your
startup form. This form will automatically be displayed when RC+ starts in auto
mode. If you do not want to display a form at startup, then the Operator Window
will be displayed and you can display any form from SPEL+ code using GShow or
GShowDialog.
3. Add controls to the forms.
4. Add desired events to the controls.
For details on working with forms and controls, see the chapter Working with Forms and
Controls.

50 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 6. Operation

6.2.2 Debugging
You can run any of the forms in the project from the Run Window.
1. Open the Run Window

2. Select the form you want to run from the dropdown list.
3. Click Start. The selected form will be displayed and you can use the controls on the
form.
4. To stop, close all forms, or click the Stop button on the Run Window.
GUI event handlers run as SPEL+ tasks, so you can set a breakpoint in any event handler,
step through code, and view variable values.

6.3 Auto Mode

After you have developed your application, you will need to setup EPSON RC+ to run in
Auto mode. At startup time, you can choose to show one of your GUI forms, or you can
show the Operator Window and then display one of your forms from your program.
To set EPSON RC+ to start in Auto mode
1. Open Setup | System Configuration.
2. In the Start Mode page, check Auto and click Apply, then click Close.
To configure a form to be displayed at startup
1. Open the GUI Builder window.
2. In the Forms Explorer, right click on the form you want displayed at startup and
select Startup Form.
3. Click the Project Save button on the main toolbar.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 51

6. Operation

6.4 Handling Pause and Continue

You may want to use the pause and continue feature of the controller in your GUI.
Typically, you will have a dialog with a pause button and a continue button. For these
buttons to work properly, you need to set the EventTaskType property for each button to 1
– NoPause. This is because when the button click event executes, the event task must
ignore the pause state of the controller.
Function frmMain_btnPause_Click(Sender$ As String)
Pause
Fend
Function frmMain_btnCont_Click(Sender$ As String)
Cont
Fend

6.5 Handling Emergency Stop

After an emergency stop, you must reset the emergency stop condition before you can run
the robot again. To do this, provide a reset button with the EventTaskType set to 2 –
NoEmgAbort.
Function frmMain_btnReset_Click(Sender$ As String)
Reset
If EstopOn Then
MsgBox "EStop could not be reset"
EndIf
Fend

6.6 Using a Help File

GUI Builder supports a simple help system by allowing you to specify a help file for the
project from which you can show a topic when a form help button is clicked by the
operator.
Help files must be in the Microsoft HTML help format.
To use a help file:
1. Open Project | Properties | GUI Builder.
2. Browse to the help file and click open to set the help file.

3. For each form that will show help, set the HelpButton property to True, and set the
HelpID property for the topic you want to display.

52 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 7. GUI Builder Reference

7. GUI Builder Reference

7.1 Overview
This chapter explains all GUI Builder form and control properties and events, and all GUI Builder
SPEL+ commands. For more information on how to use GUI Builder, refer to the GUI Builder
manual.

7.2 GUI Builder Properties and Events Format Description

All GUI Builder properties and events are listed in the pages that follow. An explanation of the
headings for the property and result reference pages is given below:

Applies To If the property or event is used with GUI Builder objects, then this section
simply lists the objects for which this property applies. (Ex. Button, Label,
Checkbox...)
If the property or event is used with forms then the word Forms will appear in
this section.
Description A simple description is given for each property or event. This section is
normally very short for simplicity.
Usage The Usage Section describes how to access the property or event from the
SPEL+ Language.
Values Describes the range of acceptable values which the property can be set to or
which the result will return. A default value is also shown for those properties
that have a default.
Remarks Explains more details than the Description Section. This section is normally
used to describe any caveats or special information that may apply to the
specific property or event. (It is highly recommended to read the Remarks
Section for each property prior to its usage.)
See Also Gives a list of related properties, results, objects and other topics that may prove
useful to review.
Runtime only This is displayed under the property or result name when it applies. Runtime
only properties and results cannot be accessed from the GUI Builder. They can
only be accessed from the SPEL+ language.

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 53

AcceptButton Property

AcceptButton Property

Applies To
Form

Description
Gets or sets the button on the form that is clicked when the user presses the ENTER key.

Usage
GGet Form.AcceptButton, var
GSet Form.AcceptButton, value
Form Name of a form or string variable containing a form name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
The name of any button on the form.
Default: None

Remarks
This property allows you to designate a default action to occur when the user presses the ENTER key in your
application. The button assigned to this property must be a Button that is on the current form or located within
a container on the current form.
You can use this property to allow the user to quickly navigate a simple form by allowing them to simply
press the ENTER key when they are finished instead of manually clicking the accept button with their mouse.
The accept button might not be activated if the currently selected control on the form intercepts the ENTER
key and processes it. For example, a multiline text box control allows the ENTER key to be pressed when it
is selected to insert a new line character in the control.

See Also
Form, Button, CancelButton

Example
GSet frmMain.AcceptButton, "btnOK"

54 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 AddItem Property

AddItem Property

Applies To
ListBox, ComboBox

Description
Used to add an item to a ListBox or ComboBox control.

Usage
GSet Form.Control.AddItem, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
value String expression for the new value of the property.

Values
A string value to be added to the list.

See Also
ComboBox, ListBox, List, ListCount, Sorted

Example
GSet frmMain.lstModels.AddItem, "Model1"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 55

AddRow Property

AddRow Property

Applies To
Grid

Description
Used to add a row to a Grid control during runtime.

Usage
GSet Form.Control.AddRow, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
value Integer representing the index of the newly added row. Specifying “-1” causes the new row to
be appended after last row. Otherwise, the new row is inserted at the specified row index.

See Also
Grid, RemoveRow, RowCount

Example
GSet frmMain.Grid01.AddRow, 0

56 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 AppendText Property

AppendText Property

Applies To
TextBox

Description
Appends text to a TextBox control.

Usage
GSet Form.Control.AppendText, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
value String expression for the new value of the property.

Values
A string that will be added to the end of the text in the control.

See Also
TextBox

Example
GSet frmMain.txtStatus.AppendText, "Cycle Complete"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 57

AllowStateChange Property

AllowStateChange Property

Applies To
LED

Description
Gets or sets the inversion actuation of LED control when double-clicked.

Usage
GGet Form.Control.AllowStateChange, var
GSet Form.Control.AllowStateChange, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
The control must exist in the specified form.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

Remarks
To invert output, set IOType property in 1 – Output or 2 – Memory.

See Also
LED, IOType

Example
GSet frmMain.Led1.AllowStateChange, True

58 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 BackColor Property

BackColor Property

Applies To
Form, Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox, LED,
ProgressBar, TrackBar, StatusBar

Description
Gets or sets the background color of a form or control.

Usage
GGet Form.Control.BackColor, var
GSet Form.Control.BackColor, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
The name of the color to be used for the background color of the form or control.
Default: Control (Form, Button, Label, RadioButton, CheckBox, PictureBox, GroupBox, LED)
Window (TextBox, ListBox, ComboBox)

See Also
BackColorMode, Form, Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, PictureBox,
GroupBox, LED, ProgressBar, TrackBar, StatusBar

Example
GSet frmMain.lblStatus.BackColor, "Red"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 59

BackColorMode Property

BackColorMode Property

Applies To
Button

Description
Gets or sets the BackColorMode used for a button control.

Usage
GGet Form.Control.BackColorMode, var
GSet Form.Control.BackColorMode, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – VisualStyle. Uses the system specified BackColor.
1 - User. Uses the specified BackColor.

Remarks
When BackColorMode is 0, the background color for the control is set by Windows, depending on the
current theme.
When BackColorMode is 1, the background color is set by the BackColor property value.
Default: 0 – Visual Style

See Also
BackColor, Button

Example
GSet frmMain.btnOK.BackColorMode, BACKCOLORMODE_USER

60 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 BorderStyle Property

BorderStyle Property

Applies To
Label, TextBox, ListBox, PictureBox, VideoBox, LED, ProgressBar, StatusBar, Grid

Description
Gets or sets the control's border style.

Usage
GGet Form.Control.BorderStyle, var
GSet Form.Control.BorderStyle, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 - None
1 - FixedSingle
2 - Fixed3D
Default: 0 – None (Label, PictureBox, VideoBox, LED)
2 – Fixed3D (TextBox, ListBox)

Remarks
You can use this property to add a border to the control. For example, this property can be used to differentiate
a Label that labels another control from a Label that displays the status of a process in an application.

See Also
Label, TextBox, ListBox, PictureBox, VideoBox, LED, ProgressBar, StatusBar

Example
GSet frmMain.lblStatus.BorderStyle, BORDERSTYLE_NONE

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 61

Camera Property

Camera Property

Applies To
VideoBox

Description
Gets or sets the camera number for the VideoBox control.

Usage
GGet Form.Control.Camera, var
GSet Form.Control.Camera, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
The camera number for the video display. If the value is 0, then the video from any camera is displayed
when VRun executes. To display the video, set the VideoEnabled property to “1 – True”.

See Also
VideoBox, VideoEnabled

Example
GSet frmMain.VideoBox1.Camera, 1

62 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 CancelButton Property

CancelButton Property

Applies To
Form

Description
Gets or sets the button on the form that is clicked when the user presses the ESC key.

Usage
GGet Form.CancelButton, var
GSet Form.CancelButton, value
Form Name of a form or string variable containing a form name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
The name of any button on the form.
Default: None

Remarks
The cancel button for a form is the button control that is clicked whenever the user presses the ESC key. The
button assigned to this property must be a button that is on the current form or located within a container on
the current form.
This property allows you to designate a default action to occur when the user presses the ESC key in your
application. You can use this property to allow the user to quickly navigate a simple form by allowing them
to simply press the ESC key to close a window without committing changes instead of manually clicking the
cancel button with their mouse.
CancelButton may not work if another control on the form intercepts the ESC key. For example, if you have
a ComboBox open on your form, ESC will close the ComboBox instead of closing the Form.
The Button control assigned to CancelButton must be visible on the form, or else pressing the ESC key will
have no effect.

See Also
Form, Button, AcceptButton
Example
GSet frmMain.CancelButton, "btnCancel"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 63

CellBackColor Property

CellBackColor Property

Applies To
Grid

Description
Gets or sets the background color for a Grid cell at runtime.

Usage
GGet Form.Control.CellBackColor (row, column), var
GSet Form.Control.CellBackColor (row, column), value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
row Integer expression for the cell row. The index of the first row is “0”.
column Integer expression for the cell column. The index of the first column is “0”.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string containing the name of the background color for the specified grid cell.

See Also
Grid, CellForeColor, CellText

Example
GSet frmMain.gridMyData.CellBackColor(1, 1), "Red"

64 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 CellChanged Event

CellChanged Event

Applies To
Grid

Description
Occurs when you leave a cell that has been changed.

Usage
Form_Control_CellChanged (sender$ As String, CellText$ As String, RowNumber As Integer,
ColumnNumber As Integer)
Sender$ Name of a control that sent the event.
CellText$ Text of the changed cell.
RowNumber Row number of the changed cell.
ColumnNumber Column number of the changed cell.

Remarks
The CellChanged event is used to respond to when the user leaves a cell that has been modified. You can use
the Sender$ parameter to determine which control sent the event, the CellText$ parameter to see what the
value the cell now has, and the RowNumber and ColumnNumber parameters to determine which cell
triggered the event. This is useful when you want to see when specific cells are changed or whenever any
cell is changed.

See Also
Grid

Example
Function frmMain_Grid1_CellChanged(Sender$ As String, CellText$ As String,
RowNumber As Integer, ColumnNumber As Integer)
Xqt main
Fend

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 65

CellForeColor Property

CellForeColor Property

Applies To
Grid

Description
Gets or sets the foreground color for a Grid cell at runtime.

Usage
GGet Form.Control.CellForeColor (row, column), var
GSet Form.Control.CellForeColor (row, column), value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
row Integer expression for the cell row. The index of the first row is 0.
column Integer expression for the cell column. The index of the first column is 0.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string containing the name of the foreground color for the specified grid cell.

See Also
Grid, CellBackColor, CellText

Example
GSet frmMain.gridMyData.CellForeColor(1, 1), "Red"

66 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 CellText Property

CellText Property

Applies To
Grid

Description
Gets or sets the text in a Grid cell at runtime.

Usage
GGet Form.Control.CellText (row, column), var
GSet Form.Control.CellText (row, column), value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
row Integer expression for the cell row. The index for the first row is 0.
column Integer expression for the cell column. The index for the first column is 0.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string containing the text of the specified grid cell.

See Also
Grid, CellForeColor, CellBackColor

Example
GSet frmMain.gridMyData.CellText(1, 1), "Value1"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 67

Checked Property

Checked Property

Applies To
RadioButton, Checkbox

Description
Gets or sets a value indicating whether the CheckBox or RadioButton control is checked.

Usage
GGet Form.Control.Checked, var
GSet Form.Control.Checked, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 - False
1 – True
Default: 0 – False

Remarks
Use this property to determine whether the CheckBox or RadioButton control is checked. This property can
also be used to programmatically set the state of the CheckBox or RadioButton control.

See Also
RadioButton, CheckBox

Example
GSet frmMain.chkHiPower.Checked, False

68 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Click Event

Click Event

Applies To
Button, Label, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox, VideoBox,
ProgressBar, StatusBar, Grid

Description
Occurs when a control is clicked.

Usage
Form_Control_Click (sender$ As String)
Sender$ Name of a control that sent the event.

Remarks
The Click event is used to respond to a click on a control by the user. You can use the Sender$ parameter to
determine which control sent the event. This is useful when you want to use one function to handle more
than one control, such as for radio buttons and check boxes.

See Also
Button, Label, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox, VideoBox,
ProgressBar, StatusBar

Example
Function frmMain_btnStart_Click(Sender$ As String)
Xqt main
Fend

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 69

Closed Event

Closed Event

Applies To
Form

Description
Occurs when a form has been closed.

Usage
Form_Closed (Sender$ As String)
Sender$ Name of the form that sent the event.

Remarks
You can use this event to perform tasks after a form has been closed.

See Also
Form, Load, Resize

Example
Function frmMain_Closed(Sender$ As String)

Print "frmMain was closed"

Fend

70 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 ControlBox Property

ControlBox Property

Applies To
Form

Description
Gets or sets a value indicating whether a control box is displayed in the caption bar of the form.

Usage
GGet Form.ControlBox, var
GSet Form.ControlBox, value
Form Name of a form or string variable containing a form name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 - False
1 – True
Default: True

Remarks
If the ControlBox property is set to true, the control box is displayed in the upper-left corner of the form's
title bar. The control box can be used to close the form.

See Also
Form, MaximizeBox, MinimizeBox

Example
GSet frmMain.ControlBox, False

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 71

Controls Property

Controls Property

Applies To
Form

Description
Array of controls in the form. Used to access control properties with an index.

Usage
GGet Form.Controls(Index As Integer).Property, var
GSet Form. Controls(Index As Integer).Property, value
Form Name of a form or string variable containing a form name.
Index Integer expression containing the index of a control on the form.
Property Name of the control property to access.
var Variable that will contain the value of the property. The data type depends on which property
is specified.
value Expression for the new value of the property. The data type depends on which property is
specified.

Remarks
Use the Controls property to access controls on the form using an index. This allows you to iterate through
the control collection and get or set common properties.

See Also
Count, Type

Example
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

72 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Count Property

Count Property

Applies To
Form.Controls

Description
Gets the number of controls on a form.

Usage
GGet Form.Controls.Count, var
Form Name of a form or string variable containing a form name.
var Integer variable that will contain the value of the property.
Values
Returns the number of controls on a form.

Remarks
Use the Count property to determine the number of controls on a form. Then you can iterate through all the
controls using the Controls property.

See Also
Controls, Type

Example
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

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 73

DblClick Event

DblClick Event

Applies To
Label, ListBox, Led, PictureBox, VideoBox, LED, ProgressBar, Grid

Description
Occurs when a control is double clicked.

Usage
Form_Control_DblClick (Sender$ As String)
Sender$ Name of a control that sent the event.

Remarks
The DblClick event is used to respond to a double click on a control by the user. You can use the
Sender$ parameter to determine which control sent the event.

See Also
Label, ListBox, PictureBox, VideoBox, LED, ProgressBar

Example
Function frmMain_lstModels_DblClick(Sender$ As String)
Integer index
GGet frmMain.lstModels.SelectedIndex, index
GGet frmMain.lstModels.List(index), g_CurrModel$
Fend

74 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 DialogResult Property

DialogResult Property

Applies To
Form

Description
Gets or sets the dialog result for a form.

Usage
GGet Form.DialogResult, var
GSet Form.DialogResult, value
Form Name of a form or string variable containing a form name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – None
1 – OK
2 – Cancel
Default: 2 – Cancel
Remarks
DialogResult is used to indicated if the user accepted a form or canceled it. Typically, a dialog has an OK
button and a Cancel button. When the user clicks the OK button, the DialogResult property is set to 1 - OK
in the button click event. If the Cancel button is clicked, the DialogResult property is set to 2 – Cancel.
See Also
Form
Example
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

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 75

Dock Property

Dock Property

Applies To
ProgressBar, StausBar

Description
Gets or sets a docking operation of the status bar.

Usage
GGet Form.Control.Dock, var
GSet Form.Control.Dock, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – None
1 – Top
2 – Bottom
3 – Left
4 – Right
5 – Fill
Default: ProgressBar: 0 – None, StatusBar: 2 - Bottom

See Also
ProgressBar, StatusBar

Example
GSet frmStatus.ProgressBar1.Dock, DOCK_TOP

76 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 DropDownStyle Property

DropDownStyle Property

Applies To
ComboBox

Description
Gets or sets a value specifying the style of the combo box.

Usage
GGet Form.Control.DropDownStyle, var
GSet Form.Control.DropDownStyle, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – Simple
1 – DropDown
2 – DropDownList
Default: 1 – DropDown

Remarks
The DropDownStyle property controls the interface that is presented to the user. You can enter a value that
provides a simple drop-down list box, where the list always displays, a drop-down list box, where the text
portion is not editable and you must select an arrow to view the drop-down, or the default drop-down list
box, where the text portion is editable and the user must press the arrow key to view the list. To always
display a list that the user cannot edit, use a ListBox control.

See Also
ComboBox

Example
GSet frmMain.cmbPartNames.DropDownStyle, DROPDOWNSTYLE_SIMPLE

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 77

Enabled Property

Enabled Property

Applies To
Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox, Timer,
VideoBox, LED, ProgressBar, TrackBar, StatusBar, Grid

Description
Gets or sets whether a control is enabled or not at runtime.

Usage
GGet Form.Control.Enabled, var
GSet Form.Control.Enabled, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 1 – True (for others than Timer)
0 – False (for Timer)

Remarks
In certain situations, you need to prevent the operator from clicking a control, such as a button. For example,
when SPEL+ tasks are not running, you can dim a Pause button by setting Enabled to 0 – False.

See Also
Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox, Timer,
VideoBox, LED, ProgressBar, TrackBar, StatusBar

Example
GSet frmMain.btnPause.Enabled, False

78 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 EventTaskType Property

EventTaskType Property

Applies To
Form, Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox,
VideoBox, LED, ProgressBar, TrackBar, StatusBar, Grid

Description
Gets the task type of the function that starts with the event.

Usage
GGet Form.[Control].EventTaskType, var
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.

Values
0 – Normal
1 – NoPause
2 – NoEmgAbort
Default: 0 – Normal

Remarks
When this property is set to 1–NoPause, the event handler function is able to be run when other tasks are
paused.
When this property is set to 2–NoEmgAbort, the event handler function is able to be run in the emergency
stop state.

See Also
Form, Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox,
VideoBox, LED, ProgressBar, TrackBar, StatusBar

Example
Integer Ttype
GGet frmMain.btnPause.EventTaskType, Ttype

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 79

Font Property

Font Property

From GUI Only

Applies To
Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, GroupBox, LED, StatusBar

Description
The Font property allows you to change font parameters for a control at design time. (Font name, style, size)

Usage
From the GUI Builder window Property Grid, select a control on a form and click the button in the Font
property value. The following dialog is displayed.

Change the settings and click OK to save them.

See Also
Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, GroupBox, LED, StatusBar

80 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 FontBold Property

FontBold Property

Applies To
Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, GroupBox, LED, StatusBar

Description
Gets or sets if the font for the text used on a control is bold at runtime.

Usage
GGet Form.Control.FontBold, var
GSet Form.Control.FontBold, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

See Also
Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, GroupBox, LED, StatusBar,
FontName, FontItalic, FontSize

Example
GSet frmMain.btnOK.FontBold, True

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 81

FontItalic Property

FontItalic Property

Applies To
Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, GroupBox, LED, StatusBar

Description
Gets or sets if the font for a control is italic at runtime.

Usage
GGet Form.Control.FontItalic, var
GSet Form.Control.FontItalic, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

See Also
Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, GroupBox, LED, StatusBar,
FontName, FontBold, FontSize

Example
GSet frmMain.btnOK.FontItalic, True

82 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 FontName Property

FontName Property

Applies To
Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, GroupBox, LED, StatusBar

Description
Gets or sets the font name of the text used on a control.

Usage
GGet Form.Control.FontName, var
GSet Form.Control.FontName, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string containing the name of the font.
Default: Microsoft Sans Serif

See Also
Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, GroupBox, LED, StatusBar,
FontSize, FontItalic, FontBold

Example
GSet frmMain.txtStatus.FontName, "Courier New"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 83

FontSize Property

FontSize Property

Applies To
Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, GroupBox, LED, StatusBar

Description
Gets or sets the font size of the text used on a control.

Usage
GGet Form.Control.FontSize, var
GSet Form.Control.FontSize, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Real variable that will contain the value of the property.
value Real expression for the new value of the property.

Values
The value of the font size in points.
Default: 8.25

See Also
Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, GroupBox, LED, StatusBar,
FontName, FontItalic, FontBold

Example
GSet frmMain.btnOK.FontSize, 16

84 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 ForeColor Property

ForeColor Property

Applies To
Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, GroupBox, LED, ProgressBar,
StatusBar

Description
Gets or sets the foreground color of a control.

Usage
GGet Form.Control.ForeColor, var
GSet Form.Control.ForeColor, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string that represents the foreground color of a control.
Default: Control Text (Button, Label, RadioButton, CheckBox, GroupBox, LED)
Window Text (TextBox, ListBox, ComboBox)

See Also
Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, GroupBox, LED, ProgressBar,
StatusBar

Example
GSet frmMain.btnOK.ForeColor, "Blue"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 85

FormBorderStyle Property

FormBorderStyle Property

Applies To
Form

Description
Gets or sets the border style of the form.

Usage
GGet Form.FormBorderStyle, var
GSet Form.FormBorderStyle, value
Form Name of a form or string variable containing a form name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – None
1 – Fixed Single
2 – Fixed3D
3 – FixedDialog
4 – Sizeable
Default: 3 – FixedDialog

See Also
Form

Example
GSet frmMain.FormBorderStyle, FORMBORDERSYTLE_NONE

86 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 GClose Statement

GClose Statement

Applies To
Form

Description
Close the form.

Usage
GClose Form
Form Name of a form or string variable containing a form name. You can also supply a system form
ID to close one of the following system windows:
WIN_IOMON Closes the I/O Monitor window.
WIN_TASKMGR Closes the Task Manager window.
WIN_FORCEMON Closes the Force Monitor window.
WIN_SIMULATOR Closes the Simulator window.

Remarks
Do not use GClose for a form which is not displayed.

See Also
GShow, GShowDialog

Example
GClose frmSetup

GClose WIN_TASKMGR

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 87

GGet Statement

GGet Statement

Description
GGet is used to get the values of properties for forms and controls in the current project.

Usage
GGet Form .Property, var
GGet Form .Control.Property, var
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
Property Name of the property to set or return the value of.
var Variable(s) that will contain the value(s) returned.

Remarks
GGet is used to retrieve the value of a property at runtime.

See Also
GSet

88 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 GraphicsEnabled Property

GraphicsEnabled Property

Applies To
VideoBox

Description
Gets or sets whether the VideoBox displays vision graphics or not.

Usage
GGet Form.Control.GraphicsEnabled, var
GSet Form.Control.GraphicsEnabled, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

See Also
VideoBox, VideoEnabled

Example
GSet frmMain.VideoBox1.GraphicsEnabled, True

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 89

GridEditor Property

GridEditor Property

Applies To
Grid

Description
Opens a designer to set up the Grid control.

Usage
The GridEditor property can only be used at design time. Allows the user to set up the grid in order to meet
their needs.
Setting Description
Add Column Adds a column at the end of the grid.
Minimum: 1
Maximum: 25
Add Row Adds a row at the bottom of the grid.
Minimum: 0
Maximum: 10000
Allow Editing Sets whether the user can edit cells in the selected column at runtime.
Allow Resizing Sets whether the user can resize the selected column at runtime.
Back Color Sets the back color of the selected column.
Cell Alignment Sets the alignment of the cell text.
Left: Aligns the cell text to the left of the column
Center: Aligns the cell text in the center of the column
Right: Aligns the cell text to the right of the column
Font Sets the font for the column headers.
Header Alignmnent Sets the alignment of the column headers.
Left: Aligns the column name to the left of the column
Center: Aligns the column name in the center of the column

90 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 GridEditor Property

Setting Description
Right: Aligns the column name to the right of the column
Header Lines Sets the amount of lines available in the column headers.
Minimum: 1
Maximum: 3
Remove Column Removes the selected column.
Remove Row Removes the selected row.
Resize Method Decides how to resize the columns in the grid whenever a column is added,
removed, or resized.
Auto: Automatically resizes columns to fit the grid control.
Free: Each column has their own independent width.
Synchronized: Makes all of the columns the same size when a column is
resized.
Row Count Sets/displays the number of rows in the grid. To manually change this value,
type in the desired rows and click <Apply> button.
Show Row Selectors Sets whether to show the row selectors that are located on the left side of the
grid.
Width Sets/displays the width of the selected column. To manually change this
value, Resize Method must not be Auto.

Remarks
Use the designer to configure the grid and how it will first appear at runtime. You can add text to cells at
designtime and/or add data at runtime.
Columns can be moved by dragging and dropping them to desired locations. They can also be swapped with
other columns by using the drop down arrow in the column header.
Columns can be renamed by double clicking on the desired column header.
The designer supports cut, copy, paste, undo, and redo operations using a right-click menu and shortcuts.
Multiple rows can be selected when Show Row Selectors is set to True.

See Also
Grid

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 91

GSet Statement

GSet Statement

Description
GSet is used to set the values of properties in GUI Builder.

Usage
GSet Form .Property, value
GSet Form .Control.Property, value
Form Name of a form or string variable containing a form name.
Control Name of an control or string variable containing an object name. The control must exist in the
specified form.
Property Name of the property to set the value of.
value The expression that holds the data to be set.

Remarks
GSet is used to set the value of a form or control property at runtime.

See Also
GGet

92 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 GShow Statement

GShow Statement

Applies To
Form

Description
GShow displays a form as a non-modal window.

Usage
GShow Form
Form Name of a form or string variable containing a form name. You can also supply a system form
ID to show one of the following system windows:
WIN_IOMON Opens the I/O Monitor window.
WIN_TASKMGR Opens the Task Manager window.
WIN_FORCEMON Opens the Force Monitor window.
WIN_SIMULATOR Opens the Simulator window.

See Also
GClose, GShowDialog

Example
GShow frmIODiags

GShow WIN_TASKMGR

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 93

GShowDialog Function

GShowDialog Function

Applies To
Form

Description
GShowDialog displays a form as a modal dialog box and returns the DialogResult value.

Usage
GShowDialog(Form)
Form Name of a form or string variable containing a form name.

Returns
The value of the form's DialogResult property is returned.

See Also
GShow, GShowDialog Statement

Example
result = GShowDialog(frmSetup)
If result = DIALOGRESULT_OK Then
Call SaveSettings
EndIf

94 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 GShowDialog Statement

GShowDialog Statement

Applies To
Form

Description
GShowDialog displays a form as a modal dialog box without returning the DialogResult value.

Usage
GShowDialog Form
Form Name of a form or string variable containing a form name.

See Also
GShow, GShowDialog Function

Example
GShowDialog frmInfoDisplay

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 95

Height Property

Height Property

Applies To
Form, Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox,
VideoBox, LED, ProgressBar, TrackBar, StatusBar, Grid

Description
Get or sets the height of a form or control in pixels.

Usage
GGet Form.[Control].Height, var
GSet Form.[Control].Height, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
An integer representing the height in pixels.

See Also
Form, Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox,
VideoBox, LED, ProgressBar, TrackBar, StatusBar, Left, Top, Width

Example
GSet frmMain.btnOK.Height, 48

96 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 HelpButton Property

HelpButton Property

Applies To
Form

Description
Gets or sets a value indicating whether a Help button should be displayed in the caption box of the form.

Usage
GGet Form.HelpButton, var
GSet Form.HelpButton, value
Form Name of a form or string variable containing a form name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

Remarks
When this property is set to 1 – True, a small button with a question mark appears in the caption bar to the
left of the Close button (when MaximizeBox, MinimizeBox properties are set to “False”). You can use this
button to display help for your application.

See Also
Form, HelpID

Example
GSet frmMain.HelpButton, True

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 97

HelpID Property

HelpID Property

Applies To
Form

Description
Returns or sets an Integer containing the HelpID for a topic in a Help file.

Usage
GGet Form.HelpID, var
GSet Form.HelpID, value
Form Name of a form or string variable containing a form name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
An integer value that is a topic ID in the help file. (0 to 999999)
Default: 0

Remarks
The HelpID property is used to display context-sensitive Help for an application. The help file is specified
in the EPSON RC+ Project | Properties | GUI Builder page.
When HelpID is not 0 and the user types F1 or clicks the form help button (if the HelpButton property is
True), then the help topic is displayed.

See Also
Form, HelpButton

Example
GSet frmMain.HelpID, 50

98 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Image Property

Image Property

Applies To
Button, Label, RadioButton, CheckBox, PictureBox

Description
Gets or sets the image that is displayed on a control.

Usage
GGet Form.Control.Image, var
GSet Form.Control.Image, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string containing the full path to an image file.
Default: Blank

NOTE
Using the Delete key, you can delete an image file that has already been set.

See Also
Button, Label, RadioButton, Checkbox, PictureBox, ImageAlign

Example
GSet frmMain.btnTools.Image, "c:\Images\Tools.bmp"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 99

ImageAlign Property

ImageAlign Property

Applies To
Button, Label, RadioButton, CheckBox, LED

Description
Gets or sets the image alignment for the image that is displayed on a control.

Usage
GGet Form.Control.ImageAlign, var
GSet Form.Control.ImageAlign, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
1 – TopLeft
2 – TopCenter
3 – TopRight
4 – MiddleLeft
5 – MiddleCenter
6 – MiddleRight
7 – BottomLeft
8 – BottomCenter
9 – BottomRight
Default: 5 – MiddleCenter (Button, Label, RadioButton, CheckBox)
4 – MiddleLeft (LED)

See Also
Button, Label, RadioButton, Checkbox, LED, Image, TextAlign

Example
GSet frmMain.btnTools.ImageAlign, IMAGEALIGN_MIDDLECENTER

100 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 ImageOff Property

ImageOff Property

Applies To
LED

Description
Gets or sets the image that is displayed when LED control is off.

Usage
GGet Form.Control.ImageOff, var
GSet Form.Control.ImageOff, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string containing the full path to an image file. The file extensions should be bmp, ico, jpeg, gif, wmf, or
png.
Default: LedOff.ico

See Also
LED, ImageOn

Example
GSet frmMain.Led1.ImageOff, "c:\EpsonRC70\GUI\Icons\LedOff.ico"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 101

ImageOn Property

ImageOn Property

Applies To
LED

Description
Gets or sets the image that is displayed when LED control is on.

Usage
GGet Form.Control.ImageOn, var
GSet Form.Control.ImageOn, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string containing the full path to an image file. The file extensions should be bmp, ico, jpeg, gif, wmf, or
png.
Default: LedRed.ico

See Also
LED, ImageOff

Example
GSet frmMain.Led1.ImageOn, "c:\EpsonRC70\GUI\Icons\LedRed.ico"

102 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Interval Property

Interval Property

Applies To
Timer

Description
Gets or sets the time, in milliseconds, between timer ticks.

Usage
GGet Form.Control.Interval, var
GSet Form.Control.Interval, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
The number of milliseconds between each timer tick. The integer value from 1 – 9999.
Default: 100

Remarks
To get the number of seconds in the interval, divide this number by 1,000.

See Also
Timer, Enabled

Example
GSet frmMain.tmrMain.Interval, 500

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 103

IOBit Property

IOBit Property

Applies To
LED

Description
Gets or sets the number of the I/Obit that indicates it to the LED Control.

Usage
GGet Form.Control.IOBit, var
GSet Form.Control.IOBit, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
The integer value from 0 to 9999
Default: 0

See Also
LED, IOType

Example
GSet frmMain.Led1.IOBit, 10

104 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 IOType Property

IOType Property

Applies To
LED

Description
Gets or sets the type of the I/O that indicates it to the LED Control.

Usage
GGet Form.Control.IOType, var
GSet Form.Control.IOType, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – Input
1 – Output
2 – Memory
Default: 0 – Input

See Also
LED, IOBit

Example
GSet frmMain.Led1.IOType, IOTYPE_OUTPUT

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 105

KeyPress Event

KeyPress Event

Applies To
TextBox

Description
Occurs when a key is pressed.

Usage
Form_Control_KeyPress (Sender$ As String, ByRef Key$ As String)
Sender$ Name of the control that sent the event.
Key$ The key that was pressed by the operator.

Remarks
The Keypress event can be used to detect the keys that are input by the operator. This event can be used as
a filter. You can change the key that was pressed by setting Key$ to another character. You can cancel a
keypress by setting Key$ to an empty string.

See Also
TextBox

Example
Function frmMain_txtSpeed_KeyPress(Sender$ As String, ByRef Key$ As String)

' Allow only digits to be entered

If Instr("0123456789" Key$) < 0 Then
Key$ = ""
EndIf
Fend

106 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 LargeChange Property

LargeChange Property

Applies To
TrackBar

Description
Gets or sets the number of positions that the slider moves when clicking the mouse or pressing Page Up and
Page Down keys.

Usage
GGet Form.Control.LargeChange, var
GSet Form.Control.LargeChange, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
An integer representing the number of positions that the slider moves.

See Also
TrackBar, SmallChange

Example
GSet frmMain.TrackBar1.LargeChange, 10

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 107

Left Property

Left Property

Applies To
Form, Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox,
VideoBox, LED, ProgressBar, TrackBar, StatusBar, Grid

Description
Get or sets the left coordinate of a form or control in pixels.

Usage
GGet Form.[Control].Left, var
GSet Form.[Control].Left, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
An integer representing the left coordinate in pixels.

See Also
Form, Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox,
VideoBox, LED, ProgressBar, TrackBar, StatusBar, Top, Height, Width

Example
GSet frmMain.btnOK.Left, 200

108 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 List Property

List Property

Applies To
ListBox, ComboBox

Description
Get or sets the string value of the specified element in the control item list.

Usage
GGet Form.Control.List(index), var
GSet Form.Control.List(index), value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
index Integer expression for the list array index staring with 0.
var Integer variable that will contain the value of the property.
value String expression for the new value of the property.

Values
String containing the specified list item.
Remarks
After using AddItem to add items to the ListBox or ComboBox list, you can use the List property to get or
edit the value of any of the items.
Setting a blank string, you can delete an item.

See Also
ComboBox, ListBox, ListCount, AddItem

Example
String part$
GGet frmMain.lstPartNames.List(0), part$

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 109

ListCount Property

ListCount Property

Applies To
ListBox, ComboBox

Description
Gets or sets the count of the number of items in a Listbox or Combobox.

Usage
GGet Form.Control.ListCount, var
GSet Form.Control.ListCount, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
The number of items in the list.

Remarks
To clear the items in a ListBox or ComboBox, you can set ListCount to 0. If ListCount is set to a value that
is higher than the number of items in the list, then empty text is added for the extra items.

See Also
ComboBox, ListBox, AddItem, List

Example
Integer count

' Retrieve the number of items in a list

GGet frmMain.lstPartNames.ListCount, count

' Clear the items in a list

GSet frmMain.lstPartName.ListCount, 0

110 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Load Event

Load Event

Applies To
Form

Description
Occurs before a form is displayed for the first time.

Usage
Form_Load (Sender$ As String)
Sender$ Name of the form that sent the event.

Remarks
You can use this event to perform tasks before a form is shown to the user.

See Also
Form, Resize, Closed

Example
Function frmMain_Load(Sender$ As String)

GSet frmMain.txtSpeed.Text, Str$(g_RobotSpeed)

Fend

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 111

MaximizeBox Property

MaximizeBox Property

Applies To
Form

Description
Gets or sets a value indicating whether the maximize button is displayed in the title bar of the form.

Usage
GGet Form.MaximizeBox, var
GSet Form.MaximizeBox, value
Form Name of a form or string variable containing a form name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

Remarks
A maximize button enables users to maximize a form to full screen.

See Also
Form, MinimizeBox

Example
GSet frmMain.MaximizeBox, True

112 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Maximum Property

Maximum Property

Applies To
ProgressBar, TrackBar

Description
Get or sets the maximum value of the processing range of the control.

Usage
GGet Form.Control.Maximum, var
GSet Form.Control.Maximum, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
The control must exist in the specified form.
var Integer variable that will contain the value of the property.
value String expression for the new value of the property.

Values
An integer representing the maximum value of the processing range.

See Also
ProgressBar, TrackBar, Minimum, Value

Example
GSet frmMain.TrackBar1.Maximum, 60

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 113

MinimizeBox Property

MinimizeBox Property

Applies To
Form

Description
Gets or sets a value indicating whether the minimize button is displayed in the title bar of the form.

Usage
GGet Form.MinimizeBox, var
GSet Form.MinimizeBox, value
Form Name of a form or string variable containing a form name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

Remarks
A minimize button enables users to minimize a form to an icon.

See Also
Form, MaximizeBox

Example
GSet frmMain.MinimizeBox, True

114 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Minimum Property

Minimum Property

Applies To
ProgressBar, TrackBar

Description
Get or sets the minimum value of the processing range of the control.

Usage
GGet Form.Control.Minimum, var
GSet Form.Control.Minimum, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
The control must exist in the specified form.
var Integer variable that will contain the value of the property.
value String expression for the new value of the property.

Values
An integer representing the minimum value of the processing range.

See Also
ProgressBar, TrackBar, Maximum, Value

Example
GSet frmMain.TrackBar1.Minimum, 10

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 115

MultiLine Property

MultiLine Property

Applies To
TextBox

Description
Gets or sets a value indicating whether this is a multiline TextBox control.

Usage
GGet Form.Control.MultiLine, var
GSet Form.Control.MultiLine, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

Remarks
If you want to display multiple lines in a TextBox control, you must set MultiLine to 1 – True.

See Also
TextBox, ScrollBars

Example
GSet frmMain.txtStatus.MultiLine, True

116 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Name Property

Name Property

Applies To
Form, Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox,
Timer, VideoBox, LED, ProgressBar, TrackBar, StatusBar, Grid

Description
Gets the name of a form or control at runtime. Used to set the Name of a form or control at design time.

Usage
GGet Form.[Control].Name, var
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.

Values
A string containing the name of the form or control.

See Also
Form, Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox,
Timer, VideoBox, LED, ProgressBar, TrackBar, StatusBar

Example
String name$
GGet frmMain.btnOK.Name, name$

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 117

Orientation Property

Orientation Property

Applies To
ProgressBar, TrackBar

Description
Get or sets the orientation of the control.

Usage
GGet Form.Control.Orientation, var
GSet Form.Control.Orientation, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
0 – Horizontal
1 – Vertical
Default: 0 – Horizontal

See Also
ProgressBar, TrackBar

Example
GSet frmMain.ProgressBar1.Orientation, ORIENT_VERTICAL

118 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 PasswordChar Property

PasswordChar Property

Applies To
TextBox

Description
Gets or sets the character used to mask characters of a password in a single-line TextBox control.

Usage
GGet Form.Control.PasswordChar, var
GSet Form.Control.PasswordChar, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string containing the character used for the mask.

Remarks
Use PasswordChar to hide the characters of a password. When the user types a character, the
PasswordChar is displayed. Note that the Multiline property for the TextBox control must be set to 0–False.

See Also
TextBox

Example
GSet frmMain.txtPassword.PasswordChar, "*"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 119

ProgressBarStyle Property

ProgressBarStyle Property

Applies To
ProgressBar

Description
Get or sets the style of the ProgressBar.

Usage
GGet Form.Control.ProgressBarStyle, var
GSet Form.Control.ProgressBarStyle, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
0 – Blocks
1 – Continuous
2 – Marquee
Default: 0 - Blocks

See Also
ProgressBar

Example
GSet frmMain.ProgressBar1.ProgressBarStyle, PROGRESSBAR_STYLE_MARQUEE

120 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 ReadOnly Property

ReadOnly Property

Applies To
TextBox

Description
Gets or sets which the textbox control is ReadOnly or not.

Usage
GGet Form.Control.ReadOnly, var
GSet Form.Control.ReadOnly, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
The control must exist in the specified form.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default 0 – False

Remarks
When this property is set to 1–True, Operator is not able to edit textbox.

See Also
TextBox

Example
GSet frmMain.txtSpeed.ReadOnly, True

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 121

RemoveRow Property

RemoveRow Property

Applies To
Grid

Description
Used to remove a row from a Grid control during runtime.

Usage
GSet Form.Control.RemoveRow, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
value Integer representing the index of the row being removed.

Values
An integer value containing the index of the removed row.

See Also
AddRow, Grid, RowCount

Example
GSet frmMain.Grid01.RemoveRow, 0

122 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Resize Event

Resize Event

Applies To
Form

Description
Occurs when the form is resized.

Usage
Form_Resize (Sender$ As String)
Sender$ Name of a form that sent the event.

See Also
Form, Load, Closed

Example
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

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 123

RobotNumber Property

RobotNumber Property

Applies To
StatusBar

Description
Get or sets the robot number to use when ShowRobot is True.

Usage
GGet Form.Control.RobotNumber, var
GSet Form.Control.RobotNumber, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
The control must exist in the specified form.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
An integer that specifies the robot number used to display the robot information.
Default: 1

See Also
StatusBar, ShowRobot

Example
GSet frmMain.StatusBar1.RobotNumber, 2

124 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 RowCount Property

RowCount Property

Applies To
Grid

Description
Used to set or get the number of rows in a Grid control.
If set to a value greater than the current number of lines, a new line will be added to the end. If set to a value
less than the current number of lines, a new line will be removed from the end.

Usage
GGet Form.Control.RowCount, var
GSet Form.Control.RowCount, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var Integer variable that will contain the number of rows in the control.
value Integer representing the total number of rows in the control.
Values
Integer value specifying the number of rows in the Grid.

See Also
AddRow, Grid, RemoveRow, RowCount

Example
Integer count
GSet frmMain.Grid01.RowCount, 50
GGet frmMain.Grid01.RowCount, count

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 125

Scroll Event

Scroll Event

Applies To
TrackBar

Description
Occurs when the track bar slider has been moved.

Usage
Form_Control_Scroll (Sender$ As String)
Sender$ Name of the control that sent the event.

See Also
TrackBar

Example
Function frmMain_TrackBar1_Scroll(Sender$ As String, Value As Integer)
Print "The trackbar value after scroll is", Value
Fend

126 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 ScrollBars Property

ScrollBars Property

Applies To
TextBox, Grid

Description
Gets or sets which scroll bars should appear in a multiline TextBox control.

Usage
GGet Form.Control.ScrollBars, var
GSet Form.Control.ScrollBars, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – None
1 – Horizontal
2 – Vertical
3 – Both
Default: 0 – None

Remarks
To use ScrollBars, the Multiline property for the TextBox control must be set to 1 – True.
To display the horizontal scroll bar, set WordWrap property to 0 – False.

See Also
TextBox, Multiline, WordWrap

Example
GSet frmMain.txtStatus.Scrollbars, SCROLLBARS_VERT

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 127

SelectedIndex Property

SelectedIndex Property

Applies To
ListBox, ComboBox, Grid

Description
Gets or sets the SelectedIndex property returns an index of the currently selected item

Usage
GGet Form.Control.SelectedIndex, var
GSet Form.Control.SelectedIndex, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
Returns the index of the selected item, starting with 0. -1 is returned if no items are selected.

Remarks
Use SelectedIndex to determine which item the user has selected in a ListBox or ComboBox. Typically,
you would do this in the Click event of the control.

See Also
AddItem, ComboBox, List, ListBox, Grid

Example
Integer index
GGet frmMain.lstParts.SelectedIndex, index

128 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 ShowDateTime Property

ShowDateTime Property

Applies To
StatusBar

Description
Gets or sets whether to display the current date and time on a StatusBar control.

Usage
GGet Form.Control.ShowDateTime, var
GSet Form.Control.ShowDateTime, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
The control must exist in the specified form.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

See Also
StatusBar, ShowEStop, ShowRobot, ShowSafeguard

Example
GSet frmMain.StatusBar1.ShowDateTime, True

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 129

ShowEStop Property

ShowEStop Property

Applies To
StatusBar

Description
Gets or sets whether to display EStop status on a StatusBar control.

Usage
GGet Form.Control.ShowEStop, var
GSet Form.Control.ShowEStop, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
The control must exist in the specified form.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

See Also
StatusBar, ShowDateTime, ShowRobot, ShowSafeguard

Example
GSet frmMain.StatusBar1.ShowEStop, True

130 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 ShowPrint Property

ShowPrint Property

Applies To
TextBox

Description
Gets or sets whether to display output from Print statements or not.

Usage
GGet Form.Control.ShowPrint, var
GSet Form.Control.ShowPrint, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

Remarks
When ShowPrint is True, then all output from Print statements executed in Spel tasks will be displayed in
the text box. If multiple text boxes have ShowPrint set to True, then all of the text boxes will show the print
output.

See Also
TextBox, ScrollBars

Example
GSet frmMain.txtStatus.ShowPrint, True

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 131

ShowRobot Property

ShowRobot Property

Applies To
StatusBar

Description
Get or sets whether to display the robot name and model that is specified by the RobotNumber property on a
StatusBar control.

Usage
GGet Form.Control.ShowRobot, var
GSet Form.Control.ShowRobot, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
The control must exist in the specified form.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

See Also
StatusBar, ShowDateTime, ShowEStop, ShowSafeguard

Example
GSet frmMain.StatusBar1.ShowRobot, True

132 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 ShowSafeguard Property

ShowSafeguard Property

Applies To
StatusBar

Description
Get or sets whether to display the Safeguard status on a StatusBar control.

Usage
GGet Form.Control.ShowSafeguard, var
GSet Form.Control.ShowSafeguard, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
The control must exist in the specified form.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

See Also
StatusBar, ShowDateTime, ShowEStop, ShowRobot

Example
GSet frmMain.StatusBar1.ShowSafeguard, True

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 133

SizeMode Property

SizeMode Property

Applies To
PictureBox

Description
Indicates how the image is displayed.

Usage
GGet Form.Control.SizeMode, var
GSet Form.Control.SizeMode, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – Normal
1 – StretchImage
2 – AutoSize
3 – CenterImage
4 – Zoom
Default: 0 – Normal

Remarks
By default, in Normal mode, the image is placed in the upper left corner of the PictureBox, and any part of
the image too big for the PictureBox is clipped. Using the StretchImage value causes the image to stretch to
fit the PictureBox. Using the AutoSize value causes the control to resize to always fit the image. Using the
CenterImage value causes the image to be centered in the PictureBox. Using the Zoom value causes the
image to stretch to fit the PictureBox keeping the same aspect ratio.

See Also
PictureBox, Image, ImageAlign

Example
GSet frmMain.picLogo.SizeMode, SIZEMODE_AUTOSIZE

134 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 SmallChange Property

SmallChange Property

Applies To
TrackBar

Description
Gets or sets the number of positions that the slider moves for keyboard inputs (arrow orientation keys).

Usage
GGet Form.Control.SmallChange, var
GSet Form.Control.SmallChange, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
An integer representing the number of positions that the slider moves.

See Also
TrackBar, LargeChange

Example
GSet frmMain.TrackBar1.SmallChange, 5

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 135

Sorted Property

Sorted Property

Applies To
ComboBox, ListBox

Description
Gets or sets a value indicating whether the items in the ComboBox or ListBox are sorted alphabetically.
Sorting order: Numeric character (regardless of whether one-byte or two byte), alphabetical character,
Katakana, Hiragana, Kanji character

Usage
GGet Form.Control.Sorted, var
GSet Form.Control.Sorted, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

See Also
ComboBox, ListBox

Example
GSet frmMain.lstParts.Sorted, True

136 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 StartPosition Property

StartPosition Property

Applies To
Form

Description
Gets or sets the starting position of the form at run time.

Usage
GGet Form.StartPosition, var
GSet Form.StartPosition, value
Form Name of a form or string variable containing a form name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – Manual
1 – CenterScreen
2 – CenterParent
Default: 1 – CenterScreen

See Also
Form, WindowState

Example
GSet frmMain.StartPosition, STARTPOSITION_CENTERSCREEN

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 137

Step Property

Step Property

Applies To
ProgressBar

Description
Gets or sets the amount to increment the current value of the progress bar as a percentage of the length of the
progress indicator.

Usage
GGet Form.Control.Step, var
GSet Form.Control.Step, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
An integer representing the amount to increment the current value.

See Also
ProgressBar

Example
GSet frmMain.ProgressBar1.Step, 5

138 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 TabIndex Property

TabIndex Property

Applies To
Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox, VideoBox,
LED, ProgressBar, TrackBar, StatusBar, Grid

Description
Gets or sets the tab order of the control within its container.

Usage
GGet Form.Control.TabIndex, var
GSet Form.Control.TabIndex, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
The index of the tab order of the control.

See Also
Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox, VideoBox,
LED, ProgressBar, TrackBar, StatusBar

Example
GSet frmMain.txtStatus.TabIndex, 3

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 139

Text Property

Text Property

Applies To
Form, Button, Label, TextBox, RadioButton, CheckBox, ComboBox, GroupBox, LED, StatusBar

Description
Gets or sets the text associated with the control.

Usage
GGet Form.[Control].Text, var
GSet Form.[Control].Text, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string containing the text of the form or control.

See Also
Form, Button, Label, TextBox, RadioButton, Checkbox, ComboBox, GroupBox, LED, StatusBar, TextAlign

Example
GSet frmMain.lblName.Text, "Name: "

140 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 TextAlign Property

TextAlign Property

Applies To
Button, Label, TextBox, RadioButton, CheckBox, LED

Description
Gets or sets the alignment of text in the control.

Usage
GGet Form.Control.TextAlign, var
GSet Form.Control.TextAlign, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
For Button, Label, RadioButton, CheckBox controls
1 – TopLeft
2 – TopCenter
3 – TopRight
4 – MiddleLeft
5 – MiddleCenter
6 – MiddleRight
7 – BottomLeft
8 – BottomCenter
9 – BottomRight
Default : 1 – TopLeft (Label 1)
4 – MiddleLeft (RadioButton, CheckBox)
5 – MiddleCenter (Button)
6 – MiddleRight (LED)
For TextBox
1 – Left
2 – Center
3 – Right
Default: 1 – Left

See Also
Button, Label, TextBox, RadioButton, Checkbox, LED, Text

Example
GSet frmMain.lblName.TextAlign, TEXTALIGN_LEFT

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 141

Tick Event

Tick Event

Applies To
Timer

Description
Occurs when a Timer control reaches its Interval value.

Usage
Form_Control_Tick (Sender$ As String)
Sender$ Name of a control that sent the event.

See Also
Timer, Interval, Enabled

Example
Function frmMain_Timer1_Tick(Sender$ As String)

GSet frmMain.lblDateTime.Text, Date$ + " " + Time$

Fend

142 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 TickFrequency Property

TickFrequency Property

Applies To
TrackBar

Description
Gets or sets the interval of the tick marks on a TrackBar control.

Usage
GGet Form.Control.TickFrequency, var
GSet Form.Control.TickFrequency, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
An integer representing the interval of the tick marks.

See Also
TrackBar

Example
GSet frmMain.TrackBar1.TickFrequency, 5

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 143

TickStyle Property

TickStyle Property

Applies To
TrackBar

Description
Gets or sets where to display the tick marks on a TrackBar control.

Usage
GGet Form.Control.TickStyle, var
GSet Form.Control.TickStyle, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – None
1 – TopLeft
2 – BottomRight
3 – Both
Default: 2 - BottomRight

See Also
TrackBar

Example
GSet frmMain.TrackBar1.TickStyle, TICKSTYLE_BOTH

144 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 ToolTipText Property

ToolTipText Property

Applies To
Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox, VideoBox,
LED, ProgressBar, TrackBar, StatusBar, Grid

Description
Used to show a small rectangular pop-up window that displays a brief description of a control's purpose when
the user rests the mouse pointer over the control.

Usage
GGet Form.Control.ToolTipText, var
GSet Form.Control.ToolTipText, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
A string containing the tool tip text of the control.
Default: Empty string

See Also
Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox, VideoBox,
LED, ProgressBar, StatusBar, TrackBar

Example
GSet frmMain.btnStart.ToolTipText, "Click Here to Start"

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 145

Top Property

Top Property

Applies To
Form, Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox,
VideoBox, LED, ProgressBar, TrackBar, StatusBar, Grid

Description
Get or sets the top coordinate of a form or control in pixels.

Usage
GGet Form.[Control].Top, var
GSet Form.[Control].Top, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
An integer representing the top coordinate in pixels.

See Also
Form, Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox,
VideoBox, LED, ProgressBar, TrackBar, StatusBar, Left, Height, Width

Example
GSet frmMain.txtStatus.Top, 200

146 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Type Property

Type Property

Applies To
All Controls

Description
Gets the type name of a control.

Usage
GGet Form.Control.Type, var
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var String variable that will contain the value of the property.

Values
A string containing the name of the type of the control.

See Also
Controls

Example
GGet frmMain.Controls(index).Type, typeName$

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 147

Update Property

Update Property

Applies To
TextBox

Description
Gets or sets if the value of textbox is updated automatically or not when it is set to display the global variable.

Usage
GGet Form.Control.Update, var
GSet Form.Control.Update, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 1 – True

Remarks
To show a SPEL+ global variable on a textbox, set the global variable name in the Variable property. If the
Update property is set to 0–False, the global variable value is not updated.
When you set the TextBox Variable property to a global variable, by default RC+ automatically updates the
TextBox Text value with the value of the variable at runtime. The Update property default value is True. If
you want to allow a user to change the value of the same variable, you must set Update to False. This stops
the auto update so the user can type in a new value. When Update is set from False to True, RC+ sets the
value of the variable to the new value entered by the user in the TextBox. One method is to add a CheckBox
above the TextBox called “Change Value” or some similar name. In the ChechkBox Click event, use GGet
to get the checked state of the CheckBox and then use GSset to set the TextBox Update property. When the
box is checked, set Update to False.

See Also
TextBox, Variable

Example
GSet frmMain.txtStatus.Update, False

148 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Value Property

Value Property

Applies To
ProgressBar, TrackBar

Description
Gets or sets the value that represents the control’s current position.

Usage
GGet Form.Control.Value, var
GSet Form.Control.Value, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
The control must exist in the specified form.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
An integer representing the current value.

See Also
ProgressBar, TrackBar, Maximum, Minimum, Variable

Example
GSet form1.ProgressBar1.Value, 75

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 149

Variable Property

Variable Property

Applies To
TextBox, ProgressBar, TrackBar

Description
Gets or sets the name of a SPEL+ global variable used for the textbox display.

Usage
GGet Form.Control.Variable, var
GSet Form.Control.Variable, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var String variable that will contain the value of the property.
value String expression for the new value of the property.

Values
The name of a SPEL+ global variable in the current project.
Default: None

Remarks
When the Variable property is set to a SPEL+ global variable, then the Text value is automatically updated
at runtime to show the value of the variable.
When you set the TextBox Variable property to a global variable, by default RC+ automatically updates the
TextBox Text value with the value of the variable at runtime. The Update property default value is True. If
you want to allow a user to change the value of the same variable, you must set Update to False. This stops
the auto update so the user can type in a new value. When Update is set from False to True, RC+ sets the
value of the variable to the new value entered by the user in the TextBox. One method is to add a CheckBox
above the TextBox called “Change Value” or some similar name. In the ChechkBox Click event, use GGet
to get the checked state of the CheckBox and then use GSset to set the TextBox Update property. When the
box is checked, set Update to False.
When you set the ProgressBar Variable property to a global variable, the progress bar will display the value
of the variable.
When you set the TrackBar Variable property to a global variable, the variable value is set by the track bar.

See Also
TextBox, ProgressBar, TrackBar, Value

Example
GSet frmMain.txtStatus.Variable, "g_Status$"

150 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 VideoEnabled Property

VideoEnabled Property

Applies To
VideoBox

Description
Gets or sets whether the VideoBox displays video or not.

Usage
GGet Form.Control.VideoEnabled, var
GSet Form.Control.VideoEnabled, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
0 – False
1 – True
Default: 0 – False

See Also
VideoBox, GraphicsEnabled

Example
GSet frmMain.VideoBox1.VideoEnabled, True

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 151

Visible Property

Visible Property

Applies To
Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox, VideoBox,
LED, ProgressBar, StatusBar, TrackBar, Grid

Description
Gets or sets a value indicating whether the control is displayed at runtime.

Usage
GGet Form.Control.Visible, var
GSet Form.Control.Visible, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
1 – True Display the control
0 – False Don't display the control
Default: 1 – True

Remarks
If GGet is executed without loading a form by GShow or GShowDialog, the return value will be False.

See Also
Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox, VideoBox,
LED, ProgressBar, StatusBar, TrackBar, Enabled

Example
GSet frmMain.txtStatus.Visible, True

152 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 Width Property

Width Property

Applies To
Form, Button, Label, TextBox, RadioButton, CheckBox, ListBox, ComboBox, PictureBox, GroupBox1,
VideoBox, LED, ProgressBar, TrackBar, StatusBar, Grid

Description
Get or sets the width of a form or control in pixels.

Usage
GGet Form.[Control].Width, var
GSet Form.[Control].Width, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
An integer representing the width in pixels.

See Also
Form, Button, Label, TextBox, RadioButton, Checkbox, ListBox, ComboBox, PictureBox, GroupBox,
VideoBox, LED, ProgressBar, TrackBar, StatusBar, Left, Top, Height

Example
GSet frmMain.txtStatus.Width, 300

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 153

WindowState Property

WindowState Property

Applies To
Form

Description
Gets or sets the form's window state.

Usage
GGet Form.WindowState, var
GSet Form.WindowState, value
Form Name of a form or string variable containing a form name.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.

Values
0 – Normal
1 – Minimized
2 – Maximized
Default: 0 – Normal

See Also
Form

Example
GSet frmMain.WindowState, WINDOWSTATE_MAXIMIZED

154 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6

 WordWrap Property

WordWrap Property

Applies To
TextBox

Description
Indicates whether a multiline text box control automatically wraps words to the beginning of the next line
when necessary.

Usage
GGet Form.Control.WordWrap, var
GSet Form.Control.WordWrap, value
Form Name of a form or string variable containing a form name.
Control Name of a control or string variable containing a control name. The control must exist in the
specified form.
var Boolean variable that will contain the value of the property.
value Boolean expression for the new value of the property.

Values
1 – True : The multiline text box control wraps words
0 – False : The text box control automatically scrolls horizontally when the user types past the right edge
of the control.
Default : 1 – True

See Also
TextBox, Multiline, ScrollBars

Example
GSet frmMain.txtStatus.WordWrap, True

EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6 155

WordWrap Property

156 EPSON RC+ 7.0 option GUI Builder 7.0 Rev.6