Enabling Real-Time Designer to Work with the WPF Connector
To enable Real-Time Designer to work with the WPF Connector:
| 1. | Complete the Real-Time Designer installation process. For more information, see the Real-Time Client and Designer Server Installation Guide. |
| 2. | Start the Real-Time Designer and select the Physical Objects tab. WPF is selected by default in the Connectors Enabled for Capture drop-down list. If you need to disable the WPF connector, clear the WPF checkbox. |
| 3. | Next, configure the WPF plugin settings in the System Settings window or the RTDesigner.exe.config file. Click the NICE button on the top-left of the window and select Settings to open the Real-Time Designer's System Settings window, then browse to the WPF Plugin Configuration section. |
For example, in the Multi Instance Classes Names parameter, you can define the names of the classes for which the Has multi instance option is checked by default when capturing a WPF object.
If you need to specify class names in your WPF application, or other parameters that Real-Time Designer uses to identify WPF screen elements, refer to the WPF Plugin Configuration section in the Advanced Process Automation System Administration Guide.
When running the WPF application, you do not need to configure the application to capture objects on it. The Real-Time Designer connects automatically to the WPF API.
| 4. | In the RTDesigner.exe.config file, the WPF connector’s settings can be found under the </configuration> section: |
<screenPluginWPFConfig SelfPropsRecOrder_Normal="BaseUri,WPFPath,WinRealName,WinName,ClassName,PersistId,Id,XYLocation" Window_Classes="Window" Tab_Classes="TabControl" Edit_Classes="TextBlock,TextBox,PasswordBox" Label_Classes="Text" Combo_Classes="ComboBox" Listbox_Classes="ListBox" Toolbar_Classes="ToolBar" Listview_Classes="ListView" Tree_Classes="TreeView" Grid_Classes="DataGrid" Button_Classes="Button" Radiobutton_Classes="RadioButton" Checkbox_Classes="CheckBox" Menu_Classes="Menu" Hyperlink_Classes="Hyperlink" />
The WPF connector settings in the RTDesigner.exe.config file present the same settings that are in the System Settings window in the Real-Time Designer.
After a successful installation, you can capture any WPF screen element type in a WPF application (see Capturing WPF Screen Elements).