DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques au WEB / Fonctions de gestion des pages
  • Caractéristiques du champ Cellule
  • Cas particuliers
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
Affiche un champ Cellule dans la page avec un effet de GFI (Grisage des Fenêtres Inaccessibles). Cette fonction permet de simuler simplement une boîte de dialogue en code navigateur, en utilisant un champ Cellule dans une page.
Pour plus de détails sur les éléments nécessaires et les différents modes de dialogue, consultez Dialoguer avec l'internaute.
Exemple
// Affiche un champ Cellule contenant une question
CelluleAfficheDialogue(CELL_Question, celCentre, Vrai, 50)
Syntaxe
CelluleAfficheDialogue(<Champ Cellule> [, <Position d'affichage> [, <Prise en compte du GFI> [, <Taux de grisage>]]])
<Champ Cellule> : Nom de champ
Nom du champ Cellule qui sera affiché.
<Position d'affichage> : Constante de type Entier optionnelle
Position d'affichage de la cellule :
celBasDroiteLe champ Cellule est placé en bas à droite de la partie visible de la page courante.
celBasGaucheLe champ Cellule est placé en bas à gauche de la partie visible de la page courante.
celCentre
(Valeur par défaut)
Le champ Cellule est centré dans la partie visible de la page courante.
celHautDroiteLe champ Cellule est placé en haut à droite de la partie visible de la page courante.
celHautGaucheLe champ Cellule est placé en haut à gauche de la partie visible de la page courante.
celPositionXYLe champ Cellule est laissé à la position courante.
<Prise en compte du GFI> : Booléen optionnel
  • Vrai (valeur par défaut) pour afficher le champ Cellule avec l'effet de GFI (la page affichée derrière le champ Cellule est alors grisée),
  • Faux pour ne pas utiliser l'effet de GFI.
<Taux de grisage> : Entier
Taux de grisage (compris entre 0 et 100) utilisé pour le GFI.
Si une valeur supérieure à 100 est donnée, la valeur 100 sera utilisée.
Si une valeur inférieure à 0 est donnée, le GFI n'est pas pris en compte. Le taux de grisage par défaut est 18%.
Remarques

Caractéristiques du champ Cellule

  • Le champ Cellule doit être superposable (onglet "UI" de la fenêtre de description du champ Cellule).
  • Pour ne pas afficher d'ascenseurs inutiles dans le navigateur, cochez l'option "Forcer la position en haut à gauche de la page au moment du chargement" (onglet "Avancé" de la fenêtre de description du champ Cellule). Cette option permet de positionner automatiquement le champ Cellule à la position (0,0) au chargement de la page. La position d'affichage déterminée par la fonction CelluleAfficheDialogue est ensuite prise en compte.
Remarque : Pour exécuter un code serveur depuis un champ Cellule, utilisez les fonctions AJAXExécute ou AJAXExécuteAsynchrone.

Cas particuliers

  • Pour que le champ Cellule soit affiché, il faut utiliser la fonction CelluleAfficheDialogue :
    • soit dans un bouton de type "Aucune". Dans ce cas, seul le code navigateur du bouton sera exécuté.
    • soit dans un bouton de type "Submit" et activer AJAX dans le code de ce bouton. Dans ce cas, les codes navigateur et serveur du bouton seront exécutés.
  • Le champ Cellule affiché pourra être masqué avec la fonction CelluleFermeDialogue.
  • Les navigateurs ne rafraîchissent pas l'affichage au milieu d'un code Javascript : les fonctions CelluleAfficheDialogue et CelluleFermeDialogue doivent être utilisées dans des événements/traitements différents. Si ces fonctions sont utilisées dans le même événement/traitement, le champ Cellule n'est pas affiché.
  • Il n'est pas possible d'afficher deux champs Cellule différents en même temps avec la fonction CelluleAfficheDialogue.
Composante : WDJS.DLL
Version minimum requise
  • Version 12
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 18/12/2023

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