PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Cas particuliers
  • Paramètres nommés
  • Appel de procédure globale WLangage navigateur depuis une procédure globale Javascript (présente dans la même collection de procédures)
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
L'appel d'une procédure est le même qu'il s'agisse d'une procédure globale ou d'une procédure locale.
Rappel :
  • En WLangage, il n'existe pas de distinction entre les procédures et les fonctions. Les syntaxes de déclaration et d'utilisation décrites pour les procédures sont les mêmes pour les fonctions.
  • Versions 16 et supérieures
    Dans le cas d'une procédure multisyntaxe, l'appel de la bonne syntaxe est résolu à l'exécution. Pour plus de détails, consultez Surcharge de prototype.
    Nouveauté 16
    Dans le cas d'une procédure multisyntaxe, l'appel de la bonne syntaxe est résolu à l'exécution. Pour plus de détails, consultez Surcharge de prototype.
    Dans le cas d'une procédure multisyntaxe, l'appel de la bonne syntaxe est résolu à l'exécution. Pour plus de détails, consultez Surcharge de prototype.
Versions 21 et supérieures
Universal Windows 10 App Cette fonctionnalité est disponible en mode Universal Windows 10 App.
Apple Watch Cette fonctionnalité est disponible en mode Apple Watch.
Nouveauté 21
Universal Windows 10 App Cette fonctionnalité est disponible en mode Universal Windows 10 App.
Apple Watch Cette fonctionnalité est disponible en mode Apple Watch.
Universal Windows 10 App Cette fonctionnalité est disponible en mode Universal Windows 10 App.
Apple Watch Cette fonctionnalité est disponible en mode Apple Watch.
Exemple
// Appel de la procédure Trouve qui retourne un booléen
SI Trouve(Client, NumCli, Numéro) ALORS
        Info("Numéro de client trouvé")
SINON
        Info("Numéro de client inexistant")
FIN
Syntaxe

Appeler une procédure renvoyant un paramètre Masquer les détails

[<Valeur retournée> = ] <Nom de la procédure>([<Paramètres>])
<Valeur retournée> :
Valeur retournée (optionnel) par la procédure, uniquement si la procédure retourne un résultat.
Versions 18 et supérieures
Il est possible de typer la valeur de retour d'une procédure lors de sa déclaration. Pour plus de détails, consultez Déclarer une procédure.
Nouveauté 18
Il est possible de typer la valeur de retour d'une procédure lors de sa déclaration. Pour plus de détails, consultez Déclarer une procédure.
Il est possible de typer la valeur de retour d'une procédure lors de sa déclaration. Pour plus de détails, consultez Déclarer une procédure.
<Nom de la procédure> :
Nom de la procédure à appeler.
<Paramètres> :
Paramètres passés à la procédure. Chaque paramètre est séparé par une virgule.
Versions 20 et supérieures
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
Nouveauté 20
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
Pour plus de détails sur la déclaration des paramètres d'une procédure, consultez Les paramètres d'une procédure.
Versions 19 et supérieures

Appeler une procédure renvoyant plusieurs paramètres Masquer les détails

(<Valeur 1>, ..., <Valeur N>) = <Nom de la procédure>([<Paramètres>])
<Valeur 1 à N> :
Valeurs retournées par la procédure.
Il est possible de typer les valeurs de retour d'une procédure lors de sa déclaration. Pour plus de détails, consultez Déclarer une procédure.
<Nom de la procédure> :
Nom de la procédure à appeler.
<Paramètres> :
Paramètres passés à la procédure. Chaque paramètre est séparé par une virgule.
Versions 20 et supérieures
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
Nouveauté 20
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
Pour plus de détails sur la déclaration des paramètres d'une procédure, consultez Les paramètres d'une procédure.
Nouveauté 19

Appeler une procédure renvoyant plusieurs paramètres Masquer les détails

(<Valeur 1>, ..., <Valeur N>) = <Nom de la procédure>([<Paramètres>])
<Valeur 1 à N> :
Valeurs retournées par la procédure.
Il est possible de typer les valeurs de retour d'une procédure lors de sa déclaration. Pour plus de détails, consultez Déclarer une procédure.
<Nom de la procédure> :
Nom de la procédure à appeler.
<Paramètres> :
Paramètres passés à la procédure. Chaque paramètre est séparé par une virgule.
Versions 20 et supérieures
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
Nouveauté 20
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
Pour plus de détails sur la déclaration des paramètres d'une procédure, consultez Les paramètres d'une procédure.

Appeler une procédure renvoyant plusieurs paramètres Masquer les détails

(<Valeur 1>, ..., <Valeur N>) = <Nom de la procédure>([<Paramètres>])
<Valeur 1 à N> :
Valeurs retournées par la procédure.
Il est possible de typer les valeurs de retour d'une procédure lors de sa déclaration. Pour plus de détails, consultez Déclarer une procédure.
<Nom de la procédure> :
Nom de la procédure à appeler.
<Paramètres> :
Paramètres passés à la procédure. Chaque paramètre est séparé par une virgule.
Versions 20 et supérieures
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
Nouveauté 20
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile Il est possible d'utiliser des paramètres nommés. Pour plus de détails, consultez le paragraphe "Paramètres nommés".
Pour plus de détails sur la déclaration des paramètres d'une procédure, consultez Les paramètres d'une procédure.
Remarques

Cas particuliers

  • Pour des raisons de lisibilité des programmes, le mot-clé PROCEDURE peut être remplacé par le mot-clé FONCTION.
  • Si la procédure n'attend aucun paramètre, il est également possible d'utiliser la syntaxe suivante :
    [<Valeur retournée> = ] <Nom de la procédure>
  • Pour exécuter une procédure d'une fenêtre ouverte, il suffit d'utiliser la fonction ExécuteTraitement. Exemple :
    // Exécution de la procédure MaProc contenue dans la fenêtre FEN_MaFenêtre
    NomFen est une chaîne = "FEN_MaFenêtre"
    ExécuteTraitement(NomFen + ".MaProc", trtProcédure)
Versions 20 et supérieures
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile

Paramètres nommés

Si une procédure possède des paramètres avec des valeurs par défaut, il est possible d'appeler la procédure en nommant ses paramètres. Deux syntaxes sont possibles :
  • Paramètres nommés monolignes,
  • Paramètres nommés multilignes.
1. Paramètres nommés monolignes
La syntaxe utilisée est la suivante :
NomProcédure(< <nom du paramètre1> > : <valeur1>, < <nom du paramètre2> > : <valeur2>, ...)
Voyons les différentes règles de fonctionnement à l'aide d'un exemple :
  • Code de la procédure :
    PROCEDURE MaProcédure(p1, p2, p3 = 0, p4 = 0, p5 = 0)
  • Appel de la procédure en utilisant des paramètres nommés :
    MaProcédure(<p1>:1, <p2>:2)
  • Les paramètres optionnels non renseignés seront affectés avec leur valeur par défaut.
    MaProcédure(<p1>:1, <p2>:2, <p4>:4)
  • Les paramètres obligatoires peuvent être passés sans leur nom, en utilisant les paramètres ordonnés classiques. Les paramètres nommés sont forcément après les paramètres ordonnés :
    MaProcédure(1, 2, <p4>:4)

    MaProcédure(1, <p4>:4, 2) // Provoque une erreur
  • Tous les paramètres obligatoires doivent être précisés sinon une erreur de compilation sera générée.
    MaProcédure(<p1>:1) // erreur : p2 manquant

    MaProcédure(<p1>:1, <p4>:4)// erreur : p2 manquant
  • Chaque paramètre ne peut être précisé qu'une seule fois sinon une erreur de compilation sera générée.
    MaProcédure(<p2>:2, <p1>:1, <p2>:2) //erreur : p2 en double
  • Les paramètres peuvent être indiqués dans n'importe quel ordre : les valeurs des paramètres sont évaluées dans l'ordre d'écriture habituel (de gauche à droite).
    MaProcédure(f1(), f2(), <p5>:f3(), <p4>:f4()) // Ordre d'exécution : f1, f2, f3, f4
Les règles de passage des paramètres sont identiques à celles appliquées lors d'un appel classique. Pour plus de détails, consultez Passage de paramètres.
2. Paramètres nommés multilignes
La syntaxe utilisée est la suivante :
// Définition des paramètres
NomProcédure.<Nom du paramètre 1> = <Valeur 1>
...
NomProcédure.<Nom du paramètre N> = <Valeur N>
// Appel de la procédure
NomProcédure()
Cette syntaxe est disponible :
  • sur les procédures globales.
  • sur les procédures locales appelées depuis l'élément qui possède la procédure.
  • sur les méthodes appelées depuis une méthode de la classe ou d'une classe dérivée.
Exemple :
  • Code de la procédure :
    PROCEDURE MaProcédure(p1, p2, p3 = 0, p4 = 0, p5 = 0)
  • Code d'appel :
    // Définition des paramètres
    MaProcédure.p1 = 1
    NomProcédure.p2 = 2
    // Appel de la procédure
    MaProcédure()
Remarques :
  • Les paramètres de la procédure sont limités au traitement courant. L'appel doit donc se trouver dans le même traitement que les affectations. Une erreur de compilation est provoquée si des paramètres sont renseignés et si aucun appel à la procédure n'est détecté dans le traitement.
  • Aucune vérification n'est faite sur la présence des paramètres obligatoires. Une erreur peut donc se produire à l'exécution si un paramètre obligatoire n'a pas été renseigné.
  • Les paramètres sont réinitialisés au moment de l'appel pour qu'un paramètre ne soit pas réutilisé par erreur ; il n'est donc pas possible de faire deux appels avec les mêmes paramètres.
  • Attention : Le passage de paramètres se fait dans ce cas par valeur et non plus par variable.
Nouveauté 20
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile

Paramètres nommés

Si une procédure possède des paramètres avec des valeurs par défaut, il est possible d'appeler la procédure en nommant ses paramètres. Deux syntaxes sont possibles :
  • Paramètres nommés monolignes,
  • Paramètres nommés multilignes.
1. Paramètres nommés monolignes
La syntaxe utilisée est la suivante :
NomProcédure(< <nom du paramètre1> > : <valeur1>, < <nom du paramètre2> > : <valeur2>, ...)
Voyons les différentes règles de fonctionnement à l'aide d'un exemple :
  • Code de la procédure :
    PROCEDURE MaProcédure(p1, p2, p3 = 0, p4 = 0, p5 = 0)
  • Appel de la procédure en utilisant des paramètres nommés :
    MaProcédure(<p1>:1, <p2>:2)
  • Les paramètres optionnels non renseignés seront affectés avec leur valeur par défaut.
    MaProcédure(<p1>:1, <p2>:2, <p4>:4)
  • Les paramètres obligatoires peuvent être passés sans leur nom, en utilisant les paramètres ordonnés classiques. Les paramètres nommés sont forcément après les paramètres ordonnés :
    MaProcédure(1, 2, <p4>:4)

    MaProcédure(1, <p4>:4, 2) // Provoque une erreur
  • Tous les paramètres obligatoires doivent être précisés sinon une erreur de compilation sera générée.
    MaProcédure(<p1>:1) // erreur : p2 manquant

    MaProcédure(<p1>:1, <p4>:4)// erreur : p2 manquant
  • Chaque paramètre ne peut être précisé qu'une seule fois sinon une erreur de compilation sera générée.
    MaProcédure(<p2>:2, <p1>:1, <p2>:2) //erreur : p2 en double
  • Les paramètres peuvent être indiqués dans n'importe quel ordre : les valeurs des paramètres sont évaluées dans l'ordre d'écriture habituel (de gauche à droite).
    MaProcédure(f1(), f2(), <p5>:f3(), <p4>:f4()) // Ordre d'exécution : f1, f2, f3, f4
Les règles de passage des paramètres sont identiques à celles appliquées lors d'un appel classique. Pour plus de détails, consultez Passage de paramètres.
2. Paramètres nommés multilignes
La syntaxe utilisée est la suivante :
// Définition des paramètres
NomProcédure.<Nom du paramètre 1> = <Valeur 1>
...
NomProcédure.<Nom du paramètre N> = <Valeur N>
// Appel de la procédure
NomProcédure()
Cette syntaxe est disponible :
  • sur les procédures globales.
  • sur les procédures locales appelées depuis l'élément qui possède la procédure.
  • sur les méthodes appelées depuis une méthode de la classe ou d'une classe dérivée.
Exemple :
  • Code de la procédure :
    PROCEDURE MaProcédure(p1, p2, p3 = 0, p4 = 0, p5 = 0)
  • Code d'appel :
    // Définition des paramètres
    MaProcédure.p1 = 1
    NomProcédure.p2 = 2
    // Appel de la procédure
    MaProcédure()
Remarques :
  • Les paramètres de la procédure sont limités au traitement courant. L'appel doit donc se trouver dans le même traitement que les affectations. Une erreur de compilation est provoquée si des paramètres sont renseignés et si aucun appel à la procédure n'est détecté dans le traitement.
  • Aucune vérification n'est faite sur la présence des paramètres obligatoires. Une erreur peut donc se produire à l'exécution si un paramètre obligatoire n'a pas été renseigné.
  • Les paramètres sont réinitialisés au moment de l'appel pour qu'un paramètre ne soit pas réutilisé par erreur ; il n'est donc pas possible de faire deux appels avec les mêmes paramètres.
  • Attention : Le passage de paramètres se fait dans ce cas par valeur et non plus par variable.
WINDEVWEBDEV - Code ServeuriPhone/iPadApple WatchWindows Mobile

Paramètres nommés

Si une procédure possède des paramètres avec des valeurs par défaut, il est possible d'appeler la procédure en nommant ses paramètres. Deux syntaxes sont possibles :
  • Paramètres nommés monolignes,
  • Paramètres nommés multilignes.
1. Paramètres nommés monolignes
La syntaxe utilisée est la suivante :
NomProcédure(< <nom du paramètre1> > : <valeur1>, < <nom du paramètre2> > : <valeur2>, ...)
Voyons les différentes règles de fonctionnement à l'aide d'un exemple :
  • Code de la procédure :
    PROCEDURE MaProcédure(p1, p2, p3 = 0, p4 = 0, p5 = 0)
  • Appel de la procédure en utilisant des paramètres nommés :
    MaProcédure(<p1>:1, <p2>:2)
  • Les paramètres optionnels non renseignés seront affectés avec leur valeur par défaut.
    MaProcédure(<p1>:1, <p2>:2, <p4>:4)
  • Les paramètres obligatoires peuvent être passés sans leur nom, en utilisant les paramètres ordonnés classiques. Les paramètres nommés sont forcément après les paramètres ordonnés :
    MaProcédure(1, 2, <p4>:4)

    MaProcédure(1, <p4>:4, 2) // Provoque une erreur
  • Tous les paramètres obligatoires doivent être précisés sinon une erreur de compilation sera générée.
    MaProcédure(<p1>:1) // erreur : p2 manquant

    MaProcédure(<p1>:1, <p4>:4)// erreur : p2 manquant
  • Chaque paramètre ne peut être précisé qu'une seule fois sinon une erreur de compilation sera générée.
    MaProcédure(<p2>:2, <p1>:1, <p2>:2) //erreur : p2 en double
  • Les paramètres peuvent être indiqués dans n'importe quel ordre : les valeurs des paramètres sont évaluées dans l'ordre d'écriture habituel (de gauche à droite).
    MaProcédure(f1(), f2(), <p5>:f3(), <p4>:f4()) // Ordre d'exécution : f1, f2, f3, f4
Les règles de passage des paramètres sont identiques à celles appliquées lors d'un appel classique. Pour plus de détails, consultez Passage de paramètres.
2. Paramètres nommés multilignes
La syntaxe utilisée est la suivante :
// Définition des paramètres
NomProcédure.<Nom du paramètre 1> = <Valeur 1>
...
NomProcédure.<Nom du paramètre N> = <Valeur N>
// Appel de la procédure
NomProcédure()
Cette syntaxe est disponible :
  • sur les procédures globales.
  • sur les procédures locales appelées depuis l'élément qui possède la procédure.
  • sur les méthodes appelées depuis une méthode de la classe ou d'une classe dérivée.
Exemple :
  • Code de la procédure :
    PROCEDURE MaProcédure(p1, p2, p3 = 0, p4 = 0, p5 = 0)
  • Code d'appel :
    // Définition des paramètres
    MaProcédure.p1 = 1
    NomProcédure.p2 = 2
    // Appel de la procédure
    MaProcédure()
Remarques :
  • Les paramètres de la procédure sont limités au traitement courant. L'appel doit donc se trouver dans le même traitement que les affectations. Une erreur de compilation est provoquée si des paramètres sont renseignés et si aucun appel à la procédure n'est détecté dans le traitement.
  • Aucune vérification n'est faite sur la présence des paramètres obligatoires. Une erreur peut donc se produire à l'exécution si un paramètre obligatoire n'a pas été renseigné.
  • Les paramètres sont réinitialisés au moment de l'appel pour qu'un paramètre ne soit pas réutilisé par erreur ; il n'est donc pas possible de faire deux appels avec les mêmes paramètres.
  • Attention : Le passage de paramètres se fait dans ce cas par valeur et non plus par variable.
WEBDEV - Code Navigateur

Appel de procédure globale WLangage navigateur depuis une procédure globale Javascript (présente dans la même collection de procédures)

Pour appeler une procédure WLangage navigateur depuis une procédure Javascript, il est nécessaire de préfixer le nom de la procédure WLangage par le nom de la collection de procédures. Le nom de la procédure et le nom de la fonction doivent être séparés par un tiret bas (_) et non par un point.
Le nom de la collection de procédures utilisé dans la procédure Javascript :
  • ne doit comporter aucun accent,
  • être en majuscules,
  • sans ponctuation,
  • sans espaces.
Par exemple : Pour appeler la procédure WLangage "MaCollection à tester.TestUnitaire", il faut écrire dans la procédure Javascript "MACOLLECTIONATESTER_TestUnitaire".
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire