|
|
|
|
- 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 (syntaxe préfixée)
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 <Tableau de bord>.AjouteWidget. 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) :
nIndice = TDB_TableauDeBord.AjouteWidget(FI_Widget_AlerteStock, "Alerte stock")
- Ajout d'un Widget avec paramètres :
nIndice est un entier
nIndice = TDB_TableauDeBord.AjouteWidget(FI_Widget_Horloge, ...
"Horloge " + COMBO_AjoutWidget[COMBO_AjoutWidget].ValeurAffichée, ...
COMBO_AjoutWidget[COMBO_AjoutWidget].ValeurAffichée)
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)
nIndice = TDB_TableauDeBord.AjouteWidget(FI_Widget_AlerteStock, "Alerte stock")
TDB_TableauDeBord.ConfigurationInitiale(nIndice, 5, 1)
- Ajout d'un widget avec paramètres
dDate est une Date
nIndice est un entier
nX, nY sont des entiers
nX = 1 ; nY = 3
POUR i = 1 À 3
nIndice = TDB_TableauDeBord.AjouteWidget(FI_Widget_ChiffreClé, ...
ChaîneConstruit("Chiffres clés de %1", ...
dDate.VersChaîne("Mmm AAAA")), dDate)
TDB_TableauDeBord.ConfigurationInitiale(nIndice, nX, nY)
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 <Tableau de bord>.Affiche.
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…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|