VP SET ALLOWED METHODS

Home

4D v19


VP SET ALLOWED METHODS ( methodObj )

Parameter	Typ	Beschreibung
methodObj	Objekt	Erlaubte Methoden in 4D View Pro Bereichen

Beschreibung

Der Befehl VP SET ALLOWED METHODS bestimmt die Projektmethoden, welche in 4D View Pro Formeln aufgerufen werden können. Dieser Befehl gilt für alle 4D View Pro Bereiche, die nach dessen Aufruf während der Sitzung initialisiert werden. Er lässt sich in einer Sitzung auch mehrfach aufrufen, um unterschiedliche Konfigurationen zu initialisieren.

Führen Sie den Befehl VP SET ALLOWED METHODS nicht aus, ist aus Sicherheitsgründen in 4D View Pro Bereichen standardmäßig kein Methodenaufruf zugelassen -- außer der generische 4D Befehl SET ALLOWED METHODS wurde verwendet (siehe nachfolgender Hinweis). Verwenden Sie eine nicht-autorisierte Methode in einer Formel, erscheint im 4D View Pro Bereich der Fehler #NAME? .

Hinweis zur Kompatibilität: Wird VP SET ALLOWED METHODS nicht aufgerufen, verwendet 4D den generischen Befehl SET ALLOWED METHODS. Jedoch wird die Verwendung von VP SET ALLOWED METHODS empfohlen. Sobald dieser Befehl aufgerufen wird, hat SET ALLOWED METHODS keine Auswirkung mehr auf 4D View Pro Bereiche.

Im Parameter methodObj übergeben Sie ein Objekt, wobei jede Eigenschaft der Name einer Funktion zur Definition in 4D View Pro Bereichen ist:

Eigenschaft

Typ

Beschreibung

Objekt

Name der eigenen Funktion zur Anzeige in 4D View Pro Formeln (keine Leerzeichen erlaubt)

method

Text

(zwingend) Name der vorhandenen 4D Projektmethode, die erlaubt werden soll

parameters

Collection von Objekten

Collection der Parameter (in der Reihenfolge, wie sie in der Methode definiert sind).

[ ].name

Text

Name eines Parameters zur Anzeige für <functionName>. Hinweis: Parameternamen dürfen keine Leerzeichen enthalten.

[ ].type

Zahl

Typ des Parameters. Unterstützte Typen:

Konstante
Is Boolean
Is date
Is longint
Is object
Is real
Is text
Is time

Ohne Angabe wird automatisch der Wert mit seinem Typ gesendet, außer bei Datums- und Zeitwerten, die als Objekt gesendet werden (siehe Abschnitt Parameter). Beim Typ Is object hat das Objekt dieselbe Struktur wie das von VP Get value zurückgegebene Objekt.

summary

Text

Funktionsbeschreibung zur Anzeige in 4D View Pro

minParams

Zahl

Min. Anzahl der Parameter

maxParams

Zahl

Max. Anzahl der Parameter. Bei Angabe einer Zahl höher als die Länge von parameters lassen sich "optionale" Parameter mit Standardtyp deklarieren

Für größere Flexibilität empfehlen wir den Befehl VP SET CUSTOM FUNCTIONS. Damit können Sie 4D Formeln bestimmen, die sich von 4D View Pro Bereichen aufrufen lassen.

Beispiel

Zwei Methoden in ihren 4D View Pro Bereichen erlauben:

 C_OBJECT($allowed)

 $allowed:=New object //Parameter für den Befehl

 

 $allowed.Hello:=New object //Erste einfache Funktion mit Namen "Hello" erstellen

 $allowed.Hello.method:="My_Hello_Method" //setzt die 4D Methode

 $allowed.Hello.summary:="Hello prints hello world"

 

 $allowed.Byebye:=New object //Zweite Funktion mit Parametern mit Namen "Byebye" erstellen

 $allowed.Byebye.method:="My_ByeBye_Method"

 $allowed.Byebye.parameters:=New collection

 $allowed.Byebye.parameters.push(New object("name";"Message";"type";Is text))

 $allowed.Byebye.parameters.push(New object("name";"Date";"type";Is date))

 $allowed.Byebye.parameters.push(New object("name";"Time";"type";Is time))

 $allowed.Byebye.summary:="Byebye prints a custom timestamp"

 $allowed.Byebye.minParams:=3

 $allowed.Byebye.maxParams:=3

 

 VP SET ALLOWED METHODS($allowed)

Nach Ausführen des Code lassen sich die definierten Funktionen in 4D View Pro Formeln ausführen:

Hinweis: Funktionsnamen in 4D View Pro erscheinen automatisch in Großbuchstaben.

Siehe auch

Referenzen auf Projektmethoden
VP SET CUSTOM FUNCTIONS