• En WINDEV et WINDEV Mobile, c'est une fenêtre interne.
• En WEBDEV, c'est une page interne.

1. Sous le volet "Création", dans le groupe "Conteneurs", cliquez sur "Tableau de bord".
2. Cliquez dans la fenêtre ou la page à la position où le champ doit être créé.

• Largeur des Widgets variable : Dans ce cas, il est possible de définir le nombre de colonnes présentes dans le champ Tableau de bord et la hauteur des cellules.
• Nombre de Widgets variable : Dans ce cas, il est possible de définir la taille des cellules (largeur et hauteur en pixels).
• Largeur et nombre de Widgets fixes . Dans ce cas, il est possible de définir le nombre de colonnes et la taille des cellules. Les boutons "Adapter" permettent d'adapter le nombre des colonnes selon la taille des cellules ou inversement.
• les marges entre les différents Widgets affichés dans le champ Tableau de bord.

Onglet "Détail" : Position du menu contextuel
Le menu contextuel du champ Tableau de bord permet à l'internaute de :

• Passer en mode édition. Le mode édition permet à l'internaute de changer l'ordre des widgets, de modifier leur taille, ... La configuration des options proposées peut être réalisée avec la fonction TDBMode.
• Restaurer la configuration initiale.

Le menu contextuel du champ Tableau de bord est ouvert à partir d'un bouton positionné sur le champ Tableau de bord. Il est possible de :

• spécifier le bouton à utiliser (option "Utiliser le bouton"). Par défaut, un bouton est créé lors de la création du champ Tableau de bord. Il est possible d'utiliser un autre bouton présent dans la page. Ce bouton doit être associé à l'action "Ouvrir le menu du Tableau de bord" (Onglet "Général" de la fenêtre de description du bouton). Si le bouton "Aucun" est sélectionné, le menu contextuel ne sera pas proposé.
  Remarque : Pour ne pas proposer le menu contextuel par programmation, il est possible de le rendre invisible avec la propriété Visible.
• indiquer la position du bouton qui ouvrira le menu contextuel (option "à la position"). Ce bouton peut être positionné en haut à gauche, en haut à droite, en bas à gauche, en bas à droite du champ Tableau de bord.

Onglet "Détail" : Modification par l'utilisateur
Dans le champ Tableau de bord, les options sont les suivantes :

• Compacter les Widgets : Cette option permet de réorganiser automatiquement les Widgets dans le champ Tableau de bord lors de la suppression d'un Widget par l'utilisateur final.
• Mémoriser la configuration des Widgets : Cette option permet de sauvegarder automatiquement à la fermeture de la fenêtre (ou de la page) la configuration du champ Tableau de bord réalisée par l'utilisateur. Cette configuration sera automatiquement ré-affichée lors de la prochaine ouverture de la fenêtre (ou de la page).
  Remarque : L'utilisateur peut configurer son Tableau de bord grâce au menu contextuel des FAA (Fonctionnalités Automatiques de vos Applications). Pour plus de détails, consultez FAA du champ Tableau de bord.
• Mode édition permanent : Cette option permet de proposer le champ Tableau bord en mode édition directement lors de son affichage. L'utilisateur pourra directement déplacer, redimensionner ou masquer les widgets.

• une fenêtre interne.
• une page interne.

• Ajouter un Widget à un champ Tableau de bord.
• Définir ou modifier les options d'affichage d'un Widget.

Ajouter un Widget à un champ Tableau de bord

1. Dans l'onglet "Contenu" de la description du champ, cliquez sur le bouton "Ajouter".
2. Dans la fenêtre qui s'ouvre :
   • sélectionnez la ou les fenêtres internes à ajouter comme Widget et validez.
   • sélectionnez la ou les pages internes à ajouter comme Widget et validez.
   Remarque : Seules les fenêtres ou les pages internes sans paramètres peuvent être ajoutées sous l'éditeur dans le champ Tableau de bord. Pour ajouter une fenêtre ou une page interne avec paramètres, les ajouts doivent être réalisés par programmation via la fonction TDBAjouteWidget.
