CONTROL
- Introduction to CTRL
- Control Classes
- Types of Control Functions
- Control graphics
- CONTROL Functions
  - Funtions A
  - Funtions B
  - Funtions C
  - Funtions D
  - Functions E
  - Functions F
  - Functions G
  - Functions H
  - Functions I
  - Functions J
  - Functions K
  - Functions L
  - Functions M
  - Functions N
  - Functions O
  - Functions P
  - Functions Q
  - Functions R
  - Functions S
  - Functions T
    - textEditor()
      Opens the text editor as a main window (not modally).
    - The Extension timedFuncConflicts()
      The timed function extension "timedFuncConflicts()" is designed to discover call conflicts between two or more timed functions. It compares the given parameters to analyze all conflicts and returns the result times.
    - trackZoomMode()
      Complies with the function "Rubber band zoom". After calling this function a cursor "cross" is displayed, which allows to create a window by left-clicking. The panel is scaled in accordance with the specified window size.
    - tanh()
      Calculates the hyperbolic tangent.
    - triggerAction()
      The function can be used to trigger an action from a GEDI or Script Editor extension script.
    - tan()
      Calculates the tangent.
    - tcpRead()
      Reads the data of a defined socket, which was opened with tcpOpen().
    - timedFuncEvents()
      The function timedFuncEvents() returns up to a given max_count all planned start_times (occurrences) when WinCC OA timedFunc would trigger a (start-)event. This function also handles the time periods (broadcast periods) (see Timed function extension) within the range defined by ’r;valid from’ and ’r;valid until’.
    - tr()
      The function translates the given combination (text, comment) into the requested language or the UI language if the lang argument is not given.
    - tcpShutdownOutput()
      Closes the write direction of a TCP socket.
    - timeFromGMT()
      Returns the difference between local time and GMT.
    - Timed function extension
      The timed function was extended and now provides several new functions:
    - throw()
      Signals an erroneous condition by using an error class variable.
    - tcpOpen()
      Opens the connection to a TCP/IP server socket.
    - triggerGlobalEvent()
      The function triggers a UI global event.
    - tcpWrite()
      Writes data to the defined socket.
    - timedFunc()
      Starts timed CTRL functions.
    - titleBar()
      Shows or hides the title bar in the specified module or in a child panel.
    - triggerEvent()
      The function triggers a specific event.
    - tcpClose()
      Closes a TCP/IP socket connection.
    - triggerEventWait()
      The function triggers a specific event and waits for the execution of the event.
    - throwError()
      Passes a WinCC OA error to the internal error handler.
    - tmpnam()
      Creates temporary file names.
  - Functions U
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- CtrlExtension
- CTRL-Debugger
  Der CTRL-Debugger ermöglicht ein Debuggen der Pogrammiersprache Control. Der Debugger kann über ein eigenes Panel verwendet werden, welches es auch erlaubt die Variablen zu beinflussen, Breakpoints zu setzen, usw.

throwError()

Passes a WinCC OA error to the internal error handler.

Synopsis

int throwError(dyn_errClass error); int throwError(errClass error);

Parameters


Parameter	Description
error	Error variable

Return value

Usually 0, in the event of an error -1.

Errors

Missing or incorrect arguments. If 0, "0 bytes" is returned, and if the value is less, then 0 an empty string is returned.

Description

The throwError() function passes an error variable to the WinCC OA system for further processing. By default, this results in the error being written to the PVSS_II.log file.

Example

This example gets a data point value via the dpGet function and checks if the get value is within a specific value range. The check is made via a switch/case structure. If the value is not within the value range, a separate information message from an own catalog file is shown. The error (value is not within the value range) is catched via the makeErrorfunction and the information message is shown via thethrowErrorfunction.

main()
{
  string cat, note1; /* Variable definitions for the makeError
  function */
  int prio,typ,co, dpG1;
  cat = "myError"; /* Definition of the catalog. The cat extension
  is not used. Only the name of the file. */
  prio=PRIO_INFO; /* Constant which defines the importance of the
  error of the information */
  typ =ERR_PARAM; //Type of the error
  co = 2; /* Sequence number of the information message from the
  own catalog "myError" */
  note1 = "The value should be between 2.0-2.2"; /* Additional
  information that is shown. Is an optional parameter */
  errClass retError; /* errClass variable for the makeError
  function */
  string dp1 = "ExampleDP_Arg1.:_original.._value";
  float answ;
  DebugN("dpGet");
  dpG1=dpGet(dp1, answ);
  if(answ) <= 2.2)
  DebugN("Value within the value range:");
  else
  {
    DebugN("make error");
    retError=makeError(cat,prio,typ,co,note1); /* Function call.
    Catches the error */
    DebugN("throwError");
    throwError(retError); /* Outputs the error message */
  }
}

Assignment

Errors

Availability

CTRL