DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Editeurs / Editeur d'états / Types d'états
  • Présentation
  • Créer un état Agenda
  • Création de l'état
  • Informations spécifiques à la création de l'état Agenda
  • Caractéristiques d'un état Agenda et d'un champ Agenda
  • Manipulation d'un agenda dans un état par programmation
  • Fonctions WLangage
  • Propriétés WLangage
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
Présentation
L'éditeur d'états offre la possibilité de créer des états de type "Agenda".
L'état est alors constitué uniquement d'un champ Agenda. Ce type de champ est créé uniquement lors de la création d'un état Agenda : il ne peut pas être créé indépendamment de cet état.
Exemple :
Sous l'éditeur, ce champ est constitué de deux blocs :
  • Le bloc "En-tête" affichant les titres des colonnes de l'agenda.
  • Le bloc "Agenda" affichant les rendez-vous dans un champ Agenda.
Créer un état Agenda

Création de l'état

Pour créer un état de type "Agenda" :
  1. Cliquez sur parmi les boutons d'accès rapide.
    • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Etat" puis sur "Etat".
    • L'assistant de création d'un état se lance.
  2. Sélectionnez un état de type "Agenda ou Planning".
  3. Indiquez dans la suite de l'assistant :

Informations spécifiques à la création de l'état Agenda

Les informations spécifiques à la création de l'état Agenda sont les suivantes :
  • Mode d'affichage initial : L'agenda peut être affiché :
    • au jour,
    • à la semaine,
    • au mois.
  • La granularité du quadrillage. Cette granularité permet de définir la taille de la grille utilisée pour afficher le quadrillage du champ Agenda. Par défaut, cette granularité est de 30 minutes. Selon le nombre de jours à afficher, il est nécessaire de modifier cette information.
    Cette caractéristique peut être modifiée par programmation grâce à la propriété GranularitéQuadrillage.
Remarque : Si l'état Agenda est lié à une source de données (requête, fichier de données), il est nécessaire d'indiquer dans la suite de l'assistant les rubriques à prendre en compte pour l'affichage des rendez-vous. Les informations principales à indiquer sont :
  • le titre du rendez-vous.
  • la date de début et de fin du rendez-vous.
Caractéristiques d'un état Agenda et d'un champ Agenda
Il est possible de modifier les caractéristiques suivantes d'un état Agenda :
  • La source de données de l'état Agenda peut être modifiée dans l'onglet "Données" de la fenêtre de description de l'état (option "Description de l'état" dans le menu contextuel de l'état).
  • L'onglet "Général" de la fenêtre de description du champ Agenda permet de spécifier :
    • le mode d'affichage initial : Jour, semaine, mois.
    • le nombre de jours affichés.
    • la plage horaire visible.
    • le premier jour de la semaine.
    • la granularité du quadrillage.
    • l'affichage des rendez-vous à la journée entière. Si l'option "Afficher les rendez-vous à la journée entière" est cochée, l'état prend en charge les rendez-vous pour lesquels la caractéristique "Journée entière" est gérée (pour plus de détails, consultez Variable de type RendezVous). Dans ce cas, une zone permettant d'afficher les rendez-vous à la journée apparaît dans l'agenda :
      Remarque : Vérifiez que la zone d'affichage des rendez-vous à la journée est correctement dimensionnée sous l'éditeur d'états. Il est possible de la redimensionner si nécessaire.
    • le masque d'affichage de la date et des horaires.
    • l'état personnalisé pour afficher les rendez-vous.
      • Si l'option sélectionnée est "Aucun", l'affichage par défaut est utilisé.
      • Si l'option "Etat prédéfini" est sélectionnée, un état prédéfini est automatiquement ajouté au projet. Par défaut, cet état a pour nom "ETAT_WinDevVueRDV" et est automatiquement utilisé pour l'affichage des rendez-vous.
        Cet état peut être personnalisé, renommé, ...
      • Si l'option sélectionnée correspond à un état du projet, cet état sera utilisé pour afficher les rendez-vous.
        Il est conseillé de personnaliser l'état proposé par défaut.
        Le même état peut être utilisé pour personnaliser les rendez-vous dans un état planning ou agenda.
  • Si le champ Agenda est lié à une source de données (fichier de données, requête, ...), l'onglet "Contenu" de la fenêtre de description du champ permet de lier les données du rendez-vous avec les données présentes dans la source de données.
  • L'onglet "Style" de la fenêtre de description du champ Agenda permet de spécifier le style des rendez-vous affichés dans le champ Agenda.
Manipulation d'un agenda dans un état par programmation

Fonctions WLangage

