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
    - rad2deg()
      Converts an angle from a radian measure into degrees.
    - rand()
      Calculates a sequence of integer pseudo random numbers.
    - readDictionary()
      Appends the entries form a file to the internal dictionary.
    - readSMS()
      The readSMS() function reads a SMS message with the phone number of the sender and the time when the message has been sent. Possible errors will be read as well. If you want to use the control function, the runtime script sms.ctl has to run in the console.
    - recode()
      The function converts a string and returns the string in the desired encoding.
    - recodeFileName()
      Obsolete function. Converts a string from system encoding (e.g. ISO8859-1) to WinCC OA encoding (e.g. UTF8), function is intended to be used with file names, but can also be used for other strings.
    - reduActive()
      In a redundant system, returns the active computer.
    - reduSetActive()
      Activates the emergency switch on the left or on the right.
    - reduSetInactive()
      Deactivates the emergency switch on the left or on the right in a redundant system.
    - reduSetPreferred()
      Sets the Preferred to left or right in a redundant system.
    - reduSetSplitOff()
      Sets the split mode to off in a redundant project.
    - reduSetSplitOn()
      Sets the split mode in a redundant system.
    - reduSwitchDist()
      Switches over in the split mode.
    - reduSwitchDriver()
      Switches the drivers in the split mode.
    - regexpIndex()
      The function "regexpIndex()" provides pattern matching via regular expressions. The function searches for a match of the specified character starting from the given position.
    - regexpLastIndex()
      The function "regexpLastIndex()" provides pattern matching via regular expressions. The function searches for a match of the specified character(s) starting at the end of the string.
    - regexpSplit()
      The function "regexpSplit()" provides pattern matching via regular expressions.
    - registerDbgFlag()
      Registers a debug flag and returns a debug flag number.
    - releaseComObject()
      Releases the COM object.
    - remove()
      The function remove() deletes a file.
    - removeDoneCB()
      The function prevents the calculation of unwanted data in data point functions and statistical functions.
    - removeGlobal()
      Deletes the manager-wide global CTRL variable name.
    - removeGroup()
      The function removes a group connection from the panel.
    - removeGroupPVSS()
      Removes a WinCC OA group.
    - removeShape()
      The function removes a shape from the panel.
    - removeSymbol()
      The function is used to delete panel references.
    - removeUserFromGroupPVSS()
      Removes a WinCC OA group from a user.
    - removeUserPVSS()
      The function permanently disables a user.
    - rename()
      The function renames a file.
    - renameGroupPVSS()
      Renames a WinCC OA user group.
    - renameUserPVSS()
      Renames a WinCC OA user.
    - requestFileList()
      The function requestFileList() requests a file list from the manager with the specified manager Id.
    - requestFileTransfer()
      The function requestFileTransfer() requests a list of files to be transferred from the active to passive partner in a redundant project.
    - restorePanel()
      Opens an already loaded child panel that had been minimized.
    - rewind()
      Places the pointer at the beginning of the file FileDesc.
    - rmdir()
      The function deletes a specified directory.
    - rootPanel()
      Returns the name of a particular root panel.
    - RootPanelOn()
      Opens a new panel in the current module.
    - RootPanelOnModule()
      Opens a panel in a particular module.
    - RSAGenerateKeyPair()
      The function RSAGenerateKeyPair() generates a public and a private key for the functions RSASealEnvelope() and RSAOpenEnvelope().
    - RSAOpenEnvelope()
      The function RSAOpenEnvelope() decrypts data.
    - RSASealEnvelope()
      The function RSASealEnvelope() encrypts data.
    - runRealSQL()
      The function runRealSQL executes an SQL command that does not return a value such as INSERT or DELETE.
    - runRealSQLQuery()
      The function runRealSQLQuery executes an SQL query of the RDB database.
  - Functions S
  - 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.

removeGroup()

The function removes a group connection from the panel.

Synopsis

int removeGroup(shape groupPointer);

int removeGroup(string moduleName, string panelName, string groupName);

int removeGroup(shape panel, string groupName);

Parameter


Parameter	Description
groupPointer	Pointer to the group connection that should be removed.
moduleName	Name of the module.
panelName	Name of the panel.
groupName	Name of the group that should be removed.
panel	Pointer to the panel.

Return value

In case of an error -1 is returned or 0 in case of a success.

Error

-

Description

The function allows to remove a group connection from a panel. The group can either be a shape-group, a layout group or a panel reference. The objects contained inside of the group remain within the panel and are not removed for shape and layout groups.

In case a panel reference is used as target the function behaves as if calling removeSymbol() and the reference is removed.

Example

Following example removes the group connection "myRectGroup" from the current panel. Using the function shapeExists() it is written to the log if the group exists before and after being removed.

main(mapping event)
{
  DebugN(shapeExists("myRectGroup"));
  removeGroup(self, "myRectGroup");
  DebugN(shapeExists("myRectGroup"));
}

Assignment

Graphics

Availability

UI