PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

PV

  • Présentation
  • Principe
  • Pour faire défiler des fenêtres internes, le principe est simple
  • Mise en place
  • Parcours de fenêtres internes : Parcours programmé
  • Parcours de fenêtres internes : parcours automatique sur un fichier de données ou une requête
  • Programmation avancée
  • Fonctions WLangage disponibles pour manipuler les fenêtres internes
  • Traitements exécutés lors du défilement des fenêtres internes
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
Dans les applications Windows, toutes les manipulations sont réalisées grâce à la souris ou au clavier. Les écrans tactiles permettent également de réaliser certaines manipulations directement avec les mains.
Dans les applications pour les appareils mobiles, de nombreuses fonctionnalités sont disponibles à partir de mouvements de doigts.
Les fenêtres internes proposent un défilement par balayage :
  • AndroidiPhone/iPad Dans les applications Android et iPhone/iPad : le défilement des fenêtres sera effectué par un simple balayage manuel.
  • Versions 19 et supérieures
    Windows Dans les applications Windows : le défilement des fenêtres sera effectué à l'aide de la souris.
    Nouveauté 19
    Windows Dans les applications Windows : le défilement des fenêtres sera effectué à l'aide de la souris.
    Windows Dans les applications Windows : le défilement des fenêtres sera effectué à l'aide de la souris.
  • Versions 22 et supérieures
    Universal Windows 10 App Dans les applications Universal Windows : le défilement des fenêtres sera effectué par exemple à l'aide de boutons (seul le balayage par programmation est disponible).
    Nouveauté 22
    Universal Windows 10 App Dans les applications Universal Windows : le défilement des fenêtres sera effectué par exemple à l'aide de boutons (seul le balayage par programmation est disponible).
    Universal Windows 10 App Dans les applications Universal Windows : le défilement des fenêtres sera effectué par exemple à l'aide de boutons (seul le balayage par programmation est disponible).
Android Conditions d'utilisation :
Pour faire défiler des fenêtres internes en Android, l'extension "Android Support Library V4" est nécessaire sur le poste de développement, lors de la génération de l'application Android. La procédure d'installation de cette extension est disponible à l'adresse suivante :
http://developer.android.com/tools/extras/support-library.html#Downloading
Versions 22 et supérieures
Universal Windows 10 App Cette fonctionnalité est désormais disponible en mode Universal Windows 10 app.
Nouveauté 22
Universal Windows 10 App Cette fonctionnalité est désormais disponible en mode Universal Windows 10 app.
Universal Windows 10 App Cette fonctionnalité est désormais disponible en mode Universal Windows 10 app.
Principe

Pour faire défiler des fenêtres internes, le principe est simple

  • Un champ "Fenêtre interne" est créé sous l'éditeur. Ce champ "Fenêtre interne" autorise le balayage.
  • Par programmation, une liste de fenêtres internes est associée au champ "Fenêtre interne".
  • En exécution, lorsque l'utilisateur modifiera l'élément affiché (via les doigts, la souris ou des boutons spécifiques), les différentes fenêtres internes de la liste seront affichées.
Il est également possible de créer un défilement de fenêtres internes basées sur un fichier de données ou sur une requête. Dans ce cas, le principe est le suivant :
  • Une fenêtre interne est créée. Les champs de cette fenêtre sont associés à un fichier de données ou à une requête.
  • Un champ "Fenêtre interne" est créé sous l'éditeur. Ce champ "Fenêtre interne" autorise le balayage et est associé au fichier de données ou à la requête de la fenêtre interne.
  • En exécution, lorsque l'utilisateur modifiera l'élément affiché (via les doigts, la souris ou des boutons spécifiques), le fichier de données (ou la requête) sera parcouru et affiché dans la fenêtre interne.
Mise en place

Parcours de fenêtres internes : Parcours programmé

