char szPicName[_MAX_PATH+1]; //获得母画面 pszPicName
= GetParentPicture(lpszPictureName); //复制字符串
if (pszPicName != NULL)
{strncpy(szPicName,pszPicName,_MAX_PATH); }//自定义代码
//在那里用户可以使用返回值做某事 ...}
1). 将该函数GetParentPicture的返回值缓冲存储在pszPicName中。 2). 如果返回有效数值，将该返回值存储在szPicName中。。。。。. 最多存储_MAX_PATH个字符。
3). 执行处理返回值的自定义代码。
4.char* GetParentPictureWindow(char* lpszPictureName)函数,返回指向画面窗口的名称的指针。 实例：
基本画面“Picture_1”有画面窗口“Picture Window_1”，在其中调用画面“Picture_2”。 画面“Picture_2”有画面窗口“Picture Window_2”，在其中调用画面“Picture_3”。 该函数调用
GetParentPictureWindow(lpszPictureName) 指向画面窗口名称的指针：
“Picture_2”，是否从画面“Picture_3”调用该函数。
“Picture Window_1”，是否从画面“Picture_2”调用该函数。 “Picture_1”，是否从画面“Picture_1”调用该函数。
5. void OpenPicture(Picture Name)函数,用设置的画面名打开画面。
6. char* Registry2(char* mode, char* String0, char* String1)函数,该函数管理字符串对(String0，String1)的列表。
Report - 简短描述
Report组包含用来启动打印作业的打印预览或打印输出本身的函数。
1. void ReportJob(LPSTR lpJobName, LPSTR lpMethodName)函数,根据参数lpMethodName的数值，决定启动打印作业或打印预览。
RPTJobPreview和RPTJobPrint, 打印作业被启动和打印作业的预览被启动
2. BOOL RPTJobPreview(LPSTR lpJobName)函数,打印作业的预览被启动。 启动作业预览的实例
{//启动指定打印作业的打印预览
RPTJobPreview(\}
RPTJobPreview函数参数：
@Text library (compact)是打印作业的名称。
3. BOOL RPTJobPrint(LPSTR lpJobName)函数,打印作业被启动。 启动打印作业的实例
{//打印输出指定的打印作业
RPTJobPrint(\ext library (compact)\}
RPTJobPrint函数参数：
@Text library (compact)是打印作业的名称。
4. void RptShowError(LPCSTR pszFailedFunction, CMN_ERRORA* pCmnErrorA)函数,该函数提供对失败的打印作业的错误描述。该函数调用是标准函数RptJobPrint和RptJobPreview的组成部分，因此不要求单个调用命令。 结构定义CMNERROR
struct CMNERRORSTRUCT { DWORD dwError1, DWORD dwError2, DWORD dwError3, DWORD dwError4, DWORD dwError5;
TCHAR szErrorText[MAX_ERROR_LEN]; }
CMNERROR描述
扩展的错误结构包含错误代码和与发生的错误相关的错误文本。每个应用程序可以使用该错误结构评价或发出错误消息。 组成部分
dwError1 .. dwError5
可按API函数的要求使用这些条目。
API描述包含出错时条目的各自数值。否则，错误代码在dwError1中。 szErrorText
错误代码的文本描述缓冲区
从资源建立该内容，因此依赖于语言。
TagLog - 简短描述
TagLog函数包含控制WinCC表格控件和WinCC趋势控件的函数。 Template子组包含调用某些控制值的函数。
Toolbar Buttons子组包含用于工具栏中每个按钮的标准函数。 这些函数可用来创建自定义工具栏，例如选择画面，或者定义控件上的设置。
1. int TlgGetColumnPosition(char* lpszTemplate)函数,以表格窗口中的列指针的当前位置作为列索引。
使用标准函数操作WinCC表格控件的实例 {char text[5];
long int columns //获得列数
columns = GetNumberOfColumns(\//转换长整型为字符 sprintf (text,\
//在Text Field 5 SetText上设置文本 (lpszPictureName,\}
TlgGetNumberOfColumns函数参数：
“Table Control_01”是WinCC表格控件的名称。
1). 将函数TlgGetNumberOfColumns的返回值缓冲存储在columns中。 2). 将返回值缓冲存储在String text中。 3). 在静态文本域中发出返回值。
2. int TlgGetNumberOfColumns(char* lpszTemplate)函数,在表格窗口中给出列的数量。用参数lpszTemplate传递相应WinCC在线表格控件窗口的名称。 使用标准函数操作WinCC表格控件的实例 {char text[5]; long int columns //获得列数
columns = GetNumberOfColumns(\//转换长整型为字符 sprintf (text,\
//在Text Field 5 SetText上设置文本 (lpszPictureName,\}
TlgGetNumberOfColumns函数参数：
“Table Control_01”是WinCC表格控件的名称。
1). 将函数TlgGetNumberOfColumns的返回值缓冲存储在columns中。 2). 将返回值缓冲存储在String text中。 3). 在静态文本域中发出返回值。
3. int TlgGetNumberOfRows(char* lpszTemplate)函数,在表格窗口中给出行的数量。用参数lpszTemplate传递相应WinCC在线表格控件窗口的名称。 使用标准函数操作WinCC表格控件的实例 {char text[5]; long int rows; //获得行数
rows = TlgGetNumberOfRows(\//转换长整型为字符 sprintf (text,\
//在Text Field 5 SetText上设置文本 (lpszPictureName,\}
TlgGetNumberOfRows函数参数：
Table Control_01是WinCC表格控件的名称。
1). 将函数TlgGetNumberOfRows的返回值缓冲存储在rows中。 2). 将返回值缓冲存储在String text中。 3). 在静态文本域中发出返回值。
4. int TlgGetNumberOfTrends(char* lpszTemplate)函数,在趋势窗口中给出趋势的数量。用参数lpszTemplate传递相应WinCC在线趋势控件窗口的名称。 使用标准函数操作WinCC表格控件的实例 {char text[5]; long int columns //获得列数
columns = GetNumberOfColumns(\//转换长整型为字符 sprintf (text,\
//在Text Field 5 SetText上设置文本 (lpszPictureName,\}
TlgGetNumberOfColumns函数参数：
“Table Control_01”是WinCC表格控件的名称。
1). 将函数TlgGetNumberOfColumns的返回值缓冲存储在columns中。 2). 将返回值缓冲存储在String text中。 3). 在静态文本域中发出返回值。
5. int TlgGetRowPosition(char* lpszTemplate)函数,在表格窗口中给出行指针的当前位置。用参数lpszTemplate传递相应WinCC在线表格控件窗口的名称。 使用标准函数操作WinCC表格控件的实例 {char text[5]; long int columns //获得列数
columns = GetNumberOfColumns(\//转换长整型为字符 sprintf (text,\
//在Text Field 5 SetText上设置文本 (lpszPictureName,\}
TlgGetNumberOfColumns函数参数：
“Table Control_01”是WinCC表格控件的名称。
1). 将函数TlgGetNumberOfColumns的返回值缓冲存储在columns中。 2). 将返回值缓冲存储在String text中。 3). 在静态文本域中发出返回值。
6. char* TlgGetRulerArchivNameTrend(char* lpszTemplate, int nTrend)函数,在趋势窗口中这个标尺位置上给出带编号nTrend的趋势的归挡名称。用参数lpszTemplate传递相应
WinCC在线趋势控件窗口的名称。
使用标准函数操作WinCC趋势控件的实例 {char* pszVarName = NULL; char szVarName[20];
//获得标尺变量名 pszVarName
= TlgGetRulerVariableNameTrend(\if (pszVarName != NULL) {// 复制字符串 strncpy
(szVarName,pszVarName,19); }
//输出变量名 SetText
(lpszPictureName,\}
TlgGetRulerVariableNameTrend函数参数： “Trend Control_01”是WinCC趋势控件的名称。 “0”是该趋势的编号。
1). 将函数TlgGetRulerVariableNameTrend的返回值缓冲存储在pszVarName中。 2). 如果返回有效数值，将返回值复制到szVarName中。 3). 在静态文本域中发出返回值。
7. SYSTEMTIME TlgGetRulerTimeTrend(char* lpszTemplate, int nTrend)函数,在趋势窗口中这个标尺位置上给出带编号nTrend的趋势的时间。用参数lpszTemplate传递相应WinCC在线趋势控件窗口。
使用标准函数操作WinCC趋势控件的实例 {SYSTEMTIME systime; WORD wHour; WORD wMin; WORD wSec; char szTime[10];
//获得当前系统时间 systime
= TlgGetRulerTimeTrend(\//获得小时 wHour = systime.wHour; //获得分钟 wMin = systime.wMinute; //获得秒 wSec
= systime.wSecond; //
sprintf(szTime,\//输出变量名 SetText
(lpszPictureName,\}
1). 读出当前系统时间。
2). 从SYSTEMTIME结构读出小时、分和秒。
wincc 函数库
