DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Tableau de bord
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
Modifie la configuration d'un champ Tableau de bord (définie sous l'éditeur) avant son premier affichage. Il est ainsi possible de configurer et de prendre en compte les Widgets déclarés en programmation par la fonction TDBAjouteWidget.
Exemple
WINDEVAndroidiPhone/iPadMac Catalyst
// -- Initialisation de TDB_TableauDeBord
// 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 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
// - 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)
Syntaxe

Configuration initiale : manipuler le Widget par son indice Masquer les détails

TDBConfigurationInitiale(<Champ Tableau de bord> , <Indice du Widget> [, <X> [, <Y> [, <Largeur> [, <Hauteur>]]]])
<Champ Tableau de bord> : Nom de champ
Nom du champ Tableau de bord à manipuler.
<Indice du Widget> : Entier
Indice du Widget à manipuler. Cet indice correspond :
  • au numéro d'ajout du Widget défini sous l'éditeur de fenêtres ou de pages.
  • au numéro d'ajout du Widget renvoyé par la fonction TDBAjouteWidget.
<X> : Entier optionnel
Position horizontale du Widget en nombre de cases.
Si les paramètres [<X>, <Y>] ne sont pas précisés ou ont pour valeur [0,0], le Widget est positionné sur la première place libre.
La première case est la case [1, 1].
<Y> : Entier optionnel
Position verticale du Widget en nombre de cases.
Si les paramètres [<X>, <Y>] ne sont pas précisés ou ont pour valeur [0,0], le Widget est positionné sur la première place libre.
La première case est la case [1, 1].
<Largeur> : Entier optionnel
Largeur du Widget en nombre de cases.
Si les paramètres [<Largeur>, <Hauteur>] ne sont pas précisés ou ont pour valeur [0, 0] :
  • au premier appel de la fonction TDBConfigurationInitiale, la taille du Widget correspond à la taille de la fenêtre ou page interne source (au moins 1 case).
  • aux appels suivants de la fonction TDBConfigurationInitiale, la taille du Widget correspond à la taille définie au premier appel.
<Hauteur> : Entier optionnel
Hauteur du Widget en nombre de cases.
Si les paramètres [<Largeur>, <Hauteur>] ne sont pas précisés ou ont pour valeur [0, 0] :
  • au premier appel de la fonction TDBConfigurationInitiale, la taille du Widget correspond à la taille de la fenêtre ou page interne source (au moins 1 case).
  • aux appels suivants de la fonction TDBConfigurationInitiale, la taille du Widget correspond à la taille définie au premier appel.

Configuration initiale : manipuler le Widget par son nom Masquer les détails

TDBConfigurationInitiale(<Champ Tableau de bord> , <Widget> [, <X> [, <Y> [, <Largeur> [, <Hauteur>]]]])
<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 à manipuler.
  • WEBDEV - Code ServeurWEBDEV - Code Navigateur Nom de la page interne à manipuler.
<X> : Entier optionnel
Position horizontale du Widget en nombre de cases.
Si les paramètres [<X>, <Y>] ne sont pas précisés ou ont pour valeur [0,0], le Widget est positionné sur la première place libre.
La première case est la case [1, 1].
<Y> : Entier optionnel
Position verticale du Widget en nombre de cases.
Si les paramètres [<X>, <Y>] ne sont pas précisés ou ont pour valeur [0,0], le Widget est positionné sur la première place libre.
La première case est la case [1, 1].
<Largeur> : Entier optionnel
Largeur du Widget en nombre de cases.
Si les paramètres [<Largeur>, <Hauteur>] ne sont pas précisés ou ont pour valeur [0, 0] :
  • au premier appel de la fonction TDBConfigurationInitiale, la taille du Widget correspond à la taille de la fenêtre ou page interne source (au moins 1 case).
  • aux appels suivants de la fonction TDBConfigurationInitiale, la taille du Widget correspond à la taille définie au premier appel
<Hauteur> : Entier optionnel
Hauteur du Widget en nombre de cases.
Si les paramètres [<Largeur>, <Hauteur>] ne sont pas précisés ou ont pour valeur [0, 0] :
  • au premier appel de la fonction TDBConfigurationInitiale, la taille du Widget correspond à la taille de la fenêtre ou page interne source (au moins 1 case).
  • aux appels suivants de la fonction TDBConfigurationInitiale, la taille du Widget correspond à la taille définie au premier appel
Remarques
  • Si la fonction TDBConfigurationInitiale est appelée après l'initialisation du champ Tableau de bord, une erreur est générée.
  • Les Widgets configurés par la fonction TDBConfigurationInitiale seront chargés et rendus visibles par défaut après l'exécution des traitements d'initialisation.
  • La fonction TDBConfigurationInitiale n'est pas prise en compte dans les cas suivants :
    • L'option "Mémoriser la configuration des Widgets" est cochée dans la fenêtre de description du champ Tableau de bord (onglet "Détail") et l'utilisateur rend le Widget invisible.
    • L'utilisateur a rendu le Widget invisible et la configuration du champ Tableau de bord a été sauvegardée puis rechargée.
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 : wd300obj.dll
Version minimum requise
  • Version 19
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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