PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Accueil | Connexion | Français FR
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
<Tableau de bord>.ConfigurationInitiale (Fonction)
En anglais : <Dashboard>.InitialConfiguration
AjaxNon disponible
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 <Tableau de bord>.AjouteWidget.
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
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 22
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
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 = TDB_TableauDeBord.AjouteWidget(FI_Widget_ChiffreClé, ...
ChaîneConstruit("Chiffres de %1", DateVersChaîne(dDate, "Mmm AAAA")), ...
dDate)
// Configure le widget (calé à gauche)
TDB_TableauDeBord.ConfigurationInitiale(nIndice, nX, nY)
// Le prochain sera plus bas
nY++
dDate.Mois--
FIN
// - alerte de stock
// Ajoute le widget
nIndice = TDB_TableauDeBord.AjouteWidget(FI_Widget_AlerteStock, "Alerte stock")
// Configure le widget (calé à gauche)
TDB_TableauDeBord.ConfigurationInitiale(nIndice, 5, 1)
Syntaxe

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

<Champ Tableau de bord>.ConfigurationInitiale(<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 <Tableau de bord>.AjouteWidget.
<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 <Tableau de bord>.ConfigurationInitiale, 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 <Tableau de bord>.ConfigurationInitiale, 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 <Tableau de bord>.ConfigurationInitiale, 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 <Tableau de bord>.ConfigurationInitiale, la taille du Widget correspond à la taille définie au premier appel.

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

<Champ Tableau de bord>.ConfigurationInitiale(<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.
  • 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 <Tableau de bord>.ConfigurationInitiale, 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 <Tableau de bord>.ConfigurationInitiale, 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 <Tableau de bord>.ConfigurationInitiale, 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 <Tableau de bord>.ConfigurationInitiale, la taille du Widget correspond à la taille définie au premier appel
Remarques
  • Si la fonction <Tableau de bord>.ConfigurationInitiale 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 <Tableau de bord>.ConfigurationInitiale seront chargés et rendus visibles par défaut après l'exécution des traitements d'initialisation.
  • La fonction <Tableau de bord>.ConfigurationInitiale 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 : wd270obj.dll
Voir Aussi
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire