16 Sep 2013

For other posts in this series, see our series list.

Recently I saw a question about how you can pass data between screens, which is something we do a lot of in our system – so I thought I would share details on how we do it. There is a number of ways to do this, so we will start this series with a simple way of passing a string.

As with each part of this series, the code can be found on GitHub.

Example 1: Passing a string

1. For the first example what we will do is pass a hard coded string from a button on screen to a second screen. We start off by adding a button (called Pop) to a screen.

image

2. We then create a screen for it, in our example the screen is called Weasel.

image

3. On the new screen we add a custom control and set the data to be Screen.

image

4. The core of this method is first to add a new data item. For this example we will specify it as follows

  • Screen Member Type: Local Property
  • Type: String
  • Is Required: True
  • Name: data

image

5. After you click OK, click on the data item in the right hand side and go to the properties and tick the check box: Is Parameter

image

6. For the execute event for the Pop button we add the following code: myapp.showWeasel(“pop goes the weasel”);

We are using the out of the box JavaScript here to launch the code, but if you have never done this before let us look into what that simple line has:

  • myapp: This is the namespace for our app. This is the same in every LightSwitch app.
  • showWeasel: This is the method to launch the window. LightSwitch uses the pattern of show followed by the screen name.
  • “pop…”: This is the data we want to pass across. We get this property on the method as we created the data item above and set it to be a parameter.

image

7. Finally we just need to show the string on the Weasel screen. To do that we need to add two events – first we will add the created event for the screen. The code we add here is to first put a variable outside the event (named d) and then in the event we add the following: d = screen.data;

In short, when the screen is created, we read the data property from the screen and set a global variable d to be that result.

image

8. Secondly, we select the custom control we added in step 3 and edit its render code.

In the render code we just set element.innerText = d;

This just renders the string, it isn’t important for passing the data other than to show what we got.

image

9. The final code will look like the following. One note, in the example below, it says screen.myData – but that should be screen.data as out data item is named data.

image

And that’s it! That is how to pass a simple string.

image

Comments

Manuel -VbMan's picture

It works! I would only add this: Step 1. when you add a button a modal screen will show asking you to select: "Write my own method" OR "Choose an existing method" Choose to write your own method and enter the function name: showWeasel() in Step 6 you will be able to edit that code by double clicking the function below your queries inside the left panel where your queries are located, your method should be at the bottom of the queries. Double click to edit. MAD MAD PROPS! Robert, your just made my FRIDAY!!! Task completed, going home now!
Manuel -VbMan's picture

Error: For this sentence; "Choose to write your own method and enter the function name: showWeasel()" Just enter the new function name you are about to add code to: 'showWeasel' without the (). VS will complain.

Add new comment