|
|
|
|
- Présentation
- Manipuler le champ Tableau de bord par programmation
- Ajouter un Widget
- Exécuter une procédure définie pour une fenêtre ou une page interne (utilisée en Widget)
- Manipuler un Widget par programmation
- Réaliser un Drag and Drop d'un Widget sur un champ Tableau de bord
- Propriétés spécifiques aux champs Tableau de bord
Manipuler un champ Tableau de bord par programmation
Pour manipuler un champ Tableau de bord par programmation, WINDEV, WEBDEV et WINDEV Mobile proposent les fonctions de gestion des Tableaux de bord. Cette page d'aide détaille comment manipuler un champ Tableau de bord par programmation.
Manipuler le champ Tableau de bord par programmation Ajouter un Widget L'ajout des Widgets dans un champ Tableau de bord par programmation est réalisé via la fonction TDBAjouteWidget. Par défaut, ce Widget est invisible. Il est possible de l'afficher en utilisant la propriété Visible. Si le Widget n'est pas rendu directement visible, l'utilisateur pourra le rendre visible via le menu contextuel du mode édition. Exemples : - Ajout d'un Widget simple (sans paramètres) :
// Ajoute un Widget simple nIndice = TDBAjouteWidget(TDB_TableauDeBord, FI_Widget_AlerteStock, ... "Alerte stock") - Ajout d'un Widget avec paramètres :
nIndice est un entier  // Ajoute un widget qui attend des paramètres nIndice = TDBAjouteWidget(TDB_TableauDeBord, FI_Widget_Horloge, ... "Horloge " + COMBO_AjoutWidget[COMBO_AjoutWidget].ValeurAffichée, ... COMBO_AjoutWidget[COMBO_AjoutWidget].ValeurAffichée)  // Affiche ce widget à la demande SI OuiNon(Oui, "Souhaitez-vous afficher ce widget ?") = Oui ALORS TDB_TableauDeBord[nIndice].Visible = Vrai SINON ToastAffiche("Widget ajouté au tableau de bord en ""caché"". "+ ... "Passez en mode édition pour l'ajouter", toastCourt, cvMilieu, chCentre) FIN Cas particulier : ajouter un Widget dans la configuration initialePar défaut, le champ Tableau de bord affiche les Widgets tels qu'ils ont été définis sous l'éditeur de fenêtres ou de pages. Pour ajouter des Widgets par programmation au chargement du champ Tableau de bord, il suffit d'utiliser : Attention : Dans ce cas, ces fonctions doivent obligatoirement être utilisées dans l'événement "Initialisation" du champ Tableau de bord. Exemples : - Ajout d'un Widget simple (sans paramètres)
// --- Initialisation du champ TDB_TableauDeBord // - alerte de stock // Ajoute le widget nIndice = TDBAjouteWidget(MoiMême, FI_Widget_AlerteStock, "Alerte stock") // Configure le widget (calé à gauche) TDBConfigurationInitiale(MoiMême, nIndice, 5, 1) - Ajout d'un widget avec paramètres
// --- Initialisation du champ TDB_TableauDeBord  dDate est une Date nIndice est un entier nX, nY sont des entiers  // Ajoute des informations dans la configuration initiale : // - chiffres clés des 3 derniers mois nX = 1 ; nY = 3 POUR i = 1 À 3 // Ajoute le widget nIndice = TDBAjouteWidget(MoiMême, FI_Widget_ChiffreClé, ... ChaîneConstruit("Chiffres clés de %1", ... DateVersChaîne(dDate, "Mmm AAAA")), dDate) // Configure le widget (calé à gauche) TDBConfigurationInitiale(MoiMême, nIndice, nX, nY) // Le prochain sera plus bas nY++ dDate.Mois-- FIN
Remarque : Pour rafraîchir un Widget avec paramètres, il est conseillé de : - Ajouter un événement optionnel de rafraîchissement du Widget dans les événements de la fenêtre ou de la page interne.
- Saisir le code nécessaire au rafraîchissement du Widget. Ce code peut par exemple permettre de mettre à jour les éléments affichés dans la fenêtre ou la page interne.
- Rafraîchir le Widget avec la fonction TDBAffiche.
Exécuter une procédure définie pour une fenêtre ou une page interne (utilisée en Widget) Pour exécuter une procédure définie dans la fenêtre ou la page interne utilisée en Widget, il est possible d'utiliser les syntaxes suivantes : - Syntaxe utilisant le nom de la fenêtre ou de la page interne :
NomFenêtreInterne.NomProcédure(Param1, Param2, ...) Par exemple :
FI_Widget_ChiffreClé.NouvelleDate(SAI_Date)
- Syntaxe utilisant une variable de type Champ (à utiliser notamment si la même fenêtre ou page interne est utilisée plusieurs fois dans le champ Tableau de bord) :
NomVariable est un Champ <- NomTableauDeBord[IndiceWidget] NomVariable.NomProcédure(Param1, Param2, ...) Par exemple :
X est un Champ <-TDB_TableauDeBord[4]
X.NouvelleDate(SAI_Date)
Manipuler un Widget par programmation Pour manipuler un Widget par programmation, il est possible d'utiliser une des syntaxes suivantes : - Syntaxe 1 : Utilisation directe du champ Tableau de bord :
NomTableauDeBord[IndiceWidget] Par exemple :
Trace(TDB_MonTableauDeBord[1].Libellé)
- Syntaxe 2 : Utilisation d'une variable de type Champ :
NomVariable est un Champ <- NomTableauDeBord[IndiceWidget] Par exemple :
X est un Champ <-TDB_TableauDeBord[4]
Trace(X.Libellé)
Réaliser un Drag and Drop d'un Widget sur un champ Tableau de bord Propriétés spécifiques aux champs Tableau de bord Les propriétés suivantes sont spécifiques à la gestion d'un champ Tableau de bord par programmation.
| | CompacteOption | La propriété CompacteOption permet de :- savoir si les options d'un champ Interrupteur, Sélecteur ou Tableau de bord sont en mode compacté.
- passer les options d'un champ Interrupteur, Sélecteur ou Tableau de bord en mode compacté.
| HauteurElément | La propriété HauteurElément permet de :- Connaître ou modifier la hauteur des éléments d'un champ Organigramme.
- Connaître ou modifier la hauteur des cellules d'un champ Tableau de bord.
| LargeurElément | La propriété LargeurElément permet de :- Connaître ou modifier la largeur des éléments d'un champ Organigramme.
- Connaître ou modifier la largeur des cellules d'un champ Tableau de bord.
| MargeHauteur | La propriété MargeHauteur permet de : - Connaître la marge verticale entre les Widgets présents dans un champ Tableau de bord.
- Modifier la marge verticale entre les Widgets présents dans un champ Tableau de bord.
| MargeLargeur | La propriété MargeLargeur permet de : - Connaître la marge horizontale entre les Widgets présents dans un champ Tableau de bord.
- Modifier la marge horizontale entre les Widgets présents dans un champ Tableau de bord.
|
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|