DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Tableau de bord
  • Nouveau 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
Ajoute et affiche un Widget (fenêtre ou page interne) dans un champ Tableau de bord.
Attention : Les Widgets ajoutés par programmation ne s'affichent pas automatiquement. Il est nécessaire d'utiliser la fonction TDBConfigurationInitiale avant le premier affichage du champ Tableau de bord.
Exemple
WINDEVAndroidiPhone/iPadMac Catalyst
// Ajout 2 éléments
TDBAjouteWidget(TDB_MonTableauDeBord, FI_Ventes, "Ventes")
TDBAjouteWidget(TDB_MonTableauDeBord, FI_StatMensuelle, "Stats Mensuelles Juillet", "201307")
WINDEVAndroidiPhone/iPadMac Catalyst
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("Le Widget a été ajouté au tableau de bord en ""caché""." + ...
"Passez en mode édition pour l'ajouter.", ...
toastCourt, cvMilieu, chCentre)
FIN
WEBDEV - Code Serveur
IndWgt est un entier 
// Ajoute un Widget qui attend des paramètres
IndWgt = TDBAjouteWidget(TDB_FuseauxHoraires, PI_Heure, "Heure" + DonneIdentifiant(), "Paris", +0)
TDBConfigurationInitiale(TDB_FuseauxHoraires, IndWgt)
// Ajoute un Widget qui attend des paramètres
IndWgt = TDBAjouteWidget(TDB_FuseauxHoraires, PI_Heure, "Heure" + DonneIdentifiant(), "Honolulu", -12)
TDBConfigurationInitiale(TDB_FuseauxHoraires, IndWgt)
// Ajoute un Widget qui attend des paramètres
IndWgt = TDBAjouteWidget(TDB_FuseauxHoraires, PI_Heure, "Heure" + DonneIdentifiant(), "Sydney", +9) 
TDBConfigurationInitiale(TDB_FuseauxHoraires, IndWgt)
Syntaxe
<Résultat> = TDBAjouteWidget(<Champ Tableau de bord> , <Widget> , <Libellé> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Résultat> : Entier
Indice de l'élément ajouté. Cet indice peut être utilisé pour manipuler le Widget.
<Champ Tableau de bord> : Nom de champ
Nom du champ Tableau de bord à manipuler.
<Widget> : Nom de fenêtre interne ou nom de page interne
  • WINDEVAndroidiPhone/iPadMac Catalyst Nom de la fenêtre interne à ajouter dans le champ Tableau de Bord.
  • WEBDEV - Code Serveur Nom de la page interne à ajouter dans le champ Tableau de Bord.
<Libellé> : Chaîne de caractères
Libellé du Widget. Ce libellé sera affiché dans le menu contextuel du champ Tableau de bord et permettra à l'utilisateur de manipuler le Widget.
<Paramètre 1> : Type de la valeur envoyée à la fenêtre/page (optionnel)
Premier paramètre à passer à l'événement "Déclarations globales" de la fenêtre interne ou de la page interne à ouvrir. Ce paramètre est passé par référence et il est considéré comme une variable globale à la fenêtre interne ou à la page interne.
Attention : Seuls les types simples sont disponibles.
<Paramètre N> : Type de la valeur envoyée à la fenêtre/page (optionnel)
Nième paramètre à passer à l'événement "Déclarations globales" de la fenêtre interne ou de la page interne à ouvrir. Ce paramètre est passé par référence et il est considéré comme une variable globale à la fenêtre interne ou à la page interne.
Attention : Seuls les types simples sont disponibles.
Remarques

Nouveau Widget

Le Widget est déclaré en plus des Widgets définis dans la description du champ Tableau de bord.
Ce Widget peut être rendu visible :
  • soit en utilisant la fonction TDBConfigurationInitiale avant le premier affichage.
  • soit par l'utilisateur final via le menu contextuel.
  • soit en utilisant la syntaxe :
    TDB_NomTableauBord[Indice].Visible = Vrai
    où <Indice> est le numéro du Widget renvoyé par la fonction TDBAjouteWidget.
Liste des exemples associés :
WD Tableau de bord Exemples didactiques (WINDEV) : WD Tableau de bord
[ + ] L'exemple "WD Tableau de bord" est un exemple didactique sur l'utilisation du champ Tableau de bord.
Cet exemple présente comment :
- manipuler le champ en mode "édition",
- sauver/charger une configuration,
- configurer le champ (configuration initiale, ajout / suppression de widgets, ...),
- rafraîchir un widget,
- etc.
Composante : wd290obj.dll
Version minimum requise
  • Version 19
Documentation également disponible pour…
Commentaires
Erreur : le type de la page interne ...
... n'est pas compatible avec le type de la page hôte.

Cette erreur provient du fait que la définition de la page interne du Widget n'est pas identique à celui de la page hôte du tableau de bord. PAr exemple, si la page hôte est de type AWP, il faut impérativement mettre la fenêtre interne qui décrit le Widget en mode AWP.
bernard SOBRA
22 mar. 2023

Dernière modification : 22/06/2023

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