3. Les fenêtres ou les pages internes apparaissent dans la liste des Widgets affichés dans le champ Tableau de bord. Pour chaque Widget, il est possible de définir les options d'affichage. Ces options correspondent à l'affichage initial du Widget.

• L'ordre des Widgets dans la liste n'a pas d'influence sur la position du Widget dans le champ Tableau de bord. Cette position peut être définie dans la description du Widget.
• Le numéro associé au Widget permet de le manipuler par programmation.
• Pour modifier la couleur de fond de votre widget, utilisez une cellule dans votre fenêtre ou page interne. Cette cellule contiendra les champs de la fenêtre ou page interne. La couleur de fond de la cellule permettra de colorer le widget.

Définir ou modifier les options d'affichage d'un Widget

1. Sélectionnez le Widget à paramétrer dans l'onglet "Contenu" de la fenêtre de description du champ Tableau de bord.
2. Dans la partie droite de l'écran, spécifiez :
   • la fenêtre ou la page interne associée si nécessaire.
   • si le Widget doit être visible par défaut. Si le Widget est invisible, un pictogramme apparaît à côté du nom du Widget dans la liste. l'utilisateur pourra le rendre visible via le menu contextuel.
   • la position et la taille initiales du Widget. Cette position et cette taille sont exprimées en cellules. Le nombre de ces cellules a été défini dans l'onglet "Détail" de la fenêtre de description du champ. Si la position ou la taille est modifiée pour un Widget, la position des Widgets suivants est automatiquement mise à jour.
     Remarque : La taille maximale du Widget correspond à la taille maximale de la fenêtre interne associée au Widget. Par exemple, si le Widget doit avoir pour taille maximale 2 cases de 150 pixels en largeur et une case de 150 pixels en hauteur, la taille maximale de la fenêtre interne correspondante doit être 300 pixels x 150 pixels.
   • le libellé du Widget. Ce libellé est important : il apparaîtra dans le menu contextuel (FAA) pour permettre à l'utilisateur d'afficher le Widget.

Définir la taille des cellules

1. Sélectionnez le champ Tableau de bord.
2. Un cadre apparaît au tour des différentes cellules présentes dans le champ Tableau de bord.
3. La première cellule propose des poignées de redimensionnement.
   • Positionnez le curseur de la souris sur un des côtés du Widget. Le curseur de la souris se transforme en flèche.
   • Appuyez sur le bouton de la souris et déplacez la souris en maintenant le bouton enfoncé jusqu'à la taille voulue.
   • La nouvelle taille s'applique à toutes les cellules du champ Tableau de bord.

Définir la taille et la position des Widgets

1. Sélectionnez le champ Tableau de bord.
2. Passez en mode édition en utilisant une des méthodes suivantes :
   • Cliquez sur le champ Tableau de bord.
   • Sélectionnez l'option "Editer la taille et la position des Widgets" du menu contextuel du champ.
3. Un cadre jaune apparaît autour du champ. Vous pouvez :
   • Redimensionnez les Widgets présents dans le champ Tableau de bord :
     • Positionnez le curseur de la souris sur un des côtés du Widget. Le curseur de la souris se transforme en flèche.
     • Appuyez sur le bouton de la souris et déplacez la souris en maintenant le bouton enfoncé jusqu'à la taille voulue.
   • Déplacer les Widgets présents dans le champ Tableau de bord :
     • Cliquez sur le Widget.
     • Déplacez le Widget en maintenant le bouton de la souris enfoncé.
4. Pour sortir du mode édition, utilisez une des méthodes suivantes :
   • Utilisez la touche Echap du clavier.
   • Sélectionnez l'option "Terminer l'édition" du menu contextuel du champ.
   • Cliquez sur la fenêtre ou la page.