System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
Note
All functions of this group have the same parameter and application.
See also
TlgTrendWindowPressZoomInButton example (Page 1535)
TlgTrendWindowPressZoomOutButton
Function
The trend window is restored to the state in which it was before the zoom was activated. The
zoom is deactivated.
The zoom range can only be selected with the mouse (also see
TlgTrendWindowPressZoomInButton).
Syntax
BOOL TlgTrendWindowPressZoomOutButton(char* lpszWindowName)
Parameters
lpszWindowName
Pointer to the window title of the WinCC Online Trend Control
Return value
TRUE
The function has been completed without any errors.
ANSI-C function descriptions
3.2 Standard functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
911
FALSE
An error has occurred.
Note
All functions of this group have the same parameter and application.
See also
TlgTrendWindowPressZoomOutButton example (Page 1535)
Template
TlgGetNumberOfColumns
Function
Provides the number of columns in the table window.
The window title of the corresponding WinCC Online Table Control is passed with the
lpszTemplate parameter.
Syntax
int TlgGetNumberOfColumns(char* lpszTemplate)
Parameters
lpszTemplate
Pointer to the window title of the WinCC Online Table Control
Return value
Number of colums in a table window
TlgGetNumberOfRows
Function
Provides the number of lines in the table window.
The window title of the corresponding WinCC Online Table Control is passed with the
lpszTemplate parameter.
ANSI-C function descriptions
3.2 Standard functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
912
System Manual, 11/2008,
Syntax
int TlgGetNumberOfRows(char* lpszTemplate)
Parameters
lpszTemplate
Pointer to the window title of the WinCC Online Table Control
Return value
Number of lines in the table window
See also
TlgGetNumberOfRows example (Page 1532)
TlgGetNumberOfTrends
Function
Provides the number of trends in the trend window.
The window title of the corresponding WinCC Online Trend Control is passed with the
lpszTemplate parameter.
Syntax
int TlgGetNumberOfTrends(char* lpszTemplate)
Parameters
lpszTemplate
Pointer to the window title of the WinCC Online Trend Control
Return value
Number of trends in the trend window
ANSI-C function descriptions
3.2 Standard functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
913
TlgGetRowPosition
Function
Provides the current position of the line pointer in the table window.
The window title of the corresponding WinCC Online Table Control is passed with the
lpszTemplate parameter.
Syntax
int TlgGetRowPosition(char* lpszTemplate)
Parameters
lpszTemplate
Pointer to the window title of the WinCC Online Table Control
Return value
Current position of the line pointer in the table window
TlgGetRulerArchivNameTrend
Function
Provides the archive name of the trend with the nTrend number in the trend window at the
ruler position.
The window title of the corresponding WinCC Online Trend Control is passed with the
lpszTemplate parameter.
Syntax
char* TlgGetRulerArchivNameTrend(char* lpszTemplate, int nTrend)
Parameters
lpszTemplate
Pointer to the window title of the WinCC Online Trend Control
nTrend
Number of the trend
ANSI-C function descriptions
3.2 Standard functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
914
System Manual, 11/2008,
(0 <= nTrend <= Number of visible trends - 1)
Return value
Archive name of the trend with the nTrend number in the trend window at the ruler position
See also
TlgGetRulerVariableNameTrend example (Page 1533)
TlgGetRulerTimeTrend
Function
Provides the time of the trend with the nTrend number in the trend window at the ruler position.
The window title of the corresponding WinCC Online Trend Control is passed with the
lpszTemplate parameter.
Syntax
SYSTEMTIME TlgGetRulerTimeTrend(char* lpszTemplate, int nTrend)
Parameters
lpszTemplate
Pointer to the window title of the WinCC Online Trend Control
nTrend
Number of the trend
(0 <= nTrend <= Number of visible trends - 1)
Return value
Time of the trend with the nTrend number in the trend window at the ruler position
See also
TlgGetRulerTimeTrend example (Page 1532)
ANSI-C function descriptions
3.2 Standard functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
915
TlgGetRulerValueTrend
Function
Provides the value of the trend with the nTrend number in the trend window at the ruler position.
The window title of the corresponding WinCC Online Trend Control is passed with the
lpszTemplate parameter.
Syntax
double TlgGetRulerValueTrend(char* lpszTemplate, int nTrend)
Parameters
lpszTemplate
Pointer to the window title of the WinCC Online Trend Control
nTrend
Number of the trend
(0 <= nTrend <= Number of visible trends - 1)
Return value
Value of the trend with the nTrend number in the trend window at the ruler position
TlgGetRulerVariableNameTrend
Function
Provides the tag name of the trend with the nTrend number in the trend window.
The window title of the corresponding WinCC Online Trend Control is passed with the
lpszTemplate parameter.
Syntax
char* TlgGetRulerVariableNameTrend(char* lpszTemplate, int nTrend)
Parameters
lpszTemplate
Pointer to the window title of the WinCC Online Trend Control
ANSI-C function descriptions
3.2 Standard functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
916
System Manual, 11/2008,
nTrend
Number of the trend
(0 <= nTrend <= Number of visible trends - 1)
Return value
The tag name of the trend with the nTrend number in the trend window.
See also
TlgGetRulerVariableNameTrend example (Page 1533)
TlgGetTextAtPos
Function
Provides the content of a cell of the table window as text for process value archives and user
archives.
The cell is specified by nColumn and nLine.
The window title of the corresponding WinCC Online Table Control is passed with the
lpszTemplate parameter.
Syntax
char* TlgGetTextAtPos(char* lpszTemplate, int nColumn, int nLine)
Parameters
lpszTemplate
Pointer to the window title of the WinCC Online Table Control
nColumn
Number of the column
nLine
Number of the line
Return value
Content of the cell of a table window as text
ANSI-C function descriptions
3.2 Standard functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
917
See also
TlgGetRulerVariableNameTrend example (Page 1533)
TlgGetColumnPosition
Function
Provides the current position of the column pointer in the table window as column index.
Syntax
int TlgGetColumnPosition(char* lpszTemplate)
Parameters
lpszTemplate
Pointer to the window title of the WinCC Online Table Control
Return value
Current position of the column pointer in a table window
See also
TlgGetNumberOfColumns example (Page 1531)
TlgTrendWindowActivateCurve
Function
Activates a certain trend in WinCC Online Trend Control via the configured name of the trend.
This function is executed independently of the visibility or foreground position of the trend.
Syntax
BOOL TlgTrendWindowActivateCurve(char* lpszPictureName, char* lpszObjectName, char*
szValue)
Parameters
lpszPictureName
Picture name
ANSI-C function descriptions
3.2 Standard functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
918
System Manual, 11/2008,
lpszObjectName
Name of Trend Control
szValue
Name of the curve
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
3.3 Internal functions
3.3.1 Internal functions - short description
Internal functions are used to make graphic objects and archives dynamic and in project
functions, standard functions and global script actions.
Internal funtions are recognized throughout a project.
They can be neither be newly created nor can existing internal functions be modified.
Internal functions are divided into the following groups:
allocate
Functions to reserve and release working memory space
c_bib
Functions from the standard C-library
graphics
Functions to read and set properties of graphical objects
tag
Functions to read and write tags
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
919
wincc
Functions for changing languages, deactivating Runtime and ending WinCC
3.3.2 allocate
3.3.2.1 SysFree
Function
Releases the memory area previously reserved with the SysMalloc function.
Syntax
void SysFree(void* lpFree);
Parameters
lpFree
Pointer to the memory area reserved with the SysMalloc function
3.3.2.2 SysMalloc
Function
Reserves memory space for an action. The memory area is assigned to the action. When the
action
has been completed and the result transferred, the system releases the memory again.
The SysFree function can be used to release reserved memory space.
Syntax
void* SysMalloc(unsigned long int size);
Parameters
size
Size of the memory area in bytes.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
920
System Manual, 11/2008,