Pour mettre en place un parcours de fenêtres internes :
  1. Créez les fenêtres internes qui devront être affichées lors du parcours. Ces fenêtres internes peuvent prendre des paramètres lors de leur ouverture si nécessaire.
  2. Créez un champ de type "Fenêtre interne" dans votre fenêtre : sous le volet "Création", dans le groupe "Conteneurs", cliquez sur "Fenêtre interne".
  3. Affichez la fenêtre de description du champ "Fenêtre interne". Dans l'onglet "IHM" :
    • Cochez l'option "Autoriser le changement de contenu par balayage".
    • Indiquez :
      • la taille du cache. La taille du cache correspond au nombre de fenêtres internes qui seront conservées en mémoire (3 par défaut). Plus ce nombre est petit, et plus la consommation mémoire sera faible. Par contre, le chargement des fenêtres sera effectué plus souvent.
      • Versions 22 et supérieures
        l'orientation du balayage : vertical ou horizontal.
        Nouveauté 22
        l'orientation du balayage : vertical ou horizontal.
        l'orientation du balayage : vertical ou horizontal.
      • Versions 22 et supérieures
        si nécessaire l'animation à effectuer lors du balayage. Cliquez sur "Configurer l'animation".
        L'onglet "Style" du champ apparaît positionné sur l'élément "Animation de champ". Il est possible de sélectionner l'animation voulue puis de configurer ses paramètres via le bouton "Paramètres".
        Si l'option "Définie par le projet" est choisie, l'animation effectuée sera celle configurée dans les options du projet. Pour plus de détails, consultez Animation de champs.
        Nouveauté 22
        si nécessaire l'animation à effectuer lors du balayage. Cliquez sur "Configurer l'animation".
        L'onglet "Style" du champ apparaît positionné sur l'élément "Animation de champ". Il est possible de sélectionner l'animation voulue puis de configurer ses paramètres via le bouton "Paramètres".
        Si l'option "Définie par le projet" est choisie, l'animation effectuée sera celle configurée dans les options du projet. Pour plus de détails, consultez Animation de champs.
        si nécessaire l'animation à effectuer lors du balayage. Cliquez sur "Configurer l'animation".
        L'onglet "Style" du champ apparaît positionné sur l'élément "Animation de champ". Il est possible de sélectionner l'animation voulue puis de configurer ses paramètres via le bouton "Paramètres".
        Si l'option "Définie par le projet" est choisie, l'animation effectuée sera celle configurée dans les options du projet. Pour plus de détails, consultez Animation de champs.
  4. Par programmation, construisez la liste des fenêtres internes à afficher dans le champ "Fenêtre interne". Pour cela, utilisez la fonction FIListeAjoute autant de fois que nécessaire.
Remarques :
  • Les fenêtres doivent être ajoutées dans l'ordre de parcours voulu.
  • Il est possible d'indiquer dans la fonction FIListeAjoute les paramètres à passer aux fenêtres internes ajoutées.
  • Il est possible d'ajouter plusieurs fois la même fenêtre interne avec des paramètres différents.
  • Versions 22 et supérieures
    Universal Windows 10 App Dans vos applications Universal Windows 10 App, pour que l'utilisateur puisse faire défiler les fenêtres internes, créez les boutons nécessaires et utilisez les fonctions FIListePrécédent et FIListeSuivant.
    Nouveauté 22
    Universal Windows 10 App Dans vos applications Universal Windows 10 App, pour que l'utilisateur puisse faire défiler les fenêtres internes, créez les boutons nécessaires et utilisez les fonctions FIListePrécédent et FIListeSuivant.
    Universal Windows 10 App Dans vos applications Universal Windows 10 App, pour que l'utilisateur puisse faire défiler les fenêtres internes, créez les boutons nécessaires et utilisez les fonctions FIListePrécédent et FIListeSuivant.

Parcours de fenêtres internes : parcours automatique sur un fichier de données ou une requête

Pour mettre en place un parcours de fenêtres internes basé sur un fichier de données ou sur une requête :
  1. Créez la fenêtre interne qui doit afficher les différents enregistrements. Les différents champs de cette fenêtre interne doivent être liés à des rubriques du fichier ou de la requête parcourue.
  2. Créez un champ de type "Fenêtre interne" dans votre fenêtre : sous le volet "Création", dans le groupe "Conteneurs", cliquez sur "Fenêtre interne".
  3. Affichez la fenêtre de description du champ "Fenêtre interne".
    • Dans l'onglet "Général", associez la fenêtre interne précédemment créée au champ "Fenêtre interne".
    • Dans l'onglet "IHM" :
      • Cochez l'option "Autoriser le changement de contenu par balayage".
    • Indiquez :
      • la taille du cache. La taille du cache correspond au nombre de fenêtres internes qui seront conservées en mémoire (3 par défaut). Plus ce nombre est petit, et plus la consommation mémoire sera faible. Par contre, le chargement des fenêtres sera effectué plus souvent.
      • Versions 22 et supérieures
        l'orientation du balayage : vertical ou horizontal.
        Nouveauté 22
        l'orientation du balayage : vertical ou horizontal.
        l'orientation du balayage : vertical ou horizontal.
      • Versions 22 et supérieures
        si nécessaire l'animation à effectuer lors du balayage. Cliquez sur "Configurer l'animation".
        L'onglet "Style" du champ apparaît positionné sur l'élément "Animation de champ". Il est possible de sélectionner l'animation voulue puis de configurer ses paramètres via le bouton "Paramètres".
        Si l'option "Définie par le projet" est choisie, l'animation effectuée sera celle configurée dans les options du projet. Pour plus de détails, consultez Animation de champs.
        Nouveauté 22
        si nécessaire l'animation à effectuer lors du balayage. Cliquez sur "Configurer l'animation".
        L'onglet "Style" du champ apparaît positionné sur l'élément "Animation de champ". Il est possible de sélectionner l'animation voulue puis de configurer ses paramètres via le bouton "Paramètres".
        Si l'option "Définie par le projet" est choisie, l'animation effectuée sera celle configurée dans les options du projet. Pour plus de détails, consultez Animation de champs.
        si nécessaire l'animation à effectuer lors du balayage. Cliquez sur "Configurer l'animation".
        L'onglet "Style" du champ apparaît positionné sur l'élément "Animation de champ". Il est possible de sélectionner l'animation voulue puis de configurer ses paramètres via le bouton "Paramètres".
        Si l'option "Définie par le projet" est choisie, l'animation effectuée sera celle configurée dans les options du projet. Pour plus de détails, consultez Animation de champs.
      • Cochez si nécessaire l'option "Se positionner sur l'enregistrement courant lors de l'ouverture de la fenêtre interne". Cette option permet de positionner les données de la fenêtre interne automatiquement sur l'enregistrement courant. Cette option est prise en compte uniquement si le changement de contenu est réalisé par balayage et si le contenu correspond à une source de données (fichier, requête, ...).
    • Dans l'onglet "Contenu" :
      • Sélectionnez le mode de remplissage de la fenêtre interne "Fichier/Requête".
      • Sélectionnez la source utilisée : fichier, requête ou requête intégrée.
      • Sélectionnez la rubrique de parcours.
