VP SET ALLOWED METHODS

4D v19


VP SET ALLOWED METHODS ( objMethode )

Paramètre	Type	Description
objMethode	Objet	Méthodes autorisées dans les zones 4D View Pro

Description

La commande VP SET ALLOWED METHODS désigne les méthodes projets qui peuvent être appelées dans des formules 4D View Pro. Cette commande s'applique à toutes les zones 4D View Pro qui ont été crées après l'appel de la commande durant la session. Elle peut être appelée à plusieurs reprises dans la même session pour créer différentes configurations.

Par défaut, à des fins de sécurité, si vous n'exécutez pas la commande VP SET ALLOWED METHODS, aucun appel à une méthode n'est autorisé dans les zones 4D View Pro -- sauf si la commande générique de 4D, SET ALLOWED METHODS, a été utilisée (voir la note de compatibilité). L'utilisation d'une méthode non autorisée dans une formule affiche une erreur #NAME? dans la zone 4D View Pro.

Note de compatibilité : 4D View Pro prend en charge la commande générique de 4D SET ALLOWED METHODS si VP SET ALLOWED METHODS n'est pas appelée. En revanche, l'utilisation de VP SET ALLOWED METHODS est recommandée. Dès qu'elle est appelée, la commande SET ALLOWED METHODS n'a plus d'effet sur des zones 4D View Pro.

Dans le paramètre objMethode, passez un objet dans lequel chaque propriété porte le nom d'une fonction à définir dans les zones 4D View Pro :

Propriété

Type

Description

Objet

Nom de la fonction personnalisée à afficher dans les formules 4D View Pro (les espaces ne sont pas autorisés)

method

texte

(obligatoire) Nom de la méthode projet 4D existante à autoriser

parameters

Collection d'objets

Collection de paramètres (dans l'ordre dans lequel ils sont définis dans la méthode).

[ ].name

Texte

Nom d'un paramètre à afficher dans <functionName>. Note : Les noms de paramètres ne doivent pas contenir de caractères espace.

[ ].type

Numérique

Type de paramètre. Types pris en charge :

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

S'il est omis, par défaut la valeur est automatiquement envoyée avec son type, exceptées les valeurs date ou heure qui sont envoyées sous forme d'objet (voir la section Paramètres). SI type est défini sur Is object, l'objet possède la même structure que l'objet retourné par VP Get value.

summary

Texte

Description de la fonction à afficher dans 4D View Pro

minParams

Numérique

Nombre minimum de paramètres

maxParams

Numérique

Nombre maximum de paramètres. Si vous passez un nombre supérieur à la largeur de parameters, il est possible de déclarer des paramètres "optionnels" avec leur type par défaut

Pour plus de flexibilité, il est recommandé d'utiliser la commande qui vous permet de désigner des formules 4D pouvant être appelées depuis des zones 4D View Pro.

Exemple

Vous souhaitez autoriser deux méthodes dans vos zones 4D View Pro :

 C_OBJECT($allowed)

 $allowed:=New object //paramètre pour la commande

 

 $allowed.Hello:=New object //crée une première fonction simple nommée "Hello"

 $allowed.Hello.method:="My_Hello_Method" //définit la méthode 4D

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

 

 $allowed.Byebye:=New object //crée une deuxième fonction avec des paramètres nommée "Byebye" 

 $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)

Une fois ce code exécuté, les fonctions définies peuvent être utilisées dans des formules 4D View Pro :

Note : Les noms de fonctions 4D View Pro s'affichement automatiquement en majuscules.

Voir aussi

Références de méthodes projet
VP SET CUSTOM FUNCTIONS