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(\"Documentation Text Library\");
}
RPTJobPreview函数参数：
@Text library (compact)是打印作业的名称。
3. BOOL RPTJobPrint(LPSTR lpJobName)函数,打印作业被启动。
启动打印作业的实例
{//打印输出指定的打印作业
RPTJobPrint(\"@Text 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(\"TableControl_01\");
//转换长整型为字符 sprintf
(text,\"%d\",columns);
//在Text Field 5 SetText上设置文本
(lpszPictureName,\"Static Text 5\",text);
}
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(\"TableControl_01\");
//转换长整型为字符 sprintf
(text,\"%d\",columns);
//在Text Field 5 SetText上设置文本
(lpszPictureName,\"Static Text 5\",text);
}
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(\"TableControl_01\");
//转换长整型为字符 sprintf
(text,\"%d\",rows);
//在Text Field 5 SetText上设置文本
(lpszPictureName,\"Static Text 5\",text);
}
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(\"TableControl_01\");
//转换长整型为字符 sprintf
(text,\"%d\",columns);
//在Text Field 5 SetText上设置文本
(lpszPictureName,\"Static Text 5\",text);
}
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(\"TableControl_01\");
//转换长整型为字符 sprintf
(text,\"%d\",columns);
//在Text Field 5 SetText上设置文本
(lpszPictureName,\"Static Text 5\",text);
}
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(\"TrendControl_01\",0);
if (pszVarName != NULL)
{// 复制字符串 strncpy
(szVarName,pszVarName,19);
}
//输出变量名 SetText
(lpszPictureName,\"Static Text 6\",szVarName);
}
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(\"TrendControl_01\",0);
//获得小时 wHour
= systime.wHour;
//获得分钟 wMin
= systime.wMinute;
//获得秒 wSec
= systime.wSecond;
//
sprintf(szTime,\"%d:%d:%d\",wHour,wMin,wSec);
//输出变量名 SetText
(lpszPictureName,\"Static Text 7\",szTime);
}
1). 读出当前系统时间。
2). 从SYSTEMTIME结构读出小时、分和秒。
3). 创建包含该时间的字符串。
4). 读出当前时间。
8. double TlgGetRulerValueTrend(char* lpszTemplate, int nTrend)函数,在趋势窗口中这个标尺位置上给出带编号nTrend的趋势的数值。用参数lpszTemplate传递相应WinCC在线趋势控件窗口。
使用标准函数操作WinCC表格控件的实例
{char text[5];
long int columns
//获得列数
columns = GetNumberOfColumns(\"TableControl_01\");
//转换长整型为字符 sprintf
(text,\"%d\",columns);
//在Text Field 5 SetText上设置文本
(lpszPictureName,\"Static Text 5\",text);
}
TlgGetNumberOfColumns函数参数：
“Table Control_01”是WinCC表格控件的名称。
1). 将函数TlgGetNumberOfColumns的返回值缓冲存储在columns中。
2). 将返回值缓冲存储在String text中。
3). 在静态文本域中发出返回值。
9. char* TlgGetRulerVariableNameTrend(char* lpszTemplate, int nTrend)函数,在趋势窗口中给出编号为nTrend的趋势的变量名。用参数lpszTemplate传递相应WinCC在线趋势控件窗口。
使用标准函数操作WinCC趋势控件的实例
{char* pszVarName = NULL;
char szVarName[20];
//获得标尺变量名 pszVarName
= TlgGetRulerVariableNameTrend(\"TrendControl_01\",0);
if (pszVarName != NULL)
{// 复制字符串 strncpy
(szVarName,pszVarName,19);
}
//输出变量名 SetText
(lpszPictureName,\"Static Text 6\",szVarName);
}
TlgGetRulerVariableNameTrend函数参数：
“Trend Control_01”是WinCC趋势控件的名称。
“0”是该趋势的编号。
1). 将函数TlgGetRulerVariableNameTrend的返回值缓冲存储在pszVarName中。
2). 如果返回有效数值，将返回值复制到szVarName中。
3). 在静态文本域中发出返回值。
10. char* TlgGetTextAtPos(char* lpszTemplate, int nColumn, int nLine)函数,为过程变量归档和用户归档提供表格窗口的单元格内容作为文本。单元由nColumn和nLine指定。用参数lpszTemplate传递相应WinCC在线表格控件窗口的名称。
使用标准函数操作WinCC趋势控件的实例
{char* pszVarName = NULL;
char szVarName[20];
//获得标尺变量名 pszVarName
= TlgGetRulerVariableNameTrend(\"TrendControl_01\",0);
if (pszVarName != NULL)
{// 复制字符串 strncpy
(szVarName,pszVarName,19);
}
//输出变量名 SetText
(lpszPictureName,\"Static Text 6\",szVarName);
}
TlgGetRulerVariableNameTrend函数参数：
“Trend Control_01”是WinCC趋势控件的名称。
“0”是该趋势的编号。
1). 将函数TlgGetRulerVariableNameTrend的返回值缓冲存储在pszVarName中。
2). 如果返回有效数值，将返回值复制到szVarName中。
3). 在静态文本域中发出返回值。
11. BOOL TlgTableWindowPressEditRecordButton(char* lpszWindowName)函数,锁住或释放表格窗口的编辑(切换功能)。如果允许编辑，将停止更新表格窗口。即使因为使用另一个函数而使编辑被禁止，表格窗口更新将仍保持停止状态。
使用标准函数操作WinCC报警趋势的实例
{//开始/停止
TlgTrendWindowPressStartStopButton(\"TrendControl_01\");
}
TlgTrendWindowPressStartStopButton函数参数：
“TrendControl_01”是WinCC趋势控件的对象名。
12. BOOL TlgTableWindowPressFirstButton(char* lpszWindowName)函数,显示表格窗口中显示区域的第一个数据记录。显示的数据记录数量由所组态的时间范围决定。
使用标准函数操作WinCC报警趋势的实例
{//开始/停止
TlgTrendWindowPressStartStopButton(\"TrendControl_01\");
}
TlgTrendWindowPressStartStopButton函数参数：
“TrendControl_01”是WinCC趋势控件的对象名。
13. BOOL TlgTableWindowPressHelpButton(char* lpszWindowName)函数,显示表格窗口的在线帮助
使用标准函数操作WinCC报警趋势的实例
{//开始/停止
TlgTrendWindowPressStartStopButton(\"TrendControl_01\");
}
TlgTrendWindowPressStartStopButton函数参数：
“TrendControl_01”是WinCC趋势控件的对象名。 |
