TDBAjouteWidget (Fonction)

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.

Versions 20 et supérieures

Cette fonction est désormais disponible en WEBDEV Serveur.

Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.

Nouveauté 20

Cette fonction est désormais disponible en WEBDEV Serveur.

Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.

Cette fonction est désormais disponible en WEBDEV Serveur.

Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.

Versions 22 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Cette fonction est désormais disponible pour les applications Android.

Nouveauté 22

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Cette fonction est désormais disponible pour les applications Android.

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Cette fonction est désormais disponible pour les applications Android.

Exemple

// Ajout 2 éléments
TDBAjouteWidget(TDB_MonTableauDeBord, FI_Ventes, "Ventes")
TDBAjouteWidget(TDB_MonTableauDeBord, FI_StatMensuelle, "Stats Mensuelles Juillet", "201307")

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

Versions 20 et supérieures

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)

Nouveauté 20

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

Nom de la fenêtre interne à ajouter dans le champ Tableau de Bord.
Versions 20 et supérieures
Nom de la page interne à ajouter dans le champ Tableau de Bord.
Nouveauté 20
Nom de la page interne à ajouter dans le champ Tableau de Bord.
Nom de la page interne à ajouter dans le champ Tableau de Bord.

<Libellé> : Chaîne de caractères (avec guillemets)

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 :

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 : wd240obj.dll

Voir Aussi