Versions 22 et supérieures
Universal Windows 10 App Remarque : Dans vos applications Universal Windows 10 App, pour que l'utilisateur puisse faire défiler les fenêtres internes, créez les boutons nécessaires et utilisez les fonctions FIListePrécédent et FIListeSuivant.
Nouveauté 22
Universal Windows 10 App Remarque : Dans vos applications Universal Windows 10 App, pour que l'utilisateur puisse faire défiler les fenêtres internes, créez les boutons nécessaires et utilisez les fonctions FIListePrécédent et FIListeSuivant.
Universal Windows 10 App Remarque : Dans vos applications Universal Windows 10 App, pour que l'utilisateur puisse faire défiler les fenêtres internes, créez les boutons nécessaires et utilisez les fonctions FIListePrécédent et FIListeSuivant.
Programmation avancée

Fonctions WLangage disponibles pour manipuler les fenêtres internes

Plusieurs fonctions WLangage sont disponibles pour gérer les parcours de fenêtres internes :
Versions 10 et supérieures
ChangeFenêtreSource
ChangeFenêtreSource
Change dynamiquement la fenêtre affichée dans un champ fenêtre interne.
Cas des défilements de fenêtres internes : Modifie la fenêtre actuellement affichée. Cette modification est enregistrée dans la liste des fenêtres internes à faire défiler.
Versions 18 et supérieures
FIListeAffiche
Nouveauté 18
FIListeAffiche
FIListeAffiche
Rafraîchit l’affichage d’un champ "Fenêtre interne" avec parcours automatique sur un fichier de données ou une requête.
Versions 18 et supérieures
FIListeAjoute
Nouveauté 18
FIListeAjoute
FIListeAjoute
Ajoute une nouvelle fenêtre interne à la liste des fenêtres internes parcourue par un champ Fenêtre Interne.
Versions 19 et supérieures
FIListeInsère
Nouveauté 19
FIListeInsère
FIListeInsère
Insère une nouvelle fenêtre interne à la liste des fenêtres internes parcourue par un champ Fenêtre Interne.
Versions 18 et supérieures
FIListeOccurrence
Nouveauté 18
FIListeOccurrence
FIListeOccurrence
Renvoie le nombre de fenêtres internes actuellement présentes dans la liste des fenêtres internes parcourue par un champ Fenêtre Interne.
Versions 18 et supérieures
FIListePosition
Nouveauté 18
FIListePosition
FIListePosition
Affiche la fenêtre interne correspondant à la position spécifiée (dans la liste des fenêtres internes parcourues par un champ Fenêtre Interne) ou renvoie la position de la fenêtre interne actuellement affichée (dans la liste des fenêtres internes parcourues par un champ Fenêtre Interne).
Versions 18 et supérieures
FIListePrécédent
Nouveauté 18
FIListePrécédent
FIListePrécédent
Affiche la fenêtre interne précédente de la liste des fenêtres internes parcourue par un champ Fenêtre Interne.
Versions 18 et supérieures
FIListeSuivant
Nouveauté 18
FIListeSuivant
FIListeSuivant
Affiche la fenêtre interne suivante dans la liste des fenêtres internes parcourue par un champ Fenêtre Interne.
Versions 18 et supérieures
FIListeSupprime
Nouveauté 18
FIListeSupprime
FIListeSupprime
Supprime une fenêtre interne présente dans la liste des fenêtres internes parcourue par un champ Fenêtre Interne.
Versions 18 et supérieures
FIListeSupprimeTout
Nouveauté 18
FIListeSupprimeTout
FIListeSupprimeTout
Supprime toutes les fenêtres internes ajoutées par programmation dans la liste des fenêtres internes parcourue par un champ Fenêtre Interne.
Remarques :
  • Lors d'un parcours automatique sur un fichier de données ou une requête, les fonctions ChangeFenêtreSource, FIListeAjoute, FIListeInsère, FIListeSupprime, FIListeSupprimeTout ne peuvent pas être utilisées.
  • La fonction ChangeFenêtreSource permet de modifier la fenêtre actuellement affichée. Cette modification est enregistrée dans la liste des fenêtres internes à faire défiler.
  • Seuls les champs de la fenêtre interne actuellement affichée sont accessibles par programmation. Par exemple, pour changer le libellé du bouton dans la fenêtre interne actuellement affichée, le code utilisé est le suivant :
    MonChampFenêtreInterne.BTN_Bouton = "Nouveau libellé"
  • Versions 21 et supérieures
    La propriété ..BalayageActif permet d'activer ou de désactiver le parcours des fenêtres internes à l'aide du doigt. Il est ainsi possible de désactiver temporairement le balayage pour réaliser une opération spécifique.
    Universal Windows 10 App Cette propriété n'est pas disponible.
    Nouveauté 21
    La propriété ..BalayageActif permet d'activer ou de désactiver le parcours des fenêtres internes à l'aide du doigt. Il est ainsi possible de désactiver temporairement le balayage pour réaliser une opération spécifique.
    Universal Windows 10 App Cette propriété n'est pas disponible.
    La propriété ..BalayageActif permet d'activer ou de désactiver le parcours des fenêtres internes à l'aide du doigt. Il est ainsi possible de désactiver temporairement le balayage pour réaliser une opération spécifique.
    Universal Windows 10 App Cette propriété n'est pas disponible.
  • Versions 22 et supérieures
    La propriété ..BalayageVertical permet de connaître et modifier l'orientation du balayage.
    Universal Windows 10 App Cette propriété n'est pas disponible.
    Nouveauté 22
    La propriété ..BalayageVertical permet de connaître et modifier l'orientation du balayage.
    Universal Windows 10 App Cette propriété n'est pas disponible.
    La propriété ..BalayageVertical permet de connaître et modifier l'orientation du balayage.
    Universal Windows 10 App Cette propriété n'est pas disponible.

Traitements exécutés lors du défilement des fenêtres internes

Lors de la mise en place du défilement des fenêtres internes, il est possible de paramétrer la taille du cache, c'est-à-dire le nombre de fenêtres internes chargées en mémoire.
Lors de l'exécution d'une fenêtre permettant de faire défiler une liste de fenêtres internes :
  • Les fenêtres internes présentes dans la liste et correspondant au nombre spécifié dans la taille du cache sont chargées. Pour chacune, les traitements suivants sont exécutés :
    • Déclaration des globales de la fenêtre interne
    • Initialisation des champs présents dans la fenêtre interne
    • Initialisation de la fenêtre interne
    • Après chargement de la fenêtre interne.
  • Lorsque l'utilisateur change par balayage le contenu de la fenêtre interne, les traitements suivants sont exécutés :
    • Sélection par balayage.
    • Chargement de la prochaine fenêtre interne (les traitements exécutés sont ceux du paragraphe précédent).
    • Déchargement d'une des fenêtres internes (selon la taille du cache). Dans ce cas, les traitements "Avant déchargement de la fenêtre interne" et "Fermeture" sont exécutés.
Remarques :
  • Le traitement "Sélection par balayage" n'est pas exécuté si le changement de fenêtre interne est exécuté par programmation.
  • Pour connaître la liste des traitements associés à une fenêtre interne, consultez Traitements associés à une fenêtre interne.
Liste des exemples associés :
WM CRM Exemples multiplateforme (WINDEV Mobile) : WM CRM
[ + ] WM CRM est un projet multi-plateformes Android et iOS.
Il présente comment on peut réaliser une application de CRM destinée aux tablettes Android et iPad.
Version minimum requise
  • Version 18
Documentation également disponible pour…
Commentaires
Les puces dans une CFI
Comment changer l'ordre d'affichage des puces par programmation, pas d'info à ce sujet.. FIListePosition ou FIListeAffiche ou FIListeSuivant ne change pas l’ordre des puces.

Merci.
Zack
13 mar. 2018