DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion des champs
  • Variables de fichiers
  • Traitement d'initialisation
  • Champs Table et Zone répétée
  • Limites
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Ré-initialise :
  • soit tous les champs de la fenêtre ou de la page en cours (y compris les groupes de champs, les superchamps, les popups et les fenêtres internes).
  • soit les champs présents dans un groupe de champs, un superchamp, une popup, une fenêtre interne ou une page interne.
WEBDEV - Code NavigateurPHP Réinitialise tous les champs à leur valeur initiale. La valeur initiale des champs correspond à la valeur des champs lors du dernier affichage de la page sur le navigateur (premier affichage de la page ou affichage lors d'une réactualisation, ...).
Exemple
// Ajout d'un client
EcranVersFichier()
HAjoute(Client)
// Ré-initialisation des champs afin de saisir un nouveau client
RAZ(Vrai)
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)Ajax
// Ré-initialisation des champs présents dans le superchamp "SC_Client"
// Les champs liste, combo, table et zone répétée de ce superchamp
// conserveront leur contenu actuel.
RAZ(SC_Client, Vrai)
WEBDEV - Code NavigateurPHP
// -- Code de clic navigateur du bouton BTN_ANNULER
// Annule les saisies effectuées dans le formulaire
RAZ()
Syntaxe

Ré-initialiser tous les champs de la fenêtre ou de la page en cours Masquer les détails

RAZ([<Gestion des champs spéciaux>])
<Gestion des champs spéciaux> : Booléen optionnel
  • Vrai :
    • les champs de saisie et les champs Libellé sont ré-initialisés avec leur valeur initiale,
    • les champs Liste, Combo, Table et Zone répétée (fichier ou mémoire) ne sont ni vidés ni ré-initialisés. Ils conservent leur contenu actuel.
  • Faux (par défaut) :
    • les champs de saisie et les champs Libellé sont ré-initialisés avec leur valeur initiale,
    • les champs Liste, Combo, Table et Zone répétée "mémoire" sont vidés et ré-initialisés avec leur contenu initial,
    • les champs Liste, Combo, Table et Zone répétée "fichier" sont uniquement ré-initialisés (ils ne sont pas vidés).
WEBDEV - Code NavigateurPHP Ce paramètre n'est pas disponible : tous les champs de la page sont ré-initialisés à leur valeur initiale. La valeur initiale des champs correspond à la valeur des champs lors du dernier affichage de la page sur le navigateur (premier affichage de la page, ou affichage lors d'une réactualisation, ...).
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesCode Utilisateur (MCU)PHPAjax

Ré-initialiser tous les champs d'un groupe de champs, d'un superchamp, d'une fenêtre interne ou d'une page interne Masquer les détails

RAZ(<Nom de l'élément> [, <Gestion des champs spéciaux>])
<Nom de l'élément> : Chaîne de caractères
Nom de l'élément dont les champs doivent être ré-initialisés. Peut correspondre au :
  • Nom du groupe de champs.
  • Nom du superchamp.
  • Nom de la fenêtre interne ou de la page interne.
  • WEBDEV - Code Serveur Nom du modèle de champs.
  • WEBDEV - Code Serveur Nom de la popup.
PHP Nom du groupe de champs à réinitialiser.
<Gestion des champs spéciaux> : Booléen optionnel
  • Vrai :
    • les champs de saisie et les champs Libellé sont ré-initialisés avec leur valeur initiale,
    • les champs Liste, Combo, Table et Zone répétée (fichier ou mémoire) ne sont ni vidées ni ré-initialisées. Elles conservent leur contenu actuel.
  • Faux (par défaut) :
    • les champs de saisie et les champs Libellé sont ré-initialisés avec leur valeur initiale,
    • les champs Liste, Combo, Table et Zone répétée "mémoire" sont vidées et ré-initialisées avec leur contenu initial,
    • les champs Liste, Combo, Table et Zone répétée "fichier" sont uniquement ré-initialisées (elles ne sont pas vidées).
PHP Ce paramètre n'est pas disponible : tous les champs de la page sont ré-initialisés à leur valeur initiale. La valeur initiale des champs correspond à la valeur des champs lors du dernier affichage de la page sur le navigateur (premier affichage de la page, ou affichage lors d'une réactualisation, ...).
Remarques
WEBDEV - Code ServeurPHPAjax

Variables de fichiers

La fonction HRAZ permet de remettre à vide les variables des fichiers HFSQL. Pour réinitialiser uniquement les variables des fichiers HFSQL dans une page, il est nécessaire d'utiliser le code suivant :
HRAZ(<Nom de fichier>)
FichierVersPage()
Attention : Si des champs sont associés à des rubriques de fichiers, ces rubriques contiennent des étoiles ("*").
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

Traitement d'initialisation

Il ne faut pas confondre la fonction RAZ et la fonction PageInitialisation. En effet :
  • la fonction RAZ remet les champs à vide
  • la fonction PageInitialisation remet les champs à vide et relance les traitements d'initialisation.
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

Champs Table et Zone répétée

Un champ Table ou Zone répétée lié à un fichier de données ne peut jamais être vide. Ce champ s'initialise automatiquement avec les valeurs des rubriques reliées dans le fichier de données.

Limites

La fonction RAZ ne réinitialise pas les libellés des champs Bouton.
PHP La fonction RAZ n'a aucun effet sur les champs suivants :
  • Champ Libellé,
  • Champ Bouton,
  • Champ Image.
Composante : wd290obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 22/05/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale