Eigenschaften für VI (ActiveX)
- Aktualisiert2025-07-30
- 8 Minute(n) Lesezeit
Mit einem VI-Objekt werden Eigenschaften exportiert, die sich auf ein bestimmtes VI auswirken. Ein VirtualInstrument-Objekt wird durch Aufrufen des erzeugt GetVIReference für das Anwendungsobjekt.
In den folgenden Themen wird durch ein Sternchen (*) am Ende eines Datentypnamens angezeigt, dass es sich bei der Eigenschaft um einen Zeiger handelt. Parameter in [] sind für die jeweilige Eigenschaft optional.
Weitere Informationen zu Enums, die in verschiedenen Eigenschaften verwendet werden, finden Sie unter ActiveX-Enum-Datentypen.
Eigenschaften
| Eigenschaft | Beschreibung |
|---|---|
| AllowDebugging | Bei TRUE können die Hilfsmittel zur Fehlersuche auf das VI angewandt werden. Wenn diese Eigenschaft auf FALSE gesetzt ist, verringert sich der Speicherbedarf des VIs und die Ausführungsgeschwindigkeit wird leicht verbessert. |
| BDModificationBitSet | Gibt an, ob seit dem letzten Öffnen oder Speichern (je nachdem welcher Vorgang zuletzt stattfand) Änderungen am Blockdiagramm vorgenommen wurden. Der Wert 0 bedeutet, dass keine Änderungen vorliegen. Ein Wert ungleich 0 bedeutet, dass es Änderungen gab. Diese Eigenschaft kann nur abgefragt werden. |
| BDSize | Größe des Blockdiagramms in Byte. Diese Eigenschaft kann nur abgefragt werden. |
| Callers | Führt alle im Arbeitsspeicher befindlichen VIs auf, die das VI aufrufen, zu dem der Knoten gehört. Diese Eigenschaft kann nur abgefragt werden. |
| CloneName | Name der VI-Kopie. Wenn das VI keine Kopie ist, wird ein Fehler ausgegeben. |
| CloseFPAfterCall | Gibt an, ob das Frontpanel des VIs nach Ausführungsende geschlossen werden soll oder nicht. |
| CodeSize | Umfang des VI-Codes in Byte. Diese Eigenschaft kann nur abgefragt werden. |
| DataSize | Größe des für Daten reservierten Speichers in Byte. Diese Eigenschaft kann nicht während der VI-Ausführung abgefragt werden. Diese Eigenschaft kann nur abgefragt werden. |
| Description | VI-Beschreibung, die in der LabVIEW-Kontexthilfe angezeigt wird, wenn Sie den Cursor über das VI-Symbol oder selbst erstellte VI-Dokumentation bewegen. |
| EditMode | Bei TRUE wird das VI im Bearbeitungsmodus geöffnet. Ist der Wert FALSE, dann wird das VI im Ausführungsmodus geöffnet, und die Titelleiste, die Menüleiste und die Symbolleiste werden ausgeblendet. |
| ExecInlining | Gibt an, ob ein SubVI inline in seine Aufrufer-VIs eingefügt werden soll. |
| ExecIsInlineable | Gibt TRUE aus, wenn das VI inline in seine Aufrufer-VI eingefügt werden kann. |
| ExecPriority | Gibt die Priorität des VIs an, wenn es parallel zu anderen Tasks ausgeführt wird. |
| ExecState | Gibt den Ausführungsstatus des VIs an. |
| ExpandWhenDroppedAsSubVI | Wenn das VI als SubVI in ein Blockdiagramm eingefügt wird, vergrößert sich das Symbol und es werden die Anschlüsse angezeigt. |
| FPAllowRTPopup | Gibt an, ob es zu den Frontpanel-Objekten Kontextmenüs geben soll, während das VI ausgeführt wird. Selbst erstellte Kontextmenüs können immer eingeblendet werden. |
| FPBehavior | Legt fest, wie sich das Frontpanel-Fenster zu den anderen Fenstern verhalten soll. Gültige Werte sind 0 ( Invalid ), 1 (Default ), 2 (Floating ), 3 (Floating/Auto-Hide ) und 4 (Modal ). |
| FPHiliteReturnButton | Gibt an, ob boolesche Bedienelemente markiert werden sollen, die mit der <Enter>-Taste bedient werden können. |
| FPKeepWinProps | Gibt an, ob sich das Frontpanel der Bildschirmauflösung anpassen soll. Dadurch belegt das Frontpanel bei jeder Auflösung prozentual die gleiche Bildschirmfläche. |
| FPMinimizable | Gibt an, ob der Benutzer das Frontpanel bei laufendem VI ablegen kann. |
| FPModificationBitSet | Gibt an, ob seit dem Speichern am Frontpanel Änderungen vorgenommen wurden. Der Wert 0 bedeutet, dass keine Änderungen vorliegen. Ein Wert ungleich 0 bedeutet, dass es Änderungen gab. |
| FPMonitor | Wenn mehrere Monitore an den Computer angeschlossen sind, gibt diese Eigenschaft den Monitor an, auf dem das Frontpanel angezeigt wird. Der Wert 0 steht für den Hauptmonitor. |
| FPResizable | Gibt an, ob der Anwender die Größe des Frontpanel-Fensters ändern darf, während das VI ausgeführt wird. |
| FPRunTransparently | Stellt das VI so ein, dass es in transparenter Darstellung ausgeführt wird. |
| FPShowMenuBar | Gibt an, ob während der VI-Ausführung die Menüleiste angezeigt werden soll. |
| FPSize | Größe des Frontpanels in Byte. Diese Eigenschaft kann nur abgefragt werden. |
| FPState | Aktueller Zustand des Frontpanels. Gültige Werte sind 0 ( Invalid ), 1 (Standard ), 2 (Closed ), 3 (Hidden ), 4 (Minimized ) und 5 (Maximized ).
Ein Zustand von Standard oder Maximized zeigt an, dass das Frontpanel-Fenster für den Benutzer sichtbar ist.
Wenn Sie versuchen, die Eigenschaft auf ein nicht geöffnetes Frontpanel anzuwenden, kommt es zu einem Fehler. |
| FPTitleBarVisible | Gibt an, ob während der VI-Ausführung die Titelleiste des Frontpanels angezeigt werden soll. |
| FPTransparency | Legt den Grad an Transparenz des VI-Fensters fest. Die Transparenz wird als Prozentzahl angegeben, wobei 0 für "undurchsichtig" steht und 100 für "vollständig transparent". Bei einer Angabe kleiner als 0 oder größer als 100 wird ein Fehler ausgegeben. Wenn Sie FPRunTransparently auf FALSE setzen, ist diese Eigenschaft wirkungslos. |
| FPWinBounds | Der Cluster enthält vier Elemente, und zwar die Koordinaten der vier Ecken des Frontpanel-Fensters einschließlich der Bildlaufleisten sowie der Titel-, Menü- und der Symbolleiste. Die Angabe erfolgt nicht in relativen Koordinaten. Diese Eigenschaft gilt nur für VIs mit geöffnetem Frontpanel. Wenn das VI, für das diese Eigenschaft verwendet wird, nicht angezeigt werden soll, verwenden Sie die Hidden Wert von FPStateEnum Datentyp für FPState Ausgeblendet werden soll das Frontpanel des VIs durch die Eigenschaft. |
| FPWinClosable | Gibt an, ob die Schließen-Schaltfläche in der Titelleiste und der Menüpunkt Schließen im Datei-Menü deaktiviert werden sollen. |
| FPWinCustomTitle | Gibt an, ob der VI einen benutzerdefinierten Titel haben soll. Bei FALSE wird der benutzerdefinierte Titel entfernt. |
| FPWinIsFrontMost | Mit TRUE wird das Frontpanel des VIs in den Vordergrund gebracht. Diese Eigenschaft gilt nur für die Anwendungsinstanz des übergeordneten VIs. Wenn dieser Wert auf FALSE gesetzt wird, hat dies keinerlei Auswirkung. Wenn die Eigenschaft abgefragt wird, dann zeigt sie an, ob sich das Frontpanel-Fenster im Vordergrund befindet (Fenster, die sich grundsätzlich im Vordergrund befinden, werden ignoriert). |
| FPWinPanelBounds | Die vier Elemente des Clusters geben die Koordinaten der Frontpanel-Fläche (oben, links, rechts und unten) ohne die Bildlaufleisten, Titelleiste, Menüleiste und die Symbolleiste an. Die Cluster-Elemente werden als Bildschirmkoordinaten angegeben und beispielsweise nicht als Koordinaten innerhalb eines geöffneten Fensters. Diese Eigenschaft gilt nur für VIs mit geöffnetem Frontpanel. Wenn das VI, für das diese Eigenschaft verwendet wird, nicht angezeigt werden soll, verwenden Sie die Hidden Wert von FPStateEnum Datentyp für FPState Ausgeblendet werden soll das Frontpanel des VIs durch die Eigenschaft. |
| FPWinTitle | Text, der in der Titelleiste erscheinen soll. Der Titel muss nicht mit dem Dateinamen des VIs übereinstimmen. |
| HelpDocumentPath | Pfad zur HTML-Datei (*.htm oder *.html) oder Hilfedatei (*.chm oder *.hlp), zu der das VI einen Link enthält. Führt der Pfad zu einer kompilierten Hilfedatei, verwenden Sie die Option HelpDocumentTag -Eigenschaft, um das spezifische Thema in der Hilfedatei zu bestimmen. |
| HelpDocumentTag | Index-Stichwort oder HTML-Dateiname für ein Thema in der kompilierten Hilfedatei, zu der das VI einen Link enthält. Um eine HTML-Datei mit einem Bookmark zu verlinken, fügen Sie an das Ende des Dateinamens das #-Zeichen gefolgt vom Namen des Bookmarks an. Diese Eigenschaft sollte nur verwendet werden HelpDocumentPath ist ein Pfad zu einer kompilierten Hilfedatei (.chm oder .hlp). Für *.chm-Dateien kann diese Eigenschaft ein HTML-Dateiname oder ein Index-Stichwort sein. Bei *.hlp-Dateien kann diese Eigenschaft ein Index-Schlüsselwort sein. |
| HelpDocumentUrl | URL für das Hilfethema im Web, das sich beim Anklicken des Links Ausführliche Hilfe in der Kontexthilfe eines VIs öffnen soll. |
| HelpUseOnline | Gibt an, ob der Link Ausführliche Hilfe in der Kontexthilfe für ein VI zu einem Hilfedatei im Web führen soll. |
| HistAddCommentsAtSave | Gibt an, ob bei jedem Speichern des VIs ein Eintrag in die Versionshistorie erfolgen soll. |
| HistPromptAtClose | Gibt an, ob der Benutzer beim Schließen des VIs aufgefordert werden soll, einen Eintrag in die Versionshistorie des VIs vorzunehmen. |
| HistPromptForCommentsAtSave | Gibt an, ob der Benutzer beim Speichern des VIs aufgefordert werden soll, einen Eintrag in die Versionshistorie des VIs vorzunehmen. |
| HistRecordAppComments | Gibt an, ob unter bestimmten Umständen (beispielsweise beim Speichern des VIs für eine andere LabVIEW-Version, bei Änderungen an SubVIs oder Änderungen des VI-Namens oder -Pfads) ein Eintrag in die VI-Versionshistorie erfolgen soll. |
| HistUseDefaults | Gibt an, ob die voreingestellte Historie genutzt werden soll, oder ob bestimmte Parameter aus anderen Historie-Eigenschaften verwendet werden sollen. |
| HistoryText | Gibt sämtlichen Text aus, der zur Versionshistorie des VIs hinzugefügt wurde. Diese Eigenschaft kann nur abgefragt werden. |
| IsCloneVI | Gibt TRUE aus, wenn das VI eine Kopie ist. |
| IsProbe | Ist TRUE, wenn das VI als Sonde ausgeführt wird und geöffnet ist. |
| IsReentrant | Gibt an, ob ein VI ablaufinvariant sein kann. |
| Library | Gibt den Namen der LabVIEW-Projektbibliothek, des XControls oder der LabVIEW-Klasse aus, die dieses VI enthält. Wenn das VI weder zu einer Bibliothek, einem XControl oder einer Klasse gehört, gibt die Eigenschaft NULL aus. |
| LogAtFinish | Gibt an, ob Frontpanel-Werte in eine Protokolldatei geschrieben werden sollen, nachdem das VI ausgeführt wurde. |
| LogFilePath | Der Pfad zur Protokolldatei, in der die Frontpanel-Daten mit einem Zeitwert abgelegt werden. |
| Name | VI-Dateiname. Diese Eigenschaft kann nur festgelegt werden, solange das VI noch nicht gespeichert wurde. Wenn das VI zu einer LabVIEW-Projektbibliothek gehört, gibt diese Eigenschaft den qualifizierten Namen des VIs und den Dateinamen der Projektbibliothek aus. |
| OwningApp | Gibt eine Referenz auf die Anwendung aus, zu der dieses VI gehört. Schließen Sie die Referenz, wenn sie nicht mehr benötigt wird. |
| Path | Pfad zur VI-Datei. Diese Eigenschaft kann nur abgefragt werden. |
| PreferredExecSystem | Gibt das Ausführungssystem an, auf dem das VI läuft. |
| PrintHeaderDatePrint | Bei TRUE enthält die Kopfzeile das Druckdatum. Verwenden Sie die PrintingHeaders Mit dieser Eigenschaft wird festgelegt, ob LabVIEW die Kopfzeilen des VIs druckt. |
| PrintHeaderModifyDate | Bei TRUE wird beim Ausdrucken eines VIs das letzte Änderungsdatum in der Kopfzeile aufgeführt. Verwenden Sie die PrintingHeaders Mit dieser Eigenschaft wird festgelegt, ob LabVIEW die Kopfzeilen des VIs druckt. |
| PrintHeaderPageNumber | Bei TRUE enthält der Ausdruck Seitenzahlen. Verwenden Sie die PrintingHeaders Mit dieser Eigenschaft wird festgelegt, ob LabVIEW die Kopfzeilen des VIs druckt. |
| PrintHeaderVIIcon | Bei TRUE wird beim Ausdrucken des VIs das VI-Symbol in der Kopfzeile aufgeführt. Verwenden Sie die PrintingHeaders Mit dieser Eigenschaft wird festgelegt, ob LabVIEW die Kopfzeilen des VIs druckt. |
| PrintHeaderVIName | Bei TRUE wird beim Ausdrucken des VIs der VI-Name in der Kopfzeile aufgeführt. Verwenden Sie die PrintingHeaders Mit dieser Eigenschaft wird festgelegt, ob LabVIEW die Kopfzeilen des VIs druckt. |
| PrintLogFileAtFinish | Gibt an, ob nach Ausführungsende des VIs das Frontpanel ausgedruckt werden soll. |
| PrintMargins | Bestimmt oder ermittelt die Seitenränder beim Drucken des VIs. Die Angabe kann in Zentimetern oder in Zoll erfolgen. |
| PrintingBDScaling | Bei TRUE wird das Blockdiagramm so verkleinert oder vergrößert, dass es auf eine Seite passt. |
| PrintingFPScaling | Bei TRUE wird das Frontpanel an die Seitengröße angepasst. |
| PrintingHeaderVIPath | Gibt bei TRUE den Pfad zum VI an. Verwenden Sie die PrintingHeaders Mit dieser Eigenschaft wird festgelegt, ob LabVIEW die Kopfzeilen des VIs druckt. |
| PrintingHeaders | Bei TRUE wird das VI mit einer Kopfzeile ausgedruckt. Der Inhalt der Kopfzeilen wird mit den PrintHeader-Eigenschaften in dieser Klasse festgelegt. |
| PrintingOrientation | Dient zum Festlegen oder Abfragen der Seitenausrichtung beim Drucken des VIs. |
| ReentrancyType | Gibt an, welche Art der Ablaufinvarianz für ein ablaufinvariantes VI gelten soll. Diese Eigenschaft ähnelt den Optionen auf der Seite Ausführung des Dialogfelds Eigenschaften für VI. |
| RevisionNumber | Aktuelle Version des VIs. |
| RunOnOpen | Gibt an, ob das VI ausgeführt werden soll, wenn es geöffnet wird. |
| RunTimeMenuPath | Wenn diese Eigenschaft abgefragt wird, gibt sie den Pfad zum Laufzeitmenü des VIs aus. Ansonsten kann hier der Laufzeit-Menüpfad bestimmt werden. Wenn das VI läuft, während die Eigenschaft gesetzt wird, wird das Menü unter dem angegebenen Pfad neu geladen. |
| ShowFPOnCall | Gibt an, ob das Frontpanel angezeigt werden soll, wenn das VI aufgerufen wird. |
| ShowFPOnLoad | Gibt an, ob das Frontpanel angezeigt werden soll, wenn das VI geladen wird. |
| SuspendOnCall | Gibt an, ob das VI unterbrochen werden soll, wenn es als SubVI aufgerufen wird. Gehen Sie bei Verwendung dieser Eigenschaft mit ablaufinvarianten VIs vorsichtig vor. |
| TBShowAbortButton | Gibt an, ob die Schaltfläche Ausführung abbrechen in der LabVIEW-Symbolleiste angezeigt wird, während das VI ausgeführt wird. |
| TBShowFreeRunButton | Gibt an, ob die Schaltfläche Wiederholt ausführen in der LabVIEW-Symbolleiste während der VI-Ausführung angezeigt wird. |
| TBShowRunButton | Gibt an, ob die Schaltfläche Ausführen in der LabVIEW-Symbolleiste während der VI-Ausführung angezeigt wird. |
| TBVisible | Gibt an, ob während der Ausführung des VIs die LabVIEW-Symbolleiste eingeblendet werden soll. |
| VIType | Gibt an, um was für einen VI-Typen es sich handelt. |