Aller au contenu principal
Version : Suivant

VP SET ALLOWED METHODS

VP SET ALLOWED METHODS ( methodObj : Object)

ParamètresTypeDescription
methodObjObject->Méthodes autorisées dans les zones 4D View Pro

Compatibilité

Pour une plus grande flexibilité, il est recommandé d'utiliser la commande VP SET CUSTOM FUNCTIONS qui vous permet de désigner des formules 4D qui peuvent être appelées à partir des zones de 4D View Pro. Dès que VP SET CUSTOM FUNCTIONS est appelé, les appels de VP SET ALLOWED METHODS sont ignorés. 4D View Pro supporte également la commande générique SET ALLOWED METHODS de 4D si ni VP SET CUSTOM FUNCTIONS ni VP SET ALLOWED METHODS ne sont appelés, Cependant, l'utilisation de la commande générique n'est pas recommandée.

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, pour des raisons de sécurité, si vous n'exécutez pas la commande VP SET ALLOWED METHODS, aucun appel de méthode n'est autorisé dans les zones de 4D View Pro -- sauf si la commande générique SET ALLOWED METHODS de 4D 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.

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

PropriétéTypeDescription
<functionName>ObjectDescription de la fonction personnalisée. The <functionName> property name defines the name of the custom function to display in 4D View Pro formulas (no spaces allowed)
methodText(obligatoire) Nom de la méthode projet 4D existante à autoriser
parametersCollection d'objetsCollection de paramètres (dans l'ordre dans lequel ils sont définis dans la méthode). Pour plus d'informations, veuillez vous reporter à la section Paramètres.
[ ].nameTextName of a parameter to display for the <functionName>.Note: Parameter names must not contain space characters.
[ ].typeNumberType de paramètre. Supported types:
  • Is Boolean
  • Is collection
  • Is date
  • Is Integer
  • Is object
  • Is real
  • Is text
  • Is time
    • type can be omitted (except when at least one parameter is of collection type, in which case parameter's type declaration is mandatory).
    If type is omitted, by default the value is automatically sent with its type, except date or time values which are sent as an object. If type is Is object, the object is sent in a .value property. See Parameters section.
    summaryTextDescription de la fonction à afficher dans 4D View Pro
    minParamsNumberNombre minimum de paramètres
    maxParamsNumberNombre 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

    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éer une première fonction simple nommée "Hello"
    $allowed.Hello.method:="My_Hello_Method" //sets the 4D method
    $allowed.Hello.summary:="Hello prints hello world"
     
    $allowed.Byebye:=New object //créer 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 :

    Dans les formules de 4D View Pro, les noms des fonctions sont automatiquement affichés en majuscules.

    Voir également​

    4D functions
    VP SET CUSTOM FUNCTIONS