DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Tableau de bord
  • Présentation
  • FAA dans les applications Windows
  • Présentation
  • Les fonctionnalités du menu contextuel
  • Le mode Edition/Modification du champ Tableau de bord
  • FAA dans les sites WEBDEV
  • FAA dans les applications mobiles
  • Passage en mode modification
  • Barre d'outils du mode modification
  • Sortie du mode modification
  • Déplacement d'un Widget
  • Redimensionnement d'un Widget
  • Ajout d'un Widget
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
Champ Tableau de bord : Fonctionnalités Automatiques de vos Applications (FAA)
Présentation
Le champ Tableau de bord propose plusieurs Fonctionnalités Automatiques de vos Applications (FAA) permettant à l'utilisateur de profiter pleinement de toutes les possibilités du champ. Ces fonctionnalités sont disponibles dans les applications Windows, les sites WEBDEV et les applications mobiles.
WINDEV
FAA dans les applications Windows

Présentation

Par défaut, le champ Tableau de bord propose à l'utilisateur de :
  • Passer en mode modification : le mode modification permet à l'utilisateur de configurer son tableau de bord.
  • Enregistrer le contenu du champ Tableau de bord sous forme d'une image.
Lorsque l'utilisateur passe en mode "modification", il peut configurer les différents éléments présents dans son tableau de bord :
Il est possible de :
  • masquer un élément,
  • ajouter un élément invisible,
  • restaurer la configuration initiale.
Le mode édition permet également de modifier la position et la taille des éléments.

Les fonctionnalités du menu contextuel

  • Enregistrer sous (image) : Cette fonctionnalité permet d'enregistrer le contenu du champ Tableau de bord sous forme d'image (pour l'imprimer par exemple).
  • Mode modification : Cette fonctionnalité permet de passer en mode modification afin que l'utilisateur puisse configurer son tableau de bord.

Le mode Edition/Modification du champ Tableau de bord

Les options disponibles dans le menu contextuel en mode modification sont les suivantes :
  • Ajouter : Cette option ouvre un sous-menu affichant la liste des Widgets rendus invisibles et pouvant être ajoutés.
  • Masquer : Cette option permet de masquer le Widget en cours.
  • Restaurer la configuration initiale : Cette option permet de remettre le tableau de bord dans son état avant les modifications effectuées en mode édition. Toutes les modifications effectuées (taille, position, masquage, ajout) sont annulées.
Il est possible de configurer par programmation le mode Modification :
  • La fonction TDBMode permet :
    • de savoir si le mode Modification est activé ou non,
    • d'activer ou de désactiver le mode modification,
    • de paramétrer les actions disponibles dans le mode modification. Il est par exemple possible de n'autoriser que le déplacement et le redimensionnement des Widgets.
  • La fonction FAADésactive utilisée avec la constante faaTdbModeEdition permet de désactiver le menu contextuel permettant de passer en mode modification.
WEBDEV - Code Serveur
FAA dans les sites WEBDEV
Par défaut, le champ Tableau de bord propose à l'utilisateur un menu contextuel permettant de  :
  • Passer en mode modification : Cette fonctionnalité permet de passer en mode Modification afin que l'utilisateur puisse configurer son tableau de bord.
  • Restaurer la configuration initiale : Cette option permet de remettre le tableau de bord dans son état avant les modifications effectuées en mode modification. Toutes les modifications effectuées (taille, position, masquage, ajout) sont annulées.
  • Afficher ou non les différents Widgets : Il suffit de cocher ou décocher le nom du Widget à afficher.
Lorsque l'utilisateur passe en mode "modification", il peut modifier la position et la taille des éléments présents dans son tableau de bord. Il est possible de configurer par programmation le mode Modification :
  • La fonction TDBMode permet :
    • de savoir si le mode Modification est activé ou non,
    • d'activer ou de désactiver le mode Modification,
    • de paramétrer les actions disponibles dans le mode Modification. Il est par exemple possible de n'autoriser que le déplacement et le redimensionnement des Widgets.
AndroidiPhone/iPadMac Catalyst
FAA dans les applications mobiles

Passage en mode modification

Pour entrer en mode édition dans un champ Tableau de bord, il faut effectuer un appui long sur le fond du champ ou sur un Widget. Une micro vibration est déclenchée (haptic feedback).
Si l'appui long est effectué sur un Widget, le Widget est sélectionné : des poignées de redimensionnement sont affichées sur les quatre bords du Widget.
Attention : Si l'appui long est effectué sur un champ situé à l'intérieur d'un Widget et que ce champ intercepte l'appui long (code dans le traitement d'appui long, affichage d'un menu contextuel, etc.), le champ Tableau de bord ne passe pas en mode édition.
En mode modification :
  • La sélection d'un Widget est effectuée par un simple clic sur le Widget.
  • Les champs affichés dans les Widgets ne reçoivent plus les événements de clic et ne peuvent plus prendre le focus.
  • Si au moins un Widget est affiché sur la dernière ligne visible du tableau de bord, une ligne supplémentaire est ajoutée en mode édition (avec activation de l'ascenseur vertical si nécessaire). Cette ligne permet l'ajout de nouveaux Widgets ou le déplacement de Widgets existants.
  • Une barre d'outils spécifique est affichée. Pour plus de détails, consultez Barre d'outils du mode modification.
  • Il est possible de :
Remarque : La fonction TDBMode permet de :
  • passer dans le mode "modification" par programmation. Pour enlever la possibilité à l'utilisateur de passer dans le mode édition (le clic long ne fait plus rien), utilisez la fonction FAADésactive avec la constante faaTdbModeEdition.
  • désactiver certaines fonctionnalités du champ Tableau de bord (et dans la barre du mode modification).

Barre d'outils du mode modification

Lorsque le champ Tableau de bord passe en mode modification, une barre d'outils est affichée dans la partie inférieure du champ. Cette barre d'outils est affichée en semi-transparence par-dessus les Widgets du tableau de bord.
Cette barre d'outils est composée de trois boutons :
  • Bouton "Réinitialiser" : permet de restaurer la configuration initiale du tableau de bord
  • Bouton "OK" : permet de sortie du mode modification.
  • Bouton poubelle : permet de masquer le Widget sélectionné d'un clic. Il est également possible de faire un Drag and Drop d'un Widget sur le bouton pour masquer ce Widget (lors du survol de la poubelle avec le Widget à masquer, une micro vibration est effectuée).
Remarque : La couleur du texte et la barre sont configurables dans le style du champ Tableau de bord. La couleur de l'icône du bouton poubelle correspond à la couleur du texte.
Remarque : Si la fonction TDBMode interdit la suppression de Widgets, le bouton poubelle n'est pas affiché dans la barre d'outils.

Sortie du mode modification

Il existe différents moyens pour quitter le mode modification du champ Tableau de bord :
  • Clic sur le fond du champ Tableau de bord.
  • Clic sur le bouton OK affiché dans la barre d'outils du mode modification.
  • Android Appui sur la touche "back" du téléphone.

Déplacement d'un Widget

Pour déplacer un Widget :
  • Si le Widget n'est pas sélectionné : il faut effectuer un appui long sur le Widget. Une vue fantôme du Widget à déplacer est automatiquement créée.
  • Si le Widget est sélectionné : il suffit d'enfoncer le pointeur sur le Widget sélectionné. Une vue fantôme du Widget à déplacer est automatiquement créée.
Pendant le déplacement, les poignées de redimensionnement du Widget sélectionné ne sont pas dessinées.
Lorsque le Widget est déplacé sur une cellule contenant un autre Widget, le second Widget est déplacé sur le premier emplacement libre et il revient à sa place dès que le Widget déplacé ne le survole plus. Le déplacement des Widgets survolés est effectué avec une animation.

Redimensionnement d'un Widget

Pour redimensionner un Widget, il faut :
  • garder le pointeur enfoncé sur l'un des bords du Widget sélectionné (celui qui affiche les poignées de redimensionnement).
  • et déplacer le pointeur dans la direction voulue.
Il n'est pas possible de redimensionner un Widget horizontalement et verticalement en même temps.
Pendant le redimensionnement, seule la poignée du bord sur lequel le pointeur a été enfoncé est affichée.
Les Widgets qui occupent les cellules sur lesquelles le Widget est agrandi sont automatiquement déplacés avec une animation sur le premier emplacement libre. Ils reprennent leur place si le Widget est finalement rétréci.

Ajout d'un Widget

En mode modification, un signe "+" est affiché au centre des cellules vides (dans la même couleur que le cadre des Widgets en mode modification).
Un clic sur une cellule vide fait apparaître un menu popup avec la liste des Widgets à ajouter.
Si tous les Widgets du tableau de bord sont affichés, le signe "+" n'est pas affiché et le clic sur une cellule vide fait sortir du mode modification.
Remarque : Pendant le déplacement et le redimensionnement d'un Widget, le signe "+" n'est pas dessiné dans les cellules vides.
Version minimum requise
  • Version 19
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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