Create a source for linked objects.
	Save the screen with the source in an easy to access location.
	Create links to the source object.
	Create an Object that can be the Source for a Linked Object

1. Create the source for a linked object.

1. Open CimEdit.

2. Create all the objects you want to include in the linked object.

SCREEN 1

Note: The object can be a single object or group. Most often it will be a group. the remainder of this procedure assumes that a group will be linked.

3. Open the Properties - Group dialog box.

4. Name the group.

5. Create public or private variables needed in the group as follows.

A	Checked	Public	Values can be entered for the variable ID in the link container.
			This makes some values unique to that container.
B	Clear	Private	A value cannot change for the variable ID in the link container.

6. Implement events, procedures and scripts as needed.

7. Save the CimEdit screen that now contains the source object.

Result: Now screen designers can create links to the source object on other screens and change the public variables to those needed for each new link.

Note: Screen designers can also do a normal copy of the source object to create an unlinked object on a new screen. However, when they do, any changes you make to the source object will not automatically be made to the copied object.

2. Save the screen with the source in an easy to access location.

The screen with the source objects can be in any location that is available to the screens that will contain the links.

A convenient way to make the objects available is to add the screens to the Object Explorer.

3. Create links to the source object.

Create a link from either of the following.

Source screen

Object Explorer

1. Select a source object on the source screen, SCREEN1.

SCREEN 1

2. Hold down Ctrl+Shift keys and the left-mouse button.

3. Drag a link of the source object to another location button.

Note: Keep holding down the keys and button.

As you move the linked object to the destination screen, SCREEN2, the cursor looks like this.

4. Use the mouse or arrow keys to position the container where you want it on the destination screen, SCREEN2.

SCREEN 1	SCREEN 2
Source	Links

Result: The container is linked to the link source object.

Example. Create an Object that can be the Source for a Linked Object

This example creates a button with a script that increments a point and text that displays the current value of the point.

1. Open the CimEdit screen where you want to save your source objects.

2. Place a text button object on the CimEdit screen.

3. Place a text object underneath the button.

4. Change the text for the button object to ButtonName; name the object SetpointButton.

5. Change the text for the text object to Setpoint; name the object SetpointValue.

6. Group the two objects.

7. Open the group's Properties dialog box.

8. Name the group IncrementSetpoint.

9. Create two public variables that look like this:

Variable	Public	Value
ButtonName	Checked	"ButtonName"
PointValue	Checked	PointID

10. Select the SetpointButton object in the group.

11. Open the SetpointButton object's Properties dialog box.

12. Do the following configuration in the Properties dialog box.

Text Button.

In the Expression field, enter the variable {ButtonName}.

Event

1. Select a MouseUp event.

2. Create a new script in the Action field.

The script will increment the value of the Point ID assigned to the variable {PointValue}, as follows.:

Sub OnMouseUp(x As Long, y As Long, flags As Long)

   Dim var As CimObjectVariable

   Set var = CimGetScriptOwner().GetVariable("PointValue")

   i = PointGet(var.Value)

   PointSet var.Value, i+1

End Sub

Note: Even though the button owns the script, the variable will be resolved at the group level.

13. Select the Group tab.

14. Select the SetpointValue object in the group.

15. Open the SetpointValue object's Properties dialog box.

16. Do the following configuration in the Properties dialog box.

Text

In the Expression field, enter the variable {PointValue}.

17. Save the screen and close it.

More information

Create linked objects.

---