There are times when you need to pass information to a child form. In these situations, you can use a parameter block in the same manor you would with a traditional ps1 script.

To do this, go to the form file’s script section and insert a Parameter block at the very top of the script. Once you add the parameter block, PowerShell Studio will color the parameters accordingly: It is very important that nothing but comments appear before the parameter block. Note: Script scope variables can also be used as an alternative to parameters. Now that you know how to pass values to a form, how do you get values back? Returning values depends on what you are referencing. SAPIEN POWERSHELL STUDIO EXECUTABLE DOT SOURCING HOW TO For example, Form files are handled differently the ps1 files. The Form’s Reference Function returns the DialogResult of the Form when it is closed. The return variables name convention is as follows: $_įor example, if AddEmployeeForm.pff has a TextBox named textBoxFirstName, PowerShell Studio will generate the following return variable: $AddEmployeeForm_textboxFirstName Luckily PowerShell Studio auto generates variable values with the values of controls in the form. When you use a Reference Function, PowerShell Studio’s PrimalSense will automatically include the return variables when you type $. The following is a list of controls that generate return values: Control The value contained in the variable depends on the control. In the case where the control doesn’t return a value or you want to return a custom value / object, you can create a variable using the script scope: $script:MyReturnValue =. if ( Call-AddEmployeeForm_pff ) –eq 'OK' ) Then you can reference the variable in the file that called the form. In the sample project, the amount of time the user took to complete the Add Employee form is saved in a script variable.

The main form then displays a message if the user took longer than the allotted time. Script (ps1) files simply return the objects via the pipeline as there is no form to return a DialogResult. Hopefully now you have the tools to create complex GUIs that utilize multiple forms.

The sample project below utilizes the techniques covered by this article. SAPIEN POWERSHELL STUDIO EXECUTABLE DOT SOURCING DOWNLOAD.SAPIEN POWERSHELL STUDIO EXECUTABLE DOT SOURCING HOW TO.

Sapien powershell studio