PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Champ d'une fenêtre, d'une page ou d'un état
  • Description d'un planning
  • Les options du champ
  • Un menu contextuel proposé automatiquement
  • Un rendez-vous supprimable
  • Personnalisez la zone du rendez-vous
  • Modes de remplissage d'un champ Planning
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
Présentation

Champ d'une fenêtre, d'une page ou d'un état

Le champ Planning permet d'afficher et de manipuler des plannings automatiquement. Il permet de gérer l'affichage de ressources multiples et trouve sa place dans de nombreuses applications ou sites.
L'affichage s'effectue à la journée, à la semaine ou au mois.
La plage horaire, le premier jour de la semaine, le nombre de jours à afficher sont paramétrables. Ces paramètres se définissent simplement depuis la fenêtre de description du champ.
Versions 21 et supérieures
WINDEV MobileAndroid Les champs Planning sont disponibles pour les applications Android.
WINDEV MobileiPhone/iPad Les champs Planning sont disponibles pour les applications iPhone/iPad.
Nouveauté 21
WINDEV MobileAndroid Les champs Planning sont disponibles pour les applications Android.
WINDEV MobileiPhone/iPad Les champs Planning sont disponibles pour les applications iPhone/iPad.
WINDEV MobileAndroid Les champs Planning sont disponibles pour les applications Android.
WINDEV MobileiPhone/iPad Les champs Planning sont disponibles pour les applications iPhone/iPad.
Pour créer un champ Planning :
  1. Sous l'éditeur de fenêtres et de pages, cliquez sur l'icône (ou sélectionnez l'option "Insertion .. Champ .. Champ Planning").Sous le volet "Création", dans le groupe "Champs graphiques", déroulez "Temps" et sélectionnez "Planning".
  2. Cliquez dans la fenêtre ou la page à la position où le champ doit être créé.
  3. WINDEVWEBDEV - Code Serveur L'assistant de création du champ Planning se lance. Répondez aux différentes questions et validez.
  4. Le champ apparaît en création.
Versions 20 et supérieures
Remarque : Les dimensions du champ créé sont optimisées pour occuper l'espace disponible à la position indiquée. Si la taille du champ ne vous convient pas, utilisez la combinaison de touches [CTRL Z] : le champ retrouvera sa taille par défaut.
Nouveauté 20
Remarque : Les dimensions du champ créé sont optimisées pour occuper l'espace disponible à la position indiquée. Si la taille du champ ne vous convient pas, utilisez la combinaison de touches [CTRL Z] : le champ retrouvera sa taille par défaut.
Remarque : Les dimensions du champ créé sont optimisées pour occuper l'espace disponible à la position indiquée. Si la taille du champ ne vous convient pas, utilisez la combinaison de touches [CTRL Z] : le champ retrouvera sa taille par défaut.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
Remarques :
  • Un champ Planning peut être ancré :
    • WINDEVAndroidiPhone/iPad grâce aux options d'ancrage de WINDEV et WINDEV Mobile.
    • WEBDEV - Code Serveur grâce à la table de positionnement en WEBDEV.
  • Versions 17 et supérieures
    WINDEVWEBDEV - Code Serveur Les champs Planning sont disponibles dans les états de type Planning. Pour plus de détails sur le fonctionnement des plannings dans les états, consultez Etat de type Planning.
    Nouveauté 17
    WINDEVWEBDEV - Code Serveur Les champs Planning sont disponibles dans les états de type Planning. Pour plus de détails sur le fonctionnement des plannings dans les états, consultez Etat de type Planning.
    WINDEVWEBDEV - Code Serveur Les champs Planning sont disponibles dans les états de type Planning. Pour plus de détails sur le fonctionnement des plannings dans les états, consultez Etat de type Planning.
  • Linux Le champ Planning est disponible en Linux uniquement dans les sites WEBDEV Linux. Le champ Planning n'est pas disponible dans les applications WINDEV pour Linux.
Description d'un planning

Les options du champ

Le champ Planning peut être paramétré directement sous l'éditeur grâce à la fenêtre de description (onglet "Détail" pour WINDEV et onglet "Général" pour WEBDEV).Le champ Planning peut être paramétré directement sous l'éditeur grâce à la fenêtre de description (onglet "Détail").
Les paramètres du champ Planning sont les suivants :
  • Avec boutons de changement de période : Cette option permet d'afficher des boutons afin que l'utilisateur puisse faire défiler les différentes périodes du planning. Ces boutons sont affichés en haut à gauche du planning.
    AndroidiPhone/iPad Cette option n'est pas disponible. En effet, le changement de période se fait grâce à un mouvement de balayage horizontal sur le champ Planning.
  • Nombre de jours à afficher : Par défaut, l'affichage est réalisé au mois, mais il est également possible d'afficher un planning à la journée, à la semaine (sur 5 ou 7 jours), selon le nombre de rendez-vous, ou selon le nombre de jours spécifié.
    WINDEV Ce mode d'affichage peut être modifié par l'utilisateur à l'aide du menu contextuel du champ.
  • Mode d'affichage des ressources : Par défaut, les ressources sont affichées en ligne.
    WINDEVWEBDEV - Code ServeurPHP Il est également possible de les afficher en colonne. PHP Les ressources sont toujours affichées en colonne.
  • Masques d'affichage : Permet de définir :
    • le format de la date affichée pour les colonnes (ou les lignes) "jour" du planning.
    • le format de l'heure affichée pour les colonnes (ou les lignes) "jour" du planning.
    • Versions 17 et supérieures
      si le numéro de semaine doit être affiché ou non, ainsi que son format. Dans le format, la chaîne '%1' correspond au numéro de semaine. Exemple de format : "Sem. %1".
      Nouveauté 17
      si le numéro de semaine doit être affiché ou non, ainsi que son format. Dans le format, la chaîne '%1' correspond au numéro de semaine. Exemple de format : "Sem. %1".
      si le numéro de semaine doit être affiché ou non, ainsi que son format. Dans le format, la chaîne '%1' correspond au numéro de semaine. Exemple de format : "Sem. %1".
  • Plage horaire : Permet de définir :
    • la plage horaire visible : Plage horaire qui sera affichée dans le champ.
    • la plage horaire ouvrable : Plage horaire pour laquelle un rendez-vous pourra être défini.
  • Caractéristiques d'un rendez-vous :
    • WINDEVWEBDEV - Code ServeurPHP Chevauchement : Gestion des chevauchements des rendez-vous. Les rendez-vous peuvent être affichés côte à côte ou légèrement décalés.
    • Granularité des rendez-vous : Précision d'affichage du planning. Par défaut, la granularité est de 30 minutes.
      Il est possible de définir :
      • la granularité de déplacement d'un rendez-vous.
      • la granularité de durée d'un rendez-vous, c'est-à-dire la durée minimale d'un rendez-vous. Attention : par défaut, cette durée est de 24 heures.
  • WINDEV Autoriser la sélection de périodes : Permet à l'utilisateur de sélectionner une période à l'aide de la souris.
  • Autoriser la saisie directe d'un rendez-vous : Permet à l'utilisateur d'ajouter directement un rendez-vous.
    WINDEVWEBDEV - Code ServeurPHP Il suffit de cliquer dans le champ Planning pour créer le rendez-vous et de saisir directement son libellé au clavier.
    AndroidiPhone/iPad Il suffit de cliquer dans le champ Planning. Un bouton "+" apparaît dans la zone sélectionnée. En cliquant sur ce bouton "+", le traitement "Avant création du rendez-vous" est exécuté. Il est possible d'ouvrir une fenêtre pour saisir les caractéristiques du rendez-vous. Pour plus de détails, consultez Traitements associés à un champ Planning.
Versions 18 et supérieures
  • WINDEVWEBDEV - Code ServeurPHP Afficher et autoriser les rendez-vous à la journée entière : Permet d'indiquer qu'un rendez-vous peut correspondre à une journée entière. Dans ce cas, une zone spécifique est affichée dans le champ Planning. Cette zone permet de saisir les rendez-vous à la journée.
    WINDEV Il est possible de spécifier la hauteur de la zone.
    Exemples :
    • si le planning est affiché avec les ressources en ligne :
      • WINDEV En WINDEV :
      • WEBDEV - Code ServeurPHP En WEBDEV :
    • si le planning est affiché avec les ressources en colonne :
      • WINDEV En WINDEV :
      • WEBDEV - Code ServeurPHP En WEBDEV :
Nouveauté 18
  • WINDEVWEBDEV - Code ServeurPHP Afficher et autoriser les rendez-vous à la journée entière : Permet d'indiquer qu'un rendez-vous peut correspondre à une journée entière. Dans ce cas, une zone spécifique est affichée dans le champ Planning. Cette zone permet de saisir les rendez-vous à la journée.
    WINDEV Il est possible de spécifier la hauteur de la zone.
    Exemples :
    • si le planning est affiché avec les ressources en ligne :
      • WINDEV En WINDEV :
      • WEBDEV - Code ServeurPHP En WEBDEV :
    • si le planning est affiché avec les ressources en colonne :
      • WINDEV En WINDEV :
      • WEBDEV - Code ServeurPHP En WEBDEV :
  • WINDEVWEBDEV - Code ServeurPHP Afficher et autoriser les rendez-vous à la journée entière : Permet d'indiquer qu'un rendez-vous peut correspondre à une journée entière. Dans ce cas, une zone spécifique est affichée dans le champ Planning. Cette zone permet de saisir les rendez-vous à la journée.
    WINDEV Il est possible de spécifier la hauteur de la zone.
    Exemples :
    • si le planning est affiché avec les ressources en ligne :
      • WINDEV En WINDEV :
      • WEBDEV - Code ServeurPHP En WEBDEV :
    • si le planning est affiché avec les ressources en colonne :
      • WINDEV En WINDEV :
      • WEBDEV - Code ServeurPHP En WEBDEV :
Les options d'édition à la souris sont les suivantes :
  • WINDEVWEBDEV - Code ServeurPHP Modification de la durée. Il est possible d'autoriser ou non l'utilisateur à modifier la durée d'un rendez-vous.
  • Déplacement. Il est possible d'autoriser ou non l'utilisateur à déplacer un rendez-vous.
  • Versions 17 et supérieures
    WINDEVAndroidiPhone/iPad Autoriser le chevauchement par l'utilisateur. Si cette option est cochée, l'utilisateur pourra lors du déplacement de rendez-vous les faire se chevaucher. Dans ce cas, les options définies pour le chevauchement des rendez-vous (décalage ou côte à côte) seront prises en compte.
    Nouveauté 17
    WINDEVAndroidiPhone/iPad Autoriser le chevauchement par l'utilisateur. Si cette option est cochée, l'utilisateur pourra lors du déplacement de rendez-vous les faire se chevaucher. Dans ce cas, les options définies pour le chevauchement des rendez-vous (décalage ou côte à côte) seront prises en compte.
    WINDEVAndroidiPhone/iPad Autoriser le chevauchement par l'utilisateur. Si cette option est cochée, l'utilisateur pourra lors du déplacement de rendez-vous les faire se chevaucher. Dans ce cas, les options définies pour le chevauchement des rendez-vous (décalage ou côte à côte) seront prises en compte.
Les options concernant la dimension des zones sont les suivantes :
  • WINDEVWEBDEV - Code ServeurPHP si les ressources sont affichées en ligne :
    • Largeur minimale d'une journée.
      WEBDEV - Code ServeurPHP En WEBDEV, il faut définir la largeur minimale d'une heure. La largeur de la journée est calculée en fonction du nombre d'heures affichées.
    • Hauteur minimale d'une ressource.
    • Largeur de l'entête des ressources.
  • WINDEVWEBDEV - Code ServeurPHP si les ressources sont affichées en colonne :
    • Largeur minimale d'une ressource.
    • Hauteur minimale d'une journée.
      WEBDEV - Code ServeurPHP En WEBDEV, il faut définir la hauteur minimale d'une heure. La hauteur de la journée est calculée en fonction du nombre d'heures affichées.
    • Hauteur de la rupture (pour le changement de journée)
  • AndroidiPhone/iPad les ressources sont toujours affichées en ligne. Il est possible de paramétrer les éléments suivants :
    • Largeur minimale d'une journée.
    • Hauteur minimale d'une ressource.
    • Largeur de l'en-tête des ressources.
Versions 17 et supérieures
WINDEV La plupart de ces paramètres sont modifiables par programmation. Pour plus de détails, consultez Propriétés associées au champ Planning.
Nouveauté 17
WINDEV La plupart de ces paramètres sont modifiables par programmation. Pour plus de détails, consultez Propriétés associées au champ Planning.
WINDEV La plupart de ces paramètres sont modifiables par programmation. Pour plus de détails, consultez Propriétés associées au champ Planning.
La plupart de ces paramètres sont modifiables par programmation. Pour plus de détails, consultez Propriétés associées au champ Planning.
WINDEV

Un menu contextuel proposé automatiquement

Le champ Planning peut afficher un menu contextuel spécifique proposant des fonctionnalités automatiques à l'utilisateur. Ce menu est proposé par les FAA (Fonctionnalités Automatiques de l'Application).
A partir du moment où au moins une ressource est présente dans le planning, ce menu permet à l'utilisateur de :
  • Modifier le mode d'affichage du planning : affichage au jour, à la semaine, au mois ou encore affichage uniquement de la journée en cours.
  • Ajouter, supprimer ou modifier un rendez-vous lors de la sélection d'une plage horaire.
  • Copier le contenu d'un rendez-vous.
  • Versions 17 et supérieures
    Imprimer le contenu du champ Planning.
    Nouveauté 17
    Imprimer le contenu du champ Planning.
    Imprimer le contenu du champ Planning.
