Editing a SpecView Project > Button Attributes & Strategy Controller Actions > SpecView: Write Text to another Text String

This Button/Strategy Controller Action will append or replace a piece of text to a designated Text parameter.

Follow the steps below to action Write Text to another Text String.

1.	Enter Edit Mode via File > Edit Mode (remain online) or Edit Mode (go offline).

If the Menu bar is not visible at the top, then Fullscreen Mode is enabled for that project.

Exit Fullscreen Mode by using the appropriate button on the screen or by using the Magic Square.

2.	Open up the Variables List.

3.	Create a Target String (Text Variable) to write to by using SpecView's User Variables.

If a Target String is already present, then skip Step 3.

For more details on how to create a User Variable please read Variables List - SpecView Variables.

4.	Navigate to the Strategy Controller Action or Button Attributes box.

5.	Select Write Text to another Text String from the Action drop down menu in the Strategy Controller Action or Button Attributes box.

6.	Click on Visual Editor.

7.	Click on Append to append a string to the Target String or Replace to replace the contents of the Target String.

Appending to the Target String can be dangerous as there is a 20,000 character limit on the Target String.

8.	Select the Target String from the Target Text String drop down menu.

9.	Enter the desired text in the Line for target text string field.

To add a new line, press Ctrl+Enter.

There are two ways to add live parameter values.

A.	Drag the parameter into the Line for target text string field from the Variables List.

B.	Enter the full instrument and parameter name encapsulated in %% as seen in the image below.

For example, the instrument name is DTB and the parameter name is Process Value.

To acquire the live value of the parameter for the Target Text String, the following has to be entered into the Line for target text string field, "%%DTB.Process Value%%".

This is called a Variable Substitution.

All variables used in the Target Text String must be on an open GDW to ensure proper operation of this Button/Strategy Controller Action.

10.	Add special characters if needed by entering the characters to the Special Characters field and clicking on Add Code.

11.	Select a Control Code from the Control Code drop down menu.

12.

Click OK.

Assuming the steps above were followed correctly, when the Button is clicked on or the Strategy Controller Event has been triggered, the text entered in the Line for target text string field should appear in the Target Text String parameter.