Example 1. Opening Bing Maps on Windows Store App/Windows Phone

Note:

• The above code is for Windows Store App/Phone implementations of BrightForms, and will open the default Bing Maps application to the location provided in the URI.

• The address provided is "106 Derby Street, Silverwater NSW, Australia". Any URI special characters will be converted automatically.

• Only the first parameter of RunProgram() is used, containing the URI to launch the application, with data provided. The second parameter is ignored.

Example 2. Opening Apple Maps on iOS

Note:

• The above code is for iOS devices, and will open the URL specified with the device's mapping app - Apple Maps.

• The URL domain provided - 'maps.apple.com' is a reserved domain for the device to launch the stock Apple Maps app on all devices. Specifying a different URL will open a web browser (with exception to YouTube or iTunes URLs, which will open those variants respectively). If Google Maps is to be used, and is installed on the device, the URL scheme "comgooglemaps://?q=..." may be used.

• The address opened is "106 Derby Street, Silverwater NSW, Australia". Any URI special characters must be coded in the URI. This may be performed via the String.Replace() method for user inputted values, such as local.vUri = String.Replace(edtInput," ","%20");

• Only the first parameter of RunProgram() is used, containing the URL to launch the application, with data provided. The second parameter is ignored.

Example 3. Using RunProgram() on Android

Note:

• The above code is for Android, and will open the location specified with the default mapping application on the device.

• The URI conforms to the Google Maps API specification.

• On Android, the second parameter of RunProgram() is used to specify what action is to be taken with the URI - in this case it is "android.intent.action.VIEW". No additional parameters with System.SetObjectState() are required for this call. For more information, please refer to BrightForms on Android > Launching Applications via URI and Action in this document.

• The address opened is "106 Derby Street, Silverwater NSW, Australia". Any URI special characters will be converted automatically.

• If more than one application exists which can open the URI with VIEW action, and no default is provided, the user will be prompted to choose the application to run.

Note:

• The above code is for Android, and will open html file specified by the local.vHtmlFile variable in the default Android HTML viewer.

Example 4. Using RunProgram() with Windows Desktop/Mobile

Note:

• The above code is for Windows Desktop or Mobile (with path change) will start the specified program, then close BrightForms.

• "C:\Program Files\Microsoft Office\Office10\WINWORD.EXE" – a string value of the complete path for MS WORD.

• "" – the second parameter for RunProgram method specifying that no document is to be opened.

• Form.Close – a Form Object method that closes the form. Refer to the Form Objects.

Note:

• The above code is for Windows Desktop or Mobile (with path change) will start the specified program, then close BrightForms.

• "C:\Program Files\Microsoft Office\Office10\WINWORD.EXE" – a string value of the complete path for MS WORD.

• "" – the second parameter for RunProgram method specifying that no document is to be opened.

• Form.Close – a Form Object method that closes the form. Refer to the Form Objects.

Note:

• The above code is for Windows Desktop or Mobile (with path change) will open the specified file with the specified application.

• "C:\Program Files\Microsoft Office\Office10\WINWORD.EXE" – a string value of the complete path for MS WORD.

• "" – the second parameter for RunProgram method specifying that no document is to be opened.

• You can still use BrightForms application even if MS Word is already open.

Note:

• The above code is for Windows Desktop or Mobile (with path change) will open a new instance of BrightForms with different application.

• "C:\Program Files\BrightSoftware\BrightForms\BrightForms.exe" – the complete path and name of the external program to run.

• ""C:\DemoApps\export\DemoCustomer.bss"" – the complete path and name of the application to open enclosed in double quotes.

• The Main form for Test.bss application cannot be accessed until DemoCustomer.bss application is closed.

Example 5. Login using BrightForms User Settings.

Note:

• edtUserName and edtPassword – edit controls to enter username and password.

• Link this expression to a Login button on a Login form.

• Form.OpenChildForm method – opens the child form. Refer to Form Objects.

Example 6. Display device and project properties.

Note:

• label1, label2, label3, label4, label5 – labels displaying the properties.

• System.GetProjectId() returns the project ID that BrightServer has assigned the deployed project. If the project has not been deployed then it will return -1.

Example 7. Set dialup entry to use for connecting to BrightServer.

Note:

• This object method will set the RAS dialup entry to be used in synchronizing to BrightServer. RAS Dialup entries can be setup in the Dial Up tab in BrightForms Settings.

Example 8. Create a delay in the form before performing an action.

Note:

• Pause the application to stop for a period of milliseconds.

Example 9. Obtaining the OS of the device used.

Note:

• intOSResult – this is a form variable

• OS_PPC, OS_WIN32, OS_WINCE, OS_ANDROID, OS_WEB – these are system constants used to evaluate the OS Id.

Example 10. Check the web browser used.

Note:

• The above code checks whether the connected device is an iPod or iPad through the user agent string.

• local.vUserAgent– this is a variable which is assigned the user agent string

• OS_WEB – system constant id for web OS.

Example 11. Send File to user via web browser.

Note:

• When called, the above code will prompt the user to save a file

• local.Filename – this is a local variable which describes the local file on the machine running BrightWeb.

• local.vFileDisplay – this is the file name which is displayed to the end user in the browser dialog.