ListeCherche (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français (historique)

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Liste

Type de recherche
Paramètre
Majuscules/Minuscules
Recherche et sélection d'un élément présent dans un champ Liste ou un champ Combo
Recherche dans un champ Liste ou Combo lié aux données : recherche sur la valeur mémorisée ou sur la valeur affichée
Recherche et sélection dans un champ Liste lié aux données
Divers

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

ListeCherche (Fonction)

En anglais : ListSeek

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 gValeurMémorisée).

Dans cette version, les valeurs décrites par la fonction gValeurMémorisée ne peuvent pas être recherchées.

Remarque : La fonction ListeCherche peut être utilisée indifféremment sur :

les champs Liste lié au données ou Liste par programmation,
les champs Liste monosélection ou multisélection.

Rappel : Dans cette version, les champs Liste fichier ne sont pas disponibles.

Exemple

// Recherche de l'élément "Dubois" dans le champ Liste "LISTE_ListeClient"
ResCherche = ListeCherche(LISTE_ListeClient, "Dubois")

// Recherche de l'élément "Dubois" dans le champ Liste lié aux données "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.
Dans un champ Liste lié aux données, 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 l'événement en cours.
Le nom du champ Liste ou Combo à manipuler doit obligatoirement être spécifié.

<Élément recherché> : Chaîne de caractères

É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.
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 champs manipulés par programmation.
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" du champ 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

Majuscules/Minuscules

Si le champ est un champ Liste par programmation, la recherche ne tient pas compte des majuscules et des minuscules.
Si le champ est un champ Liste lié aux données, 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).

La recherche est sensible à la casse.

Les champs Liste fichier ne sont pas disponibles.

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

Pour rechercher et/ou sélectionner un élément présent dans un champ Liste (ou Combo) lié aux données, 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

L'élément recherché est sélectionné.

Recherche dans un champ Liste ou Combo lié aux données : 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 gValeurMémoriséeActive :

Si gValeurMémoriséeActive(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 gValeurMémoriséeActive(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.

Recherche et sélection dans un champ Liste lié aux données

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 :

NomDuChampListe = ElémentRecherché

Les options pour le remplissage du champ Liste sont les suivantes :

Fichier de données parcouru,
Rubrique affichée,
Rubrique de parcours.

Description du champ Liste lié aux données

Divers

Pour effectuer une recherche dans un champ Table ou dans un champ Combo déroulant une table, utilisez la fonction TableCherche.
La fonction ListeCherche peut être utilisée sur une colonne d'un champ Table de type "Combo".

Composante : wd300obj.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/01/2025

Signaler une erreur ou faire une suggestion | Aide en ligne locale