Unterprogramme und Funktionen

VBScript-Unterprogramme und -Funktionen

Dieser Abschnitt bietet einen Überblick über die Verwendung von Unterprogrammen und Prozeduren in VisualBasic-Skripten von Altum Designer.

Übergabe von Parametern an Prozeduren

Wenn in einem Skript eine Funktion oder Unterroutine (eine Prozedur/Methode) definiert ist, die Parameter entgegennehmen kann, lassen sich Variablen auf zwei Arten an die Funktion oder Unterroutine übergeben: per Referenz oder per Wert, unter Verwendung von ByRef bzw. ByVal .

Um die Methode zu deklarieren, an die Parameter übergeben werden, verwenden Sie das Schlüsselwort ByRef oder ByVal Schlüsselwörter in der Parameterliste, wenn die Funktion oder Subroutine in einem Sub oder Function Anweisung. Das folgende Codefragment definiert beispielsweise eine Subroutine, die zwei Parameter akzeptiert. Der erste wird als Wert übergeben, der zweite als Referenz:

Sub Test (ByVal Param1 As Integer , ByRef B As String)

Der Unterschied zwischen den beiden Methoden besteht darin, dass ByRef eine Referenz auf die Variable übergibt und es der Unterroutine bzw. Funktion ermöglicht, Änderungen an der eigentlichen Variable vorzunehmen, die als Parameter übergeben wurde. Dies ist die Standardmethode zur Parameterübergabe und wird verwendet, wenn keine andere Methode explizit deklariert wurde.

ByVal übergibt nur den Wert der Variablen. Die Unterroutine oder Funktion kann diesen Wert verwenden, die ursprünglich übergebene Variable wird jedoch nicht verändert.

Die folgenden Beispiele veranschaulichen die Unterschiede zwischen den Methoden. Die Hauptprozedur sieht wie folgt aus:

Sub Main
  Dim X, Y
  X = 45 : Y = "Number"
  Test X, Y   ' Call to a subprocedure called Test.
  MsgBox X
   MsgBox Y
End Sub

Die obige Prozedur enthält einen Aufruf einer Unterprozedur Test – siehe unten.

Wenn die Subroutine wie folgt definiert ist:

Sub Test (ByRef A, ByRef B)
  B = B & " = " & A : A = 10*A
End Sub

Dann werden die Variablen X und Y in der Hauptprozedur werden von der Unterprozedur direkt referenziert. Das hat zur Folge, dass die Werte von X und Y durch die Unterroutine verändert werden, sodass nach der Test ausgeführt wurde, gilt: X = 450 und Y = „Number = 45“. Dies ist das Standardverhalten, wenn die Methode nicht explizit deklariert ist.

Wird die Subroutine jedoch wie folgt definiert:

Sub Test (ByVal A, ByVal B)
B = B & " = " & A : A = 10*A
End Sub

Dann meldet die Hauptprozedur nach der Ausführung von Test ausgeführt wurde, meldet die Hauptprozedur: X = 45 und Y = „Number“ – das heißt, sie bleiben unverändert.

Alternativ, wenn die Unterroutine wie folgt definiert ist (gemischte Methoden):

Sub Test (ByRef A, ByVal B)
  B = B & " = " & A : A = 10*A
End Sub

Dann wird nach Test ausgeführt wurde, gilt X = 450 und Y = „Number“, da Y als Wert übergeben wurde, bleibt dieser unverändert.

Sie können die ByRef Einstellung einer Funktion oder Subroutine überschreiben, indem Sie den Variablennamen in der Aufrufanweisung in Klammern setzen.

Aufruf von „Test“ mit der folgenden Anweisung:

Test (X), Y

...würde die Variable X als Wert übergeben, unabhängig davon, welche Methode für diesen Parameter in der Prozedurdefinition festgelegt wurde.

Datums- und Zeitroutinen

Die Sprache VBScript unterstützt eine Reihe von Datums- und Zeitroutinen, wie im Folgenden beschrieben:

Date

Day

Hour

IsDate

Minute

Month

Now

Second

Time

Year

 

 

Datei-E/A-Routinen

Die Sprache VBScript unterstützt die folgenden Datei-E/A-Routinen:

Dir

FileLen

FileTimeDate

FileCopy

Kill

Name

RmDir

MkDir

 

Mathematik-Routinen

Die Sprache VBScript unterstützt die folgenden mathematischen Routinen:

Abs

Atn

Cos

Exp

Log

Not

Oct

Rnd

Sin

Sqn

Tan

 

Zeichenfolgen-Routinen

Die Sprache VBScript unterstützt eine Reihe von Zeichenfolgenroutinen, wie im Folgenden beschrieben:

Asc

Chr

Format

InStr

InStrRev

LCase

Len

Left

Mid

Right

Str

Trim

LTrim

RTrim

UCase

Serverprozess-Routinen

Die Serverprozess-Routinen werden bei der Arbeit mit Prozessen in Skripten verwendet, insbesondere wenn Zeichenfolgen für die Prozessparameter extrahiert (abgerufen) oder festgelegt werden müssen.

Um Prozesse und Parameter in Skripten auszuführen, verwenden Sie die folgenden Funktionen:

AddColorParameter

AddIntegerParameter

AddLongIntParameter

AddSingleParameter

AddWordParameter

GetIntegerParameter

GetStringParameter

ResetParameters

RunProcess

Useful functions

SetCursorBusy

ResetCursor

CheckActiveServer

GetActiveServerName

GetCurrentDocumentFileName

RunApplication

SaveCurrentDocument

 

 

Useful Dialogs

ConfirmNoYes

ConfirmNoYesCancel

ShowError

ShowInfo

ShowWarning

 

AI-LocalizedKI-lokalisiert
Wenn Sie ein Problem feststellen, wählen Sie den Text/das Bild aus und drücken SieCtrl + Enter, um uns Ihr Feedback zu senden.
Funktionsverfügbarkeit

Die Ihnen zur Verfügung stehenden Funktionen hängen davon ab, über welche Altium-Lösung Sie verfügen – Altium Develop, Altium Agile Teams, Altium Agile Enterprise oder Altium Designer (mit aktivem Laufzeitvertrag).

Wenn Sie eine dokumentierte Funktion in Ihrer tatsächlich verwendeten Software nicht sehen, wenden Sie sich an den Altium-Vertrieb, um mehr zu erfahren.

Legacy-Dokumentation

Die Dokumentation von Altium Designer wird nicht mehr versioniert. Wenn Sie auf Dokumentation für ältere Versionen von Altium Designer zugreifen müssen, besuchen Sie den Abschnitt Legacy-Dokumentation auf der Seite Andere Installer.

Inhalt