n
描述
精智面板提供了从运行系统打开 PDF，Excel 和 Word 文档的选项。
可以使用系统函数 “StartProgram” 打开相应的文档。n
"StartProgram" 函数的语法
程序名，程序参数，显示模式，等待程序结束n
参数描述
- 程序名
对于参数 “程序名” ，指定要启动程序的路径和名称。
n - 程序参数
对于参数 “程序参数” 指定要打开文档的路径和名称。
n - 显示模式
定义程序窗口如何显示在操作面板上：
hmiShowNormal = 正常
hmiShowMinimized = 最小化
hmiShowMaximized = 最大化
hmiShowMinimizedAndInactive = 最小化且非激活注意
在 7", 9" 及 12" 精智面板上的显示总是被设置为最小化而不是全屏。
n - 等待程序结束
定义当调用程序结束后是否返回项目：
hmiNo = 否 (不返回项目)
hmiYes = 是 (返回项目)
文档可能的存储位置：n
- 存储卡： "Storage Card SD"n
- USB 盘： "Storage Card USB"n
- 网络路径： "Network" (示例： "computer_namerelease_name...")
支持以下格式的文件：n
- .PDFn
- .doc (Word 97-2003)n
- .docx (Word 2007 and Word 2010)n
- .rtf (Rich Text Format)n
- .xls (Excel 97-2003)n
- .xlsx (Excel 2007 and Excel 2010)
1.当在精智面板的按钮上使用系统函数 “StartProgram” 可以通过以下选项打开一个文档
为此可输入以下参数：
| 程序名 | 程序参数 | 结果 |
| Storage Card SDMachineData_01.doc (*.docx) | 指定的文件打开。 | |
| Storage Card SDMachineData_01.pdf | 指定的文件打开。 | |
| Storage Card SDMachineData_01.xls (*.xlsx) | 指定的文件打开。 | |
| WinCC V13 及更高版本 flashAddOnwt6explr.exe n 到 WinCC V12 为止 | 查看器启动“打开”对话框。 此时从存储介质中选择 PDF，EXCEL 或者 WORD 文档。 | |
| /d wt6pdf*.dfr | 查看器启动“打开”对话框。 此时从存储介质中选择 PDF 文档。 | |
| /d wt6xls*.dfr | 查看器启动“打开”对话框。 此时从存储介质中选择.xls,.xlsx 文档。 | |
| /d wt6xlsx*.dfr | 查看器启动“打开”对话框。 此时从存储介质中选择.xlsx 文档。 | |
| /d wt6doc*.dfr | 查看器启动“打开”对话框。 此时从存储介质中选择.docx,.doc,.rtf 文档。 | |
| /d wt6docx*.dfr | 查看器启动“打开”对话框。 此时从存储介质中选择.docx 文档。 | |
| Storage Card SDMachineData_01.doc (*.docx) | 指定的文件打开。 | |
| Storage Card SDMachineData_01.pdf | 指定的文件打开。 | |
| Storage Card SDMachineData_01.xls (*.xlsx) | 指定的文件打开。 |
表 01
注意
MachineData_01.doc, MachineData_01.pdf 及 MachineData_01.xls 是示例文档。n
2. 在精智面板的脚本中使用系统函数 “StartProgram”，通过以下选项可打开一个文件
- 使用函数列表
从函数列表中选择 "StartProgram" 并根据本文最下方的表格输入参数。
在脚本编辑器中，移动鼠标点击“应用”。n - 手动输入脚本
在脚本编辑器中直接输入函数。根据本文最下方的表格的语法。
可以为函数“StartProgram”预定义参数或通过变量（WString 类型）来提供参数。
变量包含指定的路径。确定变量的长度要大于指定的路径长度。有两种方式在变量中指定路径：n
- 不带引号 （示例：Storage Card USBDocument_name.Document_ending）- (For example: Storage Card USBDocument_name.Document_ending) - 该类型参考以下“FilePath”通配符。n
- 带引号 （示例： "Storage Card USBDocument_name.Document_ending"） - 该类型参考以下“FilePath_AZ”通配符。
不带引号指定路径的示例是函数“OpenFileBrowser”的返回值。该函数将选择文件的路径保存到一个变量中。为了在函数“StartProgram”中使用该路径，变量必须使用“FilePath”通配符。
如果传送到“程序名”参数中的指定路径包含空格，指定的路径必须使用引号。
这可以在传送到指定变量之前添加或在脚本自身中添加。在脚本中，可以通过在字符串前和后插入对应引号的 ASCII 码字符（34）来添加。n
通过“程序参数”就无所谓指定路径是否包含空格。
n
| 输入类型 |
程序名 (固定) | 通过“程序参数”变量获取指定路径 | 脚本编辑器中的语法 |
| 通过函数列表 | WinCC V13 之前 flashAddOnwt6explr.exe | FilePath | StartProgram "flashAddOnwt6explr.exe", SmartTags("FilePath"), hmiShowNormal, hmiNo |
| FilePath_AZ | StartProgram "flashAddOnwt6explr.exe", SmartTags("FilePath_AZ"), hmiShowNormal, hmiNo | ||
| 直到 WinCC V12 windowswt6explr.exe | FilePath | StartProgram "windowswt6explr.exe", SmartTags("FilePath"), hmiShowNormal, hmiNo | |
| FilePath_AZ | StartProgram "windowswt6explr.exe", SmartTags("FilePath_AZ"), hmiShowNormal, hmiNo | ||
| 手动 | WinCC V13 之前 "flashAddOnwt6explr.exe" | FilePath | StartProgram "flashAddOnwt6explr.exe", FilePath, hmiShowNormal, hmiNo |
| FilePath_AZ | StartProgram "flashAddOnwt6explr.exe", FilePath_AZ, hmiShowNormal, hmiNo | ||
| 直到 WinCC V12 "windowswt6explr.exe" | FilePath | StartProgram "windowswt6explr.exe", FilePath, hmiShowNormal, hmiNo | |
| FilePath_AZ | StartProgram "windowswt6explr.exe", FilePath_AZ, hmiShowNormal, hmiNo |
表 02
| 输入类型 | 通过“程序名”参数指定可变路径 | 程序参数（不需要） | 脚本编辑器中的语法 |
| 通过函数列表 | FilePath_AZ | StartProgram SmartTags("FilePath_AZ"), "",hmiShowNormal, hmiNo | |
| 手动 | FilePath_AZ | "" | StartProgram FilePath_AZ, "",hmiShowNormal, hmiNo |
| Chr(34) & FilePath & Chr(34) | "" | StartProgram Chr(34) & FilePath_AZ & Chr(34), "",hmiShowNormal, hmiNo |
表 03
| 输入类型 | 程序名 （固定） | 程序参数（固定） | 脚本编辑器中的语法 |
| 通过函数列表 | WinCC V13 之前 flashAddOnwt6explr.exe |
/d wt6doc*.dfr (*.pdf, *.docx, *.xls, *.xlsx) | StartProgram "flashAddOnwt6explr.exe", "/d wt6doc*.dfr", hmiShowNormal, hmiNo |
| 直到 WinCC V12 windowswt6explr.exe |
StartProgram "windowswt6explr.exe", "/d wt6doc*.dfr", hmiShowNormal, hmiNo | ||
| 手动 | WinCC V13 之前 "flashAddOnwt6explr.exe" |
"/d wt6doc*.dfr" (*.pdf, *.docx, *.xls, *.xlsx) | StartProgram "flashAddOnwt6explr.exe", "/d wt6doc*.dfr", hmiShowNormal, hmiNo |
| 直到 WinCC V12 "windowswt6explr.exe" |
StartProgram "windowswt6explr.exe", "/d wt6doc*.dfr", hmiShowNormal, hmiNo |
表 04
建议在调用“StartProgram”函数之前检查是否存在指定路径。
If FilePath <> "" Then
StartProgram Program name, Program parameter, Display, wait for the end
End If
注意
当升级到 WinCC V13, 必须相应的修改文件查看器的路径。编译器不识别错误的路径。
关键字
Office, Viewer, File viewer, Adobe Reader, Acrobat Reader, Document viewer, 文件, 存储, 存储路径
原创文章，作者：ximenziask，如若转载，请注明出处：https://www.zhaoplc.com/plc324923.html
微信扫一扫 
支付宝扫一扫