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
    - fclose()
      Closes a file.
    - folderSelector()
      Opens the folder selector dialog and writes the name of the selected folder to the string variable "path".
    - fileSelector()
      Opens the file selection dialog and writes the selected file name to fileName.
    - fscanfPL()
      Reads a file similar to fscanf() except changes to the current WinCC OA language before converting.
    - floor()
      Rounds down to an integer.
    - findExecutable()
      The function searches for the given executable and returns the full path to it or an empty string if not found.
    - fwrite()
      Writes a number of bytes from a blob variable to a file.
    - fprintfPL()
      Writes to a file similar to fprintf() except changes to the current WinCC OA language before converting.
    - fseek()
      Sets the pointer of the file f from the position whence to the position defined by the offset.
    - fontAdjust()
      This function adjusts the font attributes (specified via the mapping parameter) for the given font (specified via the font string).
    - fontToMapping()
      The function returns a mapping for a specified font string.
    - formatTimeUTC()
      Returns the UTC time in a particular format.
    - fabs()
      Returns the absolute value of x.
    - fflush()
      Writes data to a file.
    - fprintf()
      Writes to a file.
    - fswAddPath()
      The functions add a path for monitoring to the FileSystemWatcher.
    - formatDebug()
      Similar to the function Debug() but instead of writing to the log viewer returns the debug messages as string,.
    - fmod()
    - formatTime()
      Returns the time in a particular format.
    - fscanf()
      Reads a file.
    - fillSelector()
      Opens the filling pattern selector and writes the selection to a variable.
    - fileToString()
      This function loads an ASCII file and writes the contents into a string variable.
    - fontSelector()
      Opens the font type selector and writes the selection to a variable.
    - fopen()
      Opens a file.
    - feof()
      Examines whether an end of file has been noted.
    - formatSelector()
      Opens the format selector and writes the string format that has been selected on the format string variable.
    - fread()
      Reads a number of bytes from a file to a blob variable.
    - fscanfUL()
      Reads a file like fscanf(), but change to the current Windows user language before converting.
    - fileEditor()
      Opens text files such as .txt and .doc files in an editor. You can edit both plain and rich text.
    - fputs()
      Writes a string to a file.
    - fprintfUL()
      Writes to a file similar to fprintf() except changes to the current Windows user language before converting.
    - fgets()
      Returns a string from a file.
    - ftell()
      The ftell function obtains the current value of the file position indicator for the stream pointed to by f.
    - ferror()
      Examines whether a file error has been noted.
    - fswRemovePath()
      The function removes a path from the monitoring of the FileSystemWatcher.
  - 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
  - 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.

fontAdjust()

This function adjusts the font attributes (specified via the mapping parameter) for the given font (specified via the font string).

Synopsis

string fontAdjust(string font, mapping parameter);

Parameters


Parameters	Meaning
font	A font string, e.g. "Arial,-1,17,5,75,0,0,0,0,0,Bold" and a mapping parameter such as "pixelSize" or "italic" - see chapter fontToMapping() See also the example at the end of this chapter.

Return value

An adjusted font string.

Description

This function takes a specified font string and a mapping,which can be filled with one or more of the mapping-key/value pairs returned by the function fontToMapping(). The function adjusts the font attributes (specified via the mapping parameter) for the given font (specified via the font string). The return value is an adjusted font string.

Example

The example add entries to a tree widget and changes the font of the tree widget.

//The example adds the entries to the tree widget:
main()
{
  TREE1.addColumn("SURNAME");
  TREE1.addColumn("FIRST NAME");
  TREE1.addColumn("ADDRESS");
  TREE1.appendItemNC("","WHOLE NAME","WHOLE_NAME");
  TREE1.appendItemNC("WHOLE NAME","ADAM","Adam");
  TREE1.appendItemNC("WHOLE NAME","COLLINS","Collins");
  TREE1.appendItemNC("WHOLE NAME","MOORE",makeDynString("Moore","Jane","Main street. 100"));
  TREE1.setText("ADAM", 1, "John");
  TREE1.setText("COLLINS", 1, "Emma");
  TREE1.setText("ADAM",2, "Ocean road. 1");
  TREE1.setText("COLLINS",2, "Corn street. 15");
  this.font("Arial,-1,13,5,50,0,0,0,0,0,Regular");
}

//The example returns the font string of the tree widget and changes the normal font to "italic":
main(mapping event)
{
  string fontStr = TREE1.getFont("WHOLE NAME", 2);
  string adjustStr;
  adjustStr = fontAdjust(fontStr, makeMapping("italic", true));
  TREE1.font(adjustStr);
 }

Assignment

Mapping functions

Availability

UI