CONTROL
- Introduction to CTRL
- CONTROL Classes
- Types of Control Functions
- Control graphics
  - Graphics objects
  - Attributes of graphics objects
    - Color string
      Differentiates between static and dynamic colors. Static colors do not change the color, whereas dynamic colors constitute a flashing pattern. Of course static colors can still be changed. Rapid periodic color changes are best realized with dynamic colors, however, which do not require any object Redraw.
    - Line-type string
      The line type defines how lines and curves are implemented, such as the borders for rectangles, circles, ellipses, polygons and plain texts. A line-type definition has five different parameters in WinCC OA, which must all be passed in a line-type string.
    - Fill-pattern string
    - Font string
      The font defines how individual characters in e.g. text fields, trend widgets, tables, selection lists, spin buttons, combo boxes, etc. will be implemented. Font strings are specified in a QT internal format, which are dealt with in the relevant manuals. This subject will not be dealt with here. For programming Control scripts, a dialog box can be opened from the script editor, which can be used to automatically insert the string with the required font into the script (see also chapter Font).
    - Format string
      Format strings specify the formatting of text fields and those plain texts used as output fields. Format strings consist of five arguments, although not all of these need to be specified. The position of the arguments in the string must be defined, however. For instance, if only the third parameter is to be set, the string must contain at least two commas, followed by the third parameter.
    - "antiAliased"
      The attribute defines if anti aliasing is used for the object.
    - "backCol"
      The attribute can be used to set the background color of a shape.
    - "cursor"
      The attribute "cursor" specifies the cursor type.
    - "effectiveFont"
      The read-only property returns the current font of the widget.
    - "focusPolicy"
      Gets or sets the focus policy.
    - "horizontalSizePolicy", "verticalSizePolicy"
      Allows to read/write the size policy of ashape, panel, shape group or panel reference..
    - "hotKey"
      This attribute returns the hot key for a shape.
    - "imageToClipboard"
    - "imageToFile"
      Saves an image of a graphics object (screenshot).
    - "layer"
      Defines the layer of a shape.
    - "layoutDirection"
      Defines the widget's layout direction.
    - "mapFromGlobal"
      The property allows to convert the global coordinates into panel relative coordinates.
    - "mapToGlobal"
      The property allows to convert the panel relative coordinates into global coordinates.
    - "minimumSize","maximumSize"
      Allows to define the minimum / maximum size of a shape
    - "namePath"
      This function returns the name path to the shape in the notation "Ref1.SubRef2.ShapeName3" for shapes within panel references.
    - "ownerRef"
      This read-only attribute returns a pointer to the panel reference the shape belongs to.
    - "panel"
      Returns the panel on which the graphics object is placed.
    - "panelFileName"
      Returns or writes the panel name of a reference in a panel.
    - "points"
      Sets or gets the geometrical representation of the object.
    - "refName";
      Returns the reference information for a shape meaning to what reference a shape belongs to.
    - "refPoint"
      Allows to read/write the reference point coordinates.
    - "script"
      Gets or sets the event script of a shape.
    - "scriptables"
      Gets all properties that are available for a shape.
    - "scriptNames"
      Gets all events that are available for a shape.
    - "shadowColor"
      This function sets the color for a shadow of a shape.
    - "shadowEnabled"
      This function enables or disables the shadow of an object.
    - "shadowOffset"
      This function specifies the number of pixels that the shadow is offset on the x- and y-axis.
    - "shadowRadius"
      This function sets the radius of an object's shadow.
    - "shapeType"
      Returns a string specific to the type of shape.
    - "showFocus"
      Defines if an object displays the focus state.
    - "styleSheet"
      Allows to define a custom style for separate widgets or panels to individually adapt them. These styles override the general stylesheet settings.
    - "toolTipText"
      This function sets a tool tip (for a corresponding graphics object. The text is displayed when the cursor points at the graphics object.
    - "transparentForMouse"
      The attribute "transparentForMouse" allows to prevent objects from using mouse events while objects in the background can be used with the mouse.
    - "transparentForMouseInGedi"
      The attribute "transparentForMouseInGedi" allows to prevent objects from using mouse events while objects in the background can be used with the mouse.
    - "zOrderAfter()"
      Moves a shape to be drawn after another shape.
    - "zOrderToBottom()"
      Moves a shape to be at the bottom.
    - "zOrderToBottom()"
      Moves a shape to be the top-most.
  - 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 - Properties and 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
  - TextEdit
  - Text field
  - Thumb wheel
  - ToggleSwitch EWO
  - Tree widget
  - Trend
  - VideoPlayer.ewo
  - WebView EWO
  - Zoom Navigator
    Functions available for the Zoom Navigator widget.
- CONTROL Functions
- CtrlExtension, basics
- 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.

"zOrderToBottom()"

Moves a shape to be at the bottom.

Synopsis

void shape.zOrderToBottom();

Parameters


Parameter	Description
-	-

Description

This function moves the shape in its layer to be at the bottom.

Note: This function cannot be used to change parts of or an entire panel reference.

Setting the current shape to be at the bottom:

this.zOrderToBottom();

Assignment

All graphic objects