CONTROL
- Introduction to CTRL
- CONTROL Classes
- Types of Control Functions
- CONTROL graphics
  - Control graphics
    - Graphics objects
    - Attributes of graphics objects
    - Panel functions
    - Reference Functions
    - Arc
    - AttentionEffect EWO functions
    - Bar trend
    - BarChart3D EWO
    - Button
    - Chart.ewo
    - Calendar
    - Cascade
    - Checkbox
    - Clock
    - Combobox
    - DateTimeEdit EWO functions
    - DialGauge EWO
    - DoubleSpinbox EWO
    - DpTreeView
    - DpTypeView
    - Embedded module
    - Frame
    - GIS Viewer EWO
      WinCC OA GIS Viewer provides the cartographic representation of objects in WinCC OA. This new feature provides numerous advantages, particularly in geographical distributed systems, like in Water, Traffic, Oil & Gas or Energy.
    - Label Functions
    - Layoutgroup functions
    - LCD number
    - Maps Widget - Eigenschaften und Funktionen
    - PDF Viewer EWO
    - PictureFlow EWO functions
    - Pipe
    - Polyline
    - Primitive text
    - Progress bar
    - Radio box
    - Rectangle
    - Reference Functions
    - Scheduler.ewo
    - Selection list
    - Slider
    - Spin button
    - Splitter
    - Tab
    - Table
    - TextEdit
    - Text field
    - Thumb wheel
    - ToggleSwitch EWO
    - Tree widget
    - Trend
    - WebView EWO
      - "back"
        This function loads the previous URL in the history list.
      - execJsFunction()
        The function allows to call a JavaScript function from within the WebView EWO JavaScript code directly from CTRL.
      - execJsFunctionDyn()
        The function allows to call a JavaScript function from within the WebView EWO JavaScript code directly from CTRL.
      - "forward"
        This function loads the next URL in the history list.
      - "ignoreSslErrors"
        This function allows the WebView Ewo to ignore SSL Errors.
      - "linkDelegationPolicy"
        This property controls the behaviour of the WebView Ewo when a link is clicked.
      - "load"
        This function loads the specified website.
      - "loadSnippet"
        Using this function an HTML page for the JavaScript Interface can be loaded within the WebView EWO.
      - msgToJs()
        This function is used to transfer data from Control to the JavaScript interface of the WebView EWO as response to the toCtrl() function.
      - "persistentCookies"
        This function controls the storing of cookies for the Webview EWO.
      - "reload"
        This function reloads the current page.
      - "setAttribute"
        This function allows to enable or disable several options per WebView instance.
      - "stop"
        This function stops the loading of the current page.
    - Zoom Navigator
      Functions available for the Zoom Navigator widget.
- CONTROL Functions
- CTRL-Debugger
  Der CTRL-Debugger ermöglicht ein Debuggen der Pogrammiersprache Control.

"loadSnippet"

Using this function an HTML page for the JavaScript Interface can be loaded within the WebView EWO.

Synopsis

void shape.loadSnippet(stringurl);

Description

The function loads the stated path inside of the EWO and provides the oaJsApi library.

The loaded file must not included <html>, <head> or <body> tags as these are generated automatically.

By default the host name of the event manager is used as well as the default port of the WinCC OA web server (Windows: 80/443, Linux: 8080/8443).

If the web server is not located on the same host as the event manager or a non default port is used the configuration can be changed using the config entry [ui] httpServer.

Example

[ui]
httpServer="https://first_redu:6655"

In case of a redundant project the active web server is automatically used in case the stated host name is one of the redundancy partners.

Example

Following example loads the file myHtmlFile.htm in which JavaScript code has been placed to be interact with the oaJsApi interface.

main()
{
  WebView_ewo1.loadSnippet("/data/html/myHtmlFile.html");
}

When using the JavaScript Interface within the ULC UX (the combination of loadSnippet() and ulcClientSideWidget = true) the Web Socket enables local access to the oaJsApi which can potentially be used to e.g. directly manipulate data point values from within the developer console of a web browser.

Assignment

WebView EWO, WebView EWO - JavaScript Interface