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
    - scanTimeUTC()
      Determines the local time from a UTC time string.
    - scriptEditor()
      Starts the Script Editor and writes the entered script to a variable.
    - seAddCompletionItem()
      Allows to add new auto-complete suggestions for the script editor.
    - second()
      Returns the seconds part (0 ... 59) of a time t.
    - secureRandom()
      Calculates a sequence of secure integer pseudo random numbers.
    - seGetCompletionItem()
      The function returns a list of all user-defined completion items.
    - seGetCursorPos()
      Returns the current cursor position in the script editor.
    - seGetLine()
      Returns the code text from a specific line number in the script editor.
    - seGetScriptFileName()
      Returns the name of the file in which the script is located.
    - seGetSelectedText()
      Fetches the text selected in the script editor.
    - seGetSelectedTextPos()
      Returns the selected text coordinates in the script editor.
    - seInsertLine()
      Inserts a new line with the corresponding line number and a specific text into the script editor.
    - seLoadCoverageReport()
      The function loads a coverage report (an xml file).
    - semAcquire()
      The function semAcquire() tries to acquire n resources guarded by the semaphore.
    - semAvailable()
      The function semAvailable() returns the number of available resources in the given semaphore.
    - semRelease()
      The function semRelease() increases the number of the available resources in the given semaphore.
    - sendKeyClick()
      The function sends a key press and key release to the current input focus.
    - sendMail()
      The function sendMail() sends e-mails encrypted via the SMTP server.
    - sendMouseEvent()
      The function sends a mouse event to a target window.
    - sendSMS()
      The sendSMS() function sends an SMS message to a user-defined phone number. The message can be 128 characters long. The function also handles possible errors. Note that if you want to use the control function, the runtime script sms.ctl has to run in the console.
    - sendWheelEvent()
      The function sends a mouse-wheel event to a target window.
    - seRemoveLine()
      Removes a specific code line in the script editor.
    - seSetCursorPos()
      Sets the cursor on a specific position in the script editor.
    - seSetLine()
      Inserts a text in a specific line in the script editor. If a text already exists in this line, it will be replaced.
    - seSetLines()
      Inserts multiple lines of text in the selected lines in the script editor. The text already in the lines will be replaced.
    - setACount ()
      Sets an alarm number in an alarm time variable.
    - colorSetActiveScheme ()
      A color scheme is a collection of colorDB files located in a subdirectory of proj_path/colorDB, for example, proj_path/colorDB/DayScheme/colors. Hence, the name of the schema is "DayScheme" - the name of the directory. The function colorSetActiveScheme sets the active color scheme.
    - setActiveIconTheme()
      This functions sets an icon theme.
    - setAIdentifier()
      Sets the name of a data point in a time of an alert.
    - setApplicationProperty()
      Allows to edit application properties.
    - setBit()
      Sets a bit within a bit32/bit64 variable.
    - setClipboardText()
      Copies a specific text to the clipboard as plain text.
    - setClutteringLimits()
      This function is used for defining the zoom factor to show/hide layers (cluttering/decluttering) in individual panels.
    - setCursorPosition()
      Sets the cursor position to a specific coordinate.
    - setDbgFlag()
      The function allows to set debug flags inside of a CTRL script.
    - setDollarParams()
      This CTRL function is used to set the dollar parameters of the graphics reference. Only in the panel for reference configuration in the GEDI!
    - setenv()
      Sets the value of an environment variable.
    - setFileModificationTime()
      This function sets/changes the last modification date and time of a file.
    - setFilePermissions()
      Sets the permissions for a file.
    - setGroupNamePVSS() - deprecated
      Use the function UserManagementBaseType::UserAdmin/Classes/UserManagementBaseType/Methods/setFullName.html instead!
    - setInputFocus()
      Sets the input focus.
    - setLangString()
      Sets an entry of a langString to a string.
    - setMultiValue()
      Sets any number of graphics attributes of any number of graphics elements.
    - setPanelSize()
      Sets a child panel or a module (panel as a module) to a defined size.
    - setPattern()
      Sets a bit32/bit64 variable to a binary pattern.
    - setPeriod()
      Sets t to a particular number of seconds and milliseconds.
    - setQueryRDBDirect()
      Allows to change the queryRDBdirect settings to change between querying directly from the RDB or querying via the data manager during runtime.
    - setScaleStyle()
      Sets the scale style of the module for zooming.
    - setScript()
      Sets a control script to a graphical attribute.
    - setScriptLangId()
      Sets the current language of the script to the specified value.
    - setScriptUserId()
      Sets the current user ID of the script to the specified value.
    - setThrowErrorAsException()
      Allows to change the behavior for error handling within the current thread.
    - setTime()
      Sets a time to the value specified in the argument.
    - setTrace()
      Changes the trace level of the current thread.
    - setTrendByName ()
      Set a trend configuration to view by its trend name.
    - setTrendByObject()
      Set a trend configuration to view by object.
    - setUserEnabledPVSS()
      Enables the user.
    - setUserId()
      Sets the current user ID to the specified value.
    - setUserNamePVSS() - deprecated
      Use the function UserManagementBaseType::UserAdmin/Classes/UserManagementBaseType/Methods/setFullName.html instead!
    - setUserNameSSO()
      Sets the name of a WinCC OA user for SSO.
    - setUserOsIdPVSS() - deprecated
      Sets the OS ID for the user with the given WinCC OA user ID.
    - setValue()
      The function setValue() sets any number of graphics attributes of a graphics object.
    - setVariable()
      The function allows to set the value of the stated variable.
    - setWindowIcon()
      Sets the header of a module.
    - setWindowTitle()
      Sets the header of a module.
    - shapeExists()
      The function returns whether a graphics element exists in the panel.
    - showProgressBar()
      The function updates the status bar of a process.
    - showToolTip()
      The function shows a user-defined tooltip at the current mouse position. By default, the tooltip is shown until the mouse is moved.
    - sin()
      Calculates the sine.
    - sinh()
      Calculates the hyperbolic sine.
    - sizeof()
      Returns the length of a string, a dyn or a mapping variable.
    - snmpcrypt_encryptAccessParameter()
      The function allows to encrypt SNMP access parameters with the defined password of the corresponding driver ID.
    - snmpcrypt_setAccessPassPhrase()
      The function allows to set a password for the encryption of SNMP access parameters.
    - snmpMIBBrowserGetAdditionalInfos()
      Returns the additional information for the specified OIDs of a MIB file.
    - snmpMIBBrowserGetHierarchyNames()
      Returns subordinated OIDs and item names of a passed start OID.
    - sprintf()
      Formats a string.
    - sprintfPL()
      Formats a string. Like sprintf(), but change to the current WinCC OA language before converting.
    - sprintfUL()
      The function formats a string like sprintf()but changes to the current user language before formatting.
    - sqrt()
      Calculates the square root.
    - srand()
      Defines the initial value for the function rand().
    - sscanf()
      Reads data from "s" and stores the data according to the "format" parameter into the additional arguments.
    - sscanfPL()
      Imports a string in formatted form. Like sscanf(), but changes to the current WinCC OA language before converting.
    - sscanfUL()
      The function imports a string in formatted form. The function works like the function sscanf() but changes to the current user language before reading the string.
    - startAnimation()
      The function startAnimation() starts an animation group.
    - startAnimationWait()
      The function startAnimationWait() starts an animation group but unlike the function startAnimation() waits for the animation to finish.
    - startPanelRefConstruct()
      Starts the construction of the panel reference in the current panel in the GEDI.
    - startScript()
      The startScript function starts a script, which is independent from the script from where it was started.
    - startSound()
      Plays a WAV file.
    - startSymbol()
      Starts a panel reference in a panel after creating a reference via createSymbol(). The function is identical to the function addSymbol() but does not execute the initialize script.
    - startThread()
      Starts a function in a new thread.
    - stayOnTop()
      The function places the specified module above all non-topmost windows. The window of the module maintains its topmost position even when it is deactivated.
    - std_help()
      The function displays any page of the Online Help, an arbitrary HTML page in the browser or an arbitrary text/pdf file on the computer resp. on a computer in the network.
    - std_miniHelp()
      Calls a panel with the corresponding help.
    - stopAnimation()
      This function stops an animation.
    - stopScript()
      Stops a function by the stated ID.
    - stopSound()
      Stops the playback of a WAV file.
    - stopThread()
      Stops a thread.
    - strchange()
      Changes the content of a string at a specific index for a defined count of digits with a replacing string.
    - strexpand()
      Returns a formatted string.
    - strformat()
      Returns a formatted string.
    - stringEditor()
      You can use the function stringEditor() to edit string variables in, for example, text fields. This means string variables that are not saved in a file.
    - strjoin()
      This function is used to combine elements of a dyn_string to one string.
    - strlen()
      Returns the length of a string in Bytes.
    - strltrim()
      Removes certain characters from a string, beginning from left.
    - strpos()
      Returns the position of a string within another.
    - strreplace()
      Replaces parts of a string with another string.
    - strrtrim()
      Cuts certain characters out of a string, starting from the right.
    - strsplit()
      Splits strings using delimiters.
    - strtok()
      Searches a string for the first occurrence of any of a set of bytes.
    - strtolower()
      Changes a string to lowercase.
    - strtoupper()
      Changes a string to uppercase.
    - strwalk()
      The function allows to move through a string and returns the corresponding character of a specific position.
    - substr()
      Cuts a string or a character of a certain length (in Bytes) out of another string.
    - switchCtrlConnectionsToReplica()
      Switches Ctrl in split mode.
    - switchCtrlConnectionToReplica()
      Switches the CTRL with a specific number over.
    - switchLang()
      Function for switching the language at runtime in a user interface.
    - SwitchLayer()
      Switches the visibility of two layers.
    - SwitchLayerPanel()
      Switches the visibility of two layers in a specific panel.
    - SwitchLayerPanelInModule()
      Switches the visibility of two layers in a specific panel and module.
    - switchUiConnectionsToReplica()
      Switches the UI in the split mode.
    - switchUiConnectionToReplica()
      Switches a UI with a specific number in the split mode.
    - sysConnect()
      The function allows to connect to specific system events.
    - sysConnectUserData()
      The function allows to connect to specific system events.
    - sysDisconnect()
      The function allows to disconnect from a specific system events previously connect using sysConnect().
    - sysDisconnectUserData()
      The function allows to disconnect from a specific system events previously connect using sysConnectUserData().
    - system()
      Runs a system shell command.
    - systemDetached()
      The function runs a system shell command in the background.
  - Functions T
  - Functions U
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- CTRL Debugger
  With the CTRL Debugger you can debug the programming language Control.

switchLang()

Function for switching the language at runtime in a user interface.

Synopsis

int switchLang(int langIdx | OaLanguage lang | string lang);

Parameters


Parameter	Description
langIdx	Index of the language that is switched to during runtime in the user interface.
lang (OaLanguage)	Language, which can be switched at runtime in the user interface, given as OA language enum.
lang (string)	Language, which can be switched at runtime in the user interface, given as a string.

Return value

In the event of an error -1, otherwise 0.

Errors

Missing or incorrect parameters.

Description

Via this function, the language in a user interface can be changed at runtime (the language is changed for all modules and panels that were opened with the user interface manager). The languages, which can be switched, must be defined when creating the project (e.g. a multilingual project with "de_AT.utf8" and "en_US.utf8").

When using changeLang() or switchLang(), the Initialize script of the panel is executed again. For more detailed information on this behavior see the chapter Online language switching.

If the function switchLang() is used in a CTRL script, this script is aborted immediately after initialization of the panel (last command == switchLang()).

Switching of the user interface into German. Assign the following script to the "Clicked" event of a button:

main()
{
  int lang;
  lang = getLangIdx("de_AT.utf8");
  switchLang(lang);
}

Assignment

Multilingual functionality

Availability

UI