- Conditions d'utilisation
- Type de recherche
- Champ Table fichier
- Divers
TableCherche (Fonction) En anglais : TableSearch
// Recherche l'élément "Chemise" dans la colonne "COL_Produit"
// Recherche générique à partir de ligne 5
soit ResCherche = TableCherche(COL_Produit, "Chemise", rechercheCommencePar, 5)
// Permet de lister toutes les occurrences d'une valeur recherchée.
Résultat1 est un entier
Résultat1 = TableCherche(COL_NomColonne, "ValeurRecherchée", rechercheIdentique)
TANTQUE Résultat1 <> -1
Trace(Résultat1)
Résultat1 = TableCherche(COL_NomColonne, "ValeurRecherchée", ...
rechercheIdentique, Résultat1 + 1)
FIN
Syntaxe
Rechercher un élément dans une colonne Masquer les détails
<Résultat> = TableCherche(<Nom de la colonne> , <Élément recherché> [, <Type de recherche> [, <Ligne de départ>]])
<Résultat> : Entier - Indice de l'élément trouvé,
- -1 si aucun élément ne correspond à la recherche.
Si la recherche est réalisée : - dans un champ Table par programmation, l'élément trouvé n'est pas sélectionné. Pour sélectionner l'élément trouvé, utilisez la fonction TableSelectPlus.
- dans un champ Table fichier, l'élément trouvé n'est pas sélectionné, les lignes du champ Table défilent jusqu'à l'élément recherché.
<Nom de la colonne> : Chaîne de caractères Nom de la colonne dans laquelle s'effectue la recherche.
Si ce paramètre correspond à une chaîne vide (""), la colonne manipulée est la colonne à laquelle appartient le traitement en cours.Dans un champ Table ou Table hiérarchique fichier, la colonne de recherche doit être liée à une rubrique de type clé. Il n'est pas possible de faire une recherche sur une colonne non liée à une rubrique. <Élément recherché> : Type de l'élément recherché Élément à rechercher dans la colonne spécifiée. Si l'élément recherché est de type :- "Date" ou "Heure" : la recherche est effectuée sur la valeur retournée.
- "Monétaire + Euro" : la recherche est effectuée sur la devise mémorisée.
<Type de recherche> : Constante optionnelle de type Entier Type de recherche à effectuer :
| |  Versions 21 et supérieuresrechercheCommencePar Nouveauté 21rechercheCommencePar | Recherche générique du type "Commence par" Les éléments ayant une valeur commençant par <Élément recherché> sont retournés. Attention : Dans un champ Table par programmation, les espaces au début du texte sont ignorés. | Versions 21 et supérieuresrechercheContient Nouveauté 21rechercheContient rechercheContient | Recherche générique du type "Contient" Les éléments ayant une valeur contenant <Élément recherché> sont retournés. | Versions 21 et supérieuresrechercheDéfaut Nouveauté 21rechercheDéfaut rechercheDéfaut | Recherche par défaut. Pour cette fonction, la recherche par défaut est une recherche à l'identique (du type "Egale à"). Les éléments ayant une valeur strictement égale à <Élément recherché> sont retournés. Attention : Dans un champ Table par programmation, les espaces au début du texte sont ignorés. | Versions 21 et supérieuresrechercheIdentique Nouveauté 21rechercheIdentique rechercheIdentique (ou Vrai par compatibilité)
(Valeur par défaut) | Recherche à l'identique (du type "Egale à") Les éléments ayant une valeur strictement égale à <Élément recherché> sont retournés. Attention : Dans un champ Table par programmation, les espaces au début du texte sont ignorés. |
<Ligne de départ> : Entier optionnel Numéro de la ligne de départ de la recherche dans la colonne.
Si ce paramètre n'est pas spécifié, la recherche est effectuée dans toute la colonne.
Ce paramètre permet de rechercher toutes les occurrences d'une chaîne dans une colonne.
Ce paramètre est ignoré dans le cas d'un champ Table fichier. 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 TableCherche. Par exemple :
// Retourner tous les "Dupond" de la colonne "COL_ColonneNom"
TableCherche(COL_ColonneNom, "Dupond")
Attention : Dans un champ Table par programmation, les espaces au début du texte sont ignorés. - Recherche générique : Les éléments commençant par <Élément recherché> sont retournés par la fonction TableCherche.
Par exemple :
// Retourner tous les noms commençant par "DUP"
TableCherche(COL_ColonneNom, "DUP", rechercheCommencePar)
Divers - Dans un champ Table par programmation, la recherche effectuée avec la fonction TableCherche :
- n'est pas sensible à la casse (majuscules/minuscules).
- ignore les espaces au début du texte.
- Dans un champ Table fichier, la recherche effectuée avec la fonction TableCherche tient compte des caractéristiques de recherche définies dans l'analyse pour la rubrique liée à la colonne de recherche (sensible ou non à la casse, ...).
Classification Métier / UI : Code UI Composante : wd270obj.dll
Documentation également disponible pour…
|
|
|