Getting Started – WPF Visual Studio
If you do not have a copy of Visual Studio you can download a free version of Visual Basic Community Edition for VB and C# from https://visualstudio.microsoft.com/vs/community/. If you have no experience with either Visual Basic or C# choose Visual Basic. No programming is required to use WPF HMI .NET.
The following steps can be used to add visualization to a C#, or Visual Basic.NET application. Refer to the VB.NET example for programmatic interface of using the OPC Controls components. All properties are programmatically accessible.
The following example demonstrates the use of OAS WPF HMI .NET with no code required:
Load the default DemoTags Tag configuration if you have replaced your tag configuration with your own tags.
Start Visual Studio and select File->New->Project to create a new C#, or VB.
Select WPF Application as the project type.
Save the project and set the Target Framework to the full 4.0 Version or greater.
To set the Target Framework in Visual Basic select the Compile tab and Advanced Compile Options button at the bottom.
In C# the Target Framework will appear in the Application tab.
Set the Target CPU to AnyCPU and the Target framework to .NET Framework 4 or greater.
(Do not use the Client Profile)
From the Toolbox if OPCWPFDashboard Controls components are not available right click in the Toolbox and select Choose Items. If it is available go to the next step.
Note: If you have installed Visual Studio after Open Automation Software you can either Browse and include the OPCWPFDashboard.dll assembly from C:\Program Files\Open Automation Software\OAS\ or uninstall Open Automation Software and reinstall to register the OPCWPFDashboard.dll assembly with Visual Studio.
From the WPF Components select all of the OPCWPFDashboard Controls components and then select OK. For 4.0 Framework solutions use OPCWPFDashboard Namespace controls. For 3.5 and 4.0 Framework solutions select OPCWPF Namespace.
If you want to make your Window adjustable for different screen resolutions and a sizeable Window with all controls automatically scaling specify a View Box.
When you create a WPF application by default the first container in the window is a Grid. Each container has an opening and closing statement in the XAML file.
<Window x:Class="MainWindow" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Title="MainWindow" Height="350" Width="525"> <Grid> ..... </Grid> </Window>
All of your content will be in the grid.
To create a window with resizeable content add a ViewBox to the window and put the grid in the ViewBox.
<Window x:Class="MainWindow" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Title="MainWindow" Height="350" Width="525"> <Viewbox> <Grid> .... </Grid> </Viewbox> </Window>
Select the view box and set the stretch property the way you want the application to respond. The options are None, Fill, Uniform and Uniform to Fill. The default is uniform.
Add an OPCWPFLabel component onto the Window.
Right click on the OPCWPFLabel and select Properties.
Select the Content_Tag property and use the browse button at the right to set the Open Automation Software Tag to Ramp.Value.
Note: If you wish to run this application on remote PCs make sure to include the Network Node or IP Address of the OAS Engine. Select your Network Node or IP Address in the Browse Tags window.
Value is the most commonly used Variable. See Tag Variables for a complete list of all variables possible.
Live Data Cloud Networking from local OAS Engine
Live Data Cloud Networking though remote OAS Engine
The following is an example of accessing an element of an array as a read only variable.
Note: All Tag names are case sensitive. Ramp.Value is valid, ramp.value is not.
Add an OPCWPFButton to the Form.
Set the Content_Tag to Pump.Value. If the Pump Tag does not exist create a Boolean Tag using Configure-Tags with the name Pump.
Set the Format fields as defined below…
Set the Background01_Tag to Pump.Value.
Set the SetValue_Tag to Pump.Value.
Add an OPCWPFTextBox to the Form.
Set the Text_Tag property to Pump.Value. The Format properties for Boolean to Off and On.
Select the Configuration Manager from the Build Menu.
Set the compile mode in the Configuration Manager to Release.
Select Build from the VS menu and select to Build the application.
Use Windows Explorer to browse for the application located in the bin\Release directory and run the application.
To deploy the application to remote nodes first make sure the Tags as described in Steps 4, 5, and 6 are set to a Network Node or IP Address. Then simply copy the files in the bin\Release directory to the target systems or follow the Smart Client deployment section in this help file to deploy your application using Click Once Deployment.
Note: You can also use the OPCWPFNetworkNodes component and assign a network node alias to change all “localhost” tags to the desired remote node. This is done with the AddNetworkNodeAlias method. Refer to the WinForm Example Code on the exact syntax of how to use this method. Notice how all controls data sources for a particular node can be reassigned to a remote node with one simple call.
There are many different properties to each control. In WPF you can convert graphics to an Image Brush. The Image Brush can then be used as a background in most OPCWPF and OPCWPFDashboard Controls.
The OPC WPF Data component can be used to access data via code with very simple methods. Refer to the .NET Real Time Data Access Programmatic Interface.