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
    - paCfgDeleteValue()
      The function deletes the first occurrence (top down) of the specified key (config entry) or key/value pair from the specified section in the config file.
    - paCfgInsertValue()
      The function adds a key (Config entry) /value (value of the config entry) pair to a specified section of the config file. You can also add the entry/value pair before or after the first or last search key (the search key is a specified config entry), before the first value (see the parameter table below).
    - paCfgReadValue()
      The function reads the value of a specified entry in a config file section. If there are several identical values, only the last one will be read.
    - paCfgReadValueDflt()
      The function returns either the value of the found entry or the default value.
    - paCfgReadValueList()
      The function reads all values of a config entry that exist more than once in a config file. The function can be used, for example, for reading the values of the proj_path entry, the LoadCtrlLibs entry or others.
    - paCurrentConfigFiles()
      The function shows what config files were read by the current manager.
    - paIsRunAsAdmin()
      The function checks if the process of the project administration is running with administrative privileges.
    - panelFileName()
      Returns the relative panel file name, for example, "vision/login.pnl"
    - PanelOff()
    - panelOff()
      Closes a defined childpanel without connection to the Event Manager.
    - PanelOffModule()
      Closes a panel in a specific module.
    - PanelOffPanel()
      Closes a particular panel
    - PanelOffReturn()
      Needed for closing a child panel with a return value.
    - panelPosition()
      Returns the position of a panel.
    - panelSelector()
      Opens the file selection dialog and writes the selected file name to a variable.
    - panelSize()
      Returns the width and height of a panel.
    - panelZoomIn()
      Zooms in the rootpanel in a module around the center with the specified zoom factor.
    - panelZoomOut()
      Zooms out the rootpanel in a module around the center with a specified zoom factor.
    - panningMode()
      Activates or deactivates the function for displacing the root panel in a module.
    - PasswordDialog()
      Opens a dialog for changing the password of the current user.
    - patternMatch()
      Checks whether a string has a particular pattern.
    - "pause"
      Pauses the playback.
    - period()
      Returns the seconds of a time t that have elapsed since 1.1.1970, 00:00 (UTC).
    - "play"
      Starts the playback of the given source.
    - pmonGetCount()
      The function pmonGetCount() returns the number of managers defined.
    - pmonGetName()
      The function pmonGetName() returns the name of the WinCC OA manager that corresponds to the specified index.
    - pmonGetNum()
      The function pmonGetNum() returns the number of a WinCC OA manager.
    - pmonGetOptions()
      The function pmonGetOptions() returns the manager options of a WinCC OA manager.
    - pmonGetPID()
      The function pmonGetPID() returns the process ID of a WinCC OA manager.
    - pmonGetResetMinutes()
      The function pmonGetResetMinutes() returns the reset minutes set for a WinCC OA manager.
    - pmonGetRestartCount()
      The function pmonGetRestartCount() returns the number of restarts set for a WinCC OA manager.
    - pmonGetSecondsToKill()
      The function pmonGetSecondsToKill() returns the set "seconds to kill" for a WinCC OA manager.
    - pmonGetStartMode()
      The function pmonGetStartMode() returns the start mode of a WinCC OA manager.
    - pmonGetStartTime()
      The function pmonGetStartTime() returns the start time of a WinCC OA manager.
    - pmonGetState()
      The function pmonGetState() returns the manager state of a WinCC OA manager.
    - pmonStartModeToStr()
      The function pmonStartModeToStr() converts a manager start mode of a WinCC OA manager into string format.
    - popupMenu()
      Activating a context-sensitive menu by means of right-clicking.
    - popupMenuXY()
      Opens a pop-up menu in a specific position.
    - popupMessage()
      Sends a pop-up message to the desired user interface. With this function you can send messages to other "foreign" user interfaces.
    - pow()
      Returns xy.
    - prepareValues()
      The method prepares the values that were assigned to the method for the upload.
    - printPanel()
      Prints a panel.
    - printRootPanel()
      Prints a particular root panel.
    - printTable()
      This function prints a table.
    - projectTranslationUnload()
      This function tells the manager to unload all currently loaded translation files.
    - projectTranslationUpdate()
      Scans all panels and scripts from one project level and updates the translation file.
    - pt_buildModuleName()
      The function is used in conjunction with panel topology when a multi-monitor mode has been chosen. The function creates a module with the specified name and number.
    - pt_moduleNumber()
      The function is used in conjunction with panel topology when a multi-monitor mode has been chosen. The function creates a mainModule & 2 from "mainModule_2".
    - pt_panelOn()
      The function is used in conjunction with panel topology and opens a panel in a module.
    - ptms_LoadOneBasePanel()
      If two base panels are started on two monitors and the base panel will be closed on one of the monitors, the function ptms_LoadOneBasePanel can be used to reopen the base panel on this monitor.
    - pvAddColumn()
      Adds a column with the specified label to the project view.
    - pvAddSeparator()
      Adds a separator between two options of the context menu in the project view. It is not possible to set a separator behind the last menu option or before the first menu option. Also it is possible to set only one separator between two options. If this function is used in the script between the same options multiple times, anyhow, only one separator will be shown in the context menu.
    - pvAddSubMenu()
      Adds a submenu.
    - pvConnect()
      Calls the specified function with the specified label.
    - pvRefreshNode()
      The function pvRefreshNode() is used to update the project view of the GEDI through reporting to the project view all new or deleted files since the last function call.
    - pvRemoveAllUserColumns()
      Deletes all columns that were added via pvAddColumn().
    - pvSetColumnProperties()
      Use the CTRL function "pvSetColumnProperties" to set certain column properties for a column in the project view of the GEDI. This function is for use in the projectView.ctl file only (wincc_oa_path/[Version]/scripts/gedi/projectView.ctl).
    - pvSetItemProperties()
      Sets the font and color for a file in a specific column.
    - pvSetItemText()
      Sets an item text for a file in a specific column.
  - Functions Q
  - Functions R
  - Functions S
  - Functions T
  - Functions U
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- 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.

projectTranslationUpdate()

Scans all panels and scripts from one project level and updates the translation file.

Synopsis

int projectTranslationUpdate(mapping options);

Parameters


Parameter	Description
options	The mapping can have the following key(string)/datatype of value, all key/value pairs are optional: "sourceLang"/string ... source language name, e.g. "en_US.utf8". If this is not given,"translationSourceLang" from the config will be used. If this is not defined there, auto-detect will be used. "sourceLevel"/int ... source project level number (default: 1); The level number is the same as in e.g. getPath() "targetLevel"/int ... target project level number (default: 1); The level number is the same as in e.g. getPath() "verbose"/bool ... (default: false) if true, each file processed is printed with an INFO message in the logfile (via ErrHdl).

Return value

The function returns 0 in case of success, -1 on error.

Error

In case of an error (e.g. a panel can not be opened), no translation file will be updated.

Description

The function scans all panels and scripts from one project level and updates the <translations>.ts file in all /msg/ subdirectories it finds.

Assignment

Multi-language capability

Availability

CTRL