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’.
    - translate()
      Translates a term.
    - 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
- CTRL Debugger
  With the CTRL Debugger you can debug the programming language Control.

titleBar()

Shows or hides the title bar in the specified module or in a child panel.

Note that the function only works within the own UI manager. If you open a module in a new user interface manager and call the function for this module from another user interface manager it does not work. You have to call the function within the same user interface manager under that the module was opened.

Note that the function does not work if you use the save and run (quick test) option of the GEDI. The module has to be opened in a user interface

Synopsis

int titleBar(bool bFlag [, string moduleName, string panelName]);

Parameters


Parameter	Description
bFlag	Switch this property on or off.
module	The module that should be shown without title bar. If the value of bFlag is 1, the title bar of the module is shown. If the value of bFlag is 0, the title bar of the module is not shown.
panelName	Name of the panel that should be shown without title bar. If the value of bFlag is 1, the title bar of the child panel is shown. If the value of bFlag is 0, the title bar of the child panel is not shown.

Return value

0 on success, otherwise -1.

Errors

Missing or wrong arguments.

Description

Shows or hides the title bar in the specified module "module" or in a child panel "panelName".

Example

The title bar of the opened module (myModuleName()) will be hidden.

main()
{
  titleBar(0,myModuleName());
}

Example

Opens a new module and a panel within the module. The title bar of the module newModule will be hidden using the titleBar() function.

main()
{
  ModuleOnWithPanel("newModule",0,0,0,0,0,0,"","DPPanel.pnl","test", 
  makeDynString()); /* Opens a module called "newModule" and
  the
  panel called DPPanel.pnl within the module */
  int retVal;
  bool bFlag = FALSE;
  string module = "newModule";
  retVal= titleBar(bFlag, module); //hides the title bar
  DebugN(retVal);
}

EXAMPLE

In the following example a child panel is opened using a root panel. The title bar of the child panel is not shown.

The child panel "child.pnl" is opened using a root panel:

main()
{
  ChildPanelOnCentral("child.pnl","ABCD",makeDynString(""));
}

The title bar of the child panel "child.pnl" (ABCD) is not shown.

main()
{
  bool val = 0;
  /* the title bar of the child panel is not shown */
  titleBar(val,myModuleName(),"ABCD");
}

Assignment

Administration of managers...

Availability

UI