Erfordert: VI-Skripte

Mit VI-Skripten können folgende Arbeitsschritte programmatisch am Anschlussfeld eines VIs durchgeführt werden:

  • Auswahl eines Anschlussmusters für ein SubVI
  • Verknüpfen eines Elements mit einem Anschluss im Anschlussfeld
  • Navigieren innerhalb eines Anschlussfelds
  • Festlegen, ob ein SubVI-Anschluss erforderlich, optional oder empfohlen ist

In diesem Abschnitt wird auf die ersten beiden Punkte eingegangen. Weitere Informationen zum programmatischen Arbeiten mit Anschlussfeldern finden Sie im Abschnitt Anschlussfeldmethoden.

Objekte

Zum Erstellen des Skripts benötigen Sie folgende Objekte:

VI:Anschlussfeld:Referenz ConnectorPane:Pattern Anschlussfeld:Element an Anschluss zuweisen Beispiel "Connector Pane Pattern Reference"

Vorgehensweise

Bevor Sie beginnen: Öffnen Sie das VI "Add Terminals to Connector Pane.vi" im Verzeichnis labview\examples\Application Control\VI Scripting\Connector Pane. In diesem Beispiel-VI wird jeder Schritt der folgenden Vorgehensweise dargestellt.

  1. Erstellen Sie eine Referenz auf das VI, dessen Anschlussfeld untersucht oder geändert werden soll.

    Details zum Beispiel

    Im Beispiel ermittelt das Skript-VI mit Hilfe der Funktion VI-Referenz öffnen eine Referenz auf ein bestimmtes VI.

  2. Führen Sie die Eigenschaft VI:Anschlussfeld:Referenz aus, um eine Referenz auf das Anschlussfeld des VIs zu erhalten.
  3. Entscheiden Sie sich für ein Anschlussfeldmuster.

    Alle Anschlussfeldmuster sind durch einen Index zwischen 4800 und 4835 gekennzeichnet. Per Voreinstellung arbeiten Anschlussfelder mit dem Muster 4815.

    Es gibt folgende Methoden, um den Index des gewünschten Musters zu ermitteln.

    • Eine vollständige Auflistung der Muster mit Indizes finden Sie im VI "Connector Pane Pattern Reference.vi" im Verzeichnislabview\examples\Application Control\VI Scripting\Connector Pane.
    • Sehen Sie sich die Kontexthilfe zu einem VI an, das das gleiche Anschlussfeldmuster verwendet, wie Sie für Ihr VI nutzen möchten. Wenn Sie die Skriptangaben in der Kontexthilfe einblenden, wird der Index des Musters am Ende des VI-Pfads angezeigt.
    • Fragen Sie mit der Eigenschaft Anschlussfeld:Muster eines anderen VIs programmatisch den Musterindex des betreffenden VIs ab.

    Details zum Beispiel

    Im Beispiel kann der Benutzer mit Hilfe des Skript-VIs das Anschlussfeldmuster während der Ausführung auswählen. Das Skript-VI verwendet ein Element zum Ermitteln des Anschlussfeldmusters.

    Hinweis Da das Anschlussfeldmuster alle Integer verarbeiten kann, sollte geprüft werden, dass sich der Wert des Elements im gültigen Bereich von 4800..4835 befindet. Der Einfachheit halber wird dieser Schritt hier ausgelassen.
  4. Mit der Eigenschaft "Anschlussfeld:Muster" das gewünschte Muster für das Anschlussfeld festlegen.
  5. Erstellen Sie Referenzen auf die Elemente, mit denen Ihr Anschlussfeld verknüpft werden soll.

    Details zum Beispiel

    Im dem Beispiel ermittelt das Skript-VI mit Hilfe der Eigenschafts Panel:Elemente[] des Frontpanels des Ziel-VIs Referenzen auf alle Frontpanel-Elemente.

  6. Festlegen, welches Element mit welchem Anschluss des Anschlussfelds verknüpft werden soll.

    Hinweise zum Verknüpfen von Bedien- und Anzeigeelementen mit für den Benutzer sichtbaren Anschlussfeldern finden Sie in der LabVIEW Style Checklist.

    Details zum Beispiel

    Der einzige Zweck des Skript-VIs besteht im vorliegenden Beispiel darin, allen Elementen einen Anschluss zuzuweisen. Es gibt daher keine Kriterien, wie die Elemente den Anschlüssen zugewiesen werden.

  7. Verknüpfen Sie jedes Element mit Hilfe der Methode Anschlussfeld:Element an Anschluss zuweisen mit dem gewünschten Anschluss des Anschlussfelds.

    Der Index der Anschlüsse im ausgewählten Muster kann anhand des in Schritt 3 angegebenen VIs "Connector Pane Pattern Reference" ermittelt werden.

    Details zum Beispiel

    Das Skript-VI durchläuft im vorliegenden Beispiel das gesamte Array "Panel:Elemente[]" und weist den Elementen nacheinander die Anschlüsse im Anschlussfeld zu. Bei dieser Vorgehensweise müssen die Anschlussindizes nicht bekannt sein, da die Elemente nicht mit spezifischen Anschlüssen verknüpft werden.

    Hinweis Da das im Beispiel ausgewählte Anschlussfeld weniger Anschlüsse enthalten kann, als Elemente auf dem Frontpanel vorhanden sind, kann die Methode „Anschlussfeld:Element an Anschluss zuweisen“ einen Fehler ausgeben. Hinweise zum Vermeiden dieses Fehlers finden Sie im Abschnitt Empfehlungen und Warnungen dieser Seite.
  8. Mit der Funktion Referenz schließen können Sie alle geöffneten Objektreferenzen nach ihrer Nutzung schließen.

    Details zum Beispiel

    Im vorliegenden Beispiel schließt das Skript-VI die Referenz auf das Frontpanel, die Elemente, das Anschlussfeld und das Ziel-VI.

Empfehlungen und Warnungen

  • Gehen Sie beim Ändern eines Anschlussfelds, dessen Anschlüsse bereits mit Elementen verknüpft sind, vorsichtig vor—Beim Ersetzen des Anschlussfeldmusters durch ein anderes werden alle Elemente, die mit dem vorherigen Anschlussfeld verknüpft waren, automatisch in das neue übertragen. Dabei werden jedoch nicht die Anschlussindizes beibehalten. Die Position der Anschlüsse kann sich ebenfalls ändern. Sie können sich daher nur 100-prozentig auf die Anschlussindizes verlassen, die nach dem Ändern des Musters zugewiesen wurden.
  • Vergewissern Sie sich, dass das Muster eines Anschlussfelds genügend Platz für den gewünschte Anschlussindex bietet—Die Methode "Anschlussfeld:Element an Anschluss zuweisen" gibt einen Fehler aus, wenn das Muster des angegebenen Anschlussfeldmuster nicht genügend Anschlüsse für den Anschlussindex enthält, der mit der Methode verbunden wurde. Wenden Sie auf das Anschlussfeld die Eigenschaft Anschlussfeld:Anzahl der Anschlüsse an, um zu prüfen, ob die Anzahl der Anschlüsse zum gewünschten Index passt.
  • Schließen Sie alle Referenzen nach der Verwendung—Wenn zu viele Referenzen geöffnet sind, verlangsamt sich die VI-Ausführung. Weitere Hinweise zu Faktoren, die die Ausführungsgeschwindigkeit beeinflussen, erhalten Sie im Abschnitt Schließen von Referenzen auf VIs und VI-Objekte.