VI属性(ActiveX)
- 更新时间2025-07-30
- 阅读时长11分钟
通过虚拟仪器对象导出影响给定VI的属性。VirtualInstrument对象通过调用 GetVIReference 应用程序对象的方法。
在下列主题中,数据类型名称末尾的星号(*)表示该属性为指针。属性中带[]的参数是可选参数。
关于各种属性中所用枚举值的更多信息,见ActiveX枚举值。
属性
| 属性 | 说明信息 |
|---|---|
| AllowDebugging | 如值为TRUE,则允许在VI中使用调试工具。值为FALSE时可以减少内存需求并提高VI的性能。 |
| BDModificationBitSet | 表明VI上次保存或打开后是否已修改程序框图。如值为0,则未发生任何修改。如值不为0,则已发生修改。该属性为只读属性。 |
| BDSize | LabVIEW程序框图的大小,以字节为单位。该属性为只读属性。 |
| Callers | 对于引用指定的VI,返回所有调用该VI并且已经加载至内存的VI。该属性为只读属性。 |
| CloneName | VI副本的名称。如VI不是副本,则返回错误。 |
| CloseFPAfterCall | 表明VI运行后是否关闭LabVIEW前面板。 |
| CodeSize | VI代码使用的内存总量,以字节为单位。该属性为只读属性。 |
| DataSize | 分配给数据的内存总量,以字节为单位。VI正在运行时无法读取该属性。该属性为只读属性。 |
| Description | 光标移至VI图标或生成的VI说明信息时,在LabVIEW即时帮助窗口中显示VI说明信息。 |
| EditMode | 如值为TRUE,则以编辑模式打开VI。如值为FALSE,则以运行模式打开VI,不显示标题栏、菜单栏和工具栏。 |
| ExecInlining | 指定是否在调用VI中内嵌子VI。 |
| ExecIsInlineable | 如可在调用VI中内嵌子VI,则返回TRUE。 |
| ExecPriority | 表明在与其它任务同时运行时,该VI的优先级。 |
| ExecState | 表明VI的执行状态。 |
| ExpandWhenDroppedAsSubVI | 作为子VI放置在程序框图上时,展开并显示接线端。 |
| FPAllowRTPopup | 表明在VI运行时是否显示LabVIEW前面板对象的快捷菜单。如不显示默认的运行时快捷菜单,可继续使用自定义运行时快捷菜单。 |
| FPBehavior | 设置LabVIEW前面板窗口的动作。有效值包括0 ( Invalid ), 1 (Default ), 2 (Floating ), 3 (Floating/Auto-Hide )和4 (Modal ). |
| FPHiliteReturnButton | 表明是否高亮显示带<Enter>快捷键的布尔控件。 |
| FPKeepWinProps | 表明LabVIEW前面板窗口是否按照显示器分辨率改动调整大小。对于不同的分辨率,通过调整窗口大小可保持占用屏幕的比例一致。 |
| FPMinimizable | 表明在VI运行时用户是否可最小化前面板窗口。 |
| FPModificationBitSet | 表明VI上一次保存后是否已修改LabVIEW前面板。如值为0,则未发生任何修改。如值不为0,则已发生修改。 |
| FPMonitor | 如有多个显示器,则表明显示LabVIEW前面板窗口的显示器。0代表主显示器。 |
| FPResizable | 表明在VI运行时用户是否可调整LabVIEW前面板窗口的大小。 |
| FPRunTransparently | 设置VI在运行时显示为透明。 |
| FPShowMenuBar | 表明在VI运行时LabVIEW前面板是否显示菜单栏。 |
| FPSize | LabVIEW前面板的大小,以字节为单位。该属性为只读属性。 |
| FPState | LabVIEW前面板窗口的当前状态。有效值包括0 ( Invalid ), 1 (Standard ), 2 (Closed ), 3 (Hidden ), 4 (Minimized )和5 (Maximized ).
一种状态 Standard or Maximized 表示前面板窗口对用户可见。
如试图对未打开的前面板窗口设置该属性,可返回错误。 |
| FPTitleBarVisible | 表明在VI运行时是否在LabVIEW前面板上显示标题栏。 |
| FPTransparency | 设置VI窗口的透明度。窗口的透明度可设置为0-100之间的百分数,0代表不透明,100代表不可见。如果指定的值超出0到100的范围,则该属性返回错误。如将 FPRunTransparently 设置为False,更改该属性无效。 |
| FPWinBounds | 簇中的四个元素为前面板窗口的上、左、下、右坐标值。LabVIEW前面板窗口包括内部区域、滚动条、标题栏、菜单栏和工具栏。上述簇元素属于全局屏幕坐标,数值表示计算机屏幕(而非打开窗口)内的坐标。 该属性仅可用于前面板打开的VI。如不希望用户显示要设置该属性的VI,可使用 Hidden 的值 FPStateEnum 的数据类型 FPState 隐藏VI的前面板。 |
| FPWinClosable | 表明是否禁用LabVIEW标题栏的关闭按钮,以及LabVIEW文件菜单中的关闭菜单项。 |
| FPWinCustomTitle | 表明VI是否使用自定义标题字符串。写入FALSE可删除自定义标题字符串。 |
| FPWinIsFrontMost | 如值为TRUE,LabVIEW前面板窗口将显示在最前。该属性仅适用于调用VI的应用程序实例。值为FALSE时无效。读取的属性值可表明前面板窗口是否是显示在最前(忽略浮动窗口)。 |
| FPWinPanelBounds | 簇中的四个元素为LabVIEW前面板内部区域的(不包括滚动条、标题栏、菜单栏和工具栏)的上、左、下、右坐标值。簇元素属于全局屏幕坐标,数值表示计算机屏幕(而非打开窗口)内的坐标。 该属性仅可用于前面板打开的VI。如不希望用户显示要设置该属性的VI,可使用 Hidden 的值 FPStateEnum 的数据类型 FPState 隐藏VI的前面板。 |
| FPWinTitle | LabVIEW标题栏中显示的字符串。该字符串无需与VI文件同名。 |
| HelpDocumentPath | 链接至VI的HTML文件(.htm或.html)和已编译帮助文件(.chm或.hlp)的路径。如路径指向已编译的帮助文件,请使用 HelpDocumentTag 属性来确定该帮助文件中的特定主题。 |
| HelpDocumentTag | 表明在已编译的帮助文件中,与VI链接的帮助主题对应的索引关键词或HTML文件名。如需链接至HTML文件内的书签,应在文件名后添加#符号和书签名。仅在以下情况下使用该属性 HelpDocumentPath 是已编译帮助文件(.chm 或 .hlp)的路径。 对于.chm文件,该属性可以是HTML文件名或索引关键词。对于.hlp文件,该属性可以是索引关键词。 |
| HelpDocumentUrl | URL地址,用于为VI即时帮助窗口中的详细帮助信息提供在线帮助主题链接。 |
| HelpUseOnline | 表明是否通过即时帮助窗口的详细帮助信息为VI链接在线帮助文件。 |
| HistAddCommentsAtSave | 表明每次保存VI时是否在VI修订历史中添加注释。 |
| HistPromptAtClose | 表明关闭VI时是否提示用户输入VI修订历史。 |
| HistPromptForCommentsAtSave | 表明保存VI时是否提示用户输入VI修订历史。 |
| HistRecordAppComments | 表明发生特定事件时是否在VI修订历史中添加注释(例如,转换至LabVIEW新版本、子VI改动或修改VI名称和路径)。 |
| HistUseDefaults | 表明使用全局默认历史或其它历史属性中输入的值。 |
| HistoryText | 返回所有添加至VI修订历史的文本。该属性为只读属性。 |
| IsCloneVI | 如VI是副本,则返回TRUE。 |
| IsProbe | 如VI作为探针运行,且探针VI为打开状态,则返回TRUE。 |
| IsReentrant | 表明VI是否可重入。 |
| Library | 返回VI所属LabVIEW项目库、XControl或LabVIEW类的名称。如VI不属于任何库、XControl或类,该属性可返回NULL。 |
| LogAtFinish | 表明VI运行后是否在数据记录文件中写入LabVIEW前面板值。 |
| LogFilePath | 用于写入LabVIEW前面板数据和时间标识的数据记录文件的路径。 |
| Name | VI文件名。仅当VI尚未保存至磁盘时,才可以写入该属性。如LabVIEW项目库包含该VI,该属性可返回VI的合法名称(包括项目库的文件名)。 |
| OwningApp | 返回该VI所属应用程序的引用。完成使用后需关闭该引用。 |
| Path | VI文件路径。该属性为只读属性。 |
| PreferredExecSystem | 表明运行VI的执行系统。 |
| PrintHeaderDatePrint | 如值为TRUE,LabVIEW可在打印的VI页眉中包含日期。使用 PrintingHeaders 属性设置LabVIEW是否打印VI的头文件。 |
| PrintHeaderModifyDate | 如值为TRUE,LabVIEW可在VI的页眉中包含最近一次的修改日期。使用 PrintingHeaders 属性设置LabVIEW是否打印VI的头文件。 |
| PrintHeaderPageNumber | 如值为TRUE,LabVIEW可在VI的页眉中包含页码。使用 PrintingHeaders 属性设置LabVIEW是否打印VI的头文件。 |
| PrintHeaderVIIcon | 如值为TRUE,LabVIEW可在VI的页眉中包含VI图标。使用 PrintingHeaders 属性设置LabVIEW是否打印VI的头文件。 |
| PrintHeaderVIName | 如值为TRUE,LabVIEW可在VI的页眉中包含VI名称。使用 PrintingHeaders 属性设置LabVIEW是否打印VI的头文件。 |
| PrintLogFileAtFinish | 表明VI运行后是否打印LabVIEW前面板。 |
| PrintMargins | 获取或设置打印VI的页边距,以英寸或厘米为单位。 |
| PrintingBDScaling | 如值为TRUE,LabVIEW可调整程序框图的尺寸,使其符合打印页的大小。 |
| PrintingFPScaling | 如值为TRUE,LabVIEW可调整前面板的尺寸,使其符合打印页的大小。 |
| PrintingHeaderVIPath | 如值为TRUE,LabVIEW可在VI的页眉中包含VI路径。使用 PrintingHeaders 属性设置LabVIEW是否打印VI的头文件。 |
| PrintingHeaders | 如值为TRUE,LabVIEW可打印VI的页眉。该类的各种打印页眉属性均可用于自定义页眉的内容。 |
| PrintingOrientation | 获取或设置打印VI时的页面方向。 |
| ReentrancyType | 表明LabVIEW重入VI使用的重入类型。该属性类似于VI属性对话框中执行属性页的选项。 |
| RevisionNumber | VI的当前修订版本号。 |
| RunOnOpen | 表明打开VI时是否运行该VI。 |
| RunTimeMenuPath | 读取的属性值可返回VI的运行时菜单路径。写入属性值可更新VI的运行时菜单路径。如写入属性时VI正在运行,则按照新的路径数据更新菜单。 |
| ShowFPOnCall | 表明调用VI时是否显示LabVIEW前面板。 |
| ShowFPOnLoad | 表明加载VI时是否显示LabVIEW前面板。 |
| SuspendOnCall | 表明VI作为子VI调用时是否挂起。对于重入VI,必须谨慎使用该属性。 |
| TBShowAbortButton | 表明在VI运行时LabVIEW工具栏是否显示中止执行按钮。 |
| TBShowFreeRunButton | 表明在VI运行时LabVIEW工具栏是否显示连续运行按钮。 |
| TBShowRunButton | 表明在VI运行时LabVIEW工具栏是否显示运行按钮。 |
| TBVisible | 表明在VI运行时是否显示LabVIEW工具栏。 |
| VIType | 表明VI类型。 |