CONTROL
- Introduction to CTRL
  An introduction to the product's own programming language Control(CTRL).
- CONTROL Classes
- Types of Control Functions
  An overview of the types of functions distinguished within Control.
- 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..
    - "imageToClipboard"
    - "imageToFile"
      Saves an image of a graphics object (screenshot).
    - "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.
  - Arc
  - AttentionEffect EWO functions
  - Bar trend
  - 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 Functions
  - WebView EWO
    All events and functions, specifically available for the WebView EWO.
  - Zoom Navigator
    Functions available for the Zoom Navigator widget.
- CONTROL Functions
- CTRL Debugger
  With the CTRL Debugger you can debug the programming language Control.
- CtrlExtension
  The CtrlExtension allows the addition of custom C++ code.

"focusPolicy"

Gets or sets the focus policy.

Synopsis

setValue(string shape, "focusPolicy", string policy);

getValue(string shape, "focusPolicy", string policy);

shape.focusPolicy(string policy);

Parameters


Parameter	Description
shape	Name of the object
policy	Focus policy

Description

The attribute allows to define the focus behavior of the object. Following options are available:

NoFocus - The object will not receive focus even if it is directly clicked. Should not be used for input elements as it will prevent any text input.
StrongFocus - The object will receive the focus either via tab/backtab key or by clicking.(default)

Assignment

All widgets