PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Créer un état Agenda
  • Création de l'état
  • Informations spécifiques à la création de l'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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
Versions 21 et supérieures
Universal Windows 10 App Les états Agenda sont désormais disponibles.
Nouveauté 21
Universal Windows 10 App Les états Agenda sont désormais disponibles.
Universal Windows 10 App Les états Agenda sont désormais disponibles.
Créer un état Agenda

Création de l'état

Pour créer un état de type "Agenda" :
  1. Sélectionnez l'option "Fichier .. Nouveau .. État". L'assistant de création d'un état se lance. Cliquez sur parmi les boutons d'accès rapide.
    • Dans la roue qui s'affiche, cliquez sur "Etat". 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'Agenda

Les informations spécifiques à la création de l'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.
    • Versions 18 et supérieures
      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.
      Nouveauté 18
      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.
      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.
    • Versions 20 et supérieures
      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.
      Nouveauté 20
      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.
      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 Planning 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 :
Versions 15 et supérieures
AgendaAjouteRendezVous
AgendaAjouteRendezVous
Ajoute un nouveau rendez-vous dans un champ Agenda.
Versions 16 et supérieures
AgendaChangeMode
Nouveauté 16
AgendaChangeMode
AgendaChangeMode
Modifie la plage temporelle affichée par un champ Agenda (Jour/Semaine/Mois).
Versions 15 et supérieures
AgendaChangeZoom
Nouveauté 15
AgendaChangeZoom
AgendaChangeZoom
Modifie la plage temporelle affichée par un champ Agenda (Jour/Semaine/Mois). Cette fonction est conservée par compatibilité.
Versions 17 et supérieures
AgendaCouleurFond
Nouveauté 17
AgendaCouleurFond
AgendaCouleurFond
Fixe une couleur de fond sur une plage horaire d’un champ Agenda.
Versions 15 et supérieures
AgendaHeureAffichée
AgendaHeureAffichée
Définit la plage horaire affichée par le champ Agenda en mode Jour ou Semaine.
Versions 15 et supérieures
AgendaListeRendezVous
AgendaListeRendezVous
Renvoie :
  • 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é).
Versions 17 et supérieures
AgendaMode
Nouveauté 17
AgendaMode
AgendaMode
Renvoie le mode d'affichage par un champ Agenda : jour, semaine, mois, ...
Versions 15 et supérieures
AgendaPosition
Nouveauté 15
AgendaPosition
AgendaPosition
Affiche 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.
Versions 15 et supérieures
AgendaSupprimeRendezVous
AgendaSupprimeRendezVous
Supprime un rendez-vous dans un champ Agenda.
Versions 15 et supérieures
AgendaSupprimeTout
Nouveauté 15
AgendaSupprimeTout
AgendaSupprimeTout
Supprime tous les rendez-vous d'un champ Agenda.
Versions 15 et supérieures
AgendaZoom
Nouveauté 15
AgendaZoom
AgendaZoom
Renvoie 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 :
Versions 17 et supérieures
DateDébutPériodeAffichée
DateDébutPériodeAffichée
La propriété ..DateDébutPériodeAffichée permet de connaître la date de début de la période en cours d'impression dans un champ Planning ou Agenda d'un état.
Versions 17 et supérieures
DateFinPériodeAffichée
DateFinPériodeAffichée
La propriété ..DateFinPériodeAffichée permet de connaître la date de fin de la période en cours d'impression dans un champ Planning ou Agenda d'un état.
Versions 17 et supérieures
GranularitéQuadrillage
GranularitéQuadrillage
La 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.
Versions 09 et supérieures
Hauteur
Nouveauté 09
Hauteur
Hauteur
La 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 de table ou de liste (y compris liste image), d'une option d'un sélecteur ou d'un interrupteur, d'un haut ou d'un bas de rupture d'une table ou d'une zone répétée.
  • d'un champ (présent dans une page), d'un haut ou bas de rupture d'une table ou d'une zone répétée. Le champ peut être superposable ou non.
Versions 09 et supérieures
Largeur
Nouveauté 09
Largeur
Largeur
La 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.
Versions 17 et supérieures
LibelléPériodeEntête
LibelléPériodeEntête
La 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.
Versions 09 et supérieures
Nom
Nouveauté 09
Nom
Nom
La 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.
Versions 18 et supérieures
PoliceContenuRendezVous
PoliceContenuRendezVous
La 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.
Versions 18 et supérieures
PoliceTitreRendezVous
PoliceTitreRendezVous
La 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.
Versions 09 et supérieures
Visible
Nouveauté 09
Visible
Visible
La propriété ..Visible permet de :
  • Savoir si un élément est visible.
  • Rendre un élément visible ou invisible.
Versions 09 et supérieures
X
Nouveauté 09
X
X
La 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).
Versions 09 et supérieures
Y
Nouveauté 09
Y
Y
La 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