Différentes fonctions WLangage sont disponibles dans l'éditeur d'états pour manipuler les champs Agenda. Ces fonctions sont les suivantes :
AgendaAjouteRendezVousAjoute un nouveau rendez-vous dans un champ Agenda.
AgendaChangeModeModifie la plage temporelle affichée par un champ Agenda (Jour/Semaine/Mois).
AgendaChangeZoomModifie la plage temporelle affichée par un champ Agenda (Jour/Semaine/Mois). Cette fonction est conservée par compatibilité.
AgendaCouleurFondFixe une couleur de fond sur une plage horaire d'un champ Agenda.
AgendaHeureAffichéeDéfinit la plage horaire affichée par le champ Agenda en mode Jour ou Semaine.
AgendaListeRendezVousRenvoie :
  • la liste des rendez-vous compris entre deux dates données dans un champ Agenda,
  • tous les rendez-vous d'un champ Agenda,
  • un rendez-vous particulier (sélectionné ou survolé).
AgendaModeRenvoie le mode d'affichage par un champ Agenda : jour, semaine, mois, ...
AgendaPositionAffiche un champ Agenda à partir d'une date spécifiée ou renvoie la date du premier jour (ou dernier jour) affiché dans un champ Agenda.
AgendaSupprimeRendezVousSupprime un rendez-vous dans un champ Agenda.
AgendaSupprimeToutSupprime tous les rendez-vous d'un champ Agenda.
AgendaZoomRenvoie la plage temporelle affichée par un champ Agenda.

Propriétés WLangage

Différentes propriétés WLangage sont disponibles dans l'éditeur d'états pour manipuler les champs Agenda. Ces propriétés sont les suivantes :
DateDébutPériodeAffichéeLa propriété DateDébutPériodeAffichée permet de connaître la date de début de la période affichée dans un champ Planning ou Agenda d'un état.
DateFinPériodeAffichéeLa propriété DateFinPériodeAffichée permet de connaître la date de fin de la période affichée dans un champ Planning ou Agenda d'un état.
GranularitéQuadrillageLa propriété GranularitéQuadrillage permet de connaître et de modifier la taille de la grille utilisée pour l'affichage du quadrillage dans un champ Planning ou un champ Agenda d'un état.
HauteurLa propriété Hauteur permet de connaître et modifier la hauteur :
  • d'un champ ou d'un bloc dans un état.
  • d'un champ (présent dans une fenêtre), d'une fenêtre, d'une ligne d'un champ Table ou Liste (y compris Liste image), d'une option d'un champ Sélecteur ou Interrupteur, d'un haut ou d'un bas de rupture d'un champ Table ou d'un champ Zone répétée.
  • d'un champ (présent dans une page), d'un haut ou bas de rupture d'un champ Table ou Zone répétée. Le champ peut être superposable ou non.
  • d'une cellule de rupture d'un champ Table ou d'un champ Zone répétée.
LargeurLa propriété Largeur permet de connaître et modifier la largeur :
  • d'un champ ou d'un bloc dans un état.
  • d'un champ (présent dans une fenêtre), d'une fenêtre, d'une colonne de table ou d'une colonne de liste (y compris liste image).
  • d'un champ (présent dans une page), d'une colonne de table ou d'une liste. Le champ peut être superposable ou non.
LibelléPériodeEntêteLa propriété LibelléPériodeEntête permet de connaître et de modifier le contenu du libellé de la période affiché dans l'entête d'un champ Planning ou Agenda dans un état.
NomLa propriété Nom permet de connaître :
  • le nom de la police associée à une variable de type Police.
  • le nom d'un champ, d'un état ou d'un bloc d'un état.
  • le nom d'un champ, d'un groupe de champs ou d'une fenêtre.
  • le nom d'un champ, d'un groupe de champs ou d'une page.
PoliceContenuRendezVousLa propriété PoliceContenuRendezVous permet de :
  • Connaître les caractéristiques de la police utilisée pour le contenu des rendez-vous dans les états de type Planning et Agenda.
  • Modifier les caractéristiques de la police utilisée pour le contenu des rendez-vous dans les états de type Planning et Agenda.
PoliceTitreRendezVousLa propriété PoliceTitreRendezVous permet de :
  • Connaître les caractéristiques de la police utilisée pour le titre des rendez-vous dans les états de type Planning et Agenda.
  • Modifier les caractéristiques de la police utilisée pour le titre des rendez-vous dans les états de type Planning et Agenda.
VisibleLa propriété Visible permet de :
  • Savoir si un élément est visible.
  • Rendre un élément visible ou invisible.
XLa propriété X permet de :
  • Connaître l'abscisse d'un champ, d'une colonne d'un champ Table ou d'une fenêtre (position sur l'axe des X).
  • Modifier l'abscisse d'un champ ou d'une fenêtre (position sur l'axe des X).
YLa propriété Y permet de :
  • Connaître l'ordonnée d'un champ ou d'une fenêtre (position sur l'axe des Y).
  • Modifier l'ordonnée d'un champ ou d'une fenêtre (position sur l'axe des Y).
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/04/2023

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