PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Type de parcours
  • Manipuler des champs liés à un fichier de données grâce aux propriétés
  • Modifier les propriétés liées au parcours d'un champ fichier
  • Table mémoire
  • Champ Liste et Combo mémoire
  • Limites
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
Pour les champs, la propriété ..RubriqueParcourue permet de :
  • Connaître la rubrique utilisée pour le parcours automatique des champs liés à un fichier de données.
  • Modifier la rubrique utilisée pour le parcours automatique des champs liés à un fichier de données. Le parcours est alors réinitialisé.
WEBDEV - Code Serveur Cette modification est possible uniquement pour les champs de type "Automatique" ou "Dynamique" (onglet "Détail" de la description du champ).
WEBDEV - Code Serveur Cette modification est possible uniquement pour les champs de type "Automatique" ou "Dynamique" (onglet "IHM" de la description du champ).
Pour un état sur fichier, la propriété ..RubriqueParcourue permet de modifier la rubrique utilisée pour le parcours du fichier. Dans ce cas, cette propriété est utilisable uniquement dans le traitement d'ouverture de l'état.
Remarque : Cette rubrique est définie lors de la création du champ ou de l'état. Cette rubrique peut être modifiée dans l'onglet "Données" de la description de l'élément.
Versions 15 et supérieures
WINDEV MobileAndroid Cette propriété est désormais disponible pour les applications Android.
Nouveauté 15
WINDEV MobileAndroid Cette propriété est désormais disponible pour les applications Android.
WINDEV MobileAndroid Cette propriété est désormais disponible pour les applications Android.
Versions 17 et supérieures
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les états dans les applications iPhone/iPad.
Nouveauté 18
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les états dans les applications iPhone/iPad.
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les états dans les applications iPhone/iPad.
Versions 20 et supérieures
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les champs Table dans les applications Android et dans les applications iPhone/iPad.
Nouveauté 20
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les champs Table dans les applications Android et dans les applications iPhone/iPad.
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les champs Table dans les applications Android et dans les applications iPhone/iPad.
Versions 21 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Exemple
// -- Code d'ouverture de l'état
// Changement du fichier parcouru
ETAT_Etat1..NomSource = Client
// Nouvelle rubrique de parcours du fichier "Client"
ETAT_Etat1..RubriqueParcourue = IDClient
WINDEVWEBDEV - Code ServeurWINDEV MobileWindows MobileJavaAjaxCode Utilisateur (MCU)
// Tri décroissant sur les noms des sociétés
TABLE_TableClient..RubriqueParcourue = "-Société"
Syntaxe

Connaître la rubrique utilisée pour le parcours automatique dans un champ fichier Masquer les détails

<Rubrique parcourue> = <Nom du champ>..RubriqueParcourue
<Rubrique parcourue> : Chaîne de caractères
Nom de la rubrique utilisée pour le parcours automatique du champ spécifié. Cette rubrique appartient au fichier de données parcouru par le champ (connu ou modifié grâce à la propriété ..FichierParcouru).
Si le signe "-" précède le nom de la rubrique, le parcours est effectué en sens décroissant.
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ à manipuler.

Modifier la rubrique utilisée pour le parcours automatique dans un champ fichier Masquer les détails

<Nom du champ>..RubriqueParcourue = <Nouvelle rubrique>
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ à manipuler.
<Nouvelle rubrique> : Chaîne de caractères avec guillemets
Nom de la nouvelle rubrique à utiliser pour le parcours automatique du champ spécifié. Cette rubrique doit appartenir au fichier de données parcouru par le champ (connu ou modifié grâce à la propriété ..FichierParcouru).
Si le signe "-" précède le nom de la rubrique, le parcours sera effectué en sens décroissant.
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppiPhone/iPadPHPAjaxCode Utilisateur (MCU)

Connaître la rubrique utilisée pour le parcours automatique d'un état fichier Masquer les détails

<Rubrique parcourue> = <Nom de l'état>..RubriqueParcourue
<Rubrique parcourue> : Chaîne de caractères
Nom de la rubrique utilisée pour le parcours automatique de l'état spécifié. Cette rubrique appartient au fichier de données parcouru par l'état (connu ou modifié grâce à la propriété ..NomSource).
<Nom de l'état> : Chaîne de caractères (avec ou sans guillemets)
Nom de l'état sur fichier à manipuler.
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppiPhone/iPadPHPAjaxCode Utilisateur (MCU)

Modifier la rubrique utilisée pour le parcours automatique d'un état fichier Masquer les détails

<Nom de l'état>..RubriqueParcourue = <Nouvelle rubrique>
<Nom de l'état> : Chaîne de caractères (avec ou sans guillemets)
Nom de l'état sur fichier à manipuler.
<Nouvelle rubrique> : Chaîne de caractères
Nom de la nouvelle rubrique utilisée pour le parcours automatique de l'état spécifié. Cette rubrique doit appartenir au fichier de données parcouru par l'état (connu ou modifié grâce à la propriété ..NomSource).
Remarques

Type de parcours

  • Parcours automatique : Le parcours du fichier de données et l'affichage des données dans le champ sont automatiques. Le développeur n'a aucun code spécifique à saisir.
    Le tri est effectué sur la rubrique de parcours définie dans l'onglet "Contenu" de la description de l'objet. Si un filtre est spécifié ("Filtre sur la rubrique de parcours" dans l'onglet "Contenu" de la description de l'objet), ce filtre est utilisé. Aucun traitement de parcours de l'objet spécifié n'est exécuté.
  • Parcours programmé : Le développeur doit programmer le parcours du fichier de données et l'affichage des données dans le champ Table.
    Les traitements "Lecture du premier enregistrement", "Lecture de l'enregistrement précédent", "Lecture de l'enregistrement suivant" et "Lecture du dernier enregistrement" sont exécutés. Un parcours programmé permet un contrôle total sur l'ordre et le filtrage des enregistrements. Cependant, un parcours programmé est plus complexe et plus lent qu'un parcours automatique.

Manipuler des champs liés à un fichier de données grâce aux propriétés

  • Les enregistrements affichés dans un champ lié à un fichier proviennent du fichier de données ou de la requête spécifié avec la propriété ..FichierParcouru.
  • Le sens de tri est fixé par la propriété ..RubriqueParcourue.
  • Un filtrage des enregistrements peut être réalisé avec la propriété ..Filtre ou la fonction HFiltre.

Modifier les propriétés liées au parcours d'un champ fichier

Pour modifier les propriétés ..RubriqueParcourue, ..Filtre et ..FichierParcouru, il est conseillé de :
  1. Stopper le parcours en affectant une chaîne vide ("") à la propriété ..FichierParcouru.
  2. Modifier les propriétés nécessaires.
  3. Relancer le parcours avec la propriété ..FichierParcouru.
Cette méthode permet d'optimiser les modifications réalisées. En effet, chacune des modifications effectuée individuellement relance le parcours. Ces opérations peuvent vite devenir lentes sur des fichiers de données de taille importante.

Table mémoire

Si un champ Table mémoire doit afficher des données provenant d'un fichier de données, d'une requête ou d'une vue :
  • Créez un champ Table mémoire sous l'éditeur.
  • Dans votre programme, indiquez la rubrique à parcourir avec la propriété ..RubriqueParcourue. Cette rubrique doit appartenir au fichier de données, à la requête ou à la vue dont les données seront affichées dans le champ Table mémoire.
  • Utilisez la fonction FichierVersTableMémoire pour initialiser le champ Table avec les données voulues. Les données seront triées selon la rubrique parcourue spécifiée.
  • La propriété ..RubriqueAffichée sera automatiquement initialisée.

Champ Liste et Combo mémoire

Si un champ Liste ou Combo mémoire doit afficher des données provenant d'un fichier de données, d'une requête ou d'une vue :

Limites

La propriété ..RubriqueParcourue s'applique uniquement :
  • aux états dont la source de données est un fichier de données.
  • sur les champs (Liste, Table et Combo) d'une fenêtre.
WINDEVWINDEV MobileJava Dans les fenêtres, la propriété ..RubriqueParcourue s'applique uniquement aux :
  • Tables.
  • Listes (y compris listes image).
  • Combos.
  • Versions 16 et supérieures
    WINDEV Agendas.
    Nouveauté 16
    WINDEV Agendas.
    WINDEV Agendas.
  • Versions 16 et supérieures
    WINDEV Plannings.
    Nouveauté 16
    WINDEV Plannings.
    WINDEV Plannings.
  • Versions 16 et supérieures
    WINDEV Arbre.
    Nouveauté 16
    WINDEV Arbre.
    WINDEV Arbre.
  • Versions 19 et supérieures
    fenêtres internes (cas où le balayage est activé).
    Nouveauté 19
    fenêtres internes (cas où le balayage est activé).
    fenêtres internes (cas où le balayage est activé).
WEBDEV - Code ServeurPHP Dans les pages, la propriété ..RubriqueParcourue s'applique uniquement aux :
  • Tables,
  • Zones répétées,
  • Versions 16 et supérieures
    Zones répétées linéaires,
    Nouveauté 16
    Zones répétées linéaires,
    Zones répétées linéaires,
  • Listes,
  • Combos,
  • Plannings.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire