PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
TDBConfigurationInitiale (Fonction)
En anglais : DashInitialConfiguration
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.
Versions 20 et supérieures
WEBDEV - Code ServeurWindows Cette fonction est désormais disponible en WEBDEV Serveur.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
Nouveauté 20
WEBDEV - Code ServeurWindows Cette fonction est désormais disponible en WEBDEV Serveur.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WEBDEV - Code ServeurWindows Cette fonction est désormais disponible en WEBDEV Serveur.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
Versions 22 et supérieures
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
Nouveauté 22
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
Exemple
WINDEVWINDEV MobileAndroidiPhone/iPad
// -- 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 A 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(<Tableau de bord> , <Indice du Widget> [, <X> [, <Y> [, <Largeur> [, <Hauteur>]]]])
<Tableau de bord> : Chaîne de caractères (avec ou sans guillemets)
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(<Tableau de bord> , <Widget> [, <X> [, <Y> [, <Largeur> [, <Hauteur>]]]])
<Tableau de bord> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ Tableau de bord à manipuler.
<Widget> : Chaîne de caractères (avec ou sans guillemets)
  • WINDEVWINDEV MobileAndroidiPhone/iPad Nom de la fenêtre interne à manipuler.
  • Versions 20 et supérieures
    WEBDEV - Code ServeurWEBDEV - Code Navigateur Nom de la page interne à manipuler.
    Nouveauté 20
    WEBDEV - Code ServeurWEBDEV - Code Navigateur Nom de la page 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 tableau de bord a été sauvegardée puis rechargée.
  • Linux Remarque : Le champ Tableau de bord est disponible en Linux uniquement dans les sites WEBDEV Linux. Le champ Tableau de bord n'est pas disponible dans les applications WINDEV pour Linux.
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.
Composantes
WINDEVEtats et Requêtes wd220obj.dll
WEBDEV - Code Serveur wd220page.dll
WEBDEV - Code Navigateur WDJS.DLL
Linux wd220obj.so
Android wd220android.jar
Version minimum requise
  • Version 19
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire