To open the ‘Switch/Lamp’ dialog box, press [Draw] – [Switch/Lamp] or 
icon and click the background of page.
Shape Configuration
On the left side of the configuration window, you can setup the appearance and position of the switch/lamp object. You can choose the shape of the switch/lamp object and configure its size and position.
Item | Description |
Shape Select | You may decide a shape of the Switch/Lamp object. |
Nil Shape | Hides the shape of the object. It is marked with dotted lines in the editor, but the lines are not shown in the project runtime. |
Position Setting | Assign the position of the object. You can assign values from 0 to 32767. The X/Y position indicates the coordinates on the graphic page. When you manually setup the position, be cautious that the object does not exceed the page. |
Size Setting | Assign the size of the object. You can assign values from 0 to 32767. The size is based on the default size of the shape you have selected. When you manually setup the size, be cautious that the object does not exceed the page’s size. |
(1) Shape Select
When the lamp feature is disabled, only the switch shape will be selected. When the lamp feature is enabled, you can select images to indicate each status.
Item | Description |
Part Palette | Images provided by XpanelDesigner are listed here. You can select the categories from the combo box. |
Pattern | Displays each pattern of switch/lamp operation. You can apply the shape by double-clicking the item. |
New Palette | You can create a new switch/lamp image. Enter the file name(*.ipx) and press the ‘Save’ button to create a part file. |
Register | Registers each pattern of switch/lamp operation. You can use BMP, JPG, and PNG file format, from state 0 to state 16. |
Delete | Deletes the selected switch/lamp image from the list. Note that you cannot delete the default images provided by XpanelDesigner. |
OK | Applies the switch/lamp image with settings. |
Cancel | Closes the ‘Shape Select’ dialog box without configuration. |
Switch Feature
In this section, you can configure a function for the object when it is pressed in project runtime. The Switch functionality has operations such as bit switch, word switch, page switch and switch with special functions. You may check the operation order from the list.
Item | Description |
Switch Function | Decides to use the object as switch function. When the option is deselected, the object can only be used as a lamp function. |
Display Touch Highlight | If the option is selected, the object will be displayed with its reversed color when touched. |
Touch Down | Add the operation you wish to execute when pressing the button. |
Touch Up | Add the operation you wish to execute when releasing the button. |
Bit Switch | Defines a digital tag operation. |
Word Switch | Defines an analog tag operation. |
Page | Assigns the page to open when using the object. |
Special Function | Assigns the command, key input, or writing momentary value function to the object. |
Edit | Edits the selected operation of the switch. |
Delete | Removes the selected operation from the switch. |
(1) Bit Switch
Item | Description | |
Address | Controls the object with the address of the device registered in “I/O Device”. You can decide the unit of the data: BIT or WORD. The detailed configuration can be done by pressing the | |
Tag Name | Enter the tag name to change the value when the switch is pressed. You can manually enter the tag name or press the Do not enter the analog or string tag name. | |
Function | Defines the action when the switch is pressed. | |
Set | Sets the digital tag value as ON(1). | |
Reset | Sets the digital tag value as OFF(0). | |
Set on touch | This feature can be treated the same as ‘Write momentary’. The tag value goes ON(1) as the switch is pressed, and the value goes OFF(0) as the switch is released. ※ ‘Set on touch’ function is supported in XpanelDesigner 2.53 and above versions. | |
Toggle | Reverses the state of the digital tag when it is pressed. (OFF(0) → ON(1) or ON(1) → OFF(0)) | |
(2) Word Switch
Item | Description | ||
Action | Defines an analog tag operation. | ||
Write Analog Value | Writes the assigned value to the corresponding tag. | ||
Tag Operation | The tag value will be calculated based on the set value and operator. | ||
Address | Controls the object with the address of the device registered in “I/O Device”. You can decide the unit of the data: BIT or WORD. The detailed configuration can be done by pressing the | ||
Tag Name | Enter the tag name to change the value when the switch is pressed. You can manually enter the tag name or press the Do not enter the digital or string tag name. | ||
Value | Assign a tag value to write when the switch is pressed. | ||
Hexa | Writes the value in hexadecimal in the input field. | ||
Using Tag | When you select this option, the input field is changed into a tag registering field. You can manually enter the tag name or browse the tag by clicking the When switch/lamp object operates, the tag value assigned to [Tag Name] becomes the value assigned to [Use Tag]. | ||
Operator | This item appears when you have selected the ‘Tag Operation’ action. The operators you can use are [+, -, AND, OR, XOR]. | ||
(3) Page Switch
Item | Description | |
Page Type | Assign the page to open when pressing the switch. | |
General Page | Enter the page file name in the text field to open. You may browse the page file by pressing the | |
Keypad Page | Enter the keypad page file name in the text field to open. You may browse the keypad page file by pressing the | |
Open Keypad Page | Assign the keypad page to open when pressing the switch. | |
Address | Gets the value with the address of the device registered in “I/O Device”. You can decide the unit of the data: BIT, WORD, or STRING. The detailed configuration can be done by pressing the | |
Tag Name | Enter the tag name to get the value when the switch is pressed. You can manually enter the tag name or press the | |
Horizontal / Vertical | Assign the location where the keypad page will be opened at ‘Vertical Scale’ and ‘Horizontal Scale’. It is recommended to enter a value smaller than the Xpanel’s resolution. | |
Max / Min | You can select the ‘Use Max/Min’ option to assign the range of values. If the option is deselected, the minimum and the maximum values are set equal to the tag’s values. | |
(4) Special Function
Item | Description | |
Command | You can write a command expression to execute. | |
Key Input | Operates as a key in a keyboard. Supports 83 keys in total, such as Arrow keys, HOME, END, PAGE UP/DOWN, INSERT, DELETE, LOCK Keys, Alphabets, Numbers, ENTER, SPACE, ESCAPE, PRINT SCREEN, PAUSE, F1~F12, TAB, “/”, “*”, “-“, “+”, “.”, CLEAR. | |
Write Momentary | Writes an instant value when you touch or release the object. | |
Down – Written Value | Inputs a value when you touch the object. | |
Up – Written Value | Inputs a value when you release the object. | |
Switch Common
This section explains the conditions when the user touches the switch/lamp object. You can also set a security level on the object.
Item | Description | |
Touch Condition Setting | Logical operations can be used to control touch features. When the result of a logical operation is True, the touch feature operates; otherwise it does not. | |
Action Delay Setting | Sets a delay option that executes by a set number of seconds. This option will be executed only when the button is pressed and held down for the assigned value. The value you can assign is from 1(100msec) to 30(30000msec) seconds. Or you can input an analog tag name to specify delay time according to the assigned value. | |
On Delay | When touching the object for the set amount of time, the assigned action set in ‘Touch Down’ would run. If untouched before reaching the set amount of time, the object would not operate. ‘On Delay’ is usable for the ‘Touch Down’ action. The ‘Touch Up’ action operates with no relation to ‘On Delay’. | |
Off Delay | The assigned action would operate when releasing the object after the set amount of time (Delay time). ‘Off Delay’ is usable for the ‘Touch Down’ or ‘Touch Up’ action. | |
Double Touch | The assigned action would operate when touching the object and retouch in intervals. ‘Double Touch’ is usable for the ‘Touch Down’ or ‘Touch Up’ action. | |
Display Delay Status | When this option is selected, the ‘Delay’ status will be added in the ‘Shape Select’ window. While ‘Delay setting’ is operating, the shape of the switch is changed into ‘Delay’ status so that you can view the delay time. ※ ‘Display Delay Status’ function is supported in XpanelDesigner 2.53 and above versions. | |
Visible | When the option is selected, enter the tag name in the input field to specify the tag for visible condition. When the visible condition is satisfied, the corresponding switch object will appear. ※ ‘Visible’ function is supported in XpanelDesigner 2.53 and above versions. | |
ON | Switch object appears when the assigned digital tag value is ON(1) or analog tag value is bigger than 0. | |
OFF | Switch object disappears when the assigned digital tag value is OFF(0) or analog tag value is 0. | |
Security | Sets a security level on the object. (1-10) ※ Please refer to the ‘Security’ manual for more information. | |
| If multiple switches are defined, they are disabled when one switch is operating, including the ‘On/Off Delay’ setting. If the value of the PLC contact is changed, the shape of the linked switch will be changed together. |
Lamp Feature
The ‘Lamp’ feature shows the appearance of object based on a condition. If lamp feature is disabled, the object will only display a switch image.
Item | Description | |
Enable Lamp | Decides the enablement of the lamp feature and type of the lamp. | |
Digital Tag | Operates by a combination of digital tags. Lamp state is changed according to data value or bit combination. | |
Analog Tag | Operates by a combination of analog tags. Changes the lamp state by tag value or bit combinations. | |
Number of States | Assigns the number of states to display a lamp object. | |
Condition of State | Changes the lamp state with two methods. | |
(1) Changing states with bit lamp
Item | Description |
With Data Condition Conversion | Each digital tag composes each digit of the binary number. The state of data is defined according to the combination of each digit. E.g.) If DIGITAL1 = 0, DIGITAL2 = 1, DIGITAL3 = 1 and DIGITAL4 = 0, they indicate 0110 in binary. Since it is equal to “6” in decimal, the ‘State 6’ is displayed. You can use a maximum of 16 states with this option. |
At Each Bit Conversion | Each digital tag represents a single state. If all digital tags’ values are “0”, “State 0” will be displayed. If the DIGITAL4 = 1, the “State 4” will be displayed. When multiple tags are set as “1”, the priority goes to the state with the lower number. You can use maximum 5 states with this option. |
(2) Changing states with word lamp
Item | Description |
With Data Condition Conversion | Displays the state with a single analog tag. Maximum 256 states can be displayed. |
At Each Bit Conversion | Since an analog is composed of a word, it is possible to display the states with 16 bits. It indicates that a word can display 17 states. Only one bit can be turned ON at a time. If any other bit is ON simultaneously, the priority goes to the less significant bit. E.g.) If the value of an analog tag is 3(0000 0000 0000 0011), State 1 and 2 are supposed to be ON. However, since State 1 has higher priority, the State 1 is ON. |