|
|
|
|
|
- Présentation
- Manipuler le champ Agenda par programmation
- Ajouter un rendez-vous
- Remplir un champ Agenda avec les données présentes dans un fichier de données HFSQL
- Récupérer une liste de rendez-vous
- Afficher un champ Agenda à partir d'une date spécifique
- Supprimer un rendez-vous
- Modifier l'affichage du champ
- Utilisation du menu contextuel (FAA)
- Gestion des jours fériés
- Propriétés spécifiques aux champs Agenda
Manipuler un champ Agenda par programmation
Un champ Agenda peut être : - manipulé par programmation.
Pour manipuler un champ Agenda par programmation, WINDEV et WEBDEV propose les fonctions AgendaXXX. Cette page d'aide détaille comment manipuler un champ Agenda présent dans une fenêtre ou une page par programmation. L'exemple utilisé en illustration permet de mémoriser les rendez-vous dans une base de données HFSQL. Manipuler le champ Agenda par programmation Ajouter un rendez-vous L'ajout d'un rendez-vous dans un champ Agenda est réalisé grâce à la fonction AgendaAjouteRendezVous. Cette fonction accepte deux syntaxes : - syntaxe permettant de préciser les caractéristiques du rendez-vous : titre, description, etc.
AgendaAjouteRendezVous(AGD_MonAgenda, "Réunion commercial", "201003220845", ...
"201003221230", "Commerciale")
- syntaxe manipulant une variable de type RendezVous.
MonRendezVous est un RendezVous
MonRendezVous.Titre = "Réunion commerciale"
MonRendezVous.Contenu = "Réunion pour définir les objectifs de la semaine"
MonRendezVous.DateDébut = "201003220845"
MonRendezVous.DateFin = "201003221230"
MonRendezVous.Catégorie = "Commerciale"
MonRendezVous.ID = 1
AgendaAjouteRendezVous(AGD_Agenda, MonRendezVous)
La propriété CouleurFond de la variable RendezVous permet de définir une couleur d'affichage pour un rendez-vous. Si aucune couleur de fond n'est définie, le champ Agenda utilisera automatiquement la couleur associée à la catégorie du rendez-vous. Remplir un champ Agenda avec les données présentes dans un fichier de données HFSQL Les enregistrements sont stockés dans un fichier de données HFSQL. Le remplissage initial du champ Agenda peut être réalisé par un parcours du fichier de données via la syntaxe POUR TOUT et par l'ajout de chaque rendez-vous via la fonction AgendaAjouteRendezVous.
MonRendezVous est un RendezVous
POUR TOUT RDV
MonRendezVous.Titre = RDV.Titre
MonRendezVous.Contenu = RDV.Contenu
MonRendezVous.DateDébut = RDV.DateDébut
MonRendezVous.DateFin = RDV.DateFin
MonRendezVous.Catégorie = RDV.Catégorie
MonRendezVous.ID = RDV.IDRDV
AgendaAjouteRendezVous(AGD_MonAgenda, MonRendezVous)
FIN
Rappel : Il est également possible d'utiliser un champ Agenda lié à un fichier de données. Pour plus de détails, consultez Champ Agenda lié à un fichier de données.Récupérer une liste de rendez-vous La fonction AgendaListeRendezVous permet de récupérer : - la liste de tous les rendez-vous du champ Agenda :
tabListeRendezVous est un tableau de RendezVous
tabListeRendezVous = AgendaListeRendezVous(AGD_MonAgenda)
- la liste des rendez-vous compris entre deux dates :
tabListeRendezVous est un tableau de RendezVous
tabListeRendezVous = AgendaListeRendezVous(AGD_MonAgenda, "20100101", "20100131")
- le rendez-vous actuellement sélectionné ou survolé :
tabListeRendezVous est un tableau de RendezVous
tabListeRendezVous = AgendaListeRendezVous(AGD_MonAgenda, agRdvSélectionné)
Afficher un champ Agenda à partir d'une date spécifique Pour afficher le champ Agenda à partir d'une date spécifique, utilisez la fonction AgendaPosition.
AgendaPosition(AGD_Agenda1, DateDuJour())
AgendaPosition(AGD_Agenda1, "20221220")
Supprimer un rendez-vous La fonction AgendaSupprimeRendezVous permet de supprimer : - le rendez-vous sélectionné dans le champ.
- un rendez-vous précis.
AgendaSupprimeRendezVous(AGD_MonAgenda, 1)
La fonction AgendaSupprimeTout permet de supprimer tous les rendez-vous présents dans le champ Agenda. Modifier l'affichage du champ L'affichage courant d'un champ Agenda peut être modifié via les fonctions suivantes : Utilisation du menu contextuel (FAA) Gestion des jours fériés La gestion des jours fériés est réalisée par programmation. Le WLangage met à votre disposition plusieurs fonctions débutant par JourFériéXXX. Pour définir les jours fériés affichés dans les champs Agenda et les champs Calendrier, il faut utiliser la fonction JourFériéAjoute. Cette fonction permet de définir la liste des jours fériés à utiliser. Cette fonction permet de personnaliser les jours fériés en fonction du pays et de la réglementation locale. Cette fonction doit être utilisée au début de l'application car elle a un effet global sur l'application. Les jours fériés seront colorés en vert dans le champ Agenda. Exemple :
JourFériéSupprimeTout()
JourFériéAjoute("0101")
JourFériéAjoute(jfLundiDePâques)
JourFériéAjoute("0501")
JourFériéAjoute("0508")
JourFériéAjoute(jfJeudiDeLAscension)
JourFériéAjoute(jfLundiDePentecôte)
JourFériéAjoute("0714")
JourFériéAjoute("0815")
JourFériéAjoute("1101")
JourFériéAjoute("1111")
JourFériéAjoute("1225")
JourFériéAjoute("1226" + RC + jfVendrediSaint)
Propriétés spécifiques aux champs Agenda Les propriétés suivantes sont spécifiques à la gestion d'un champ Agenda par programmation.
| | DéplacementRDV | La propriété DéplacementRDV permet de savoir et d'indiquer si l'utilisateur peut déplacer un rendez-vous dans un champ Planning ou dans un champ Agenda. | GranularitéDéplacement | La propriété GranularitéDéplacement permet de connaître et de modifier la taille de la grille pour le déplacement : - des rendez-vous d'un champ Agenda.
- des rendez-vous d'un champ Planning.
- des événements d'un champ TimeLine.
- des tâches d'une colonne de type Diagramme de Gantt.
| GranularitéDurée | La propriété GranularitéDurée permet de connaître et de modifier la taille de la grille utilisée pour le redimensionnement :- des rendez-vous d'un champ Agenda.
- des rendez-vous d'un champ Planning.
- des événements d'un champ TimeLine.
- des tâches d'une colonne de type Diagramme de Gantt.
| GranularitéRendezVous | La propriété GranularitéRendezVous permet de connaître et de modifier la précision de la grille utilisée par le champ Agenda ou le champ Planning pour définir les rendez-vous.
Propriété conservée par compatibilité. | HeureOuvrableDébut | La propriété HeureOuvrableDébut permet de connaître et de modifier l'heure de début des heures ouvrables utilisées : - par un champ Agenda.
- par un champ Planning.
- par une colonne de type Diagramme de Gantt (dans un champ Table ou Table hiérarchique).
| HeureOuvrableFin | La propriété HeureOuvrableFin permet de connaître et de modifier l'heure de fin des heures ouvrables utilisées :- par un champ Agenda.
- par un champ Planning.
- par une colonne de type Diagramme de Gantt (dans un champ Table ou Table hiérarchique).
| MasqueTitreDate | La propriété MasqueTitreDate permet de connaître ou de modifier le masque utilisé pour le titre des colonnes des jours dans un champ Agenda ou dans un champ Planning. | ModificationDuréeRDV | La propriété ModificationDuréeRDV permet de savoir et d'indiquer si l'utilisateur peut modifier la durée d'un rendez-vous dans un champ Planning ou Agenda. | Num1erJourDeLaSemaine | La propriété Num1erJourDeLaSemaine permet de connaître et de modifier le 1er jour de la semaine affiché dans :- un champ Calendrier.
- un champ Agenda.
- un champ Planning.
- un champ de saisie au format Date avec Calendrier.
| SaisieDirecteRDV | La propriété SaisieDirecteRDV permet de savoir et d'indiquer si l'utilisateur peut modifier directement le titre d'un rendez-vous dans un champ Planning ou dans un champ Agenda. | SélectionPériode | La propriété SélectionPériode permet de savoir et d'indiquer si l'utilisateur peut sélectionner une période dans un champ Planning ou dans un champ Agenda. |
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|