PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Type de recherche
  • Paramètre "Début de la recherche"
  • Majuscules/Minuscules
  • Recherche et sélection d'un élément présent dans un champ Liste ou Combo
  • Recherche dans un champ Liste ou Combo fichier : recherche sur la valeur mémorisée ou sur la valeur affichée
  • Recherche et sélection dans un champ Liste fichier
  • Divers
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
Recherche un élément dans un champ Liste (liste classique ou liste image) ou un champ Combo (y compris les valeurs décrites par la fonction gLien).
WEBDEV - Code Navigateur Dans cette version, les valeurs décrites par la fonction gLien ne peuvent pas être recherchées.
Remarque : La fonction ListeCherche peut être utilisée indifféremment sur :
  • les champs Liste fichier ou mémoire,
  • les champs Liste monosélection ou multisélection.
PHP Rappel : Dans cette version, les champs Liste fichier ne sont pas disponibles.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 16 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
// Recherche de l'élément "Dubois" dans le champ Liste "LISTE_ListeClient"
ResCherche = ListeCherche(LISTE_ListeClient, "Dubois")
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurEtats et RequêtesAndroidWindows MobileUniversal Windows 10 AppJavaAjaxCode Utilisateur (MCU)
// Recherche de l'élément "Dubois" dans le champ Liste fichier "LISTE_ListeClient"
// Recherche à l'identique à partir de l'élément 5
ResCherche = ListeCherche(LISTE_ListeClient, "Dubois", Vrai, 5)
Syntaxe
<Résultat> = ListeCherche(<Champ Liste> , <Élément recherché> [, <Type de recherche> [, <Début de la recherche>]])
<Résultat> : Entier
  • Indice de l'élément trouvé.
  • -1 si aucun élément ne correspond à la recherche.
L'élément trouvé n'est pas sélectionné. Pour sélectionner l'élément trouvé, utilisez la fonction ListeSelectPlus.
WINDEV Dans un champ Liste fichier, l'élément trouvé est affiché s'il n'est pas visible.
<Champ Liste> : Nom de champ
Nom du champ Liste (ou Combo) à manipuler.
Si ce paramètre correspond à une chaîne vide (""), l'élément est recherché dans le champ auquel appartient le traitement en cours.
WEBDEV - Code Navigateur Le nom du champ Liste ou Combo à manipuler doit obligatoirement être spécifié.
<Élément recherché> : Chaîne de caractères (avec guillemets)
Élément à rechercher dans le champ Liste (ou Combo) spécifié.
<Type de recherche> : Booléen optionnel
  • Vrai (valeur par défaut) pour une recherche à l'identique,
  • Faux pour une recherche générique.
PHP Ce paramètre n'est pas disponible. Par défaut, la recherche effectuée est une recherche à l'identique.
<Début de la recherche> : Entier optionnel
Indice de départ de la recherche dans le champ Liste ou Combo.
Si ce paramètre n'est pas spécifié, la recherche est effectuée dans tout le champ. Ce paramètre est ignoré pour les listes mémoire.
PHP Ce paramètre n'est pas disponible. Par défaut, la recherche est effectuée dans tout le champ.
Remarques

Type de recherche

  • Recherche à l'identique :
    Seuls les éléments ayant une valeur strictement égale à <Élément recherché> sont retournés par la fonction ListeCherche. Par exemple :
    // Retourner tous les "Dupond" de la liste "LISTE_Nom"
    ListeCherche(LISTE_Nom, "Dupond")
  • Recherche générique :
    Les éléments commençant par <Élément recherché> sont retournés par la fonction ListeCherche. Par exemple :
    // Retourner tous les noms commençant par "DUP"
    ListeCherche(LISTE_Nom, "DUP", Faux)

Paramètre "Début de la recherche"

Le paramètre <Début de la recherche> permet de rechercher toutes les occurrences d'une chaîne dans un champ Liste ou Combo.
Par exemple, pour compter le nombre de noms commençant par "DUP" dans le champ "LISTE_ListeClient" :
Indice est un entier
Cpt est un entier = 0
// Se positionner sur le premier élément correspondant
Indice = ListeCherche(LISTE_ListeClient, "DUP", Faux)
TANTQUE Indice <> -1
Cpt++
// Recherche du nom suivant commençant par "DUP"
Indice = ListeCherche(LISTE_ListeClient, "DUP", Faux, Indice + 1)
FIN
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaPHPAjaxCode Utilisateur (MCU)

Majuscules/Minuscules

  • Si le champ est un champ Liste mémoire, la recherche ne tient pas compte des majuscules et des minuscules.
  • Si le champ est un champ Liste fichier, la recherche sur les rubriques de type "Clé" tient compte des "Options de recherche" définies dans l'éditeur d'analyses (onglet "Général" de la description de la rubrique).
PHP La recherche est sensible à la casse.
PHP Les champs Liste fichier ne sont pas disponibles.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppAjaxCode Utilisateur (MCU)

Recherche et sélection d'un élément présent dans un champ Liste ou Combo

Pour rechercher et/ou sélectionner un élément présent dans un champ Liste ou Combo fichier, il est également possible d'utiliser la syntaxe suivante :
LISTE_ListeCommande..RubriqueMémorisée = "IDClient"
// Recherche et sélection de l'élément dont le IDClient est "135"
LISTE_ListeCommande = 135
// Si l'élément recherché n'est pas trouvé, LISTE_ListeCommande vaudra -1
AndroidJava L'élément recherché est sélectionné.
WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadWindows MobileUniversal Windows 10 AppAjaxCode Utilisateur (MCU)

Recherche dans un champ Liste ou Combo fichier : recherche sur la valeur mémorisée ou sur la valeur affichée

Cas 1 : Le champ Liste ou Combo est alimenté par un fichier de données (option "Accès direct") :
La recherche se fait suivant la valeur de la fonction gLienActive :
  • Si gLienActive(Champ, Vrai) (par défaut) : La fonction ListeCherche recherche sur la "rubrique de parcours" déclarée dans l'onglet "Contenu" de la description du champ.
  • Si gLienActive(Champ, Faux) : La fonction ListeCherche recherche sur la "rubrique affichée" déclarée dans l'onglet "Contenu" de la description du champ.
Cas 2 : Le champ Liste ou Combo est alimenté par un fichier de données (option "Chargé en mémoire") :
La fonction ListeCherche recherche sur la "rubrique affichée" déclarée dans l'onglet "Contenu" de la description du champ.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaAjaxCode Utilisateur (MCU)

Recherche et sélection dans un champ Liste fichier

Si les options pour le remplissage du champ Liste sont renseignées dans la fenêtre de description du champ (onglet "Contenu"), il est possible d'utiliser la syntaxe suivante pour rechercher et sélectionner un élément dans un champ Liste :
NomDeLaListe = ElémentRecherché
Les options pour le remplissage du champ Liste sont les suivantes :
  • Fichier parcouru
  • Rubrique affichée
  • Rubrique de parcours
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurEtats et RequêtesWindows MobileJavaAjaxCode Utilisateur (MCU)

Divers

  • Pour effectuer une recherche dans un champ Table ou dans un champ Combo avec table, utilisez la fonction TableCherche.
  • La fonction ListeCherche peut être utilisée sur une colonne d'un champ Table de type "Combo".
Composante : wd240obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire