Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics you need to know before using WinCC OA.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
- Introduction to CTRL
  An introduction to the product's own programming language Control(CTRL).
- Control Classes
  The overview of classes available in Control.
- Types of Control Functions
  An overview of the types of functions distinguished within Control.
- Control graphics
  - Graphics objects
  - Attributes of graphics objects
  - Arc
  - AttentionEffect EWO functions
  - Bar trend
    - "acceptDrops"
      Specifies whether drop events are enabled for this object.
    - "colorBottom" - Element array
      Color of the bar element below the bar.
    - "colorBottom" - Time element array
      Color of the lower bar element within the tolerance range.
    - "colorCenter" - Element array
      Color of the average value element.
    - "colorCenter" - Time element array
      Color of the average value element section.
    - "colorChange"
      Defines the form of the color change.
    - "colorTop" - Element array
      Color of the bar element above the average value section.
    - "colorTop" - Time element array
      Color of the bar element above the average value section.
    - "colorTolHigh"
      Defines the bar color for values that exceed the upper tolerance value.
    - "colorTolLow"
      Defines the bar color for values that are below the lower tolerance value.
    - "colorTolOK"
      Defines the bar color when the value lies within the permitted tolerance.
    - "connection" - Curve
      Defines the display format for a curve.
    - "data" - Bars
      Data for the bar trend in the bar graph display mode.
    - "data" - Bar array
      Defines the Y values to be displayed.
    - "data" - Curve
      Data for the bar trend in the curve display mode.
    - "data" - Element array
      Specifies the data for the bar trend in the element array display mode.
    - "data" - Time element array
      Data for the bar trend in the time element array display mode.
    - "events" (obsolete)
      Gets all events that are available for a shape. Obsolete, use scriptNames instead.
    - "fill" - Curve
      Defines whether the area between curve and reference line is filled in.
    - "flush"
      Updates the trend and redraws it.
    - "font"
      Sets the font of an object.
    - "heightCenter" - Element array
      Height of the average value element.
    - "horVerLineColor"
    - "horVerLineStyle"
    - "lineColor"
      Defines the color of the curve.
    - "lineType"
      Defines the line type of the curve.
    - "refOrigin";
      Defines the origin of the reference value for the bars.
    - "refValue"
      Defines the reference value for the bars.
    - "showRange" - Element array
      Defines the type of display.
    - "showRange" - Time element array
      Defines the type of display.
    - "timeFormat"
      Defines the time format for the X-axis.
    - "tolHigh"
      Defines the upper tolerance value on the scale.
    - "tolLow"
      Defines the lower tolerance value on the scale.
    - "Type"
      Defines the type of the bar trend.
    - "updatesEnabled"
      This attribute specifies whether updates of a widget (for example, a textEdit, slider, progress bar, zoom navigator, LCD number or thumb wheel) have been enabled.
    - "widthCenter" - Element array
      Width of the average value bar.
    - "widthCenter" - Time element array
      Width of the average value bar section.
    - "widthGraphic"
      Returns the width of a graphic
    - "widthBottom" - Element array
      Width of the bar element below the average value.
    - "widthBottom" - Time element array
      Width of the bar element below the average value bar.
    - "widthTop" - Element array
      Width of the bar element above the average value.
    - "widthTop" - Time element array
      Width of the bar element above the average value bar.
    - "xArray"
      Additional data for the one-dimensional array. The xArray shows additional information for the X axis.
    - "xArrayFont"
      Changes the font for the additional x axis label.
    - "xArrayGrid"
      Specifies whether the xArray grid is visible.
    - "xArrayGridLineColor"
      Sets the color of grid lines for the X axis of a one dimensional array.
    - "xArrayGridLineStyle"
      The function "xArrayGridLineStyle" sets the style of the grid lines for the X axis of a one dimensional array.
    - "xArrayHeight"
      Defines the height of the bar for the one-dimensional array.
    - "xArrayShow"
      Specifies whether an array is displayed.
    - "xCenter"
      Defines the value at the origin of the X-axis.
    - "xFont", "yFont"
      The "xFont" and "yFont" functions set the fonts for the X and Y axes.
    - "xGrid"
      Setting for the grid lines.
    - "xGridLineColor", "yGridLineColor"
      The functions "xGridLineColor" and "yGridLineColor" set the colors of grid lines for X and Y axes.
    - "xGridLineStyle", "yGridLineStyle"
      The functions "xGridLineStyle" and "yGridLineStyle" set the style of the grid lines for the X and Y axes.
    - "xLines"
      Defines how the x-lines are displayed.
    - "xOrigin"
      Determines the origin of the X scale.
    - "xPrec"
      Number of decimal places for the X-axis scaling.
    - "xRange"
      Defines the scale of the X-axis.
    - "xStart" - Bar array
      Start position for the bars on the X-axis.
    - "xStart" - Element array
      Defines the start position for the bars on the X-axis.
    - "xStep"
      Specifies the distance between the X scale markings.
    - "xWidth" - Bar array
      This attribute can be used to define the width of the bars.
    - "xWidth" - Element array
      Defines the bar spacing on the X-axis.
    - "yCenter"
      Value at the origin of the Y-axis.
    - "yGrid"
      Specifies whether grid lines are displayed.
    - "yLines"
      Defines how the Y lines are displayed.
    - "yOrigin"
      Defines the origin of the Y scale.
    - "yPrec"
      Number of decimal places for the Y-axis range.
    - "yRange"
      Specifies the scale range in percent.
    - "yStep"
      Specifies the distance between the Y scale lines.
  - BarChart3D EWO
  - Button
  - Calendar
  - Cascade
  - Chart.ewo
  - 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 - Properties and Functions
  - Panel functions
  - 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
    The available functions of the Table object.
  - TextEdit
  - Text field
  - Thumb wheel
  - ToggleSwitch EWO
  - Tree widget
  - Trend
  - VideoPlayer.ewo
  - WebView EWO
    All events and functions, specifically available for the WebView EWO.
  - Zoom Navigator
    Functions available for the Zoom Navigator widget.
- CONTROL Functions
- CtrlExtension
  The CtrlExtension allows the addition of custom C++ code.
- CTRL Debugger
  You can use the CTRL debugger to debug the Control programming language. The debugger can be used via its own panel, which also enables the monitoring and setting of variable values during the execution of a script.
- SQL in CONTROL
  The database functions enable you to quickly carry out value queries on datapoints and elements.
- WinCC OA JavaScript Manager for Node.js
  The WinCC OA JavaScript Manager for Node.js is a manager that allows for the integration of the TypeScript/JavaScript runtime environment Node.js into WinCC OA.
- API Manager
  The WinCC OA API (Application Programming Interface) offers a number of functions adding special Managers to this process control system.
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
eLearning
Build Your Expertise Step by Step
Documentation
Basic information about terms and functions within the documentation.
Support & Services
An experienced team of support agents, consultants and trainers are ready to facilitate active partnerships with our customers, so they can profit from our comprehensive service.
Disclaimer
A brief clarification of liability exclusions or legal notices.
SIMATIC WinCC OA World
Explore the World of WinCC OA and Stay updated with the latest product news

"xArrayGrid"

Specifies whether the xArray grid is visible.

Synopsis

setValue(string shape, "xArrayGrid", bool on);

getValue(string shape, "xArrayGrid", bool &on);

shape.xArrayGrid(bool on);

Parameters


Parameter	Description
shape	Name of the object
on	Visible or invisible (TRUE/FALSE)

Description

This attribute can be used to specify whether the grid is visible or hidden.

Example

see "xArray"

Assignment

Bar trend