Pour plus de détails sur les fonctionnalités de ce menu contextuel (notamment l'impression), consultez Fonctionnalités automatiques du champ Planning.
WEBDEV - Code Serveur

Un rendez-vous supprimable

Le champ Planning donne à l'utilisateur la possibilité de supprimer un rendez-vous grâce à la croix rouge affichée en haut à droite du rendez-vous lorsque celui-ci est sélectionné.
Lorsque l'utilisateur clique sur cette croix :
  • le rendez-vous est supprimé du champ Planning.
  • si le champ Planning est lié à un fichier de données, le rendez-vous est supprimé du fichier de données.
WINDEVAndroidiPhone/iPad

Personnalisez la zone du rendez-vous

Dans le champ Planning, le rendez-vous est affiché dans une zone spécifique. Il est possible de traduire et de personnaliser cette zone : couleur du titre, couleur de fond du rendez-vous, ...
Pour personnaliser l'affichage des rendez-vous :
  1. Affichez la fenêtre de description du champ Planning.
  2. Dans l'onglet "Général", sélectionnez la fenêtre interne utilisée pour les rendez-vous :
    • "Aucune" : l'affichage par défaut sera utilisé.
    • "Fenêtre prédéfinie" : une fenêtre prédéfinie est automatiquement ajoutée au projet.
      WINDEV Par défaut, cette fenêtre s'appelle "FI_WinDevVueRDV.wdw".
      AndroidiPhone/iPad Par défaut, cette fenêtre s'appelle "FI_WinDevMobileVueRDV.wdw".
  3. La fenêtre interne est disponible dans l'explorateur de projet. Elle peut être modifiée dans l'éditeur de fenêtres.

    Attention : cette fenêtre interne permet uniquement de personnaliser le dessin de l'affichage des rendez-vous. Seul le traitement de déclaration des globales est exécuté. Aucun autre traitement n'est exécuté. Il n'est ainsi pas possible d'ajouter des boutons ayant un code de clic spécifique.
Remarques :
  • Il est également possible d'utiliser n'importe quelle fenêtre interne de votre projet.
  • Versions 17 et supérieures
    L'aspect des rendez-vous proposés par défaut est paramétrable dans l'onglet "Style" de la fenêtre de description du champ, élément "Rendez-vous".
    Nouveauté 17
    L'aspect des rendez-vous proposés par défaut est paramétrable dans l'onglet "Style" de la fenêtre de description du champ, élément "Rendez-vous".
    L'aspect des rendez-vous proposés par défaut est paramétrable dans l'onglet "Style" de la fenêtre de description du champ, élément "Rendez-vous".

Modes de remplissage d'un champ Planning

AndroidiPhone/iPad Seul le remplissage du champ Planning par programmation est disponible. Pour plus de détails, consultez Champ Planning : programmation à l'aide des différents traitements et des fonctions WLangage
Liste des exemples associés :
WD Planning Exemples complets (WINDEV) : WD Planning
[ + ] Cet exemple illustre la gestion d'un planning graphique.

Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ le champ planning
2/ les fonctions Google agenda
Le champ Planning Exemples unitaires (WEBDEV) : Le champ Planning
[ + ] Utilisation du champ Planning. Deux utilisations sont présentées :
- Remplissage du planning par programmation,
- Remplissage du planning par databinding à partir d'une variable du code.
WW_Planning Exemples complets (WEBDEV) : WW_Planning
[ + ] Cet exemple permet d'afficher de façon dynamique les tâches des différents collaborateurs.
Il est possible d'ajouter, de modifier ou de supprimer des tâches dans le planning, simplement en cliquant sur les éléments du planning.
Toutes les manipulations sont effectuées grâce à AJAX.
Cet exemple utilise également le déplacement de champ par programmation.
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire