DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table hiérarchique
  • Type de recherche
  • Divers
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Recherche une valeur dans une colonne d'un champ Table hiérarchique, dans une branche spécifiée.
Exemple
// Recherche l'élément "Chemise" dans la colonne "COL_Produit"
// Recherche générique dans les lignes de niveau 2
ResCherche = TableChercheFils(COL_Produit, "Chemise", Faux, 2)
Syntaxe

Recherche en spécifiant l'indice de l'élément parent Masquer les détails

<Résultat> = TableChercheFils(<Colonne> , <Élément recherché> [, <Type de recherche> [, <Indice de l'élément parent> [, <Ligne de départ>]]])
<Résultat> : Entier
  • Indice de l'élément trouvé,
  • -1 si aucun élément ne correspond à la recherche.
<Colonne> : Nom de champ
Nom de la colonne dans laquelle la recherche doit être effectuée.
<É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> : Booléen optionnel
  • Vrai (valeur par défaut) si la recherche doit être à l'identique,
  • Faux si la recherche doit être générique.
<Indice de l'élément parent> : Entier optionnel
Indice de la ligne parente dans la hiérarchie.
<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.

Recherche en spécifiant l'élément parent Masquer les détails

<Résultat> = TableChercheFils(<Colonne> , <Élément recherché> [, <Type de recherche> [, <Élément parent> [, <Ligne de départ>]]])
<Résultat> : Entier
  • Indice de l'élément trouvé,
  • -1 si aucun élément ne correspond à la recherche.
<Colonne> : Nom de champ
Nom de la colonne dans laquelle la recherche doit être effectuée.
<É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> : Booléen optionnel
  • Vrai (valeur par défaut) si la recherche doit être à l'identique,
  • Faux si la recherche doit être générique.
<Élément parent> : Entier optionnel
Contenu de la ligne parente dans la hiérarchie. Par défaut, ce paramètre correspond à NULL : permet une recherche parmi les racines.
<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.
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 TableChercheFils. Par exemple :
    // Retourner tous les "Dupond" de la colonne "COL_Nom"
    TableChercheFils(COL_Nom, "Dupond")
  • Recherche générique : Les éléments commençant par <Élément recherché> sont retournés par la fonction TableChercheFils. Par exemple :
    // Retourner tous les noms commençant par "DUP"
    TableChercheFils(COL_Nom, "DUP", Faux)

Divers

  • L'élément trouvé n'est pas sélectionné. La fonction TablePosition permet de se positionner sur la ligne et la fonction TableSelectPlus permet de sélectionner la ligne.
  • La recherche effectuée avec la fonction TableChercheFils n'est pas sensible à la casse (majuscules/minuscules).
Classification Métier / UI : Code UI
Composante : wd300obj.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/09/2024

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