doValueOld
Numeric old value of the WinCC tags with the name specified in "lpszObjectName". 
"doValueOld" is entered in the accompanying process value "2" of the message.
The function itself has no option of reading a tag value before the action. For this, use the 
provided "GetTag..." feature.
doValueNew
Numeric new value of the WinCC tags with the name specified in "lpszObjectName". 
"doValueNew" is entered in the accompanying proces value "3" of the message.
The function itself has no option of reading a tag value after the action. For this, use the 
provided "GetTag..." feature.
pszComment
Comment text or empty string.
When "FLAG_COMMENT_PARAMETER" is set, the text is entered directly into the message 
in Runtime as a comment. The message does not need a separate comment dialog.
Return value
Value
Description
0
The function has been completed without any errors.
-101
The message editing could not be started.
-201
An error occurred when calling the "MSRTGetComment()" 
feature.
-301
An error occurred when calling the 
"MSRTCreateMsgInstanceWithComment()" feature.
Note
Make sure that only operator input messages are used for the "GCreateMyOperationMsg" 
function. The use of messages of different message classes is not permitted.
Please note the role of the standard server when using the function with a Client. For more 
information see the chapter "Client configuration".
GMsgFunction
Function
This function provides the message data.
It is a global function for single messages. It is called for each message for which the "Triggers 
an action" parameter has been set.
Evaluation of the message data is best made in a project function called from GMsgFunction.
ANSI-C for Creating Functions and Actions
2.15 ANSI-C function descriptions
WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 02/2013, A5E32315920-AA
901
How to move pdf pages around - re-order PDF pages in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Support Customizing Page Order of PDF Document in C# Project
how to rearrange pdf pages online; how to move pages in a pdf file
How to move pdf pages around - VB.NET PDF Page Move Library: re-order PDF pages in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Sort PDF Document Pages Using VB.NET Demo Code
move pages in pdf; how to move pages within a pdf document
Syntax
BOOL GMsgFunction(char* pszMsgData)
Parameters
pszMsgData
Pointer to a string whose data are mapped with scanf to the MSG_RTDATA_STRUCT 
structure. 
The "MSG_RTDATA_STRUCT" string contains the following data, which are separated from 
each other with "#":
1. Telegram time
2. Process values
3. Instance
4. User
5. Computer
6. Current time in format "yyyy.mm.dd, hh:mm:ss.mmm"
Note
The value "Instance" of string "MSG_RTDATA_STRUCT" is only supplied if an instance 
message was triggered.
The values "User" and "Computer" of the string "MSG_RTDATA_STRUCT" are only 
supplied if a comment was provided during the creation of the message with the same 
call.
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
Note
Please note that modified standard functions are overwritten by a WinCC installation so that 
the changes will be lost. 
See also
Structure definition MSG_RTDATA_STRUCT
ANSI-C for Creating Functions and Actions
2.15 ANSI-C function descriptions
WinCC: Scripting (VBS, ANSI-C, VBA)
902
System Manual, 02/2013, A5E32315920-AA
C# HTML5 PDF Viewer SDK to view PDF document online in C#.NET
Page: Replace PDF Pages. Page: Move Page Position. Page: Extract, Copy and Paste PDF Pages. View PDF document in continuous pages display mode. 10. Zoom out.
pdf page order reverse; how to move pages around in pdf
VB.NET PDF- View PDF Online with VB.NET HTML5 PDF Viewer
Page: Replace PDF Pages. Page: Move Page Position. Page: Copy, Paste PDF Pages. Page: Rotate a PDF Page. View PDF document in continuous pages display mode.
rearrange pdf pages; reverse page order pdf
2.15.2.3
Graphics
Graphics - short description
The Graphics group contains functions for programming the graphic system.
Note
Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 
GetLinkedVariable
Function
Provides the name of the variable linked to a certain object property.
Syntax
char* GetLinkedVariable(char* lpszPictureName, char* lpszObjectName, char* 
lpszPropertyName);
Parameters
lpszPictureName
Pointer to the picture
lpszObjectName
Pointer to the object
lpszPropertyName
Pointer to the object property
Return value
Pointer to the name of the tag linked to a certain object property. 
See also
GetLinkedVariable example
ANSI-C for Creating Functions and Actions
2.15 ANSI-C function descriptions
WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 02/2013, A5E32315920-AA
903
C# WPF PDF Viewer SDK to view PDF document in C#.NET
Page: Replace PDF Pages. Page: Move Page Position. Page: Extract extract, copy, paste, C#.NET rotate PDF pages, C#.NET document on RasterEdge C#.NET WPF PDF Viewer
reorder pages in a pdf; how to reorder pages in a pdf document
VB.NET PDF - View PDF with WPF PDF Viewer for VB.NET
Page: Replace PDF Pages. Page: Move Page Position. Page: Copy extract, copy, paste, C#.NET rotate PDF pages, C#.NET document on RasterEdge VB.NET WPF PDF Viewer.
how to rearrange pages in a pdf file; change page order in pdf online
GetLocalPicture
Function
Provides a pointer to the name of the picture. The picture name is the file name without the 
".PDL" extension.
Syntax
char* GetLocalPicture(char* lpszPictureName);
Parameters
lpszPictureName
Pointer to the picture
Return value
Pointer on the name of the picture.
Note
The passed call parameter lpszPictureName must have the structure provided by the 
graphics system for the picture paths:
<Basic picture name>.<Picture window name>:<Picture name>. ... .<Picture window 
name>[:<Picture name>]
where <Basic picture name> and <Picture name> go without the ".PDL" file extension.
Example:
In a basic picture "AAA" there is a picture window "bbb" in which a picture "CCC" is called 
which itself contains a picture window "ddd" in which a picture "EEE" is called.
Then the function call
GetLocalPicture(lpszPictureName)
returns the pointer to the picture name:
"EEE" if the functions is called in the picture "EEE";
"CCC" if the functions is called in the picture "CCC";
"AAA" if the functions is called in the picture "AAA". 
See also
GetLocalPicture example
ANSI-C for Creating Functions and Actions
2.15 ANSI-C function descriptions
WinCC: Scripting (VBS, ANSI-C, VBA)
904
System Manual, 02/2013, A5E32315920-AA
GetParentPicture
Function
Provides a pointer to the name of the picture. The picture name is the file name without the 
".PDL" extension.
Syntax
char* GetParentPicture(char* lpszPictureName);
Parameters
lpszPictureName
Pointer to the picture
Return value
Name of the current picture if the function is called in the basic picture
Name path of the higher-level picture if the function is called in a picture window
Note
The passed call parameter lpszPictureName must have the structure provided by the 
graphics system for the picture paths:
<Basic picture name>.<Picture window name>:<Picture name>. ... .<Picture window 
name>[:<Picture name>]
where <Basic picture name> and <Picture name> go without the ".PDL" file extension. 
See also
GetParentPicture example
GetParentPictureWindow
Function
Provides a pointer to the name of the picture window.
Syntax
char* GetParentPictureWindow(char* lpszPictureName);
ANSI-C for Creating Functions and Actions
2.15 ANSI-C function descriptions
WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 02/2013, A5E32315920-AA
905
Parameters
lpszPictureName
Pointer to the picture
Return value
Pointer to the name of the picture window if the function is called in a picture displayed in a 
picture window of a higher-level picture
Call parameter lpszPictureName unchanged if the function is called in the basic picture
Note
The passed call parameter lpszPictureName must have the structure provided by the 
graphics system for the picture paths:
<Basic picture name>.<Picture window name>:<Picture name>. ... .<Picture window 
name>[:<Picture name>]
where <Basic picture name> and <Picture name> go without the ".PDL" file extension.
Example:
In a basic picture "Picture_1" there is a picture window "Picture_window_1" in which a picture 
"Picture_2" is called.
In the picture "Picture_2" there is a picture window "Picture_window_2" in which a picture 
"Picture_3" is called.
Then the function call
GetParentPictureWindow(lpszPictureName)
returns the pointer to the picture window name:
"Picture_2" if the function is called in the picture "Picture_3";
"Picture_window_1" if the function is called in the picture "Picture_2";
"Picture_1" if the function is called in the picture "Picture_1". 
OpenPicture
Function
Changes the specified basic picture. On the client and in case of a picture name with server 
prefix a picture change is performed in the picture window. 
If, for example, the picture window is located in a different picture window with a server prefix, 
a picture change is not performed in the picture window in which the function was called.
ANSI-C for Creating Functions and Actions
2.15 ANSI-C function descriptions
WinCC: Scripting (VBS, ANSI-C, VBA)
906
System Manual, 02/2013, A5E32315920-AA
Syntax
void OpenPicture(Picture PictureName)  
Parameters
Picture name
Picture name 
Registry2
Function
This function manages a list of string pairs (String0, String1).
It knows the following types of calls controlled by the mode parameter:
● Registry2("set", "String0", "String1");
Includes the passed string pair into the list.
● Registry2("get", "String0", NULL);
Returns the first string pair partner String1 which belongs to the passed String0 and then 
deletes the string pair from the list.
● Registry2("reset", NULL, NULL);
Deletes all string pairs from the list.
● Registry2("display", NULL, NULL);
Shows the string pairs currently stored in the list in a Global Script diagnostics window.
Syntax
char* Registry2(char* mode, char* String0, char* String1);
Parameters
mode
Defines the working principle of the function.
set
Incorporation of the string pair into the list
get
Determination of the first sting pair partner for String0 and deletion of the string 
pair from the list
reset
Deletion of all string pairs
display Display of the string pairs in a Global Script diagnostics window
String0
The parameter supply depends on the working principle of the function.
ANSI-C for Creating Functions and Actions
2.15 ANSI-C function descriptions
WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 02/2013, A5E32315920-AA
907
String1
The parameter supply depends on the working principle of the function.
Return value
In the mode=get mode a pointer to the first string pair partner is returned.
Note
This function is used in conjunction with the picture module technology.
If you work with the "Create faceplate as type" and "Create instance(s) in the process picture" 
wizards in the "Faceplates" tab of the Dynamic Wizard, using the "Registry2" function is not 
permitted!
2.15.2.4
Obsolete functions
Alarm
AXC_OnBtnAlarmHidingList
Function
This function displays the list of hidden messages in a message window.
Syntax
BOOL AXC_OnBtnAlarmHidingList(char* lpszPictureName, char* lpszObjectName)
Parameters
lpszPictureName
Pointer to the name of the picture in which the WinCC Alarm Control is located
lpszObjectName
Pointer to the object name of the WinCC Alarm Control
Return value
TRUE
The function has been completed without any errors.
ANSI-C for Creating Functions and Actions
2.15 ANSI-C function descriptions
WinCC: Scripting (VBS, ANSI-C, VBA)
908
System Manual, 02/2013, A5E32315920-AA
FALSE
An error has occurred. 
Note
The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0.
AXC_OnBtnArcLong
Function
This function displays the messages stored in a long-term archive list in a message window.
Syntax
BOOL AXC_OnBtnArcLong (char* lpszPictureName, char* lpszObjectName) 
Parameters
lpszPictureName
Pointer to the name of the picture in which the WinCC Alarm Control is located
lpszObjectName
Pointer to the object name of the WinCC Alarm Control
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred. 
Note
The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0.
See also
AXC_OnBtnMsgFirst example
ANSI-C for Creating Functions and Actions
2.15 ANSI-C function descriptions
WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 02/2013, A5E32315920-AA
909
AXC_OnBtnArcShort
Function
This function displays the messages stored in a short-term archive list in a message window.
Syntax
BOOL AXC_OnBtnArcShort(char* lpszPictureName, char* lpszObjectName) 
Parameters
lpszPictureName
Pointer to the name of the picture in which the WinCC Alarm Control is located
lpszObjectName
Pointer to the object name of the WinCC Alarm Control
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred. 
Note
The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0.
See also
AXC_OnBtnMsgFirst example
AXC_OnBtnComment
Function
External message window operation
This function displays the comment of the previously selected messages.
ANSI-C for Creating Functions and Actions
2.15 ANSI-C function descriptions
WinCC: Scripting (VBS, ANSI-C, VBA)
910
System Manual, 02/2013, A5E32315920-AA
Documents you may be interested
Documents you may be interested